From 20701311dd3c7d3d039c6f2932feaf5829ce0cda Mon Sep 17 00:00:00 2001 From: Martin Caetano Date: Sun, 2 Aug 2026 01:04:41 -0300 Subject: [PATCH 1/5] Clarify report date attribution in analytics documentation --- .../dashboard-guide.md | 19 ++ .../data-completeness-and-reporting-gaps.md | 19 ++ _config.yml | 2 + .../campaign-reporting.md | 14 +- .../dashboard-guide.md | 150 ++++++++++++ .../data-completeness-and-reporting-gaps.md | 228 ++++++++++++++++++ .../playbook-reporting.md | 15 +- .../campaign-reporting.md | 14 +- .../dashboard-guide.md | 150 ++++++++++++ .../data-completeness-and-reporting-gaps.md | 228 ++++++++++++++++++ .../playbook-reporting.md | 15 +- 11 files changed, 842 insertions(+), 12 deletions(-) create mode 100644 _analytics-reporting-attribution/dashboard-guide.md create mode 100644 _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md create mode 100644 _i18n/en/analytics-reporting-attribution/dashboard-guide.md create mode 100644 _i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md create mode 100644 _i18n/es/analytics-reporting-attribution/dashboard-guide.md create mode 100644 _i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md diff --git a/_analytics-reporting-attribution/dashboard-guide.md b/_analytics-reporting-attribution/dashboard-guide.md new file mode 100644 index 0000000..715bf73 --- /dev/null +++ b/_analytics-reporting-attribution/dashboard-guide.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Dashboard guide + description: Read the 14-day overview, tracked actions, campaign calendar, and detailed business and operations reports from one place. +es: + title: Guía del Dashboard + description: Interpreta el resumen de 14 días, las acciones registradas, el calendario de campañas y los reportes detallados de negocio y operaciones. + +permalink: dashboard-guide +permalink_es: guia-dashboard + +layout: guide +topic: analytics-reporting-attribution +popular: false +--- + +{% translate_file analytics-reporting-attribution/dashboard-guide.md %} diff --git a/_analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_analytics-reporting-attribution/data-completeness-and-reporting-gaps.md new file mode 100644 index 0000000..b84d26a --- /dev/null +++ b/_analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Data completeness and reporting gaps + description: Diagnose missing metrics and reconcile differences between the Dashboard, detailed reports, customer activity, and external systems. +es: + title: Integridad de datos y diferencias en reportes + description: Diagnostica métricas faltantes y concilia diferencias entre el Dashboard, reportes detallados, actividad de clientes y sistemas externos. + +permalink: data-completeness-and-reporting-gaps +permalink_es: integridad-datos-diferencias-reportes + +layout: guide +topic: analytics-reporting-attribution +popular: false +--- + +{% translate_file analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %} diff --git a/_config.yml b/_config.yml index aa25d96..d47e7d3 100644 --- a/_config.yml +++ b/_config.yml @@ -86,6 +86,8 @@ collections: analytics-reporting-attribution: order: - analytics-overview.md + - dashboard-guide.md + - data-completeness-and-reporting-gaps.md - playbook-reporting.md - campaign-reporting.md - tracked-links.md diff --git a/_i18n/en/analytics-reporting-attribution/campaign-reporting.md b/_i18n/en/analytics-reporting-attribution/campaign-reporting.md index 2cb8f04..4bd9b7f 100644 --- a/_i18n/en/analytics-reporting-attribution/campaign-reporting.md +++ b/_i18n/en/analytics-reporting-attribution/campaign-reporting.md @@ -6,7 +6,11 @@ To open one, go to **Campaigns**, open the delivered campaigns view, and select The report opens with **First 14 days** selected. You can switch to the first 7 or 30 days, or choose a custom range. -The selected period updates the metrics, chart, funnel, message results, revenue breakdowns, and recent activity together. It filters when those results were recorded; it does not change the attribution window used to decide whether a purchase belongs to the campaign. +The selected period is based on when campaign messages were delivered. The metrics, chart, funnel, message results, and revenue breakdowns follow the recipient messages delivered during that period. Eligible clicks and purchases can happen later and remain assigned to the original delivery date. + +For example: **Delivered April 7 → Purchased April 10 → Counted on April 7 in the campaign report.** The Revenue report counts that same purchase on April 10 because Revenue uses purchase date. + +Changing the reporting period does not change the attribution window used to decide whether a purchase belongs to the campaign. A campaign message can remain listed even when its results fall outside the selected range. In that case, its row can show zero values until you choose a period that includes its activity. @@ -14,7 +18,7 @@ A campaign message can remain listed even when its results fall outside the sele The four summary cards answer different questions: -* **Attributed revenue:** how much revenue came from purchases attributed to this campaign during the selected period. +* **Attributed revenue:** how much revenue came from eligible purchases attributed to campaign messages delivered during the selected period. * **Average ROI:** attributed revenue divided by the estimated cost of delivering the campaign messages. * **Conversion:** attributed purchases divided by delivered messages. * **Revenue/message:** attributed revenue divided by delivered messages. @@ -47,9 +51,9 @@ This lets you compare the actual messages without mixing click performance with ## Understand time to conversion -**Time to conversion** shows how long it took attributed sales to happen after the campaign launched, using ranges such as the same day, 1–3 days, 4–7 days, and later periods. +**Time to conversion** shows how long it took attributed sales to happen after message delivery, using ranges such as the same day, 1–3 days, 4–7 days, and later periods. -The report period filters when the attributed sale was recorded. A sale can therefore appear days after message delivery while still belonging to the campaign under the applicable attribution rules. +The report period selects the original message deliveries. A sale can happen days later and still be counted with its delivery date when it belongs to the campaign under the applicable attribution rules. ## Compare revenue by channel and segment @@ -80,7 +84,7 @@ Hellotext evaluates the available evidence and its precedence before assigning a ## When results are missing or unexpected -First confirm that the selected period includes the campaign activity. Then verify that tracked links and purchase events are available. Supported commerce integrations can send purchase data automatically; custom storefronts can use [Hellotext.js or the API]({% link _developers/tracking-events.md %}). +First confirm that the selected period includes the eligible message delivery. Then verify that tracked links and purchase events are available. Supported commerce integrations can send purchase data automatically; custom storefronts can use [Hellotext.js or the API]({% link _developers/tracking-events.md %}). If activity is still missing, follow [Troubleshoot missing signals or activity]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}). diff --git a/_i18n/en/analytics-reporting-attribution/dashboard-guide.md b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md new file mode 100644 index 0000000..4bc3bd8 --- /dev/null +++ b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md @@ -0,0 +1,150 @@ +The Dashboard gives you a quick view of recent business activity and access to the reports used for deeper analysis. Use it to spot a change, then open the relevant report to understand its source. + +The Dashboard combines four areas: + +- a fixed 14-day overview; +- tracked customer actions; +- a campaign calendar; and +- business performance and operations reports. + +## Start with notices and onboarding + +Hellotext can show an onboarding checklist or account notices above the metrics. Review these first because an incomplete connection, expired channel authorization, or account problem can affect sending and the data shown below. + +Completing an onboarding step does not prove that historical data was imported or that every signal is arriving. After connecting a source, verify a recent customer, event, and order before relying on the Dashboard. + +## Read the 14-day overview + +The overview cards always cover the current day and the previous 13 days. Their percentage change compares that total with the preceding 14-day period. The small chart shows the daily values inside the current period. + +Changing the date inside a detailed report does not change these Dashboard cards. + +### Attributed revenue + +**Attributed revenue** is the positive revenue Hellotext connected to eligible campaigns, routes, playbooks, or commercial interactions under its attribution rules and windows. + +Select the card to open the **Revenue report** and inspect the result in more detail. + +Attributed revenue is not the same as: + +- all revenue recorded by the connected store; +- revenue merely influenced by a customer interaction; or +- incremental revenue that would not have happened without Hellotext. + +See [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) for the evidence, precedence, and time-window rules behind this value. + +### Revenue attribution benchmark + +The **Revenue attribution benchmark** shows the percentage of total recorded revenue that was attributed to Hellotext during the same 14-day period. + +The marker represents the typical platform benchmark. Use it as context, not as a guaranteed target. The result depends on the business model, active campaigns and playbooks, customer behavior, attribution evidence, and whether Hellotext receives complete order revenue. + +This percentage can be empty when Hellotext has no total revenue for the period, even if another integration or external report contains sales. + +### Conversations + +**Conversations** counts conversations started during the 14-day period. + +It does not represent: + +- the number of messages exchanged; +- unique customers; +- conversations currently waiting in Inbox; or +- conversations resolved by AI or the team. + +Use the operations reports for resolution, SLA, assignment, and workload questions. + +### Empty values + +A dash means Hellotext did not calculate a positive value for that card in the period. Do not interpret an empty card as proof that nothing happened in the business. Confirm that the relevant channels, store, events, and identifiers are connected and sending data. + +## Understand the Actions table + +The **Actions** table summarizes tracked event types from the last 14 days. An action is the type of activity, such as a purchase, subscription, form submission, conversation event, or a custom action defined by the business. + +| Column | What it shows | +| --- | --- | +| **Events** | Number of recorded occurrences of the action. | +| **Average value** | Total monetary value recorded for the action divided by its occurrences. | +| **Amount** | Total monetary value recorded across those occurrences. | + +Select a column heading to sort the table by event volume, average value, or total amount. + +Not every action carries money. A valid action can have events while its average value and amount remain empty or zero. If a custom action should include a value, verify that the integration sends the amount and currency in the event rather than adding them only to the action name. + +The Actions table describes what Hellotext received. It does not, by itself, attribute the action to a campaign or playbook. Use the corresponding report when source and attribution matter. + +## Use the campaign calendar + +The calendar organizes scheduled and delivered campaigns by week. + +- Move between weeks with the previous and next controls. +- Hover over a campaign to review its audience, recipient count, schedule or delivery time, channels, and creator. +- For delivered campaigns, the tooltip can also show attributed revenue and CTR. +- Select a scheduled campaign to continue editing it, or a delivered campaign to open its results. + +The calendar contains campaigns. It is not a complete schedule of every message a playbook, AI agent, or route may send. + +## Choose the right report + +The report cards are divided into **Business Performance** and **Operations & Experience**. + +| Report | Use it to answer | +| --- | --- | +| **Revenue report** | How much revenue was recorded, what was attributed to AI or the team, and which channels, playbooks, or campaigns received credit? | +| **Performance report** | How are conversion rate, time to conversion, and escalation rate changing? | +| **Demand insights** | Which customer requests could not be fulfilled, which products were affected, and what revenue may have been missed? | +| **Service quality report** | How often did AI or the team resolve conversations, meet SLA, or leave conversations unresolved? | +| **Workload & capacity report** | How much work is assigned, handled, resolved, transferred, or active across teammates and teams? | + +Open a report when you need to change the date range, select a metric, compare a breakdown, or inspect detailed rows. Available breakdowns depend on the report and metric. + +## Change a report period + +Detailed reports have their own date selector. Common choices include 7, 14, or 30 days and a custom range, with additional calendar presets available in the custom picker. + +When comparing reports: + +1. Use the same date range. +2. Check which date the report uses to assign results. +3. Apply the same channel or source breakdown. +4. Allow current attribution windows to close before treating recent results as final. + +The same outcome can appear on different dates without either report being wrong. Playbook reports assign later eligible outcomes to the original trigger date, campaign reports assign them to the original message delivery date, and Revenue uses purchase date. Conversation-performance reports follow the conversation start date. Current-state sections use the time displayed by that section. + +The operations report can also contain a live operational-pressure section. A live snapshot describes the current queue and is not limited by the historical date range selected for the report. + +## A practical review routine + +For a regular business review: + +1. Resolve account or integration notices at the top. +2. Check the 14-day direction of attributed revenue and conversations. +3. Use the benchmark to understand attributed revenue as a share of total recorded revenue. +4. Review Actions for unexpected drops, spikes, or missing monetary values. +5. Check the campaign calendar for upcoming sends and recent results. +6. Open the report that answers the specific question instead of comparing unrelated headline metrics. + +For example, a rise in conversations with flat attributed revenue does not explain the cause. Open **Performance** to inspect conversion and escalation, **Service quality** to review resolution, and **Revenue** to inspect attribution sources. + +## Troubleshoot missing or unexpected data + +If the Dashboard looks incomplete: + +- Confirm the business and user timezone before comparing days. +- Verify the store or external system is still connected. +- Check that recent profiles, orders, conversations, and tracked events appear in Hellotext. +- Confirm customer and order identifiers allow activity to be connected to the correct profile. +- Review whether an external source had precedence over Hellotext attribution. +- Make sure you are comparing the Dashboard's fixed 14 days with the same period in the detailed report. + +Recent report results can change while attribution remains open or late data arrives. If the underlying event is missing, start with [Troubleshoot missing signals or activity]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}). + +## Related guides + +- [Analytics overview]({% link _analytics-reporting-attribution/analytics-overview.md %}) +- [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Understand response times]({% link _team/understanding-response-times.md %}) +- [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md new file mode 100644 index 0000000..ad0a753 --- /dev/null +++ b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -0,0 +1,228 @@ +Use this guide when a Dashboard card, report metric, breakdown, or attributed sale is missing or does not match another Hellotext view or external system. + +A difference is not always a tracking failure. Two views can use different periods, populations, timestamps, currencies, denominators, or attribution rules. Establish what each number measures before changing the integration. + +## Define the exact difference + +Record both sides of the comparison: + +- Hellotext business and report. +- Metric and breakdown selected. +- Start and end dates. +- Business and user timezone. +- Reporting currency. +- Channel, campaign, playbook, route, team, or segment filter. +- Value shown in Hellotext and value expected from the other source. +- One customer, order, conversation, or event that demonstrates the difference. + +Avoid reporting only that “revenue is wrong” or “data is missing.” A concrete record lets you determine whether the gap began at collection, identity matching, report eligibility, or attribution. + +## 1. Align the period and definition + +Confirm that both views measure the same thing. + +### Match the date range + +The Dashboard overview and Actions table always use the latest 14 days. Detailed reports have their own date selector and can use 7, 14, 30 days, or a custom period. + +Using the same dates is necessary, but it is not enough. You must also confirm what event the selected period is based on. + +### Understand how each report counts results + +Hellotext reports can assign a result to one of three kinds of dates: + +- **The date the source activity began:** the period selects messages, playbook triggers, conversations, or requests. Eligible outcomes that happen later remain assigned to the original source date. +- **The date the result happened:** the period selects purchases, reviews, resolutions, or other events completed during that range. +- **The current state:** the section shows what is true at the displayed time, such as current workload, pending follow-ups, or audience membership. + +The report or section should explain which date it uses. The most common rules are: + +| Report or section | Date used by the selected period | +| --- | --- | +| Dashboard | Revenue uses purchase date, activity uses the date each event occurred, and current-state cards reflect the displayed time. | +| Revenue report | Purchase date. Campaign and playbook rows identify the credited source for purchases completed during the selected period. | +| Campaign performance | Message delivery date. Eligible clicks and purchases recorded later remain assigned to the original delivery. | +| Playbook report | Playbook trigger date. Later messages and attributed purchases remain assigned to the original trigger. | +| Performance, Conversations, and Service Quality | Conversation start date. Later conversion, escalation, resolution, and satisfaction outcomes follow the originating conversation. | +| Channel performance | Message sent date. Later delivery, engagement, and attributed-sales outcomes follow those messages. | +| Demand insights | Date the unfulfilled request began. Later recovery follows the original request. | +| Reviews and feedback | Submitted feedback uses submission date; collection performance uses request-delivery date; pending follow-ups show current state. | +| Workload and capacity | Handled and resolved work uses the date of each action; queue, backlog, and risk sections show current state. | + +For example, if a playbook is triggered on April 7 and the customer purchases on April 10, the playbook report counts the result on April 7. The Revenue report counts that same purchase on April 10. Both are correct because they answer different questions. + +The date-counting rule does not extend or replace the attribution window. A later purchase is added to the original source date only when it qualifies under Hellotext's attribution rules. + +### Match the metric definition + +Commonly confused numbers include: + +- **Total revenue:** commerce revenue available to Hellotext for the selected period, including attributed and unattributed revenue. +- **Attributed revenue:** eligible revenue credited to Hellotext under its attribution methodology. +- **Conversion rate:** a report-specific numerator divided by its report-specific eligible population. +- **CTR:** tracked clicks divided by delivered messages where that definition applies. +- **Conversations:** conversations started, not messages, unique customers, or the current Inbox queue. +- **Action amount:** monetary value attached to tracked occurrences of an action, not automatically attributed revenue. + +Do not compare two percentages until you confirm that they use the same numerator and denominator. + +## 2. Follow one record end to end + +Choose one missing customer, purchase, conversation, or event and trace it through the measurement path. + +### Confirm the customer profile + +In **Audience**, verify that: + +- the profile exists in the correct business; +- its phone, email, external ID, or connected identity is correct; +- duplicate profiles did not split the activity; +- the expected property, subscription state, list, or segment is present; and +- the activity appears on the expected profile rather than another customer. + +When a click lands on one profile and the purchase lands on another, the report may not be able to connect the journey even though both events exist. + +### Confirm the source event + +Look for the event the metric needs: + +- message sent or delivered; +- tracked link click; +- conversation start, assignment, escalation, or resolution; +- product view, cart, or checkout; +- purchase or custom conversion; +- cancellation, refund, or replacement order; or +- the custom action and monetary value expected in the Actions table. + +If the event is absent from the customer activity, the problem is upstream of reporting. Check the connected store, channel, capture, Hellotext.js implementation, API request, or custom integration. + +### Confirm the event context + +An event can exist but still lack the context required by the report. Check the customer identifier, order or product reference, channel, campaign or playbook source, currency, amount, status, and timestamp. + +For custom tracking, use the exact action name expected by Hellotext. Small variations can create separate actions and split the results. + +## 3. Check report eligibility + +After confirming the event, check whether it belongs in the metric you are reviewing. + +### Dashboard + +- The event must fall inside the fixed 14-day period. +- Attributed revenue needs an active positive attribution record. +- The revenue benchmark also needs total commerce revenue for the period. +- Conversations counts conversation-start activity, not current queue state. +- The Actions table shows actions that have recorded events in the period. + +### Campaign reporting + +- The eligible message delivery must fall inside the selected campaign period. +- Delivery metrics require a recorded delivery result. +- CTR requires a tracked click and delivered-message denominator. +- Conversion and revenue require an eligible attributed purchase, which can happen later and remain assigned to the original delivery date. + +### Playbook and performance reporting + +- The playbook, route, or agent must be active and receive eligible traffic. +- The required trigger, interaction, conversion, escalation, or resolution event must be recorded. +- A playbook report selects original trigger dates; a performance report selects conversation start dates. Later eligible outcomes remain attached to that original activity. +- A channel, playbook, AI-versus-human, or team breakdown needs that dimension on the underlying activity. + +### Operations reporting + +- Service quality depends on conversation lifecycle and resolution data. +- SLA metrics need the relevant response and timing records. +- Workload and capacity depend on assignments, transfers, handling, resolution, teams, and teammates. +- Operational pressure is a current snapshot and is not restricted by the historical period selected elsewhere in the report. + +### Demand insights + +Demand insights require supported unfulfilled-request signals and enough product, intent, commerce, and value context to calculate the selected metric. A customer question in Inbox does not automatically become an unfulfilled demand signal. + +## 4. Check attribution separately + +An order can be present in total revenue without being attributed to Hellotext. + +For a missing attributed sale, verify: + +- Hellotext received the purchase or positive monetary event. +- The purchase is connected to the expected customer and order. +- An eligible campaign, route, playbook, click, delivery, recommendation, or commercial interaction exists. +- The evidence falls inside its attribution window. +- A recognized external source did not take precedence. +- Human checkout ownership or commercial activity did not change the applicable decision. +- A later cancellation, refund, replacement, or stronger source did not revoke or adjust the attribution. + +Hellotext selects attribution according to the available evidence and does not credit the full amount independently to every campaign and playbook that touched the customer. + +Read [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) before treating an unattributed order as a missing event. + +## Common comparisons that do not match directly + +| Comparison | Why it can differ | +| --- | --- | +| Dashboard vs detailed report | The Dashboard uses a fixed 14 days; the report has its own range and metric. | +| Playbook report vs Revenue report | The playbook report assigns later outcomes to the original trigger date; Revenue includes the purchase on its purchase date. | +| Campaign report vs Revenue report | Campaign performance assigns an eligible purchase to the original delivery date; Revenue includes it on its purchase date. | +| Hellotext total revenue vs store revenue | Hellotext can only report the supported orders and updates it received; date, currency, status, duplicate, refund, tax, shipping, or net/gross definitions can also differ. | +| Total revenue vs attributed revenue | Total revenue includes unattributed commerce revenue; attribution requires eligible Hellotext evidence. | +| Actions amount vs Revenue report | An action can carry money without representing canonical order revenue or receiving attribution. | +| Campaign CTR vs conversion rate | CTR measures tracked engagement; conversion measures eligible attributed purchases against its delivery population. | +| Campaign revenue vs playbook revenue | Attribution source precedence selects the eligible credited source rather than duplicating the sale across every touchpoint. | +| Conversations vs Inbox workload | The Dashboard counts starts; the operations report measures assignments, active load, handling, transfers, and resolutions. | +| Current report vs an earlier export | Late events, open attribution, cancellations, refunds, or source corrections can update the live report after the export was generated. | + +## Reconcile revenue with an external system + +Compare individual orders before comparing totals. + +1. Export or identify the same date range in both systems. +2. Use order references and customer identifiers to match records. +3. Confirm which order timestamp determines inclusion. +4. Compare currency and conversion behavior. +5. Check whether totals include taxes, shipping, discounts, cancellations, refunds, test orders, or duplicate/replacement orders. +6. Separate missing total revenue from missing attribution. +7. Use the Revenue export when you need Hellotext's attribution reason and supporting context for credited rows. + +Document the agreed comparison definition so the next reconciliation uses the same rules. + +## Understand recent and changing results + +Recent results may change because: + +- attribution windows are still open; +- an order or conversion arrives after the original interaction; +- a channel or commerce integration finishes processing late data; +- an order is cancelled, refunded, or replaced; +- stronger source evidence arrives; or +- corrected identity data connects previously separate activity. + +For source-based reports, a recent date can keep increasing while its outcome or attribution window remains open. Use an older period whose windows have closed for final comparisons. For current campaigns or always-on playbooks, treat early numbers as provisional. + +## When to contact Support + +If the source event exists with the required context but the expected report still does not include it, send Support: + +- business ID and report URL; +- metric, breakdown, and exact date range; +- business and user timezone; +- customer profile, order, conversation, campaign, or playbook ID; +- event name and timestamp; +- source integration or API path; +- expected and actual values; and +- screenshots or exports that show both sides of the comparison. + +Use one or two representative records rather than a broad total without examples. Do not include passwords, API secrets, or unnecessary customer data. + +If the event itself is missing, follow [Troubleshoot missing signals or activity]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}) first. + +## Related guides + +- [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Analytics overview]({% link _analytics-reporting-attribution/analytics-overview.md %}) +- [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Tracked links]({% link _analytics-reporting-attribution/tracked-links.md %}) +- [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}) +- [Tracking events]({% link _developers/tracking-events.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/playbook-reporting.md b/_i18n/en/analytics-reporting-attribution/playbook-reporting.md index 48a4b73..15bef56 100644 --- a/_i18n/en/analytics-reporting-attribution/playbook-reporting.md +++ b/_i18n/en/analytics-reporting-attribution/playbook-reporting.md @@ -18,6 +18,19 @@ When you review feedback playbooks together, keep their outcomes separate. Revie Before comparing results, choose the right date range and confirm that the playbook had enough traffic to learn from. +## Understand how dates are counted + +The same purchase can appear on different dates across reports because each report answers a different question. + +- A **playbook-specific report** uses the date the playbook was triggered. Every metric, chart, and table follows the executions triggered during the selected period. Later message activity and attributed purchases are added to the original trigger date. +- The **Playbooks overview** uses message delivery date for outcome performance. Later eligible purchases remain assigned to those deliveries. +- The **Revenue report** uses purchase date. It shows purchases completed during the selected period and identifies the playbook, campaign, or other source that received credit. +- The **Performance report** uses conversation start date for conversation outcomes. Later conversion, escalation, and resolution outcomes remain assigned to the originating conversation. + +For example: **Triggered April 7 → Purchased April 10 → Counted on April 7 in the playbook report and April 10 in Revenue.** + +Recent trigger or delivery dates can increase while their outcome and attribution windows remain open. This does not change which source activity the result belongs to. Read [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) for the eligibility and timing rules. + ## Review revenue from playbooks In the Revenue report, look for: @@ -72,7 +85,7 @@ Compare playbooks only when the context is similar enough. Before making a decision, check: -- The same date range. +- The same date range and the date-counting rule used by each report. - Similar audience size and traffic. - Comparable channel mix. - Whether the playbook was fully enabled for the whole period. diff --git a/_i18n/es/analytics-reporting-attribution/campaign-reporting.md b/_i18n/es/analytics-reporting-attribution/campaign-reporting.md index 6d298da..95298ea 100644 --- a/_i18n/es/analytics-reporting-attribution/campaign-reporting.md +++ b/_i18n/es/analytics-reporting-attribution/campaign-reporting.md @@ -6,7 +6,11 @@ Para abrir uno, ve a **Campañas**, abre la vista de campañas entregadas y sele El reporte se abre con **Primeros 14 días** seleccionado. Puedes cambiar a los primeros 7 o 30 días, o elegir un rango personalizado. -El período seleccionado actualiza en conjunto las métricas, el gráfico, el embudo, los resultados por mensaje, los desgloses de ingresos y la actividad reciente. Filtra cuándo se registraron esos resultados; no modifica la ventana de atribución utilizada para decidir si una compra corresponde a la campaña. +El período seleccionado se basa en cuándo se entregaron los mensajes de la campaña. Las métricas, el gráfico, el embudo, los resultados por mensaje y los desgloses de ingresos siguen a los mensajes entregados durante ese período. Los clicks y compras elegibles pueden ocurrir después y permanecer asignados a la fecha de entrega original. + +Por ejemplo: **Mensaje entregado el 7 de abril → Compra el 10 de abril → Cuenta el 7 de abril en el reporte de campaña.** El Reporte de ingresos cuenta esa misma compra el 10 de abril porque usa la fecha de compra. + +Cambiar el período del reporte no modifica la ventana de atribución utilizada para decidir si una compra corresponde a la campaña. Un mensaje de la campaña puede permanecer en la lista aunque sus resultados queden fuera del rango seleccionado. En ese caso, su fila puede mostrar valores en cero hasta que elijas un período que incluya su actividad. @@ -14,7 +18,7 @@ Un mensaje de la campaña puede permanecer en la lista aunque sus resultados que Las cuatro tarjetas del resumen responden preguntas diferentes: -* **Ingresos atribuidos:** cuántos ingresos provienen de compras atribuidas a esta campaña durante el período seleccionado. +* **Ingresos atribuidos:** cuántos ingresos provienen de compras elegibles atribuidas a mensajes de la campaña entregados durante el período seleccionado. * **ROI promedio:** ingresos atribuidos divididos por el costo estimado de entrega de los mensajes de la campaña. * **Conversión:** compras atribuidas divididas por mensajes entregados. * **Ingresos/mensaje:** ingresos atribuidos divididos por mensajes entregados. @@ -47,9 +51,9 @@ Esto permite comparar los mensajes reales sin mezclar el rendimiento de los clic ## Entiende el tiempo de conversión -**Tiempo de conversión** muestra cuánto demoraron en ocurrir las ventas atribuidas desde el lanzamiento de la campaña, con rangos como el mismo día, 1–3 días, 4–7 días y períodos posteriores. +**Tiempo de conversión** muestra cuánto demoraron en ocurrir las ventas atribuidas desde la entrega del mensaje, con rangos como el mismo día, 1–3 días, 4–7 días y períodos posteriores. -El período del reporte filtra cuándo se registró la venta atribuida. Por eso una venta puede aparecer días después de la entrega del mensaje y aun corresponder a la campaña según las reglas de atribución aplicables. +El período del reporte selecciona las entregas originales de los mensajes. Una venta puede ocurrir días después y aun contarse con su fecha de entrega cuando corresponde a la campaña según las reglas de atribución aplicables. ## Compara ingresos por canal y segmento @@ -80,7 +84,7 @@ Hellotext evalúa la evidencia disponible y su precedencia antes de asignar una ## Cuando faltan resultados o parecen incorrectos -Primero confirma que el período seleccionado incluya la actividad de la campaña. Luego verifica que estén disponibles los enlaces rastreados y los eventos de compra. Las integraciones de comercio compatibles pueden enviar los datos de compras automáticamente; las tiendas personalizadas pueden usar [Hellotext.js o la API]({% link _developers/tracking-events.md %}). +Primero confirma que el período seleccionado incluya la entrega elegible del mensaje. Luego verifica que estén disponibles los enlaces rastreados y los eventos de compra. Las integraciones de comercio compatibles pueden enviar los datos de compras automáticamente; las tiendas personalizadas pueden usar [Hellotext.js o la API]({% link _developers/tracking-events.md %}). Si la actividad sigue sin aparecer, consulta [Soluciona señales o actividad faltantes]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}). diff --git a/_i18n/es/analytics-reporting-attribution/dashboard-guide.md b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md new file mode 100644 index 0000000..10d3c6e --- /dev/null +++ b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md @@ -0,0 +1,150 @@ +El Dashboard ofrece una vista rápida de la actividad reciente del negocio y acceso a los reportes para analizarla en profundidad. Úsalo para detectar un cambio y luego abre el reporte correspondiente para entender su origen. + +El Dashboard combina cuatro áreas: + +- un resumen fijo de 14 días; +- acciones registradas de clientes; +- un calendario de campañas; y +- reportes de rendimiento del negocio y operaciones. + +## Comienza por los avisos y onboarding + +Hellotext puede mostrar un checklist de onboarding o avisos de la cuenta antes de las métricas. Revísalos primero porque una conexión incompleta, autorización vencida de un canal o problema de la cuenta puede afectar los envíos y datos que aparecen más abajo. + +Completar un paso del onboarding no demuestra que se hayan importado datos históricos ni que todas las señales estén llegando. Después de conectar una fuente, verifica un cliente, evento y pedido recientes antes de depender del Dashboard. + +## Interpreta el resumen de 14 días + +Las tarjetas del resumen siempre incluyen el día actual y los 13 días anteriores. Su cambio porcentual compara ese total con el período previo de 14 días. El gráfico pequeño muestra los valores diarios dentro del período actual. + +Cambiar la fecha dentro de un reporte detallado no modifica estas tarjetas del Dashboard. + +### Ingresos atribuidos + +Los **Ingresos atribuidos** son los ingresos positivos que Hellotext vinculó con campañas, rutas, playbooks o interacciones comerciales elegibles según sus reglas y ventanas de atribución. + +Selecciona la tarjeta para abrir el **Reporte de ingresos** y revisar el resultado en mayor detalle. + +Los ingresos atribuidos no son lo mismo que: + +- todos los ingresos registrados por la tienda conectada; +- ingresos solamente influenciados por una interacción con el cliente; o +- ingresos incrementales que no habrían ocurrido sin Hellotext. + +Consulta [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) para entender la evidencia, precedencia y ventanas detrás de este valor. + +### Benchmark de atribución de ingresos + +El **Benchmark de atribución de ingresos** muestra el porcentaje de los ingresos totales registrados que fue atribuido a Hellotext durante el mismo período de 14 días. + +El marcador representa el benchmark típico de la plataforma. Úsalo como contexto, no como un objetivo garantizado. El resultado depende del modelo del negocio, campañas y playbooks activos, comportamiento de clientes, evidencia de atribución y de que Hellotext reciba todos los ingresos de pedidos. + +Este porcentaje puede aparecer vacío cuando Hellotext no tiene ingresos totales para el período, aunque otra integración o reporte externo contenga ventas. + +### Conversaciones + +**Conversaciones** cuenta las conversaciones iniciadas durante el período de 14 días. + +No representa: + +- la cantidad de mensajes intercambiados; +- clientes únicos; +- conversaciones que están esperando actualmente en el Inbox; ni +- conversaciones resueltas por IA o el equipo. + +Usa los reportes de operaciones para preguntas sobre resolución, SLA, asignación y carga de trabajo. + +### Valores vacíos + +Un guion significa que Hellotext no calculó un valor positivo para esa tarjeta en el período. No interpretes una tarjeta vacía como prueba de que nada ocurrió en el negocio. Confirma que los canales, tienda, eventos e identificadores correspondientes estén conectados y enviando datos. + +## Entiende la tabla de Acciones + +La tabla de **Acciones** resume tipos de eventos registrados durante los últimos 14 días. Una acción es el tipo de actividad, como una compra, suscripción, envío de formulario, evento de conversación o acción personalizada definida por el negocio. + +| Columna | Qué muestra | +| --- | --- | +| **Eventos** | Cantidad de ocurrencias registradas para la acción. | +| **Valor Promedio** | Valor monetario total registrado para la acción dividido entre sus ocurrencias. | +| **Monto** | Valor monetario total registrado entre todas esas ocurrencias. | + +Selecciona el encabezado de una columna para ordenar la tabla por volumen de eventos, valor promedio o monto total. + +No todas las acciones incluyen dinero. Una acción válida puede tener eventos aunque su valor promedio y monto estén vacíos o en cero. Si una acción personalizada debería incluir un valor, verifica que la integración envíe el monto y moneda dentro del evento en lugar de agregarlos solamente al nombre de la acción. + +La tabla de Acciones describe lo que recibió Hellotext. Por sí sola, no atribuye la acción a una campaña o playbook. Usa el reporte correspondiente cuando importen la fuente y atribución. + +## Usa el calendario de campañas + +El calendario organiza por semana las campañas programadas y enviadas. + +- Muévete entre semanas con los controles anterior y siguiente. +- Pasa el cursor sobre una campaña para revisar su audiencia, cantidad de destinatarios, horario programado o de envío, canales y creador. +- Para campañas enviadas, el detalle también puede mostrar ingresos atribuidos y CTR. +- Selecciona una campaña programada para continuar editándola o una campaña enviada para abrir sus resultados. + +El calendario contiene campañas. No es una agenda completa de todos los mensajes que podría enviar un playbook, agente de IA o ruta. + +## Elige el reporte correcto + +Las tarjetas de reportes se dividen entre **Rendimiento del negocio** y **Operaciones & Experiencia**. + +| Reporte | Úsalo para responder | +| --- | --- | +| **Reporte de ingresos** | ¿Cuántos ingresos se registraron, cuáles se atribuyeron a IA o al equipo y qué canales, playbooks o campañas recibieron crédito? | +| **Reporte de rendimiento** | ¿Cómo están cambiando la tasa de conversión, tiempo hasta conversión y tasa de derivación? | +| **Insights de demanda** | ¿Qué solicitudes de clientes no pudieron resolverse, qué productos fueron afectados y cuántos ingresos podrían haberse perdido? | +| **Reporte de calidad de servicio** | ¿Con qué frecuencia la IA o el equipo resolvieron conversaciones, cumplieron el SLA o dejaron conversaciones sin resolver? | +| **Reporte de carga y capacidad** | ¿Cuánto trabajo está asignado, atendido, resuelto, transferido o activo entre personas y equipos? | + +Abre un reporte cuando necesites cambiar el período, seleccionar una métrica, comparar un desglose o revisar filas detalladas. Los desgloses disponibles dependen del reporte y métrica. + +## Cambia el período de un reporte + +Los reportes detallados tienen su propio selector de fechas. Las opciones habituales incluyen 7, 14 o 30 días y un rango personalizado, con más períodos disponibles dentro del selector personalizado. + +Al comparar reportes: + +1. Usa el mismo período. +2. Revisa qué fecha usa el reporte para asignar los resultados. +3. Aplica el mismo desglose de canal o fuente. +4. Espera que se cierren las ventanas de atribución actuales antes de tratar los resultados recientes como definitivos. + +El mismo resultado puede aparecer en fechas distintas sin que ninguno de los reportes esté equivocado. Los reportes de playbooks asignan los resultados elegibles posteriores a la fecha de activación original, los reportes de campañas los asignan a la fecha de entrega original y el Reporte de ingresos usa la fecha de compra. Los reportes de rendimiento de conversaciones siguen la fecha de inicio de la conversación. Las secciones de estado actual usan el momento indicado por esa sección. + +El reporte de operaciones también puede incluir una sección de presión operativa en vivo. Una instantánea en vivo describe la cola actual y no está limitada por el período histórico seleccionado para el reporte. + +## Una rutina práctica de revisión + +Para una revisión habitual del negocio: + +1. Resuelve los avisos de cuenta o integraciones que aparecen al principio. +2. Revisa la dirección de los ingresos atribuidos y conversaciones durante 14 días. +3. Usa el benchmark para entender los ingresos atribuidos como proporción de los ingresos totales registrados. +4. Revisa Acciones para detectar caídas, aumentos o valores monetarios faltantes inesperados. +5. Consulta el calendario de campañas para revisar próximos envíos y resultados recientes. +6. Abre el reporte que responda la pregunta específica en lugar de comparar métricas principales que miden cosas diferentes. + +Por ejemplo, un aumento de conversaciones con ingresos atribuidos estables no explica la causa. Abre **Rendimiento** para revisar conversión y derivación, **Calidad de servicio** para analizar resolución e **Ingresos** para revisar las fuentes de atribución. + +## Soluciona datos faltantes o inesperados + +Si el Dashboard parece incompleto: + +- Confirma la zona horaria del negocio y usuario antes de comparar días. +- Verifica que la tienda o sistema externo continúe conectado. +- Comprueba que perfiles, pedidos, conversaciones y eventos recientes aparezcan en Hellotext. +- Confirma que los identificadores de clientes y pedidos permitan vincular la actividad con el perfil correcto. +- Revisa si una fuente externa tuvo precedencia sobre la atribución de Hellotext. +- Asegúrate de comparar los 14 días fijos del Dashboard con el mismo período dentro del reporte detallado. + +Los resultados recientes pueden cambiar mientras la atribución siga abierta o lleguen datos atrasados. Si falta el evento de origen, comienza con [Soluciona señales o actividad faltante]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}). + +## Guías relacionadas + +- [Resumen de analítica, reportes y atribución]({% link _analytics-reporting-attribution/analytics-overview.md %}) +- [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Cómo interpretar los tiempos de respuesta]({% link _team/understanding-response-times.md %}) +- [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md new file mode 100644 index 0000000..b65c566 --- /dev/null +++ b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -0,0 +1,228 @@ +Usa esta guía cuando una tarjeta del Dashboard, métrica, desglose o venta atribuida falta o no coincide con otra vista de Hellotext o sistema externo. + +Una diferencia no siempre es una falla de tracking. Dos vistas pueden usar períodos, poblaciones, fechas, monedas, denominadores o reglas de atribución diferentes. Define qué mide cada número antes de cambiar la integración. + +## Define la diferencia exacta + +Registra ambos lados de la comparación: + +- Negocio y reporte de Hellotext. +- Métrica y desglose seleccionados. +- Fechas de inicio y finalización. +- Zona horaria del negocio y usuario. +- Moneda de reporte. +- Filtro de canal, campaña, playbook, ruta, equipo o segmento. +- Valor mostrado en Hellotext y valor esperado de la otra fuente. +- Un cliente, pedido, conversación o evento que demuestre la diferencia. + +Evita reportar solamente que “los ingresos están mal” o “faltan datos”. Un registro concreto permite determinar si la diferencia comenzó en la recolección, identidad, elegibilidad del reporte o atribución. + +## 1. Iguala el período y la definición + +Confirma que ambas vistas midan lo mismo. + +### Iguala el período + +El resumen del Dashboard y la tabla de Acciones siempre usan los últimos 14 días. Los reportes detallados tienen su propio selector y pueden usar 7, 14, 30 días o un período personalizado. + +Usar las mismas fechas es necesario, pero no suficiente. También debes confirmar en qué evento se basa el período seleccionado. + +### Entiende cómo cuenta los resultados cada reporte + +Los reportes de Hellotext pueden asignar un resultado a uno de estos tres tipos de fecha: + +- **La fecha en que comenzó la actividad de origen:** el período selecciona mensajes, activaciones de playbooks, conversaciones o solicitudes. Los resultados elegibles que ocurren después permanecen asignados a la fecha de origen. +- **La fecha en que ocurrió el resultado:** el período selecciona compras, reseñas, resoluciones u otros eventos completados dentro de ese rango. +- **El estado actual:** la sección muestra qué es cierto en el momento indicado, como la carga actual, los seguimientos pendientes o la pertenencia a una audiencia. + +El reporte o la sección debe explicar qué fecha utiliza. Estas son las reglas más comunes: + +| Reporte o sección | Fecha usada por el período seleccionado | +| --- | --- | +| Dashboard | Los ingresos usan la fecha de compra, la actividad usa la fecha de cada evento y las tarjetas de estado actual reflejan el momento indicado. | +| Reporte de ingresos | Fecha de compra. Las filas de campañas y playbooks identifican la fuente acreditada para compras completadas durante el período seleccionado. | +| Rendimiento de campañas | Fecha de entrega del mensaje. Los clicks y compras elegibles registrados después permanecen asignados a la entrega original. | +| Reporte de un playbook | Fecha de activación del playbook. Los mensajes posteriores y las compras atribuidas permanecen asignados a la activación original. | +| Performance, Conversaciones y Calidad de servicio | Fecha de inicio de la conversación. La conversión, derivación, resolución y satisfacción posteriores siguen a la conversación de origen. | +| Rendimiento de canales | Fecha de envío del mensaje. La entrega, interacción y ventas atribuidas posteriores siguen a esos mensajes. | +| Insights de demanda | Fecha en que comenzó la solicitud no resuelta. La recuperación posterior sigue a la solicitud original. | +| Reseñas y feedback | El feedback recibido usa la fecha de envío de la respuesta; el rendimiento de recopilación usa la fecha de entrega de la solicitud; los seguimientos pendientes muestran el estado actual. | +| Carga y capacidad | El trabajo atendido y resuelto usa la fecha de cada acción; la cola, el backlog y el riesgo muestran el estado actual. | + +Por ejemplo, si un playbook se activa el 7 de abril y el cliente compra el 10 de abril, el reporte del playbook cuenta el resultado el 7 de abril. El Reporte de ingresos cuenta esa misma compra el 10 de abril. Ambos son correctos porque responden preguntas diferentes. + +La regla que asigna la fecha no extiende ni reemplaza la ventana de atribución. Una compra posterior se agrega a la fecha de origen solo cuando cumple las reglas de atribución de Hellotext. + +### Iguala la definición de la métrica + +Algunos números que suelen confundirse son: + +- **Ingresos totales:** ingresos de comercio disponibles para Hellotext durante el período, incluidos ingresos atribuidos y no atribuidos. +- **Ingresos atribuidos:** ingresos elegibles acreditados a Hellotext según su metodología de atribución. +- **Tasa de conversión:** numerador específico de un reporte dividido entre su población elegible correspondiente. +- **CTR:** clicks registrados divididos entre mensajes entregados cuando se aplica esa definición. +- **Conversaciones:** conversaciones iniciadas, no mensajes, clientes únicos ni la cola actual del Inbox. +- **Monto de una acción:** valor monetario incluido en ocurrencias de una acción, no ingresos atribuidos automáticamente. + +No compares dos porcentajes hasta confirmar que usen el mismo numerador y denominador. + +## 2. Sigue un registro de principio a fin + +Elige un cliente, compra, conversación o evento faltante y síguelo a través del camino de medición. + +### Confirma el perfil del cliente + +En **Audiencia**, verifica que: + +- el perfil exista en el negocio correcto; +- su teléfono, email, ID externo o identidad conectada sea correcta; +- perfiles duplicados no hayan dividido la actividad; +- la propiedad, estado de suscripción, lista o segmento esperado esté presente; y +- la actividad aparezca en el perfil esperado y no en otro cliente. + +Cuando el click queda en un perfil y la compra en otro, el reporte puede no conectar el recorrido aunque ambos eventos existan. + +### Confirma el evento de origen + +Busca el evento que necesita la métrica: + +- mensaje enviado o entregado; +- click en un link con tracking; +- inicio, asignación, derivación o resolución de conversación; +- vista de producto, carrito o checkout; +- compra o conversión personalizada; +- cancelación, reembolso o pedido de reemplazo; o +- acción personalizada y valor monetario esperado en la tabla de Acciones. + +Si el evento no aparece en la actividad del cliente, el problema ocurre antes del reporte. Revisa la tienda conectada, canal, captura, implementación de Hellotext.js, solicitud de API o integración personalizada. + +### Confirma el contexto del evento + +Un evento puede existir y aun así no incluir el contexto requerido por el reporte. Revisa el identificador del cliente, referencia de pedido o producto, canal, origen de campaña o playbook, moneda, monto, estado y fecha. + +Para tracking personalizado, usa el nombre exacto de acción esperado por Hellotext. Pequeñas variaciones pueden crear acciones separadas y dividir los resultados. + +## 3. Revisa la elegibilidad del reporte + +Después de confirmar el evento, revisa si pertenece a la métrica que estás analizando. + +### Dashboard + +- El evento debe estar dentro del período fijo de 14 días. +- Los ingresos atribuidos necesitan un registro de atribución positivo y activo. +- El benchmark de ingresos también necesita ingresos totales de comercio para el período. +- Conversaciones cuenta inicios de conversaciones, no el estado actual de la cola. +- La tabla de Acciones muestra acciones con eventos registrados en el período. + +### Reportes de campañas + +- La entrega elegible del mensaje debe estar dentro del período seleccionado para la campaña. +- Las métricas de entrega necesitan un resultado de entrega registrado. +- El CTR necesita un click registrado y el denominador de mensajes entregados. +- La conversión y los ingresos necesitan una compra atribuida elegible, que puede ocurrir después y permanecer asignada a la fecha de entrega original. + +### Reportes de playbooks y rendimiento + +- El playbook, ruta o agente debe estar activo y recibir tráfico elegible. +- Debe registrarse el evento requerido de disparador, interacción, conversión, derivación o resolución. +- El reporte de un playbook selecciona las fechas de activación originales; un reporte de Performance selecciona las fechas de inicio de las conversaciones. Los resultados elegibles posteriores permanecen vinculados con esa actividad original. +- Un desglose por canal, playbook, IA frente a personas o equipo necesita esa dimensión en la actividad de origen. + +### Reportes de operaciones + +- La calidad de servicio depende del ciclo y datos de resolución de las conversaciones. +- Las métricas de SLA necesitan los registros correspondientes de respuesta y tiempos. +- Carga y capacidad dependen de asignaciones, transferencias, atención, resolución, equipos y personas. +- La presión operativa es una instantánea actual y no está restringida por el período histórico seleccionado en otras partes del reporte. + +### Insights de demanda + +Los insights de demanda necesitan señales compatibles de solicitudes no resueltas y suficiente contexto de producto, intención, comercio y valor para calcular la métrica elegida. Una pregunta del cliente en Inbox no se convierte automáticamente en una señal de demanda no resuelta. + +## 4. Revisa la atribución por separado + +Un pedido puede aparecer en ingresos totales sin atribuirse a Hellotext. + +Para una venta atribuida faltante, verifica que: + +- Hellotext haya recibido la compra o evento monetario positivo. +- La compra esté conectada con el cliente y pedido esperados. +- Exista una campaña, ruta, playbook, click, entrega, recomendación o interacción comercial elegible. +- La evidencia esté dentro de su ventana de atribución. +- Una fuente externa reconocida no haya tenido precedencia. +- La propiedad humana del checkout o actividad comercial no haya cambiado la decisión aplicable. +- Una cancelación, reembolso, reemplazo o fuente posterior más fuerte no haya revocado o ajustado la atribución. + +Hellotext selecciona la atribución según la evidencia disponible y no acredita el monto completo de forma independiente a cada campaña y playbook que interactuó con el cliente. + +Consulta [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) antes de tratar un pedido no atribuido como un evento faltante. + +## Comparaciones que no coinciden directamente + +| Comparación | Por qué puede ser diferente | +| --- | --- | +| Dashboard vs reporte detallado | El Dashboard usa 14 días fijos; el reporte tiene su propio período y métrica. | +| Reporte de un playbook vs Reporte de ingresos | El reporte del playbook asigna los resultados posteriores a la fecha de activación original; Ingresos incluye la compra en su fecha de compra. | +| Reporte de campaña vs Reporte de ingresos | El rendimiento de la campaña asigna una compra elegible a la fecha de entrega original; Ingresos la incluye en su fecha de compra. | +| Ingresos totales de Hellotext vs ingresos de la tienda | Hellotext solo puede reportar los pedidos y actualizaciones compatibles que recibió; también pueden diferir la fecha, moneda, estado, duplicados, reembolsos, impuestos, envío o definiciones netas/brutas. | +| Ingresos totales vs ingresos atribuidos | Los ingresos totales incluyen ingresos de comercio no atribuidos; la atribución necesita evidencia elegible de Hellotext. | +| Monto de Acciones vs Reporte de ingresos | Una acción puede incluir dinero sin representar ingresos canónicos de pedidos ni recibir atribución. | +| CTR de campaña vs tasa de conversión | El CTR mide interacción registrada; la conversión mide compras atribuidas elegibles frente a su población de entrega. | +| Ingresos de campaña vs ingresos de playbooks | La precedencia selecciona la fuente elegible acreditada en lugar de duplicar la venta entre todos los puntos de contacto. | +| Conversaciones vs carga del Inbox | El Dashboard cuenta inicios; el reporte de operaciones mide asignaciones, carga activa, atención, transferencias y resoluciones. | +| Reporte actual vs exportación anterior | Eventos atrasados, atribución abierta, cancelaciones, reembolsos o correcciones de origen pueden actualizar el reporte después de generar la exportación. | + +## Concilia ingresos con un sistema externo + +Compara pedidos individuales antes de comparar totales. + +1. Exporta o identifica el mismo período en ambos sistemas. +2. Usa referencias de pedidos e identificadores de clientes para hacer coincidir registros. +3. Confirma qué fecha del pedido determina su inclusión. +4. Compara la moneda y comportamiento de conversión. +5. Revisa si los totales incluyen impuestos, envío, descuentos, cancelaciones, reembolsos, pedidos de prueba o pedidos duplicados y de reemplazo. +6. Separa los ingresos totales faltantes de la atribución faltante. +7. Usa la exportación del Reporte de ingresos cuando necesites el motivo de atribución de Hellotext y contexto de respaldo para las filas acreditadas. + +Documenta la definición acordada de comparación para que la próxima conciliación use las mismas reglas. + +## Entiende los resultados recientes y cambiantes + +Los resultados recientes pueden cambiar porque: + +- las ventanas de atribución continúan abiertas; +- un pedido o conversión llega después de la interacción original; +- un canal o integración de comercio termina de procesar datos atrasados; +- un pedido se cancela, reembolsa o reemplaza; +- llega evidencia de origen más fuerte; o +- una corrección de identidad conecta actividad que estaba separada. + +En los reportes basados en la actividad de origen, una fecha reciente puede seguir creciendo mientras su ventana de resultados o atribución continúe abierta. Usa un período anterior cuyas ventanas ya hayan cerrado para comparaciones finales. Para campañas actuales o playbooks siempre activos, considera provisionales los primeros resultados. + +## Cuándo contactar a Soporte + +Si el evento de origen existe con el contexto requerido pero el reporte esperado todavía no lo incluye, envía a Soporte: + +- ID del negocio y URL del reporte; +- métrica, desglose y período exacto; +- zona horaria del negocio y usuario; +- ID del perfil, pedido, conversación, campaña o playbook; +- nombre y fecha del evento; +- integración de origen o camino de API; +- valor esperado y valor real; y +- capturas o exportaciones que muestren ambos lados de la comparación. + +Usa uno o dos registros representativos en lugar de un total amplio sin ejemplos. No incluyas contraseñas, secretos de API ni datos innecesarios del cliente. + +Si falta el evento, primero sigue [Soluciona señales o actividad faltante]({% link _troubleshooting-deliverability/troubleshoot-missing-signals-or-activity.md %}). + +## Guías relacionadas + +- [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Resumen de analítica, reportes y atribución]({% link _analytics-reporting-attribution/analytics-overview.md %}) +- [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Links con tracking]({% link _analytics-reporting-attribution/tracked-links.md %}) +- [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}) +- [Seguimiento de eventos]({% link _developers/tracking-events.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/playbook-reporting.md b/_i18n/es/analytics-reporting-attribution/playbook-reporting.md index 4ccf775..1698f33 100644 --- a/_i18n/es/analytics-reporting-attribution/playbook-reporting.md +++ b/_i18n/es/analytics-reporting-attribution/playbook-reporting.md @@ -18,6 +18,19 @@ Cuando revises playbooks de feedback juntos, mantén separados sus resultados. G Antes de comparar resultados, elige el rango de fechas correcto y confirma que el playbook tuvo suficiente tráfico para aprender algo. +## Entiende cómo se asignan las fechas + +La misma compra puede aparecer en fechas diferentes entre reportes porque cada uno responde una pregunta distinta. + +- El **reporte específico de un playbook** usa la fecha en que se activó el playbook. Todas las métricas, gráficos y tablas siguen las ejecuciones activadas durante el período seleccionado. La actividad posterior de los mensajes y las compras atribuidas se agregan a la fecha de activación original. +- El **resumen de Playbooks** usa la fecha de entrega del mensaje para medir resultados. Las compras elegibles posteriores permanecen asignadas a esas entregas. +- El **Reporte de ingresos** usa la fecha de compra. Muestra las compras completadas durante el período seleccionado e identifica el playbook, campaña u otra fuente que recibió el crédito. +- El reporte de **Performance** usa la fecha de inicio de la conversación para sus resultados. La conversión, derivación y resolución posteriores permanecen asignadas a la conversación de origen. + +Por ejemplo: **Playbook activado el 7 de abril → Compra el 10 de abril → Cuenta el 7 de abril en el reporte del playbook y el 10 de abril en Ingresos.** + +Las fechas de activación o entrega recientes pueden seguir creciendo mientras sus ventanas de resultados y atribución continúen abiertas. Esto no cambia a qué actividad de origen pertenece el resultado. Consulta [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) para conocer las reglas de elegibilidad y tiempo. + ## Revisa ingresos de playbooks En el reporte de Ingresos, mira: @@ -72,7 +85,7 @@ Compara playbooks solo cuando el contexto sea suficientemente parecido. Antes de decidir, revisa: -- El mismo rango de fechas. +- El mismo rango de fechas y la regla usada por cada reporte para asignar los resultados a una fecha. - Tamaño de audiencia y tráfico similares. - Mezcla de canales comparable. - Si el playbook estuvo activo durante todo el período. From 2cdc16472838e8b7bb11b72d044f164e89a48aaf Mon Sep 17 00:00:00 2001 From: Martin Caetano Date: Sun, 2 Aug 2026 01:45:37 -0300 Subject: [PATCH 2/5] Add analytics report guides and standardize eCommerce terminology --- .../revenue-report-guide.md | 19 +++ .../service-quality-report-guide.md | 19 +++ .../workload-capacity-report-guide.md | 19 +++ _config.yml | 3 + .../analytics-overview.md | 27 ++++ .../dashboard-guide.md | 1 + .../data-completeness-and-reporting-gaps.md | 3 + .../revenue-report-guide.md | 102 +++++++++++++ .../sales-attribution.md | 1 + .../service-quality-report-guide.md | 128 ++++++++++++++++ .../workload-capacity-report-guide.md | 141 ++++++++++++++++++ _i18n/en/audience/personalization-tags.md | 2 +- _i18n/en/captures/forms.md | 4 +- _i18n/en/developers/tracking-events.md | 2 +- _i18n/en/journeys/ai-cart-saver-playbook.md | 2 +- .../journeys/anniversary-surprise-playbook.md | 6 +- _i18n/en/journeys/birthday-bash-playbook.md | 6 +- _i18n/en/journeys/browse-recovery-playbook.md | 2 +- .../en/journeys/complete-the-look-playbook.md | 6 +- .../en/journeys/cross-sell-driver-playbook.md | 4 +- _i18n/en/journeys/dormant-revival-playbook.md | 6 +- .../first-purchase-driver-playbook.md | 2 +- .../how-to-customize-a-playbook-safely.md | 6 +- _i18n/en/journeys/how-to-enable-a-playbook.md | 2 +- .../journeys/replenishment-driver-playbook.md | 2 +- _i18n/en/journeys/review-builder-playbook.md | 4 +- .../en/journeys/soft-reactivation-playbook.md | 6 +- _i18n/en/journeys/sunset-saver-playbook.md | 6 +- _i18n/en/team/teams-and-inbox-capacity.md | 1 + _i18n/en/team/understanding-response-times.md | 2 + .../analytics-overview.md | 27 ++++ .../dashboard-guide.md | 3 +- .../data-completeness-and-reporting-gaps.md | 3 + .../revenue-report-guide.md | 102 +++++++++++++ .../sales-attribution.md | 1 + .../service-quality-report-guide.md | 128 ++++++++++++++++ .../workload-capacity-report-guide.md | 141 ++++++++++++++++++ _i18n/es/captures/forms.md | 4 +- _i18n/es/journeys/ai-cart-saver-playbook.md | 2 +- .../journeys/anniversary-surprise-playbook.md | 6 +- _i18n/es/journeys/birthday-bash-playbook.md | 6 +- _i18n/es/journeys/browse-recovery-playbook.md | 2 +- .../es/journeys/complete-the-look-playbook.md | 8 +- .../es/journeys/cross-sell-driver-playbook.md | 4 +- _i18n/es/journeys/dormant-revival-playbook.md | 6 +- .../first-purchase-driver-playbook.md | 2 +- .../how-to-customize-a-playbook-safely.md | 6 +- _i18n/es/journeys/how-to-enable-a-playbook.md | 2 +- .../journeys/replenishment-driver-playbook.md | 2 +- _i18n/es/journeys/review-builder-playbook.md | 4 +- .../es/journeys/soft-reactivation-playbook.md | 6 +- _i18n/es/journeys/sunset-saver-playbook.md | 6 +- _i18n/es/team/teams-and-inbox-capacity.md | 1 + _i18n/es/team/understanding-response-times.md | 2 + 54 files changed, 940 insertions(+), 68 deletions(-) create mode 100644 _analytics-reporting-attribution/revenue-report-guide.md create mode 100644 _analytics-reporting-attribution/service-quality-report-guide.md create mode 100644 _analytics-reporting-attribution/workload-capacity-report-guide.md create mode 100644 _i18n/en/analytics-reporting-attribution/revenue-report-guide.md create mode 100644 _i18n/en/analytics-reporting-attribution/service-quality-report-guide.md create mode 100644 _i18n/en/analytics-reporting-attribution/workload-capacity-report-guide.md create mode 100644 _i18n/es/analytics-reporting-attribution/revenue-report-guide.md create mode 100644 _i18n/es/analytics-reporting-attribution/service-quality-report-guide.md create mode 100644 _i18n/es/analytics-reporting-attribution/workload-capacity-report-guide.md diff --git a/_analytics-reporting-attribution/revenue-report-guide.md b/_analytics-reporting-attribution/revenue-report-guide.md new file mode 100644 index 0000000..6d7923b --- /dev/null +++ b/_analytics-reporting-attribution/revenue-report-guide.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Revenue report guide + description: Understand total and attributed revenue, the report's purchase-date basis, source breakdowns, and export. +es: + title: Guía del Reporte de ingresos + description: Entiende los ingresos totales y atribuidos, la fecha de compra usada por el reporte, sus desgloses y la exportación. + +permalink: revenue-report-guide +permalink_es: guia-reporte-ingresos + +layout: guide +topic: analytics-reporting-attribution +popular: false +--- + +{% translate_file analytics-reporting-attribution/revenue-report-guide.md %} diff --git a/_analytics-reporting-attribution/service-quality-report-guide.md b/_analytics-reporting-attribution/service-quality-report-guide.md new file mode 100644 index 0000000..997a4e3 --- /dev/null +++ b/_analytics-reporting-attribution/service-quality-report-guide.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Service quality report guide + description: Understand AI and team resolution, SLA compliance, unresolved conversations, response times, and agent performance. +es: + title: Guía del Reporte de calidad de servicio + description: Entiende resolución por IA y equipo, cumplimiento de SLA, conversaciones no resueltas, tiempos de respuesta y rendimiento de agentes. + +permalink: service-quality-report-guide +permalink_es: guia-reporte-calidad-servicio + +layout: guide +topic: analytics-reporting-attribution +popular: false +--- + +{% translate_file analytics-reporting-attribution/service-quality-report-guide.md %} diff --git a/_analytics-reporting-attribution/workload-capacity-report-guide.md b/_analytics-reporting-attribution/workload-capacity-report-guide.md new file mode 100644 index 0000000..39d1f77 --- /dev/null +++ b/_analytics-reporting-attribution/workload-capacity-report-guide.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Workload & capacity report guide + description: Understand active load, handled and resolved work, capacity pressure, session efficiency, and the live operational queue. +es: + title: Guía del Reporte de carga y capacidad + description: Entiende carga activa, conversaciones manejadas y resueltas, presión de capacidad, eficiencia de sesión y la cola operativa en vivo. + +permalink: workload-capacity-report-guide +permalink_es: guia-reporte-carga-capacidad + +layout: guide +topic: analytics-reporting-attribution +popular: false +--- + +{% translate_file analytics-reporting-attribution/workload-capacity-report-guide.md %} diff --git a/_config.yml b/_config.yml index d47e7d3..f536f3e 100644 --- a/_config.yml +++ b/_config.yml @@ -87,6 +87,9 @@ collections: order: - analytics-overview.md - dashboard-guide.md + - revenue-report-guide.md + - service-quality-report-guide.md + - workload-capacity-report-guide.md - data-completeness-and-reporting-gaps.md - playbook-reporting.md - campaign-reporting.md diff --git a/_i18n/en/analytics-reporting-attribution/analytics-overview.md b/_i18n/en/analytics-reporting-attribution/analytics-overview.md index a9ae1b5..bed4bea 100644 --- a/_i18n/en/analytics-reporting-attribution/analytics-overview.md +++ b/_i18n/en/analytics-reporting-attribution/analytics-overview.md @@ -6,6 +6,14 @@ This section connects three related questions: - Which customer actions happened after the message? - Which revenue was attributed to Hellotext? +## Revenue report + +The Revenue report shows purchases completed during the selected period, including total revenue and the portion attributed to eligible Hellotext activity. + +Use it when you need to compare revenue attributed to AI or classified as team-managed, inspect credited Campaigns and Playbooks, or reconcile individual attributed purchases. + +Keep reading: [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}). + ## Campaign reports Campaign reports help you review delivery, engagement, clicks, conversions, replies, and attributed revenue for a one-time send. @@ -22,6 +30,22 @@ Use playbook reporting when you need to compare attributed revenue, conversion b Keep reading: [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}). +## Service quality report + +The Service quality report compares AI and team resolution, SLA compliance, unresolved conversations, response-time distribution, and agent performance. + +Use it when you need to understand how conversations are being resolved and whether a service problem is concentrated in a channel, team, teammate, AI agent, or resolution path. + +Keep reading: [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}). + +## Workload & capacity report + +The Workload & capacity report compares active load, handled and resolved work, concurrency, assignments, transfers, capacity pressure, session efficiency, and the current operational queue. + +Use it when you need to understand how Inbox work is distributed during a period and what needs attention right now. + +Keep reading: [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}). + ## Attribution Attribution explains when Hellotext receives credit for a sale and when it does not. @@ -57,6 +81,9 @@ If you are reviewing your first launch, start with [Measure success in your firs ## Related guides - [Measure success in your first 7 days]({% link _getting-started/measure-success-first-7-days.md %}) +- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Create a campaign]({% link _campaigns/creating-a-campaign.md %}) - [Pricing, billing, and plans overview]({% link _billing/billing-overview.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/dashboard-guide.md b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md index 4bc3bd8..87bd793 100644 --- a/_i18n/en/analytics-reporting-attribution/dashboard-guide.md +++ b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md @@ -146,5 +146,6 @@ Recent report results can change while attribution remains open or late data arr - [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Understand response times]({% link _team/understanding-response-times.md %}) - [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index ad0a753..d906269 100644 --- a/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -220,6 +220,9 @@ If the event itself is missing, follow [Troubleshoot missing signals or activity - [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) - [Analytics overview]({% link _analytics-reporting-attribution/analytics-overview.md %}) +- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/revenue-report-guide.md b/_i18n/en/analytics-reporting-attribution/revenue-report-guide.md new file mode 100644 index 0000000..d609573 --- /dev/null +++ b/_i18n/en/analytics-reporting-attribution/revenue-report-guide.md @@ -0,0 +1,102 @@ +Use the Revenue report to understand how much commerce revenue Hellotext received, which purchases were attributed, and whether AI, the team, a Campaign, or a Playbook received credit. + +Open it from the **Revenue report** card on the Dashboard. Choose a period that matches the business question you want to answer before comparing totals or sources. + +## How this report counts results + +The selected period is based on **purchase date**. The summary metrics, timeline, revenue breakdowns, and source tables include purchases completed during that period. + +Campaign and Playbook performance reports use a different date because they measure the activity that originated the result. For example: + +**Campaign message delivered June 30 → Purchase completed July 5 → Counted on July 5 in Revenue and June 30 in Campaign performance.** + +Both reports can be correct. Revenue answers what was purchased during the period; the source report answers what later results came from the messages, triggers, or conversations that began during its period. + +A late order correction, cancellation, refund, replacement, or attribution update can change the value assigned to the original purchase date. + +## Read the summary metrics + +The report's main metrics separate three kinds of revenue: + +- **Revenue attributed to AI:** revenue the attribution engine assigned to AI based on eligible commercial evidence. +- **Revenue classified as team-managed:** revenue classified as team-managed by the attribution engine, together with eligible legacy teammate-managed revenue that does not have an engine verdict. +- **Total revenue:** all supported revenue Hellotext received from eCommerce, marketplace, and retail activity during the selected period, including attributed and unattributed revenue. + +Attributed revenue is a subset of total revenue. A support reply or any other team interaction does not automatically make a sale team-managed; Hellotext evaluates the applicable source path and commercial evidence. + +Select a metric to update its timeline. Compare the chart only after confirming that the selected metric, period, currency, and breakdown are the same. + +## Attributed revenue is not every influenced sale + +Hellotext can interact with a customer without receiving attribution for the later purchase. + +A purchase receives attribution only when Hellotext has eligible customer, order, source, and timing evidence and no stronger recognized source takes precedence. A purchase outside the applicable window, connected to another profile, or carrying a recognized external source can remain in total revenue without appearing in attributed revenue. + +The page title may describe Hellotext's influence on sales, but **influenced revenue is not a separate catch-all metric** in this report. Use the attributed metrics for revenue that qualified under Hellotext's methodology. Attribution also does not prove that the entire amount was incremental growth. + +Read [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) for evidence, precedence, windows, team participation, and order adjustments. + +## Break down the timeline + +Use the breakdown control to understand where a selected metric came from. Available options depend on the metric and available data, and can include: + +- channel, Campaign, or Playbook; +- segment, store, or region; +- product category, product, or variant; +- subscription state, payment method, or commerce context; +- intent, AI versus team, attribution reason, team, teammate, or AI agent. + +Choose only the dimensions needed to answer the question. A small row can look unusually strong when the underlying purchase count is low, so review its volume before making a decision. + +## Read the attributed-revenue widgets + +The widgets below the timeline explain the composition of attributed revenue. + +- **Campaigns vs Playbooks** compares the attributed amount credited to one-time Campaigns and always-on Playbooks. +- **Commerce context** separates supported eCommerce, marketplace, and retail revenue. +- **Commerce channel** shows which connected sales channel recorded the attributed purchases. + +These widgets distribute attributed revenue; they do not replace total revenue or add the same purchase to every source that touched the customer. + +## Review source tables + +The Playbooks, Campaigns, and Channels sections group the attributed purchases included in the selected period by their credited source. + +Use attributed orders, average attributed order value, and attributed revenue to compare the value assigned to each source. A row with no revenue does not necessarily mean that its messages failed to send: it can mean that no purchase completed during the selected period qualified for that source. + +For source conversion, ROI, revenue per message, or later outcomes assigned back to an original message or trigger date, open the corresponding Campaign or Playbook performance report. + +## Export and inspect attributed purchases + +Use **Export** when you need order-level reconciliation or the evidence behind attributed rows. The export can include: + +- order, customer, and conversation references; +- credited Campaign, Playbook, and channel; +- attributed amount and purchase timestamp; +- attribution type and reason; +- AI and human commercial evidence, when applicable; +- conversation state, commercial driver, and a plain-language explanation; and +- a link to relevant event or conversation context. + +The export is prepared in the background. Hellotext downloads it when ready and can also email a completion notice. + +## When a number looks wrong + +Before contacting Support: + +1. Confirm that both systems use the purchase date, timezone, currency, and order-status rules you expect. +2. Compare individual order references before comparing totals. +3. Separate missing total revenue from missing attribution. +4. Confirm that the purchase and source activity belong to the same customer profile. +5. Check cancellations, refunds, replacement orders, and recognized external sources. +6. Generate an export to inspect the credited source and explanation. + +For a complete investigation, follow [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Related guides + +- [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/sales-attribution.md b/_i18n/en/analytics-reporting-attribution/sales-attribution.md index 62e72b8..7d68726 100644 --- a/_i18n/en/analytics-reporting-attribution/sales-attribution.md +++ b/_i18n/en/analytics-reporting-attribution/sales-attribution.md @@ -150,6 +150,7 @@ The revenue remains merchant revenue but is not attributed to Hellotext. ## Related guides +- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Tracked links]({% link _analytics-reporting-attribution/tracked-links.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/service-quality-report-guide.md b/_i18n/en/analytics-reporting-attribution/service-quality-report-guide.md new file mode 100644 index 0000000..d0f5a3a --- /dev/null +++ b/_i18n/en/analytics-reporting-attribution/service-quality-report-guide.md @@ -0,0 +1,128 @@ +Use the Service quality report to understand how conversations are resolved, whether response-time commitments are being met, and where AI agents, teammates, teams, or channels need attention. + +Open it from the **Service quality report** card under **Operations & Experience** on the Dashboard. + +## How this report counts results + +The selected period is based on when a conversation started. Resolution, escalation, SLA, and other eligible outcomes that happen later remain assigned to the originating conversation. + +For example: **Conversation started April 7 → Resolved April 10 → Counted on April 7.** + +Recent dates can change while conversations remain open or their service-analysis window has not closed. Compare older periods when you need stable results, and use Inbox or Workload & capacity when you need the current queue rather than the outcome of conversations that started during a period. + +## Read the main metrics + +Select a metric to update the timeline and available breakdowns. + +### AI Resolution Rate + +The percentage of conversations fully resolved by AI without escalation to a teammate. + +A higher rate means AI completed more eligible conversations on its own. It does not mean AI participated in every other resolution, and it should not be optimized without reviewing whether customers received correct and useful outcomes. + +### Resolved by team + +The number of conversations resolved or closed by teammates from the selected conversation population. + +A conversation can include AI activity before the team takes over. When a teammate completes the final resolution, it belongs to the team-resolved result. + +### SLA compliance + +The percentage of eligible response obligations that met the configured response-time threshold. + +Hellotext applies the response policy and Business hours that were in effect when each timer started. Internal notes, drafts, Campaigns, and system-only activity do not count as customer-facing responses. + +Read [Response times and response rules]({% link _team/understanding-response-times.md %}) to understand first-response and subsequent-response timers. + +### Unresolved rate + +The percentage of conversations that remain unresolved or pending within the selected population. + +This metric can decrease as recent conversations close. Use it to find a pattern by channel, team, teammate, AI versus human handling, or resolution path rather than treating every open conversation as a service failure. + +## Use the breakdowns + +Available breakdowns depend on the selected metric: + +- **AI Resolution Rate:** channel, AI agent, or resolution path. +- **Resolved by team:** team, teammate, channel, or resolution path. +- **SLA compliance:** team, teammate, channel, AI agent, or AI versus human handling. +- **Unresolved rate:** channel, team, teammate, AI versus human handling, or resolution path. + +Use one dimension at a time when investigating a change. A channel difference can come from customer intent or operating hours; a team difference can come from routing, capacity, or the types of conversations it receives. + +## Understand Resolution path + +**Resolution path** compares conversations whose final resolution was completed by AI with those completed by the team. + +This chart describes the final resolver, not every participant. A conversation that started with AI and was later resolved by a teammate appears as **Resolved by team**. An AI resolution must complete without escalation to appear as **Resolved by AI**. + +Use the timeline breakdown when you need more detail such as AI only, human from beginning, escalated to human, active AI, or active human. + +## Understand Response time distribution + +**Response time distribution** shows how answered response waits are distributed across these ranges: + +- under 1 minute; +- 1–3 minutes; +- 3–5 minutes; +- 5–10 minutes; and +- more than 10 minutes. + +Use the selector to compare all conversations, AI-handled conversations, human-handled conversations, or conversations escalated to the team. + +The percentage in each bar is the share of answered waits that fell into that range. It is **not the SLA compliance rate**. SLA compliance compares each eligible response with its configured deadline, which can vary by channel and Business hours. + +## Compare agent performance + +The **Agent performance** table can show all individual agents, teams, AI agents, or teammates. + +The **All** view compares individual teammates with AI agents. Teams are excluded from this view because they aggregate the same human work and would duplicate it. + +The table can include: + +- **Conversations:** conversation volume connected to that agent or team. +- **Resolved:** conversations completed by that row. +- **First response:** average time to the first eligible response. +- **Average handle:** active human handling time divided by handled conversations. AI rows show no value because there is no comparable active-work interval. +- **Resolution time:** time from the start of ownership to resolution, or to escalation when AI handed the conversation off. +- **FCR:** conversations resolved without escalation, reassignment, or reopening. +- **SLA:** eligible response obligations completed within their configured deadline. + +Compare similar roles before drawing conclusions. AI and teammates can receive different intents and have different timing primitives, so a missing value is not the same as zero performance. + +## Turn the report into an action + +| If you see... | Review... | +| --- | --- | +| AI Resolution Rate falling | AI agent, channel, resolution-path breakdown, missing knowledge, unsupported requests, and escalation rules. | +| Team resolutions rising | Whether more conversations are being routed to people intentionally or AI is escalating cases it should resolve. | +| SLA compliance falling | Response policies, Business hours, channel differences, team capacity, and unassigned conversations. | +| Unresolved rate rising | Recent open conversations, routing, ownership, capacity, and repeated issue types. | +| Many waits above 10 minutes | Whether the delay is concentrated in human-handled, escalated, channel, team, or teammate activity. | +| Low FCR for one row | Escalations, reassignments, reopened conversations, and whether ownership is reaching the correct destination. | + +Open representative conversations before changing a Playbook, routing rule, response policy, or team capacity. The report identifies a pattern; the conversation history explains what happened. + +## When data is missing or unexpected + +Confirm that: + +- conversations have a recorded start, owner, and lifecycle outcome; +- AI resolutions and escalations were recorded by the Playbook or route; +- teammates closed completed conversations instead of leaving them open; +- response rules and Business hours are configured for the channels you are comparing; +- team and teammate assignments identify who handled the conversation; and +- both comparisons use the same date range, timezone, metric, and breakdown. + +If the source records exist but the report remains inconsistent, follow [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Related guides + +- [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Conversation lifecycle in Inbox]({% link _team/conversation-lifecycle.md %}) +- [Response times and response rules]({% link _team/understanding-response-times.md %}) +- [Teams and Inbox capacity]({% link _team/teams-and-inbox-capacity.md %}) +- [AI handoff to Inbox]({% link _team/ai-handoff-to-inbox.md %}) +- [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/workload-capacity-report-guide.md b/_i18n/en/analytics-reporting-attribution/workload-capacity-report-guide.md new file mode 100644 index 0000000..88d90ee --- /dev/null +++ b/_i18n/en/analytics-reporting-attribution/workload-capacity-report-guide.md @@ -0,0 +1,141 @@ +Use the Workload & capacity report to understand how Inbox work is distributed, how much capacity is being consumed, and where the current queue needs attention. + +Open it from the **Workload & capacity report** card under **Operations & Experience** on the Dashboard. + +## How this report counts results + +This report combines historical work from the selected period with a live operational snapshot. The date selector does not control every section in the same way: + +- **Handled** uses when a teammate first handled the conversation by sending an eligible reply. +- **Resolved** uses when the conversation was resolved or closed. +- **Active load**, concurrency, capacity pressure, and session efficiency use work or session intervals that overlap the selected period. +- **Operational Pressure** shows the current queue at the time displayed by the section. It is not limited by the selected historical date range. + +For example: **Conversation started April 7 → First handled April 8 → Resolved April 10**. It contributes to Handled on April 8 and Resolved on April 10. If a conversation is still waiting now, it appears in Operational Pressure now, regardless of when it started. + +This report does not wait for an attribution window to mature. Historical values can still change if conversation ownership, lifecycle events, or session records are corrected. + +## Read the main metrics + +Select a metric to update the timeline and available breakdowns. + +### Active load + +The average number of open, active conversations assigned during the selected period. + +Active load describes work in progress, not every conversation visible in Inbox. Compare it with capacity pressure, response health, and the current queue before deciding that a team is overloaded. + +### Handled + +The number of conversations where a teammate or team sent at least one eligible reply during the selected period. + +A conversation can be handled in one period and resolved in another. Handled measures work taken on, not final completion. + +### Resolved + +The number of conversations resolved or closed by a teammate or team during the selected period. + +Compare Resolved with Handled over time. A short-term difference can be normal when conversations span multiple days; a persistent gap can indicate growing unfinished work. + +### Avg. concurrent + +The average number of conversations handled at the same time during the selected period. + +High concurrency can be appropriate for short or simple conversations. Review it together with response times, SLA risk, and conversation quality instead of treating one target as correct for every team. + +### Assigned + +The number of handled conversations where the selected teammate was the first human owner during the period. + +This metric is available by teammate because it describes individual ownership rather than a team aggregate. + +### Transferred to + +The number of handled conversations the selected teammate inherited from another teammate during the period. + +Transfers are not automatically a problem. Review repeated transfers when they suggest unclear routing, missing expertise, or ownership that starts in the wrong place. + +## Compare teammates and teams + +Most metrics can be broken down by teammate or team. **Assigned** and **Transferred to** use teammate-level ownership. + +Compare like with like. Different teams can receive different intents, channels, schedules, or conversation complexity. A higher volume does not by itself mean better performance, and a lower volume does not by itself mean unused capacity. + +## Understand Capacity pressure + +**Capacity pressure** compares consumed handling time with the available handling capacity represented in the selected period. You can view it by teammate or team. + +Each bar shows: + +- **Available capacity:** the handling capacity available for the period. +- **Consumed capacity:** active handling time used during that period. +- **Pressure:** consumed capacity as a percentage of available capacity. + +Capacity depends on the Inbox capacity settings for teams and teammates. A high percentage is a prompt to review the queue and response health, not proof that capacity should immediately be increased. + +Read [Teams and Inbox capacity]({% link _team/teams-and-inbox-capacity.md %}) before changing these settings. + +## Understand Session efficiency + +**Session efficiency** compares active handling time with total logged-in time for the selected period. It can be viewed by teammate or team. + +The chart separates: + +- **Total logged-in time:** the session time recorded during the period. +- **Active time:** time spent actively handling conversations. +- **Idle time:** logged-in time without active conversation handling. + +Use this view to understand how recorded Inbox time was distributed. It is not a complete productivity score: meetings, breaks, administrative work, and responsibilities outside the Inbox may not appear as active handling time. + +## Read Operational Pressure + +**Operational Pressure** is a live view of the current queue. Changing the historical date range does not move this section into the past. + +View it by teammate or team and use these columns: + +- **Unanswered:** current conversations still waiting for a reply. +- **Oldest waiting:** the longest current customer wait. +- **SLA risk:** whether active response obligations are Safe, At risk, or Imminent. +- **Utilization:** current active handling time compared with recorded available session time. +- **Concurrent:** current handling concurrency. +- **Burn:** an operational signal that combines utilization, concurrency, and SLA pressure. Its states are Normal, Watch, and At risk. + +Burn is a queue-pressure indicator, not a diagnosis or a performance rating for a person. Open the underlying conversations and consider schedules, routing, and capacity before taking action. + +## Turn the report into an action + +| If you see... | Review... | +| --- | --- | +| Active load rising | New assignments, unresolved work, team capacity, and whether conversations are being closed when complete. | +| Handled staying above Resolved | Whether work is spanning periods normally or unfinished conversations are accumulating. | +| High concurrency with slower responses | Concurrent-conversation limits, conversation complexity, response rules, and staffing. | +| Transfers concentrated on one teammate | Routing destinations, team membership, expertise, and initial ownership. | +| Low recorded session efficiency | Whether the teammate was available for Inbox work and whether non-Inbox responsibilities explain the difference. | +| Unanswered or oldest waiting increasing | The live unassigned and assigned queues, teammate availability, and response health. | +| SLA risk or Burn worsening | The conversations causing pressure, Business hours, response rules, routing, concurrency, and available capacity. | + +Use the historical metrics to identify a pattern and Operational Pressure to decide what needs attention now. + +## When data is missing or unexpected + +Confirm that: + +- teams and teammate Inbox capacity modes are configured correctly; +- active teammates have realistic concurrent-conversation and daily handling capacity; +- assignments and transfers identify the correct owner; +- teammates send replies and close completed conversations in Inbox; +- logged-in sessions and active handling intervals are recorded for the period; +- response rules and Business hours are configured when reviewing SLA risk; and +- both comparisons use the same date range, timezone, metric, and breakdown. + +If the source records exist but the report remains inconsistent, follow [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Related guides + +- [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Teams and Inbox capacity]({% link _team/teams-and-inbox-capacity.md %}) +- [Response times and response rules]({% link _team/understanding-response-times.md %}) +- [Conversation lifecycle in Inbox]({% link _team/conversation-lifecycle.md %}) +- [Assign conversations]({% link _team/assigning-conversations.md %}) +- [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/en/audience/personalization-tags.md b/_i18n/en/audience/personalization-tags.md index d5c9a12..4e9de79 100644 --- a/_i18n/en/audience/personalization-tags.md +++ b/_i18n/en/audience/personalization-tags.md @@ -61,7 +61,7 @@ when targeting the property by its kind `{checkbox}` we will automatically use t ### Object tags -Hellotext ships with the most common types of Objects that are suitable for most ecommerce sites. These include +Hellotext ships with the most common types of Objects that are suitable for most eCommerce sites. These include `app`, `product`, `cart`, `order`, `coupon`, `order` and `refund` objects. In addition, you can also create your custom objects, or modify the existing ones by adding extra properties that are specific to your business's needs. diff --git a/_i18n/en/captures/forms.md b/_i18n/en/captures/forms.md index c8c32b6..a143cf6 100644 --- a/_i18n/en/captures/forms.md +++ b/_i18n/en/captures/forms.md @@ -94,7 +94,7 @@ Copy the generated link when you want Hellotext to host the form. Open it in a n Use the generated HTML when the form should appear inside one of your pages. -1. Make sure the website is connected through a supported ecommerce integration or has [Hellotext.js](https://github.com/hellotext/hellotext.js) installed. +1. Make sure the website is connected through a supported eCommerce integration or has [Hellotext.js](https://github.com/hellotext/hellotext.js) installed. 2. Copy the generated form code exactly as Hellotext provides it. 3. Paste it in the page body where the form should appear. 4. Apply your website styles without removing or renaming the generated form attributes. @@ -129,7 +129,7 @@ After a successful completion, the same browser can remember that the form was c Check these items in order: 1. Confirm that the generated form code is present on the page. -2. Confirm that the connected ecommerce integration or Hellotext.js loads successfully. +2. Confirm that the connected eCommerce integration or Hellotext.js loads successfully. 3. Compare the embedded code with the current snippet shown in Hellotext. 4. Check whether website styles or scripts hide or replace the form. 5. Test the hosted link to separate a form configuration problem from an installation problem. diff --git a/_i18n/en/developers/tracking-events.md b/_i18n/en/developers/tracking-events.md index 4940ab7..6880e38 100644 --- a/_i18n/en/developers/tracking-events.md +++ b/_i18n/en/developers/tracking-events.md @@ -1,4 +1,4 @@ -Tracking events turns customer behavior into signals Hellotext can use across customer profiles, segments, attribution, playbooks, and the Inbox. Signals can come from your ecommerce site, physical store, custom backend, forms, conversations, or any other source that matters to your business. +Tracking events turns customer behavior into signals Hellotext can use across customer profiles, segments, attribution, playbooks, and the Inbox. Signals can come from your eCommerce site, physical store, custom backend, forms, conversations, or any other source that matters to your business. Those signals help Hellotext decide when to trigger a playbook, update a segment, enrich a customer profile, support an agent, or attribute revenue to the right action. diff --git a/_i18n/en/journeys/ai-cart-saver-playbook.md b/_i18n/en/journeys/ai-cart-saver-playbook.md index 88d76f1..2862c7f 100644 --- a/_i18n/en/journeys/ai-cart-saver-playbook.md +++ b/_i18n/en/journeys/ai-cart-saver-playbook.md @@ -60,7 +60,7 @@ Open **Playbooks**, click **Explore playbooks**, and choose **AI Cart Saver**. AI Cart Saver exposes: - **Channels:** where Hellotext can send or continue the cart recovery conversation. -- **Discount strategy:** whether the playbook follows existing ecommerce offer rules, can create AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the playbook follows existing eCommerce offer rules, can create AI-driven discounts up to a maximum percentage, or sends without discounts. - **Tone:** how the generated follow-up should sound. - **Escalation or assignment:** who should take over when the conversation needs a person. diff --git a/_i18n/en/journeys/anniversary-surprise-playbook.md b/_i18n/en/journeys/anniversary-surprise-playbook.md index 690a849..6d61d25 100644 --- a/_i18n/en/journeys/anniversary-surprise-playbook.md +++ b/_i18n/en/journeys/anniversary-surprise-playbook.md @@ -15,7 +15,7 @@ It can: - Use an anniversary source, such as first purchase, profile creation, subscription date, or a custom date, when available. - Detect when the customer reaches an anniversary based on that source. - Send a celebration message with a grateful or appreciative tone. -- Include an approved coupon or existing ecommerce offer when the message calls for one. +- Include an approved coupon or existing eCommerce offer when the message calls for one. - Personalize the message with customer profile data, purchase history, or relationship context when that data is available. - Skip profiles when the anniversary date is missing, consent is missing, the channel is not ready, or the profile cannot be reached. @@ -48,7 +48,7 @@ Check that: - The audience you want to reach is identifiable and eligible. - The channel, sender, or WhatsApp account is ready. - The message or template is approved if the channel requires it. -- If you include a coupon or ecommerce offer, it is approved and works before launch. +- If you include a coupon or eCommerce offer, it is approved and works before launch. - Purchase, profile, or custom-property data is synced if the anniversary depends on it. For setup validation, use [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}). If you import profiles or custom dates, see [Import customer profiles]({% link _audience/import-customer-profiles.md %}). For custom tracking, use [Tracking events]({% link _developers/tracking-events.md %}). @@ -65,7 +65,7 @@ Available options can vary, but review: - **Audience:** which profiles can receive the playbook. - **Outgoing channels:** where Hellotext can send the message. - **Message:** the anniversary copy and variables it will use. -- **Coupon or offer:** the approved coupon or existing ecommerce offer to include when relevant. +- **Coupon or offer:** the approved coupon or existing eCommerce offer to include when relevant. - **Inbox replies:** how your team should review replies if the customer responds. Do not assume every account uses the same anniversary source. If the control is not visible, confirm with your Hellotext team which date the playbook uses before launch. diff --git a/_i18n/en/journeys/birthday-bash-playbook.md b/_i18n/en/journeys/birthday-bash-playbook.md index 4c55920..0024d30 100644 --- a/_i18n/en/journeys/birthday-bash-playbook.md +++ b/_i18n/en/journeys/birthday-bash-playbook.md @@ -15,7 +15,7 @@ It can: - Detect customer profiles whose birthday matches the current day and month. - Create a birthday event to start the playbook when it is active. - Send a birthday message with a celebratory tone. -- Include an approved coupon or existing ecommerce offer when the message calls for one. +- Include an approved coupon or existing eCommerce offer when the message calls for one. - Personalize the message with customer profile data, such as name or birthday, when available. - Skip profiles when the birthday is missing, consent is missing, the channel is not ready, or the profile cannot be reached. @@ -49,7 +49,7 @@ Check that: - The audience you want to reach has channel consent. - The channel, sender, or WhatsApp account is ready. - The birthday message or template is approved if the channel requires it. -- If you include a coupon or ecommerce offer, it is approved and works before launch. +- If you include a coupon or eCommerce offer, it is approved and works before launch. - The audience excludes profiles that should not receive promotional messages. For setup validation, use [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}). If you import profiles, see [Import customer profiles]({% link _audience/import-customer-profiles.md %}). For custom tracking, use [Tracking events]({% link _developers/tracking-events.md %}). @@ -65,7 +65,7 @@ Available options can vary, but you usually review: - **Outgoing channels:** where Hellotext can send the greeting. - **Audience:** which profiles can receive the playbook. - **Message:** the birthday copy and variables it will use. -- **Coupon or offer:** the approved coupon or existing ecommerce offer to include when relevant. +- **Coupon or offer:** the approved coupon or existing eCommerce offer to include when relevant. - **Inbox replies:** how your team should review replies if the customer responds. You do not need to create a manual campaign for each date. The playbook depends on the profile's birthday signal and runs when the birthday matches the current day. diff --git a/_i18n/en/journeys/browse-recovery-playbook.md b/_i18n/en/journeys/browse-recovery-playbook.md index edf1483..4aa610a 100644 --- a/_i18n/en/journeys/browse-recovery-playbook.md +++ b/_i18n/en/journeys/browse-recovery-playbook.md @@ -63,7 +63,7 @@ Browse Recovery exposes: - **Channels:** where Hellotext can send or continue the browse recovery conversation. - **Tone or Playground feedback:** how the generated follow-ups should learn what fits your business. -- **Discount strategy:** whether the playbook follows existing ecommerce offer rules, can create AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the playbook follows existing eCommerce offer rules, can create AI-driven discounts up to a maximum percentage, or sends without discounts. - **Escalation or assignment:** who should take over when a reply needs a person. Keep automatic channel selection unless you have a clear reason to limit the playbook. Browse Recovery depends on whether the customer can actually be reached and whether the message format is allowed in the channel. diff --git a/_i18n/en/journeys/complete-the-look-playbook.md b/_i18n/en/journeys/complete-the-look-playbook.md index f6c0594..930c949 100644 --- a/_i18n/en/journeys/complete-the-look-playbook.md +++ b/_i18n/en/journeys/complete-the-look-playbook.md @@ -17,7 +17,7 @@ It can: - Use customer, product, catalog, price, stock, and channel context before a message is sent. - Generate message examples that adapt per customer. - Let your team give Playground feedback on examples so Hellotext learns what fits the business. -- Follow existing ecommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. +- Follow existing eCommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. - Avoid recommending products that are unavailable, irrelevant, already purchased, or outside the selected product scope. The exact configuration can vary by account, connected store, catalog quality, channel, templates, and rollout status. @@ -52,7 +52,7 @@ Check that: - Product and variant identifiers are stable across catalog, product-view, cart, recommendation, and purchase signals. - The audience you want to reach is subscribed, identifiable, and eligible for the selected channel. - Purchase, cart, and product-interest signals are available so Hellotext can avoid irrelevant suggestions. -- If discounts are allowed, ecommerce offer rules and any maximum AI discount percentage are approved before launch. +- If discounts are allowed, eCommerce offer rules and any maximum AI discount percentage are approved before launch. - Product cards, product links, or rich messages work in the channels you plan to use. For setup validation, use [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}). For custom tracking, use [Tracking events]({% link _developers/tracking-events.md %}). @@ -68,7 +68,7 @@ The available cards can vary, but the proposed setup focuses on: - **Outgoing channels:** where Hellotext can send matching-product suggestions. - **Audience:** which audience or segment can receive the playbook. - **Products:** which products, collections, categories, or groups the playbook can use. -- **Discount strategy:** whether the playbook follows existing ecommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the playbook follows existing eCommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. - **Tone or Playground feedback:** how generated examples should learn what fits your business. Keep automatic channel selection unless you have a clear reason to limit the playbook. Complete-the-Look depends on whether the shopper can be reached when the matching-product suggestion is still relevant. diff --git a/_i18n/en/journeys/cross-sell-driver-playbook.md b/_i18n/en/journeys/cross-sell-driver-playbook.md index bccce47..3ddbd74 100644 --- a/_i18n/en/journeys/cross-sell-driver-playbook.md +++ b/_i18n/en/journeys/cross-sell-driver-playbook.md @@ -47,7 +47,7 @@ Check that: - Product relationships can be inferred or provided through catalog data, collections, categories, purchase history, or recommendation logic. - The products you want to recommend have enough stock and usable links. - Your team knows which collections, categories, or products should be included or excluded in the playbook configuration. -- If discounts are allowed, ecommerce offer rules and any maximum AI discount percentage are approved before launch. +- If discounts are allowed, eCommerce offer rules and any maximum AI discount percentage are approved before launch. - The channel the playbook can use is connected and ready. - Customers have consent and are eligible for the channel. @@ -66,7 +66,7 @@ The playbook exposes product scope and recommendation rules: Depending on the account rollout, it may also show cards for: -- **Discount strategy:** whether the message follows existing ecommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the message follows existing eCommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. - **Channels:** where Hellotext can send or continue the conversation. - **Tone or Playground feedback:** how generated follow-ups should learn what fits your business. - **Escalation or assignment:** who should take over when a reply needs a person. diff --git a/_i18n/en/journeys/dormant-revival-playbook.md b/_i18n/en/journeys/dormant-revival-playbook.md index e009f0b..2a6238e 100644 --- a/_i18n/en/journeys/dormant-revival-playbook.md +++ b/_i18n/en/journeys/dormant-revival-playbook.md @@ -17,7 +17,7 @@ It can: - Suggest products, collections, or offers that are relevant to the customer's past behavior. - Generate personalized message examples that adapt per customer. - Let your team give Playground feedback on examples so Hellotext learns what fits the business. -- Follow existing ecommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. +- Follow existing eCommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. - Choose the most cost-efficient available channel, such as WhatsApp, SMS, or others, and send only when it internally detects an opportunity to keep ROI healthy. - Skip customers when the customer reactivated, bought recently, entered another active playbook, opted out, cannot be reached, or lacks enough product context. @@ -51,7 +51,7 @@ Check that: - The products or collections you want to use are appropriate for win-back messages. - The audience you want to reach is identifiable and eligible for the selected channel. - Purchase, browse, click, reply, unsubscribe, opt-out, and recent reactivation signals are available enough for Hellotext to avoid irrelevant sends. -- If discounts are allowed, ecommerce offer rules and any maximum AI discount percentage are approved before launch. +- If discounts are allowed, eCommerce offer rules and any maximum AI discount percentage are approved before launch. - Product cards, product links, or rich messages work in the channels you plan to use. For setup validation, use [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}). For custom tracking, use [Tracking events]({% link _developers/tracking-events.md %}). @@ -67,7 +67,7 @@ The available cards can vary, but the proposed setup focuses on: - **Outgoing channels:** where Hellotext can send or continue the reactivation message. - **Audience:** which audience or segment can receive the playbook. - **Products:** which products, collections, categories, or groups can be used in the message. -- **Discount strategy:** whether the playbook follows existing ecommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the playbook follows existing eCommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. - **Tone or Playground feedback:** how generated examples should learn what fits your business. Keep automatic channel selection unless you have a clear reason to limit the playbook. Dormant Revival depends on whether the customer can still be reached in a channel where the message makes sense. Hellotext can internally choose the most cost-efficient channel, such as WhatsApp, SMS, or others depending on availability, and avoid sends when it does not detect an opportunity to keep ROI healthy. diff --git a/_i18n/en/journeys/first-purchase-driver-playbook.md b/_i18n/en/journeys/first-purchase-driver-playbook.md index 27d9643..50f5169 100644 --- a/_i18n/en/journeys/first-purchase-driver-playbook.md +++ b/_i18n/en/journeys/first-purchase-driver-playbook.md @@ -63,7 +63,7 @@ Open **Playbooks**, click **Explore playbooks**, and choose **First-Purchase Dri The playbook handles first-purchase eligibility and follow-up timing automatically. Depending on your account rollout, review the cards it exposes for: -- **Discount strategy:** whether the playbook follows existing ecommerce offer rules, can create AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the playbook follows existing eCommerce offer rules, can create AI-driven discounts up to a maximum percentage, or sends without discounts. - **Channels:** where Hellotext can send or continue the conversation. - **Tone or Playground feedback:** how generated follow-ups should learn what fits your business. - **Escalation or assignment:** who should take over when a reply needs a person. diff --git a/_i18n/en/journeys/how-to-customize-a-playbook-safely.md b/_i18n/en/journeys/how-to-customize-a-playbook-safely.md index 6831b5d..2f04dbc 100644 --- a/_i18n/en/journeys/how-to-customize-a-playbook-safely.md +++ b/_i18n/en/journeys/how-to-customize-a-playbook-safely.md @@ -39,7 +39,7 @@ Consider disabling temporarily only when the change could affect live customers - You are changing the prompt of a playbook that allows prompt edits and the agent could reply incorrectly. - You are changing intents for a custom agent. - You are changing incoming or outgoing channels. -- You are changing discounts or ecommerce offer rules. +- You are changing discounts or eCommerce offer rules. - You are editing a route with steps, conditions, branches, or assignments. For active sales playbooks, the risk depends on which card you are changing. Many adjustments do not affect customers immediately, but a prompt, discount strategy, channel, or route logic change should be tested before you broaden it again. @@ -54,7 +54,7 @@ Use this table as a quick map: | **Intents** | Custom agents and custom playbooks | Which customer messages activate that agent. | | **Knowledge** | Sales or support AI agents | What information the agent uses to answer. | | **Incoming/outgoing channels** | Playbooks that allow channel selection | Where the playbook can reply or send. | -| **Discounts** | Sales playbooks that allow offers | Which ecommerce offer rules and AI discount limits the agent may use. | +| **Discounts** | Sales playbooks that allow offers | Which eCommerce offer rules and AI discount limits the agent may use. | | **Escalation** | AI agents, support, [Webchat]({% link _captures/webchat-widget-playbook.md %}), and some custom playbooks | Who takes over when the agent should not continue. | | **Route steps** | Journeys or routes | Sequence, waits, branches, assignments, and exit from the flow. | @@ -133,7 +133,7 @@ Discount rules affect customer expectations and revenue, so change them carefull Before changing discount settings: -- Confirm whether the playbook should follow ecommerce offer rules, create AI-driven discounts up to a maximum percentage, combine both, or send without discounts. +- Confirm whether the playbook should follow eCommerce offer rules, create AI-driven discounts up to a maximum percentage, combine both, or send without discounts. - Set clear maximums for any AI-driven discount. - Avoid stacking discounts beyond your business rules. - Test what happens when a customer asks for a better discount. diff --git a/_i18n/en/journeys/how-to-enable-a-playbook.md b/_i18n/en/journeys/how-to-enable-a-playbook.md index 9a16f03..c40ce19 100644 --- a/_i18n/en/journeys/how-to-enable-a-playbook.md +++ b/_i18n/en/journeys/how-to-enable-a-playbook.md @@ -36,7 +36,7 @@ You may see cards such as: - **Agent prompt**, for instructions that tell the AI agent what to do and how to respond. - **Intents**, for customer intentions that should activate a custom agent. - **Knowledge**, for FAQs, policies, product notes, or documents the agent can use. -- **Discounts**, for ecommerce offer rules and maximum AI discount limits. +- **Discounts**, for eCommerce offer rules and maximum AI discount limits. - **Tone**, for the voice used in AI-generated responses. - **Escalation**, for the teammate or team that should take over when the agent needs help. - **Web search**, for approved websites the agent can use when searching online. diff --git a/_i18n/en/journeys/replenishment-driver-playbook.md b/_i18n/en/journeys/replenishment-driver-playbook.md index c5bf1b7..c10b916 100644 --- a/_i18n/en/journeys/replenishment-driver-playbook.md +++ b/_i18n/en/journeys/replenishment-driver-playbook.md @@ -61,7 +61,7 @@ Open **Playbooks**, click **Explore playbooks**, and choose **Replenishment Driv The playbook exposes the settings that control how it communicates: -- **Discount strategy:** whether the reminder follows existing ecommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the reminder follows existing eCommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. - **Channels:** where Hellotext can send or continue the conversation. - **Tone or Playground feedback:** how generated follow-ups should learn what fits your business. diff --git a/_i18n/en/journeys/review-builder-playbook.md b/_i18n/en/journeys/review-builder-playbook.md index ed489ce..d5c3de6 100644 --- a/_i18n/en/journeys/review-builder-playbook.md +++ b/_i18n/en/journeys/review-builder-playbook.md @@ -128,8 +128,8 @@ The automatic playbook report lets you see: - Rating distribution. - Review text. - Review attachments such as image or video URLs when available. -- The customer profile and ecommerce customer identifier when available. -- The product name and ecommerce product identifier when available. +- The customer profile and eCommerce customer identifier when available. +- The product name and eCommerce product identifier when available. - The date and time of the review. - A link back to the conversation where the review was given. diff --git a/_i18n/en/journeys/soft-reactivation-playbook.md b/_i18n/en/journeys/soft-reactivation-playbook.md index 022137d..d6283e1 100644 --- a/_i18n/en/journeys/soft-reactivation-playbook.md +++ b/_i18n/en/journeys/soft-reactivation-playbook.md @@ -17,7 +17,7 @@ It can: - Suggest products that may bring the customer back based on recent or historical interest. - Generate personalized message examples that adapt per customer. - Let your team give Playground feedback on examples so Hellotext learns what fits the business. -- Follow existing ecommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. +- Follow existing eCommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. - Choose the most cost-efficient available channel, such as WhatsApp, SMS, or others, and send only when it internally detects an opportunity to keep ROI healthy. - Skip customers when a recent purchase, another active playbook, missing consent, channel limits, or poor product context makes the send a bad fit. @@ -50,7 +50,7 @@ Check that: - The products or collections you want to promote are eligible for reactivation messages. - The audience you want to reach is identifiable and eligible for the selected channel. - Purchase, browse, click, reply, and opt-out signals are available enough for Hellotext to avoid irrelevant sends. -- If discounts are allowed, ecommerce offer rules and any maximum AI discount percentage are approved before launch. +- If discounts are allowed, eCommerce offer rules and any maximum AI discount percentage are approved before launch. - Product cards, product links, or rich messages work in the channels you plan to use. For setup validation, use [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}). For custom tracking, use [Tracking events]({% link _developers/tracking-events.md %}). @@ -66,7 +66,7 @@ The available cards can vary, but the proposed setup focuses on: - **Outgoing channels:** where Hellotext can send or continue the reactivation message. - **Audience:** which audience or segment can receive the playbook. - **Products:** which products, collections, categories, or groups can be used in the message. -- **Discount strategy:** whether the playbook follows existing ecommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the playbook follows existing eCommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. - **Tone or Playground feedback:** how generated examples should learn what fits your business. Keep automatic channel selection unless you have a clear reason to limit the playbook. Soft Reactivation depends on whether the customer can be reached at a moment when the nudge still feels timely. Hellotext can internally choose the most cost-efficient channel, such as WhatsApp, SMS, or others depending on availability, and avoid sends when it does not detect an opportunity to keep ROI healthy. diff --git a/_i18n/en/journeys/sunset-saver-playbook.md b/_i18n/en/journeys/sunset-saver-playbook.md index b8f153d..7f63449 100644 --- a/_i18n/en/journeys/sunset-saver-playbook.md +++ b/_i18n/en/journeys/sunset-saver-playbook.md @@ -16,7 +16,7 @@ It can: - Use customer history, product context, catalog data, channel eligibility, and offer rules before a message is sent. - Generate one final personalized message with a clear reason to come back, such as a relevant product, collection, update, or approved offer. - Let your team give Playground feedback on examples so Hellotext learns which tone and style fit the business. -- Follow existing ecommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. +- Follow existing eCommerce offer rules, use AI-driven discounts up to an approved maximum percentage, or send without discounts. - Choose the most cost-efficient available channel, such as WhatsApp, SMS, or others, and send only when it internally detects an opportunity to keep ROI healthy. - Automatically suppress future recovery attempts for that profile if the customer does not buy, reply, or show another relevant signal. - Skip customers when there is no consent, the profile cannot be reached, another playbook is a better fit, or there is not enough relevant reason to reach out. @@ -51,7 +51,7 @@ Check that: - Hellotext can distinguish recently inactive customers, customers around 3 months inactive, and customers around 12 months inactive or not reactivated. - Product names, images, prices, stock, and links are current if the message can include recommendations. - The audience you want to reach is identifiable and eligible for the selected channel. -- If discounts are allowed, ecommerce offer rules and any maximum AI discount percentage are approved before launch. +- If discounts are allowed, eCommerce offer rules and any maximum AI discount percentage are approved before launch. - Product cards, product links, or rich messages work in the channels you plan to use. For setup validation, use [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}). For custom tracking, use [Tracking events]({% link _developers/tracking-events.md %}). @@ -67,7 +67,7 @@ The available cards can vary, but the proposed setup focuses on: - **Outgoing channels:** where Hellotext can send or continue the final message. - **Audience:** which audience or segment can receive the playbook. - **Products:** which products, collections, categories, or groups can be used in the message. -- **Discount strategy:** whether the playbook follows existing ecommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. +- **Discount strategy:** whether the playbook follows existing eCommerce offer rules, can use AI-driven discounts up to a maximum percentage, or sends without discounts. - **Tone or Playground feedback:** how generated examples should learn what fits your business. Keep automatic channel selection unless you have a clear reason to limit the playbook. Sunset Saver depends on finding a reachable and cost-efficient channel for a customer who has been inactive for a long time. Hellotext can internally choose the most cost-efficient channel, such as WhatsApp, SMS, or others depending on availability, and avoid sends when it does not detect an opportunity to keep ROI healthy. diff --git a/_i18n/en/team/teams-and-inbox-capacity.md b/_i18n/en/team/teams-and-inbox-capacity.md index 27421f3..80487e0 100644 --- a/_i18n/en/team/teams-and-inbox-capacity.md +++ b/_i18n/en/team/teams-and-inbox-capacity.md @@ -109,3 +109,4 @@ Deleting a team clears that destination from conversations that were waiting for - [Conversation lifecycle in Inbox]({% link _team/conversation-lifecycle.md %}) - [AI handoff to Inbox]({% link _team/ai-handoff-to-inbox.md %}) - [Response times and response rules]({% link _team/understanding-response-times.md %}) +- [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) diff --git a/_i18n/en/team/understanding-response-times.md b/_i18n/en/team/understanding-response-times.md index 5411441..8102a31 100644 --- a/_i18n/en/team/understanding-response-times.md +++ b/_i18n/en/team/understanding-response-times.md @@ -117,6 +117,8 @@ Review conversations, teams, teammates, and reports regularly to detect delays b ## Related guides +- [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Teams and Inbox capacity]({% link _team/teams-and-inbox-capacity.md %}) - [Assign conversations]({% link _team/assigning-conversations.md %}) - [Conversation lifecycle in Inbox]({% link _team/conversation-lifecycle.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/analytics-overview.md b/_i18n/es/analytics-reporting-attribution/analytics-overview.md index 17c25f5..b0272e5 100644 --- a/_i18n/es/analytics-reporting-attribution/analytics-overview.md +++ b/_i18n/es/analytics-reporting-attribution/analytics-overview.md @@ -6,6 +6,14 @@ Esta sección conecta tres preguntas relacionadas: - ¿Qué acciones de clientes ocurrieron después del mensaje? - ¿Qué ingresos se atribuyeron a Hellotext? +## Reporte de ingresos + +El Reporte de ingresos muestra las compras completadas durante el período seleccionado, incluidos los ingresos totales y la parte atribuida a actividad elegible de Hellotext. + +Úsalo cuando necesites comparar ingresos atribuidos a la IA o clasificados como gestionados por el equipo, revisar Campañas y Playbooks acreditados o conciliar compras atribuidas individuales. + +Sigue leyendo: [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}). + ## Reportes de campañas Los reportes de campaña te ayudan a revisar entrega, interacción, clicks, conversiones, respuestas e ingresos atribuidos para un envío puntual. @@ -22,6 +30,22 @@ Usa reportes de playbooks cuando necesites comparar ingresos atribuidos, comport Sigue leyendo: [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}). +## Reporte de calidad de servicio + +El Reporte de calidad de servicio compara resolución por IA y equipo, cumplimiento de SLA, conversaciones no resueltas, distribución del tiempo de respuesta y rendimiento de agentes. + +Úsalo cuando necesites entender cómo se resuelven las conversaciones y si un problema de servicio se concentra en un canal, equipo, colaborador, agente de IA o ruta de resolución. + +Sigue leyendo: [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}). + +## Reporte de carga y capacidad + +El Reporte de carga y capacidad compara carga activa, conversaciones manejadas y resueltas, concurrencia, asignaciones, transferencias, presión de capacidad, eficiencia de sesión y la cola operativa actual. + +Úsalo cuando necesites entender cómo se distribuye el trabajo del Inbox durante un período y qué necesita atención ahora. + +Sigue leyendo: [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}). + ## Atribución La atribución explica cuándo Hellotext recibe crédito por una venta y cuándo no. @@ -57,6 +81,9 @@ Si estás revisando tu primer lanzamiento, empieza por [Mide el éxito en tus pr ## Guías relacionadas - [Mide el éxito en tus primeros 7 días]({% link _getting-started/measure-success-first-7-days.md %}) +- [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Crea una campaña]({% link _campaigns/creating-a-campaign.md %}) - [Resumen de precios, facturación y planes]({% link _billing/billing-overview.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/dashboard-guide.md b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md index 10d3c6e..9bcbae7 100644 --- a/_i18n/es/analytics-reporting-attribution/dashboard-guide.md +++ b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md @@ -95,7 +95,7 @@ Las tarjetas de reportes se dividen entre **Rendimiento del negocio** y **Operac | **Reporte de rendimiento** | ¿Cómo están cambiando la tasa de conversión, tiempo hasta conversión y tasa de derivación? | | **Insights de demanda** | ¿Qué solicitudes de clientes no pudieron resolverse, qué productos fueron afectados y cuántos ingresos podrían haberse perdido? | | **Reporte de calidad de servicio** | ¿Con qué frecuencia la IA o el equipo resolvieron conversaciones, cumplieron el SLA o dejaron conversaciones sin resolver? | -| **Reporte de carga y capacidad** | ¿Cuánto trabajo está asignado, atendido, resuelto, transferido o activo entre personas y equipos? | +| **Reporte de carga y capacidad** | ¿Cuánto trabajo está asignado, manejado, resuelto, transferido o activo entre colaboradores y equipos? | Abre un reporte cuando necesites cambiar el período, seleccionar una métrica, comparar un desglose o revisar filas detalladas. Los desgloses disponibles dependen del reporte y métrica. @@ -146,5 +146,6 @@ Los resultados recientes pueden cambiar mientras la atribución siga abierta o l - [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Cómo interpretar los tiempos de respuesta]({% link _team/understanding-response-times.md %}) - [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index b65c566..edf493b 100644 --- a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -220,6 +220,9 @@ Si falta el evento, primero sigue [Soluciona señales o actividad faltante]({% l - [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) - [Resumen de analítica, reportes y atribución]({% link _analytics-reporting-attribution/analytics-overview.md %}) +- [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/revenue-report-guide.md b/_i18n/es/analytics-reporting-attribution/revenue-report-guide.md new file mode 100644 index 0000000..ddcf293 --- /dev/null +++ b/_i18n/es/analytics-reporting-attribution/revenue-report-guide.md @@ -0,0 +1,102 @@ +Usa el Reporte de ingresos para entender cuántos ingresos de comercio recibió Hellotext, qué compras fueron atribuidas y si la IA, el equipo, una Campaña o un Playbook recibió el crédito. + +Ábrelo desde la tarjeta **Reporte de ingresos** del Dashboard. Antes de comparar totales u orígenes, elige un período que coincida con la pregunta que quieres responder. + +## Cómo cuenta los resultados este reporte + +El período seleccionado se basa en la **fecha de compra**. Las métricas principales, la línea de tiempo, los desgloses de ingresos y las tablas de origen incluyen compras completadas durante ese período. + +Los reportes de rendimiento de Campañas y Playbooks usan una fecha diferente porque miden la actividad que originó el resultado. Por ejemplo: + +**Mensaje de Campaña entregado el 30 de junio → Compra completada el 5 de julio → Cuenta el 5 de julio en Ingresos y el 30 de junio en el rendimiento de la Campaña.** + +Ambos reportes pueden ser correctos. Ingresos responde qué se compró durante el período; el reporte de origen responde qué resultados posteriores produjeron los mensajes, activaciones o conversaciones que comenzaron durante su período. + +Una corrección tardía, cancelación, reembolso, reemplazo o actualización de atribución puede cambiar el valor asignado a la fecha de compra original. + +## Interpreta las métricas principales + +Las métricas principales separan tres tipos de ingresos: + +- **Ingresos atribuidos a la IA:** ingresos que el motor de atribución asignó a la IA según evidencia comercial elegible. +- **Ingresos clasificados como gestionados por el equipo:** ingresos clasificados de esa forma por el motor, junto con ingresos históricos elegibles gestionados por una persona que no tienen un veredicto del motor. +- **Ingresos totales:** todos los ingresos compatibles que Hellotext recibió desde actividad de eCommerce, marketplaces y retail durante el período seleccionado, incluidos los atribuidos y no atribuidos. + +Los ingresos atribuidos son una parte de los ingresos totales. Una respuesta de soporte u otra participación del equipo no convierte automáticamente una venta en gestionada por el equipo; Hellotext evalúa el camino de origen y la evidencia comercial aplicable. + +Selecciona una métrica para actualizar su línea de tiempo. Compara el gráfico solo después de confirmar que la métrica, período, moneda y desglose seleccionados sean los mismos. + +## Los ingresos atribuidos no incluyen toda venta influenciada + +Hellotext puede interactuar con un cliente sin recibir atribución por una compra posterior. + +Una compra recibe atribución solo cuando Hellotext tiene evidencia elegible de cliente, pedido, origen y tiempo, y ninguna fuente reconocida con mayor precedencia. Una compra fuera de la ventana aplicable, vinculada con otro perfil o que contiene una fuente externa reconocida puede permanecer en los ingresos totales sin aparecer en los ingresos atribuidos. + +El título de la página puede describir la influencia de Hellotext sobre las ventas, pero **los ingresos influenciados no son una métrica general separada** dentro de este reporte. Usa las métricas atribuidas para los ingresos que cumplen la metodología de Hellotext. La atribución tampoco demuestra que todo el monto sea crecimiento incremental. + +Consulta [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) para entender evidencia, precedencia, ventanas, participación del equipo y ajustes de pedidos. + +## Desglosa la línea de tiempo + +Usa el control de desglose para entender de dónde proviene una métrica. Las opciones dependen de la métrica y de los datos disponibles, y pueden incluir: + +- canal, Campaña o Playbook; +- segmento, tienda o región; +- categoría de producto, producto o variante; +- estado de suscripción, método de pago o contexto de comercio; +- intención, IA frente al equipo, motivo de atribución, equipo, persona o agente de IA. + +Elige solamente las dimensiones necesarias para responder la pregunta. Una fila pequeña puede parecer especialmente fuerte cuando incluye pocas compras, por lo que conviene revisar su volumen antes de decidir. + +## Interpreta los widgets de ingresos atribuidos + +Los widgets debajo de la línea de tiempo explican la composición de los ingresos atribuidos. + +- **Campañas vs Playbooks** compara el monto atribuido a Campañas puntuales y Playbooks siempre activos. +- **Contexto de comercio** separa ingresos compatibles de eCommerce, marketplaces y retail. +- **Canal de comercio** muestra qué canal de venta conectado registró las compras atribuidas. + +Estos widgets distribuyen los ingresos atribuidos; no reemplazan los ingresos totales ni agregan la misma compra a cada origen que interactuó con el cliente. + +## Revisa las tablas de origen + +Las secciones Playbooks, Campañas y Canales agrupan las compras atribuidas incluidas en el período seleccionado según el origen que recibió el crédito. + +Usa pedidos atribuidos, valor promedio del pedido atribuido e ingresos atribuidos para comparar el valor asignado a cada origen. Una fila sin ingresos no significa necesariamente que sus mensajes no se hayan enviado: puede indicar que ninguna compra completada durante el período seleccionado fue elegible para ese origen. + +Para analizar conversión, ROI, ingresos por mensaje o resultados posteriores asignados a la fecha original de un mensaje o activación, abre el reporte de rendimiento de la Campaña o Playbook correspondiente. + +## Exporta e inspecciona compras atribuidas + +Usa **Exportar** cuando necesites conciliar pedidos o revisar la evidencia detrás de las filas atribuidas. La exportación puede incluir: + +- referencias del pedido, cliente y conversación; +- Campaña, Playbook y canal acreditados; +- monto atribuido y fecha de compra; +- tipo y motivo de atribución; +- evidencia comercial de IA y humana, cuando corresponda; +- estado de la conversación, driver comercial y una explicación en lenguaje simple; y +- un link al contexto del evento o conversación. + +La exportación se prepara en segundo plano. Hellotext la descarga cuando está lista y también puede enviar una notificación por email. + +## Cuando un número parece incorrecto + +Antes de contactar a Soporte: + +1. Confirma que ambos sistemas usen la fecha de compra, zona horaria, moneda y reglas de estado de pedido esperadas. +2. Compara referencias individuales de pedidos antes de comparar totales. +3. Separa ingresos totales faltantes de atribución faltante. +4. Confirma que la compra y la actividad de origen pertenezcan al mismo perfil del cliente. +5. Revisa cancelaciones, reembolsos, pedidos de reemplazo y fuentes externas reconocidas. +6. Genera una exportación para revisar el origen acreditado y la explicación. + +Para una investigación completa, consulta [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Guías relacionadas + +- [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/sales-attribution.md b/_i18n/es/analytics-reporting-attribution/sales-attribution.md index 956974f..98602c9 100644 --- a/_i18n/es/analytics-reporting-attribution/sales-attribution.md +++ b/_i18n/es/analytics-reporting-attribution/sales-attribution.md @@ -150,6 +150,7 @@ Los ingresos permanecen en los ingresos del comercio, pero no se atribuyen a Hel ## Guías relacionadas +- [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Links con tracking]({% link _analytics-reporting-attribution/tracked-links.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/service-quality-report-guide.md b/_i18n/es/analytics-reporting-attribution/service-quality-report-guide.md new file mode 100644 index 0000000..3730b46 --- /dev/null +++ b/_i18n/es/analytics-reporting-attribution/service-quality-report-guide.md @@ -0,0 +1,128 @@ +Usa el Reporte de calidad de servicio para entender cómo se resuelven las conversaciones, si se cumplen los tiempos de respuesta y dónde necesitan atención los agentes de IA, colaboradores, equipos o canales. + +Ábrelo desde la tarjeta **Reporte de calidad de servicio** dentro de **Operaciones & Experiencia** en el Dashboard. + +## Cómo cuenta los resultados este reporte + +El período seleccionado se basa en cuándo comenzó una conversación. La resolución, derivación, SLA y otros resultados elegibles que ocurren después permanecen asignados a la conversación de origen. + +Por ejemplo: **Conversación iniciada el 7 de abril → Resuelta el 10 de abril → Cuenta el 7 de abril.** + +Las fechas recientes pueden cambiar mientras las conversaciones sigan abiertas o su ventana de análisis de servicio no haya cerrado. Compara períodos anteriores cuando necesites resultados estables y usa el Inbox o Carga y capacidad cuando necesites revisar la cola actual en lugar del resultado de conversaciones iniciadas durante un período. + +## Interpreta las métricas principales + +Selecciona una métrica para actualizar la línea de tiempo y los desgloses disponibles. + +### Tasa de resolución por IA + +Es el porcentaje de conversaciones resueltas completamente por IA sin Derivación a un colaborador. + +Una tasa mayor significa que la IA completó por sí sola más conversaciones elegibles. No significa que la IA haya participado en todas las demás resoluciones y no debería optimizarse sin revisar si los clientes recibieron resultados correctos y útiles. + +### Resueltas por equipo + +Es la cantidad de conversaciones resueltas o cerradas por colaboradores dentro de la población seleccionada. + +Una conversación puede incluir actividad de IA antes de que el equipo la tome. Cuando un colaborador completa la resolución final, pertenece al resultado resuelto por el equipo. + +### Cumplimiento de SLA + +Es el porcentaje de obligaciones de respuesta elegibles que cumplieron el tiempo configurado. + +Hellotext aplica la política de respuesta y el Horario comercial vigentes cuando comenzó cada temporizador. Las notas internas, borradores, Campañas y actividad exclusiva del sistema no cuentan como respuestas para el cliente. + +Consulta [Tiempo de respuesta y reglas de respuesta]({% link _team/understanding-response-times.md %}) para entender los temporizadores de primera respuesta y respuestas posteriores. + +### Tasa de no resueltas + +Es el porcentaje de conversaciones que permanecen sin resolver o pendientes dentro de la población seleccionada. + +Esta métrica puede disminuir a medida que se cierran conversaciones recientes. Úsala para encontrar un patrón por canal, equipo, colaborador, gestión por IA o humana, o ruta de resolución en lugar de interpretar cada conversación abierta como una falla de servicio. + +## Usa los desgloses + +Los desgloses disponibles dependen de la métrica seleccionada: + +- **Tasa de resolución por IA:** canal, agente de IA o ruta de resolución. +- **Resueltas por equipo:** equipo, colaborador, canal o ruta de resolución. +- **Cumplimiento de SLA:** equipo, colaborador, canal, agente de IA o gestión por IA frente a humana. +- **Tasa de no resueltas:** canal, equipo, colaborador, gestión por IA frente a humana o ruta de resolución. + +Usa una dimensión por vez cuando investigues un cambio. Una diferencia por canal puede venir de la intención del cliente o del horario operativo; una diferencia por equipo puede venir del enrutamiento, la capacidad o los tipos de conversaciones que recibe. + +## Entiende la Ruta de resolución + +**Ruta de resolución** compara las conversaciones cuya resolución final fue completada por IA con las completadas por el equipo. + +Este gráfico describe quién completó la resolución final, no todos los participantes. Una conversación que empezó con IA y luego fue resuelta por un colaborador aparece como **Resuelta por equipo**. Una resolución de IA debe completarse sin Derivación para aparecer como **Resuelta por IA**. + +Usa el desglose de la línea de tiempo cuando necesites más detalle, como solo IA, humano desde el inicio, escalada a humano, activa con IA o activa con humano. + +## Entiende la Distribución del tiempo de respuesta + +**Distribución del tiempo de respuesta** muestra cómo se distribuyen las esperas respondidas entre estos rangos: + +- menos de 1 minuto; +- 1–3 minutos; +- 3–5 minutos; +- 5–10 minutos; y +- más de 10 minutos. + +Usa el selector para comparar todas las conversaciones, las gestionadas por IA, las gestionadas por personas o las derivadas al equipo. + +El porcentaje de cada barra es la proporción de esperas respondidas que cayó dentro de ese rango. **No es el cumplimiento de SLA**. El cumplimiento de SLA compara cada respuesta elegible con su tiempo configurado, que puede variar según el canal y el Horario comercial. + +## Compara el rendimiento de agentes + +La tabla **Rendimiento de agentes** puede mostrar todos los agentes individuales, equipos, agentes de IA o colaboradores. + +La vista **Todos** compara colaboradores individuales con agentes de IA. Los equipos no aparecen allí porque agrupan el mismo trabajo humano y lo duplicarían. + +La tabla puede incluir: + +- **Conversaciones:** volumen de conversaciones vinculado con ese agente o equipo. +- **Resueltas:** conversaciones completadas por esa fila. +- **Primera respuesta:** tiempo promedio hasta la primera respuesta elegible. +- **Atención promedio:** tiempo activo de atención humana dividido entre conversaciones atendidas. Los agentes de IA no muestran un valor porque no existe un intervalo de trabajo activo comparable. +- **Tiempo de resolución:** tiempo desde el inicio de la responsabilidad hasta la resolución, o hasta la Derivación cuando la IA entregó la conversación. +- **FCR:** conversaciones resueltas sin Derivación, reasignación ni reapertura. +- **SLA:** obligaciones de respuesta elegibles completadas dentro del tiempo configurado. + +Compara roles similares antes de sacar conclusiones. La IA y los colaboradores pueden recibir intenciones diferentes y tener distintas mediciones de tiempo, por lo que un valor vacío no equivale a rendimiento cero. + +## Convierte el reporte en una acción + +| Si ves... | Revisa... | +| --- | --- | +| Baja la Tasa de resolución por IA | Agente de IA, canal, ruta de resolución, conocimiento faltante, solicitudes no compatibles y reglas de Derivación. | +| Suben las resoluciones por equipo | Si más conversaciones se están enviando intencionalmente a personas o si la IA deriva casos que debería resolver. | +| Baja el cumplimiento de SLA | Políticas de respuesta, Horario comercial, diferencias por canal, capacidad del equipo y conversaciones sin asignar. | +| Sube la tasa de no resueltas | Conversaciones recientes abiertas, enrutamiento, responsable, capacidad y tipos de problema repetidos. | +| Muchas esperas superan los 10 minutos | Si la demora se concentra en actividad humana, derivada, de un canal, equipo o colaborador. | +| FCR bajo en una fila | Derivaciones, reasignaciones, conversaciones reabiertas y si la responsabilidad llega al destino correcto. | + +Abre conversaciones representativas antes de cambiar un Playbook, regla de enrutamiento, política de respuesta o capacidad del equipo. El reporte identifica un patrón; el historial de la conversación explica qué ocurrió. + +## Cuando faltan datos o parecen incorrectos + +Confirma que: + +- las conversaciones tengan registrados su inicio, responsable y resultado del ciclo; +- las resoluciones y Derivaciones de IA hayan sido registradas por el Playbook o la ruta; +- los colaboradores cierren las conversaciones completadas en lugar de dejarlas abiertas; +- las reglas de respuesta y el Horario comercial estén configurados para los canales comparados; +- las asignaciones a equipos y colaboradores identifiquen quién gestionó la conversación; y +- ambas comparaciones usen el mismo período, zona horaria, métrica y desglose. + +Si los registros de origen existen pero el reporte sigue siendo inconsistente, consulta [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Guías relacionadas + +- [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Ciclo de una conversación en el Inbox]({% link _team/conversation-lifecycle.md %}) +- [Tiempo de respuesta y reglas de respuesta]({% link _team/understanding-response-times.md %}) +- [Equipos y capacidad del Inbox]({% link _team/teams-and-inbox-capacity.md %}) +- [Derivación de IA al Inbox]({% link _team/ai-handoff-to-inbox.md %}) +- [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/workload-capacity-report-guide.md b/_i18n/es/analytics-reporting-attribution/workload-capacity-report-guide.md new file mode 100644 index 0000000..f2f129e --- /dev/null +++ b/_i18n/es/analytics-reporting-attribution/workload-capacity-report-guide.md @@ -0,0 +1,141 @@ +Usa el Reporte de carga y capacidad para entender cómo se distribuye el trabajo del Inbox, cuánta capacidad se consume y dónde necesita atención la cola actual. + +Ábrelo desde la tarjeta **Reporte de carga y capacidad** dentro de **Operaciones & Experiencia** en el Dashboard. + +## Cómo cuenta los resultados este reporte + +Este reporte combina el trabajo histórico del período seleccionado con una instantánea operativa en vivo. El selector de fechas no controla todas las secciones de la misma manera: + +- **Manejadas** usa el momento en que un colaborador manejó por primera vez la conversación mediante una respuesta elegible. +- **Resueltas** usa el momento en que la conversación se resolvió o cerró. +- **Carga activa**, concurrencia, presión de capacidad y eficiencia de sesión usan intervalos de trabajo o sesión que se superponen con el período seleccionado. +- **Presión operativa** muestra la cola actual en el momento indicado por la sección. No está limitada por el período histórico seleccionado. + +Por ejemplo: **Conversación iniciada el 7 de abril → Manejada por primera vez el 8 de abril → Resuelta el 10 de abril**. Contribuye a Manejadas el 8 de abril y a Resueltas el 10 de abril. Si una conversación sigue esperando ahora, aparece en Presión operativa ahora, sin importar cuándo comenzó. + +Este reporte no espera que madure una ventana de atribución. Los valores históricos todavía pueden cambiar si se corrigen responsables, eventos del ciclo de conversación o registros de sesión. + +## Interpreta las métricas principales + +Selecciona una métrica para actualizar la línea de tiempo y los desgloses disponibles. + +### Carga activa + +Es la cantidad promedio de conversaciones abiertas y activas asignadas durante el período seleccionado. + +La carga activa describe trabajo en curso, no todas las conversaciones visibles en el Inbox. Compárala con la presión de capacidad, la salud de respuesta y la cola actual antes de concluir que un equipo está sobrecargado. + +### Manejadas + +Es la cantidad de conversaciones donde un colaborador o equipo envió al menos una respuesta elegible durante el período seleccionado. + +Una conversación puede manejarse en un período y resolverse en otro. Manejadas mide el trabajo tomado, no su finalización. + +### Resueltas + +Es la cantidad de conversaciones resueltas o cerradas por un colaborador o equipo durante el período seleccionado. + +Compara Resueltas con Manejadas a lo largo del tiempo. Una diferencia breve puede ser normal cuando las conversaciones duran varios días; una brecha persistente puede indicar que crece el trabajo sin terminar. + +### Concurrencia + +Es la cantidad promedio de conversaciones atendidas al mismo tiempo durante el período seleccionado. + +Una concurrencia alta puede ser apropiada para conversaciones simples o breves. Revísala junto con tiempos de respuesta, riesgo de SLA y calidad de las conversaciones en lugar de usar un mismo objetivo para todos los equipos. + +### Asignadas + +Es la cantidad de conversaciones atendidas donde el colaborador seleccionado fue el primer responsable humano durante el período. + +Esta métrica está disponible por colaborador porque describe responsabilidad individual y no un agregado del equipo. + +### Transferidas a + +Es la cantidad de conversaciones atendidas que el colaborador seleccionado heredó de otra persona durante el período. + +Las transferencias no son automáticamente un problema. Revisa las transferencias repetidas cuando indiquen enrutamiento poco claro, conocimiento faltante o una responsabilidad que comienza en el lugar equivocado. + +## Compara colaboradores y equipos + +La mayoría de las métricas puede desglosarse por colaborador o equipo. **Asignadas** y **Transferidas a** usan la responsabilidad individual. + +Compara elementos equivalentes. Distintos equipos pueden recibir diferentes intenciones, canales, horarios o niveles de complejidad. Un volumen mayor no significa por sí solo mejor rendimiento y uno menor tampoco significa capacidad sin usar. + +## Entiende la Presión de capacidad + +**Presión de capacidad** compara el tiempo de atención consumido con la capacidad de atención disponible representada en el período seleccionado. Puedes verla por colaborador o equipo. + +Cada barra muestra: + +- **Capacidad disponible:** capacidad de atención disponible para el período. +- **Capacidad consumida:** tiempo de atención activa usado durante ese período. +- **Presión:** capacidad consumida como porcentaje de la capacidad disponible. + +La capacidad depende de la configuración del Inbox para equipos y colaboradores. Un porcentaje alto invita a revisar la cola y la salud de respuesta, pero no demuestra por sí solo que debas aumentar la capacidad inmediatamente. + +Consulta [Equipos y capacidad del Inbox]({% link _team/teams-and-inbox-capacity.md %}) antes de cambiar esta configuración. + +## Entiende la Eficiencia de sesión + +**Eficiencia de sesión** compara el tiempo de atención activa con el tiempo total de sesión registrado durante el período seleccionado. Puedes verla por colaborador o equipo. + +El gráfico separa: + +- **Tiempo total conectado:** tiempo de sesión registrado durante el período. +- **Tiempo activo:** tiempo dedicado a atender conversaciones activamente. +- **Tiempo inactivo:** tiempo conectado sin atención activa de conversaciones. + +Usa esta vista para entender cómo se distribuyó el tiempo registrado en el Inbox. No es una medición completa de productividad: reuniones, pausas, tareas administrativas y responsabilidades fuera del Inbox pueden no aparecer como tiempo de atención activa. + +## Interpreta Presión operativa + +**Presión operativa** es una vista en vivo de la cola actual. Cambiar el período histórico no mueve esta sección hacia el pasado. + +Puedes verla por colaborador o equipo e interpretar estas columnas: + +- **Sin respuesta:** conversaciones actuales que todavía esperan una respuesta. +- **Mayor espera:** la espera actual más larga de un cliente. +- **Riesgo SLA:** indica si las obligaciones activas están en estado Seguro, En riesgo o Inminente. +- **Utilización:** tiempo actual de atención activa comparado con el tiempo disponible de sesión registrado. +- **Concurrente:** cantidad actual de conversaciones manejadas simultáneamente. +- **Burn:** señal operativa que combina utilización, concurrencia y presión de SLA. Sus estados son Normal, Observación y En riesgo. + +Burn es un indicador de presión de la cola, no un diagnóstico ni una evaluación del rendimiento de una persona. Abre las conversaciones involucradas y considera horarios, enrutamiento y capacidad antes de actuar. + +## Convierte el reporte en una acción + +| Si ves... | Revisa... | +| --- | --- | +| Sube la Carga activa | Nuevas asignaciones, trabajo sin resolver, capacidad del equipo y si las conversaciones se cierran al completarse. | +| Manejadas se mantiene por encima de Resueltas | Si el trabajo normalmente atraviesa varios períodos o se acumulan conversaciones sin terminar. | +| Concurrencia alta con respuestas más lentas | Límites de conversaciones simultáneas, complejidad, reglas de respuesta y disponibilidad del equipo. | +| Transferencias concentradas en un colaborador | Destinos de enrutamiento, integrantes del equipo, conocimiento y responsabilidad inicial. | +| Baja eficiencia de sesión registrada | Si el colaborador estaba disponible para el Inbox y si otras responsabilidades explican la diferencia. | +| Aumentan Sin respuesta o Mayor espera | Las colas actuales sin asignar y asignadas, disponibilidad y salud de respuesta. | +| Empeora el riesgo de SLA o Burn | Conversaciones que generan presión, Horario comercial, reglas de respuesta, enrutamiento, concurrencia y capacidad disponible. | + +Usa las métricas históricas para identificar un patrón y Presión operativa para decidir qué necesita atención ahora. + +## Cuando faltan datos o parecen incorrectos + +Confirma que: + +- los equipos y modos de capacidad del Inbox de cada colaborador estén configurados correctamente; +- los colaboradores activos tengan valores realistas de conversaciones simultáneas y capacidad diaria de atención; +- las asignaciones y transferencias identifiquen al responsable correcto; +- los colaboradores envíen respuestas y cierren las conversaciones completadas en el Inbox; +- las sesiones y los intervalos de atención activa estén registrados para el período; +- las reglas de respuesta y el Horario comercial estén configurados al revisar riesgo de SLA; y +- ambas comparaciones usen el mismo período, zona horaria, métrica y desglose. + +Si los registros de origen existen pero el reporte sigue siendo inconsistente, consulta [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Guías relacionadas + +- [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Equipos y capacidad del Inbox]({% link _team/teams-and-inbox-capacity.md %}) +- [Tiempo de respuesta y reglas de respuesta]({% link _team/understanding-response-times.md %}) +- [Ciclo de una conversación en el Inbox]({% link _team/conversation-lifecycle.md %}) +- [Asigna conversaciones]({% link _team/assigning-conversations.md %}) +- [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/es/captures/forms.md b/_i18n/es/captures/forms.md index 1d13c4a..fbc1879 100644 --- a/_i18n/es/captures/forms.md +++ b/_i18n/es/captures/forms.md @@ -94,7 +94,7 @@ Copia el enlace generado cuando quieras que Hellotext aloje el formulario. Ábre Usa el HTML generado cuando el formulario deba aparecer dentro de una de tus páginas. -1. Confirma que el sitio esté conectado mediante una integración de ecommerce compatible o que tenga instalado [Hellotext.js](https://github.com/hellotext/hellotext.js). +1. Confirma que el sitio esté conectado mediante una integración de eCommerce compatible o que tenga instalado [Hellotext.js](https://github.com/hellotext/hellotext.js). 2. Copia el código generado exactamente como lo proporciona Hellotext. 3. Pégalo dentro del cuerpo de la página donde debe aparecer. 4. Aplica los estilos de tu sitio sin eliminar ni cambiar los atributos generados del formulario. @@ -129,7 +129,7 @@ Después de completar el formulario, el mismo navegador puede recordar que ya fu Revisa estos puntos en orden: 1. Confirma que el código generado esté presente en la página. -2. Confirma que la integración de ecommerce conectada o Hellotext.js cargue correctamente. +2. Confirma que la integración de eCommerce conectada o Hellotext.js cargue correctamente. 3. Compara el código integrado con el snippet actual que muestra Hellotext. 4. Revisa si los estilos o scripts del sitio ocultan o reemplazan el formulario. 5. Prueba el enlace alojado para diferenciar un problema de configuración de uno de instalación. diff --git a/_i18n/es/journeys/ai-cart-saver-playbook.md b/_i18n/es/journeys/ai-cart-saver-playbook.md index 72781eb..483be3b 100644 --- a/_i18n/es/journeys/ai-cart-saver-playbook.md +++ b/_i18n/es/journeys/ai-cart-saver-playbook.md @@ -60,7 +60,7 @@ Abre **Playbooks**, haz click en **Explorar playbooks** y elige **Recuperador de Recuperador de Carritos con IA expone: - **Canales:** dónde Hellotext puede enviar o continuar la conversación de recuperación de carrito. -- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del ecommerce, puede crear descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del eCommerce, puede crear descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Tono:** cómo debería sonar el seguimiento generado. - **Derivación o asignación:** quién debería tomar la conversación cuando necesita una persona. diff --git a/_i18n/es/journeys/anniversary-surprise-playbook.md b/_i18n/es/journeys/anniversary-surprise-playbook.md index 1076bf0..9f98b5b 100644 --- a/_i18n/es/journeys/anniversary-surprise-playbook.md +++ b/_i18n/es/journeys/anniversary-surprise-playbook.md @@ -15,7 +15,7 @@ Puede: - Usar una fuente de aniversario, como primera compra, creación del perfil, fecha de suscripción o una fecha personalizada, cuando esté disponible. - Detectar cuándo el cliente llega a un aniversario según esa fuente. - Enviar un mensaje de celebración con tono de agradecimiento o reconocimiento. -- Incluir un cupón aprobado o una oferta existente del ecommerce cuando el mensaje lo necesita. +- Incluir un cupón aprobado o una oferta existente del eCommerce cuando el mensaje lo necesita. - Personalizar el mensaje con datos del perfil del cliente, historial de compra o contexto de relación cuando esos datos están disponibles. - Omitir perfiles cuando falta la fecha de aniversario, falta consentimiento, el canal no está listo o el perfil no puede ser alcanzado. @@ -48,7 +48,7 @@ Revisa que: - La audiencia que quieres alcanzar sea identificable y elegible. - El canal, remitente o cuenta de WhatsApp esté listo. - El mensaje o plantilla esté aprobado si el canal lo requiere. -- Si vas a incluir un cupón u oferta del ecommerce, esté aprobado y funcione antes del lanzamiento. +- Si vas a incluir un cupón u oferta del eCommerce, esté aprobado y funcione antes del lanzamiento. - Los datos de compra, perfil o propiedades personalizadas estén sincronizados si el aniversario depende de ellos. Para validar la configuración, usa [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}). Si importas perfiles o fechas personalizadas, revisa [Importa perfiles del cliente]({% link _audience/import-customer-profiles.md %}). Para tracking personalizado, usa [Seguimiento de eventos]({% link _developers/tracking-events.md %}). @@ -65,7 +65,7 @@ Las opciones disponibles pueden variar, pero revisa: - **Audiencia:** qué perfiles pueden recibir el playbook. - **Canales de salida:** dónde Hellotext puede enviar el mensaje. - **Mensaje:** el texto de aniversario y las variables que usará. -- **Cupón u oferta:** el cupón aprobado o la oferta existente del ecommerce que se incluirá si corresponde. +- **Cupón u oferta:** el cupón aprobado o la oferta existente del eCommerce que se incluirá si corresponde. - **Respuestas en Inbox:** cómo debería revisar tu equipo las respuestas si el cliente contesta. No asumas que todas las cuentas tienen la misma fuente de aniversario. Si el control no aparece, confirma con tu equipo de Hellotext qué fecha está usando el playbook antes de lanzar. diff --git a/_i18n/es/journeys/birthday-bash-playbook.md b/_i18n/es/journeys/birthday-bash-playbook.md index ba77edb..18331ac 100644 --- a/_i18n/es/journeys/birthday-bash-playbook.md +++ b/_i18n/es/journeys/birthday-bash-playbook.md @@ -15,7 +15,7 @@ Puede: - Detectar perfiles del cliente cuyo cumpleaños coincide con el día y mes actuales. - Crear un evento de cumpleaños para iniciar el playbook cuando está activo. - Enviar un mensaje de cumpleaños con tono celebratorio. -- Incluir un cupón aprobado o una oferta existente del ecommerce cuando el mensaje lo necesita. +- Incluir un cupón aprobado o una oferta existente del eCommerce cuando el mensaje lo necesita. - Personalizar el mensaje con datos del perfil del cliente, como nombre o cumpleaños, si están disponibles. - Omitir perfiles cuando falta la fecha de cumpleaños, falta consentimiento, el canal no está listo o el perfil no puede ser alcanzado. @@ -49,7 +49,7 @@ Revisa que: - La audiencia que quieres alcanzar tenga consentimiento para el canal. - El canal, remitente o cuenta de WhatsApp esté listo. - El mensaje o plantilla de cumpleaños esté aprobado si el canal lo requiere. -- Si vas a incluir un cupón u oferta del ecommerce, esté aprobado y funcione antes del lanzamiento. +- Si vas a incluir un cupón u oferta del eCommerce, esté aprobado y funcione antes del lanzamiento. - La audiencia excluya perfiles que no deberían recibir mensajes promocionales. Para validar la configuración, usa [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}). Si importas perfiles, revisa [Importa perfiles del cliente]({% link _audience/import-customer-profiles.md %}). Para tracking personalizado, usa [Seguimiento de eventos]({% link _developers/tracking-events.md %}). @@ -65,7 +65,7 @@ Las opciones disponibles pueden variar, pero normalmente revisas: - **Canales de salida:** dónde Hellotext puede enviar el saludo. - **Audiencia:** qué perfiles pueden recibir el playbook. - **Mensaje:** el texto de cumpleaños y las variables que usará. -- **Cupón u oferta:** el cupón aprobado o la oferta existente del ecommerce que se incluirá si corresponde. +- **Cupón u oferta:** el cupón aprobado o la oferta existente del eCommerce que se incluirá si corresponde. - **Respuestas en Inbox:** cómo debería revisar tu equipo las respuestas si el cliente contesta. No hace falta crear una campaña manual para cada fecha. El playbook depende de la señal de cumpleaños del perfil y se ejecuta cuando el cumpleaños coincide con el día actual. diff --git a/_i18n/es/journeys/browse-recovery-playbook.md b/_i18n/es/journeys/browse-recovery-playbook.md index ee526ea..4a76eb2 100644 --- a/_i18n/es/journeys/browse-recovery-playbook.md +++ b/_i18n/es/journeys/browse-recovery-playbook.md @@ -63,7 +63,7 @@ Recuperación de Navegación expone: - **Canales:** dónde Hellotext puede enviar o continuar la conversación de recuperación de navegación. - **Tono o feedback en Playground:** cómo deberían aprender los seguimientos generados qué encaja con tu negocio. -- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del ecommerce, puede crear descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del eCommerce, puede crear descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Derivación o asignación:** quién debería tomar la conversación cuando una respuesta necesita una persona. Mantén la selección automática de canales salvo que tengas una razón clara para limitar el playbook. Recuperación de Navegación depende de si el cliente realmente puede ser alcanzado y si el formato del mensaje está permitido en el canal. diff --git a/_i18n/es/journeys/complete-the-look-playbook.md b/_i18n/es/journeys/complete-the-look-playbook.md index 192e180..5dc21df 100644 --- a/_i18n/es/journeys/complete-the-look-playbook.md +++ b/_i18n/es/journeys/complete-the-look-playbook.md @@ -17,7 +17,7 @@ Puede: - Usar contexto de cliente, producto, catálogo, precio, stock y canal antes de enviar un mensaje. - Generar ejemplos de mensajes que se adaptan por cliente. - Permitir que tu equipo dé feedback en Playground para que Hellotext aprenda qué encaja con el negocio. -- Seguir reglas de oferta existentes del ecommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. +- Seguir reglas de oferta existentes del eCommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. - Evitar recomendar productos no disponibles, irrelevantes, ya comprados o fuera del alcance de productos seleccionado. La configuración exacta puede variar según cuenta, tienda conectada, calidad del catálogo, canal, plantillas y estado de despliegue. @@ -46,13 +46,13 @@ Antes de habilitar Completa el Look, confirma la configuración de la que depend Revisa que: -- Tu catálogo de productos o integración de ecommerce esté conectada. +- Tu catálogo de productos o integración de eCommerce esté conectada. - Nombres, imágenes, precios, variantes, stock y links de producto estén actualizados. - Los productos que quieres incluir tengan complementos claros, productos que combinan, accesorios compatibles o ítems relacionados. - Identificadores de producto y variante sean estables entre catálogo, vista de producto, carrito, recomendación y compra. - La audiencia que quieres alcanzar esté suscrita, identificable y sea elegible para el canal seleccionado. - Señales de compra, carrito e interés de producto estén disponibles para que Hellotext evite sugerencias irrelevantes. -- Si se permiten descuentos, las reglas de oferta del ecommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. +- Si se permiten descuentos, las reglas de oferta del eCommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. - Tarjetas de producto, links de producto o mensajes enriquecidos funcionen en los canales que quieres usar. Para validar la configuración, usa [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}). Para tracking personalizado, usa [Seguimiento de eventos]({% link _developers/tracking-events.md %}). @@ -68,7 +68,7 @@ Las tarjetas disponibles pueden variar, pero la configuración propuesta se conc - **Canales de salida:** dónde Hellotext puede enviar sugerencias de productos que combinan. - **Audiencia:** qué audiencia o segmento puede recibir el playbook. - **Productos:** qué productos, colecciones, categorías o grupos puede usar el playbook. -- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del ecommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del eCommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Tono o feedback en Playground:** cómo deberían aprender los ejemplos generados qué encaja con tu negocio. Mantén la selección automática de canales salvo que tengas una razón clara para limitar el playbook. Completa el Look depende de si el comprador puede ser alcanzado cuando la sugerencia de producto que combina todavía es relevante. diff --git a/_i18n/es/journeys/cross-sell-driver-playbook.md b/_i18n/es/journeys/cross-sell-driver-playbook.md index ffc9e3e..1a31d92 100644 --- a/_i18n/es/journeys/cross-sell-driver-playbook.md +++ b/_i18n/es/journeys/cross-sell-driver-playbook.md @@ -47,7 +47,7 @@ Revisa que: - Las relaciones entre productos puedan inferirse o proveerse mediante catálogo, colecciones, categorías, historial de compra o lógica de recomendación. - Los productos que quieres recomendar tengan suficiente stock y links usables. - Tu equipo tenga claro qué colecciones, categorías o productos deberían incluirse o excluirse en la configuración del playbook. -- Si se permiten descuentos, las reglas de oferta del ecommerce y el porcentaje máximo que puede usar la IA estén aprobados antes del lanzamiento. +- Si se permiten descuentos, las reglas de oferta del eCommerce y el porcentaje máximo que puede usar la IA estén aprobados antes del lanzamiento. - El canal que puede usar el playbook esté conectado y listo. - Los clientes tengan consentimiento y sean elegibles para el canal. @@ -66,7 +66,7 @@ El playbook expone el alcance de productos y las reglas de recomendación: Según el despliegue de la cuenta, también puede mostrar tarjetas para: -- **Estrategia de descuento:** si el mensaje sigue las reglas de oferta del ecommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el mensaje sigue las reglas de oferta del eCommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Canales:** dónde Hellotext puede enviar o continuar la conversación. - **Tono o feedback en Playground:** cómo deberían aprender los seguimientos generados qué encaja con tu negocio. - **Derivación o asignación:** quién debería tomar la conversación cuando una respuesta necesita una persona. diff --git a/_i18n/es/journeys/dormant-revival-playbook.md b/_i18n/es/journeys/dormant-revival-playbook.md index 86e2dd6..89b851d 100644 --- a/_i18n/es/journeys/dormant-revival-playbook.md +++ b/_i18n/es/journeys/dormant-revival-playbook.md @@ -17,7 +17,7 @@ Puede: - Sugerir productos, colecciones u ofertas relevantes según el comportamiento anterior del cliente. - Generar ejemplos de mensajes personalizados que se adaptan por cliente. - Permitir que tu equipo dé feedback en Playground para que Hellotext aprenda qué encaja con el negocio. -- Seguir reglas de oferta existentes del ecommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. +- Seguir reglas de oferta existentes del eCommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. - Buscar el canal más eficiente en costo entre los disponibles, como WhatsApp, SMS u otros, y enviar solo cuando detecta internamente una oportunidad con ROI saludable. - Omitir clientes cuando el cliente se reactivó, compró recientemente, entró en otro playbook activo, quitó consentimiento, no puede ser alcanzado o no hay suficiente contexto de producto. @@ -51,7 +51,7 @@ Revisa que: - Los productos o colecciones que quieres usar sean apropiados para mensajes de recuperación. - La audiencia que quieres alcanzar sea identificable y elegible para el canal seleccionado. - Las señales de compra, navegación, clicks, respuestas, bajas, opt-out y reactivación reciente estén disponibles para que Hellotext evite envíos irrelevantes. -- Si se permiten descuentos, las reglas de oferta del ecommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. +- Si se permiten descuentos, las reglas de oferta del eCommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. - Tarjetas de producto, links de producto o mensajes enriquecidos funcionen en los canales que quieres usar. Para validar la configuración, usa [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}). Para tracking personalizado, usa [Seguimiento de eventos]({% link _developers/tracking-events.md %}). @@ -67,7 +67,7 @@ Las tarjetas disponibles pueden variar, pero la configuración propuesta se conc - **Canales de salida:** dónde Hellotext puede enviar o continuar el mensaje de reactivación. - **Audiencia:** qué audiencia o segmento puede recibir el playbook. - **Productos:** qué productos, colecciones, categorías o grupos puede usar el mensaje. -- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del ecommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del eCommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Tono o feedback en Playground:** cómo deberían aprender los ejemplos generados qué encaja con tu negocio. Mantén la selección automática de canales salvo que tengas una razón clara para limitar el playbook. Reactivación de Inactivos depende de si el cliente todavía puede ser alcanzado en un canal donde el mensaje tenga sentido. Hellotext puede elegir internamente el canal más eficiente en costo, como WhatsApp, SMS u otros según disponibilidad, y evitar envíos cuando no detecta una oportunidad con ROI saludable. diff --git a/_i18n/es/journeys/first-purchase-driver-playbook.md b/_i18n/es/journeys/first-purchase-driver-playbook.md index 3dd82ad..d0ffd7c 100644 --- a/_i18n/es/journeys/first-purchase-driver-playbook.md +++ b/_i18n/es/journeys/first-purchase-driver-playbook.md @@ -63,7 +63,7 @@ Abre **Playbooks**, haz click en **Explorar playbooks** y elige **Impulsor de Pr El playbook maneja automáticamente la elegibilidad para primera compra y el momento del seguimiento. Según el despliegue de tu cuenta, revisa las tarjetas que expone para: -- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del ecommerce, puede crear descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del eCommerce, puede crear descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Canales:** dónde Hellotext puede enviar o continuar la conversación. - **Tono o feedback en Playground:** cómo deberían aprender los seguimientos generados qué encaja con tu negocio. - **Derivación o asignación:** quién debería tomar la conversación cuando una respuesta necesita una persona. diff --git a/_i18n/es/journeys/how-to-customize-a-playbook-safely.md b/_i18n/es/journeys/how-to-customize-a-playbook-safely.md index 20ca0f5..f9adb05 100644 --- a/_i18n/es/journeys/how-to-customize-a-playbook-safely.md +++ b/_i18n/es/journeys/how-to-customize-a-playbook-safely.md @@ -39,7 +39,7 @@ Considera deshabilitar temporalmente solo cuando el cambio pueda afectar a clien - Estás cambiando el prompt de un playbook que lo permite y el agente podría responder de forma incorrecta. - Estás cambiando intenciones de un agente personalizado. - Estás modificando canales de entrada o salida. -- Estás cambiando descuentos o reglas de oferta del ecommerce. +- Estás cambiando descuentos o reglas de oferta del eCommerce. - Estás editando una ruta con pasos, condiciones, ramas o asignaciones. Para playbooks activos de venta, el riesgo depende de qué tarjeta estás cambiando. Muchos ajustes no afectan clientes inmediatamente, pero un cambio de prompt, estrategia de descuento, canal o lógica de ruta sí merece prueba antes de volver a ampliar. @@ -54,7 +54,7 @@ Usa esta tabla como mapa rápido: | **Intenciones** | Agentes personalizados y playbooks personalizados | Qué mensajes de clientes activan ese agente. | | **Conocimiento** | Agentes de IA de venta o atención | Qué información usa el agente para responder. | | **Canales de entrada/salida** | Playbooks que permiten selección de canales | Dónde puede responder o enviar mensajes. | -| **Descuentos** | Playbooks de venta que permiten ofertas | Qué reglas de oferta del ecommerce y límites de descuento con IA puede usar el agente. | +| **Descuentos** | Playbooks de venta que permiten ofertas | Qué reglas de oferta del eCommerce y límites de descuento con IA puede usar el agente. | | **Derivación** | Agentes de IA, atención, [Webchat]({% link _captures/webchat-widget-playbook.md %}) y algunos playbooks personalizados | Quién toma la conversación cuando el agente no debe seguir. | | **Pasos de ruta** | Journeys o rutas | Secuencia, esperas, ramas, asignaciones y salida del flujo. | @@ -133,7 +133,7 @@ Las reglas de descuento afectan expectativas del cliente e ingresos, así que c Antes de cambiar descuentos: -- Confirma si el playbook debería seguir las reglas de oferta del ecommerce, crear descuentos con IA hasta un porcentaje máximo, combinar ambos o enviar sin descuentos. +- Confirma si el playbook debería seguir las reglas de oferta del eCommerce, crear descuentos con IA hasta un porcentaje máximo, combinar ambos o enviar sin descuentos. - Define máximos claros para cualquier descuento generado por IA. - Evita acumular descuentos más allá de tus reglas de negocio. - Prueba qué pasa cuando un cliente pide un mejor descuento. diff --git a/_i18n/es/journeys/how-to-enable-a-playbook.md b/_i18n/es/journeys/how-to-enable-a-playbook.md index e4dc78b..4a09b93 100644 --- a/_i18n/es/journeys/how-to-enable-a-playbook.md +++ b/_i18n/es/journeys/how-to-enable-a-playbook.md @@ -36,7 +36,7 @@ Puedes ver tarjetas como: - **Prompt del agente**, para instrucciones que indican qué debe hacer el agente de IA y cómo debe responder. - **Intenciones**, para intenciones de clientes que deberían activar un agente personalizado. - **Conocimiento**, para FAQs, políticas, notas de producto o documentos que el agente puede usar. -- **Descuentos**, para reglas de oferta del ecommerce y límites máximos de descuento con IA. +- **Descuentos**, para reglas de oferta del eCommerce y límites máximos de descuento con IA. - **Tono**, para la voz usada en respuestas generadas por IA. - **Derivación**, para la persona o equipo que debería tomar la conversación cuando el agente necesita ayuda. - **Búsqueda web**, para sitios aprobados donde el agente puede buscar información online. diff --git a/_i18n/es/journeys/replenishment-driver-playbook.md b/_i18n/es/journeys/replenishment-driver-playbook.md index db5dba4..044713f 100644 --- a/_i18n/es/journeys/replenishment-driver-playbook.md +++ b/_i18n/es/journeys/replenishment-driver-playbook.md @@ -61,7 +61,7 @@ Abre **Playbooks**, haz click en **Explorar playbooks** y elige **Impulsor de Re El playbook expone las configuraciones que controlan cómo se comunica: -- **Estrategia de descuento:** si el recordatorio sigue las reglas de oferta del ecommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el recordatorio sigue las reglas de oferta del eCommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Canales:** dónde Hellotext puede enviar o continuar la conversación. - **Tono o feedback en Playground:** cómo deberían aprender los seguimientos generados qué encaja con tu negocio. diff --git a/_i18n/es/journeys/review-builder-playbook.md b/_i18n/es/journeys/review-builder-playbook.md index 5755192..07c9923 100644 --- a/_i18n/es/journeys/review-builder-playbook.md +++ b/_i18n/es/journeys/review-builder-playbook.md @@ -128,8 +128,8 @@ El reporte automático del playbook permite ver: - Distribución de calificaciones. - Texto de la reseña. - Adjuntos de la reseña como URLs de imágenes o videos cuando estén disponibles. -- Perfil de cliente e identificador del cliente en ecommerce cuando estén disponibles. -- Nombre del producto e identificador del producto en ecommerce cuando estén disponibles. +- Perfil de cliente e identificador del cliente en eCommerce cuando estén disponibles. +- Nombre del producto e identificador del producto en eCommerce cuando estén disponibles. - Fecha y hora de la reseña. - Un link a la conversación donde se dejó la reseña. diff --git a/_i18n/es/journeys/soft-reactivation-playbook.md b/_i18n/es/journeys/soft-reactivation-playbook.md index c53526f..aeecd9f 100644 --- a/_i18n/es/journeys/soft-reactivation-playbook.md +++ b/_i18n/es/journeys/soft-reactivation-playbook.md @@ -17,7 +17,7 @@ Puede: - Sugerir productos que podrían traer de vuelta al cliente según interés reciente o histórico. - Generar ejemplos de mensajes personalizados que se adaptan por cliente. - Permitir que tu equipo dé feedback en Playground para que Hellotext aprenda qué encaja con el negocio. -- Seguir reglas de oferta existentes del ecommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. +- Seguir reglas de oferta existentes del eCommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. - Buscar el canal más eficiente en costo entre los disponibles, como WhatsApp, SMS u otros, y enviar solo cuando detecta internamente una oportunidad con ROI saludable. - Omitir clientes cuando una compra reciente, otro playbook activo, falta de consentimiento, límites de canal o poco contexto de producto hacen que el envío no sea una buena idea. @@ -50,7 +50,7 @@ Revisa que: - Los productos o colecciones que quieres promover sean elegibles para mensajes de reactivación. - La audiencia que quieres alcanzar sea identificable y elegible para el canal seleccionado. - Las señales de compra, navegación, clicks, respuestas y bajas estén disponibles para que Hellotext evite envíos irrelevantes. -- Si se permiten descuentos, las reglas de oferta del ecommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. +- Si se permiten descuentos, las reglas de oferta del eCommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. - Tarjetas de producto, links de producto o mensajes enriquecidos funcionen en los canales que quieres usar. Para validar la configuración, usa [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}). Para tracking personalizado, usa [Seguimiento de eventos]({% link _developers/tracking-events.md %}). @@ -66,7 +66,7 @@ Las tarjetas disponibles pueden variar, pero la configuración propuesta se conc - **Canales de salida:** dónde Hellotext puede enviar o continuar el mensaje de reactivación. - **Audiencia:** qué audiencia o segmento puede recibir el playbook. - **Productos:** qué productos, colecciones, categorías o grupos puede usar el mensaje. -- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del ecommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del eCommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Tono o feedback en Playground:** cómo deberían aprender los ejemplos generados qué encaja con tu negocio. Mantén la selección automática de canales salvo que tengas una razón clara para limitar el playbook. Reactivación Suave depende de si el cliente puede ser alcanzado en un momento donde el empujón todavía se siente oportuno. Hellotext puede elegir internamente el canal más eficiente en costo, como WhatsApp, SMS u otros según disponibilidad, y evitar envíos cuando no detecta una oportunidad con ROI saludable. diff --git a/_i18n/es/journeys/sunset-saver-playbook.md b/_i18n/es/journeys/sunset-saver-playbook.md index e7ebf31..9490444 100644 --- a/_i18n/es/journeys/sunset-saver-playbook.md +++ b/_i18n/es/journeys/sunset-saver-playbook.md @@ -16,7 +16,7 @@ Puede: - Usar historial del cliente, contexto de producto, datos de catálogo, elegibilidad de canal y reglas de oferta antes de enviar un mensaje. - Generar un último mensaje personalizado con una razón clara para volver, como un producto relevante, una colección, una novedad o una oferta aprobada. - Permitir que tu equipo dé feedback en Playground para que Hellotext aprenda qué tono y estilo encajan con el negocio. -- Seguir reglas de oferta existentes del ecommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. +- Seguir reglas de oferta existentes del eCommerce, usar descuentos con IA hasta un porcentaje máximo aprobado o enviar sin descuentos. - Buscar el canal más eficiente en costo entre los disponibles, como WhatsApp, SMS u otros, y enviar solo cuando detecta internamente una oportunidad con ROI saludable. - Suprimir automáticamente futuros intentos de recuperación para ese perfil si el cliente no compra, responde o vuelve a mostrar una señal relevante. - Omitir clientes cuando no hay consentimiento, el perfil no puede ser alcanzado, otro playbook encaja mejor o no existe una razón suficientemente relevante para escribir. @@ -51,7 +51,7 @@ Revisa que: - Hellotext pueda distinguir clientes recientemente inactivos, clientes inactivos alrededor de 3 meses y clientes alrededor de 12 meses sin actividad o sin reactivarse. - Nombres, imágenes, precios, stock y links de producto estén actualizados si el mensaje puede incluir recomendaciones. - La audiencia que quieres alcanzar sea identificable y elegible para el canal seleccionado. -- Si se permiten descuentos, las reglas de oferta del ecommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. +- Si se permiten descuentos, las reglas de oferta del eCommerce y cualquier porcentaje máximo de descuento con IA estén aprobados antes del lanzamiento. - Tarjetas de producto, links de producto o mensajes enriquecidos funcionen en los canales que quieres usar. Para validar la configuración, usa [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}). Para tracking personalizado, usa [Seguimiento de eventos]({% link _developers/tracking-events.md %}). @@ -67,7 +67,7 @@ Las tarjetas disponibles pueden variar, pero la configuración propuesta se conc - **Canales de salida:** dónde Hellotext puede enviar o continuar el mensaje final. - **Audiencia:** qué audiencia o segmento puede recibir el playbook. - **Productos:** qué productos, colecciones, categorías o grupos puede usar el mensaje. -- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del ecommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. +- **Estrategia de descuento:** si el playbook sigue las reglas de oferta del eCommerce, puede usar descuentos con IA hasta un porcentaje máximo o envía sin descuentos. - **Tono o feedback en Playground:** cómo deberían aprender los ejemplos generados qué encaja con tu negocio. Mantén la selección automática de canales salvo que tengas una razón clara para limitar el playbook. Último Intento depende de encontrar un canal alcanzable y costo-eficiente para un cliente que ya lleva mucho tiempo inactivo. Hellotext puede elegir internamente el canal más eficiente en costo, como WhatsApp, SMS u otros según disponibilidad, y evitar envíos cuando no detecta una oportunidad con ROI saludable. diff --git a/_i18n/es/team/teams-and-inbox-capacity.md b/_i18n/es/team/teams-and-inbox-capacity.md index f87b682..a7fa3eb 100644 --- a/_i18n/es/team/teams-and-inbox-capacity.md +++ b/_i18n/es/team/teams-and-inbox-capacity.md @@ -109,3 +109,4 @@ Eliminar un equipo quita ese destino de las conversaciones que lo estaban espera - [Ciclo de una conversación en el Inbox]({% link _team/conversation-lifecycle.md %}) - [Derivación de IA al Inbox]({% link _team/ai-handoff-to-inbox.md %}) - [Tiempo de respuesta y reglas de respuesta]({% link _team/understanding-response-times.md %}) +- [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) diff --git a/_i18n/es/team/understanding-response-times.md b/_i18n/es/team/understanding-response-times.md index 4009113..191d0a4 100644 --- a/_i18n/es/team/understanding-response-times.md +++ b/_i18n/es/team/understanding-response-times.md @@ -117,6 +117,8 @@ Revisa conversaciones, equipos, colaboradores y reportes regularmente para detec ## Guías relacionadas +- [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Equipos y capacidad del Inbox]({% link _team/teams-and-inbox-capacity.md %}) - [Asigna conversaciones]({% link _team/assigning-conversations.md %}) - [Ciclo de una conversación en el Inbox]({% link _team/conversation-lifecycle.md %}) From ebfa32e5502963c420329a414b87bf2f0417e307 Mon Sep 17 00:00:00 2001 From: Martin Caetano Date: Sun, 2 Aug 2026 01:50:06 -0300 Subject: [PATCH 3/5] Add performance report guide links --- .../performance-report-guide.md | 19 +++ _config.yml | 1 + .../analytics-overview.md | 9 ++ .../dashboard-guide.md | 1 + .../data-completeness-and-reporting-gaps.md | 1 + .../performance-report-guide.md | 132 ++++++++++++++++++ .../sales-attribution.md | 1 + .../analytics-overview.md | 9 ++ .../dashboard-guide.md | 1 + .../data-completeness-and-reporting-gaps.md | 1 + .../performance-report-guide.md | 132 ++++++++++++++++++ .../sales-attribution.md | 1 + 12 files changed, 308 insertions(+) create mode 100644 _analytics-reporting-attribution/performance-report-guide.md create mode 100644 _i18n/en/analytics-reporting-attribution/performance-report-guide.md create mode 100644 _i18n/es/analytics-reporting-attribution/performance-report-guide.md diff --git a/_analytics-reporting-attribution/performance-report-guide.md b/_analytics-reporting-attribution/performance-report-guide.md new file mode 100644 index 0000000..52f6ab7 --- /dev/null +++ b/_analytics-reporting-attribution/performance-report-guide.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Performance report guide + description: Understand conversation conversion, time to conversion, escalation, available breakdowns, and recent results. +es: + title: Guía del Reporte de rendimiento + description: Entiende conversión de conversaciones, tiempo de conversión, Derivación, desgloses disponibles y resultados recientes. + +permalink: performance-report-guide +permalink_es: guia-reporte-rendimiento + +layout: guide +topic: analytics-reporting-attribution +popular: false +--- + +{% translate_file analytics-reporting-attribution/performance-report-guide.md %} diff --git a/_config.yml b/_config.yml index f536f3e..925ac41 100644 --- a/_config.yml +++ b/_config.yml @@ -88,6 +88,7 @@ collections: - analytics-overview.md - dashboard-guide.md - revenue-report-guide.md + - performance-report-guide.md - service-quality-report-guide.md - workload-capacity-report-guide.md - data-completeness-and-reporting-gaps.md diff --git a/_i18n/en/analytics-reporting-attribution/analytics-overview.md b/_i18n/en/analytics-reporting-attribution/analytics-overview.md index bed4bea..7e0fffd 100644 --- a/_i18n/en/analytics-reporting-attribution/analytics-overview.md +++ b/_i18n/en/analytics-reporting-attribution/analytics-overview.md @@ -14,6 +14,14 @@ Use it when you need to compare revenue attributed to AI or classified as team-m Keep reading: [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}). +## Performance report + +The Performance report follows conversations from their start through later conversion and escalation outcomes. + +Use it when you need to compare conversion rate, time to conversion, escalation rate, and AI-only versus team-managed conversion paths. + +Keep reading: [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}). + ## Campaign reports Campaign reports help you review delivery, engagement, clicks, conversions, replies, and attributed revenue for a one-time send. @@ -82,6 +90,7 @@ If you are reviewing your first launch, start with [Measure success in your firs - [Measure success in your first 7 days]({% link _getting-started/measure-success-first-7-days.md %}) - [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/dashboard-guide.md b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md index 87bd793..9ff6950 100644 --- a/_i18n/en/analytics-reporting-attribution/dashboard-guide.md +++ b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md @@ -146,6 +146,7 @@ Recent report results can change while attribution remains open or late data arr - [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Understand response times]({% link _team/understanding-response-times.md %}) - [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index d906269..febc013 100644 --- a/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -221,6 +221,7 @@ If the event itself is missing, follow [Troubleshoot missing signals or activity - [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) - [Analytics overview]({% link _analytics-reporting-attribution/analytics-overview.md %}) - [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/performance-report-guide.md b/_i18n/en/analytics-reporting-attribution/performance-report-guide.md new file mode 100644 index 0000000..f142c3d --- /dev/null +++ b/_i18n/en/analytics-reporting-attribution/performance-report-guide.md @@ -0,0 +1,132 @@ +Use the Performance report to understand how conversations convert, how long conversion takes, and how often AI explicitly hands work to a teammate. + +Open it from the **Performance report** card under **Business Performance** on the Dashboard. + +## How this report counts results + +The selected period is based on when the conversation or interaction started. A conversion or escalation that happens later remains assigned to that originating start date. + +For example: **Conversation started April 7 → Escalated April 8 → Purchase completed April 10 → Counted on April 7.** + +This keeps the population consistent: the conversion rate, time to conversion, and escalation rate all follow conversations that started during the selected period. It avoids dividing purchases completed during one period by unrelated conversations that started during another. + +Recent dates can change while conversations remain open or their outcome window has not closed. Compare older periods when you need stable results, and compare recent periods at the same age. + +## Read the main metrics + +Select a metric to update the timeline and available breakdowns. + +### Conversion rate + +The percentage of conversations in the selected start-date population that resulted in a completed purchase recorded by Hellotext. + +The numerator and denominator follow the same originating population. A purchase completed later can increase the conversion rate on the earlier date when the conversation began. + +Conversion rate is not total store conversion. It covers the eligible conversation and interaction records available to this report. Use the Revenue report when you need purchases by purchase date or total recorded revenue. + +### Time to conversion + +The average time between the start of a conversation and its completed purchase among conversations with a recorded conversion. + +A lower value means conversions happened sooner for that population. It does not by itself mean the experience was better: product complexity, purchase consideration, channel, campaign, and Playbook can all change the expected time. + +### Escalation rate + +The percentage of conversations where AI explicitly requested a human takeover, regardless of the reason. + +Human participation alone does not count as an escalation. A teammate can reply, claim ownership, or help during a conversation without changing this metric when AI did not request the handoff. + +An escalation is not automatically a failure. Sales and support Playbooks can escalate because the customer is upset, reports a defective product, needs an unsupported answer, matches an escalation rule, or requires a person or team to continue. + +Read [AI handoff to Inbox]({% link _team/ai-handoff-to-inbox.md %}) for the available handoff paths. + +## Use the breakdowns + +The available breakdowns depend on the selected metric. + +For **Conversion rate** and **Time to conversion**, compare by: + +- channel; +- Playbook; +- Campaign; or +- AI versus human. + +For **Escalation rate**, compare by: + +- channel; +- Playbook; +- Campaign; +- reason; +- team; +- teammate; or +- AI agent. + +Use one dimension at a time when investigating a change. A channel difference can come from customer intent or purchase behavior; a Playbook difference can come from its mission; and a team difference can come from which escalations it receives. + +## Understand Time to conversion distribution + +The distribution separates converted conversations into **AI-Only** and **Team-managed** paths. + +- **AI-Only:** the conversion path did not include an explicit AI escalation. A teammate may still have participated without taking over through an escalation. +- **Team-managed:** AI explicitly escalated the conversation before the outcome. + +Each chart shows the share and number of conversations that converted: + +- the same day; +- in 1–3 days; +- in 4–7 days; +- in 8–30 days; or +- after more than 30 days. + +Use the distribution together with the average. Two periods can have a similar average while one contains many same-day conversions and a smaller group of very late conversions. + +## Compare Performance with other reports + +Use the report whose date basis answers your question: + +| Question | Report | +| --- | --- | +| How did conversations that started during this period eventually perform? | Performance report | +| How much revenue was purchased during this period? | Revenue report | +| How did one Playbook trigger population perform? | Playbook report | +| How did one Campaign delivery population perform? | Campaign report | +| How were conversations resolved and did they meet SLA? | Service quality report | + +The same purchase can appear on different dates across these reports by design. Performance uses conversation start date, Revenue uses purchase date, and source reports use their own trigger or delivery date. + +## Turn the report into an action + +| If you see... | Review... | +| --- | --- | +| Conversion rate falling | Channel, Playbook, Campaign, AI versus human path, purchase signals, and whether orders connect to the correct customer profile. | +| Time to conversion increasing | The distribution, channel mix, purchase complexity, delayed follow-up, and whether escalations wait too long for a teammate. | +| Escalation rate increasing | Reason, Playbook, AI agent, channel, team destination, missing knowledge, and escalation rules. | +| One Playbook converts well but slowly | Whether the longer consideration period is expected for its mission before changing message timing or logic. | +| One team receives many escalations | Routing destinations, team capacity, repeated customer intents, and whether AI should resolve more of those requests. | +| Recent conversion is lower than usual | Whether the compared conversations have had equal time to convert before drawing a conclusion. | + +Open representative conversations before changing a Playbook, prompt, knowledge source, routing rule, or team destination. The report identifies a pattern; the conversation and attribution history explain the cause. + +## When data is missing or unexpected + +Confirm that: + +- conversation or interaction starts are recorded with the correct timestamp; +- purchases arrive from the connected eCommerce source and connect to the correct customer profile; +- eligible purchases are linked to the originating interaction under Hellotext's attribution rules; +- Playbook, Campaign, channel, AI agent, team, and teammate context is present where expected; +- explicit AI handoffs record an escalation event and destination; and +- both comparisons use the same date range, timezone, metric, and breakdown. + +If a purchase appears in Revenue but not in Performance, check whether it has an eligible originating interaction. If the source records exist but the report remains inconsistent, follow [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Related guides + +- [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [AI handoff to Inbox]({% link _team/ai-handoff-to-inbox.md %}) +- [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/sales-attribution.md b/_i18n/en/analytics-reporting-attribution/sales-attribution.md index 7d68726..011c5dd 100644 --- a/_i18n/en/analytics-reporting-attribution/sales-attribution.md +++ b/_i18n/en/analytics-reporting-attribution/sales-attribution.md @@ -150,6 +150,7 @@ The revenue remains merchant revenue but is not attributed to Hellotext. ## Related guides +- [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/analytics-overview.md b/_i18n/es/analytics-reporting-attribution/analytics-overview.md index b0272e5..e8652a5 100644 --- a/_i18n/es/analytics-reporting-attribution/analytics-overview.md +++ b/_i18n/es/analytics-reporting-attribution/analytics-overview.md @@ -14,6 +14,14 @@ El Reporte de ingresos muestra las compras completadas durante el período selec Sigue leyendo: [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}). +## Reporte de rendimiento + +El Reporte de rendimiento sigue las conversaciones desde su inicio hasta resultados posteriores de conversión y Derivación. + +Úsalo cuando necesites comparar tasa de conversión, tiempo de conversión, tasa de Derivación y caminos de conversión Solo IA frente a Gestionado por el equipo. + +Sigue leyendo: [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}). + ## Reportes de campañas Los reportes de campaña te ayudan a revisar entrega, interacción, clicks, conversiones, respuestas e ingresos atribuidos para un envío puntual. @@ -82,6 +90,7 @@ Si estás revisando tu primer lanzamiento, empieza por [Mide el éxito en tus pr - [Mide el éxito en tus primeros 7 días]({% link _getting-started/measure-success-first-7-days.md %}) - [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/dashboard-guide.md b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md index 9bcbae7..6db7833 100644 --- a/_i18n/es/analytics-reporting-attribution/dashboard-guide.md +++ b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md @@ -146,6 +146,7 @@ Los resultados recientes pueden cambiar mientras la atribución siga abierta o l - [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Cómo interpretar los tiempos de respuesta]({% link _team/understanding-response-times.md %}) - [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index edf493b..f208e63 100644 --- a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -221,6 +221,7 @@ Si falta el evento, primero sigue [Soluciona señales o actividad faltante]({% l - [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) - [Resumen de analítica, reportes y atribución]({% link _analytics-reporting-attribution/analytics-overview.md %}) - [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/performance-report-guide.md b/_i18n/es/analytics-reporting-attribution/performance-report-guide.md new file mode 100644 index 0000000..f658705 --- /dev/null +++ b/_i18n/es/analytics-reporting-attribution/performance-report-guide.md @@ -0,0 +1,132 @@ +Usa el Reporte de rendimiento para entender cómo convierten las conversaciones, cuánto demora la conversión y con qué frecuencia la IA deriva explícitamente el trabajo a un colaborador. + +Ábrelo desde la tarjeta **Reporte de rendimiento** dentro de **Rendimiento del negocio** en el Dashboard. + +## Cómo cuenta los resultados este reporte + +El período seleccionado se basa en cuándo comenzó la conversación o interacción. Una conversión o Derivación posterior permanece asignada a esa fecha de inicio. + +Por ejemplo: **Conversación iniciada el 7 de abril → Derivada el 8 de abril → Compra completada el 10 de abril → Cuenta el 7 de abril.** + +Esto mantiene una población consistente: la tasa de conversión, el tiempo de conversión y la tasa de Derivación siguen las conversaciones iniciadas durante el período seleccionado. Así se evita dividir compras completadas en un período entre conversaciones no relacionadas que comenzaron en otro. + +Las fechas recientes pueden cambiar mientras las conversaciones sigan abiertas o su ventana de resultados no haya cerrado. Compara períodos anteriores cuando necesites resultados estables y compara períodos recientes con la misma antigüedad. + +## Interpreta las métricas principales + +Selecciona una métrica para actualizar la línea de tiempo y los desgloses disponibles. + +### Tasa de conversión + +Es el porcentaje de conversaciones dentro de la población seleccionada por fecha de inicio que resultó en una compra completada y registrada por Hellotext. + +El numerador y denominador siguen la misma población de origen. Una compra completada después puede aumentar la tasa de conversión de la fecha anterior en que comenzó la conversación. + +La tasa de conversión no es la conversión total de la tienda. Incluye los registros elegibles de conversaciones e interacciones disponibles para este reporte. Usa el Reporte de ingresos cuando necesites compras por fecha de compra o los ingresos totales registrados. + +### Tiempo de conversión + +Es el tiempo promedio entre el inicio de una conversación y su compra completada entre las conversaciones con una conversión registrada. + +Un valor menor significa que las conversiones ocurrieron antes para esa población. Por sí solo no significa que la experiencia haya sido mejor: la complejidad del producto, consideración de compra, canal, Campaña y Playbook pueden cambiar el tiempo esperado. + +### Tasa de Derivación + +Es el porcentaje de conversaciones donde la IA solicitó explícitamente que una persona tomara el control, sin importar el motivo. + +La participación humana por sí sola no cuenta como Derivación. Un colaborador puede responder, tomar responsabilidad o ayudar durante una conversación sin cambiar esta métrica cuando la IA no solicitó el traspaso. + +Una Derivación no es automáticamente una falla. Los Playbooks de venta y atención pueden derivar porque el cliente está enojado, informa un producto defectuoso, necesita una respuesta no compatible, coincide con una regla de Derivación o requiere que una persona o equipo continúe. + +Consulta [Derivación de IA al Inbox]({% link _team/ai-handoff-to-inbox.md %}) para conocer las formas disponibles de Derivación. + +## Usa los desgloses + +Los desgloses disponibles dependen de la métrica seleccionada. + +Para **Tasa de conversión** y **Tiempo de conversión**, compara por: + +- canal; +- Playbook; +- Campaña; o +- IA frente a humano. + +Para **Tasa de Derivación**, compara por: + +- canal; +- Playbook; +- Campaña; +- motivo; +- equipo; +- colaborador; o +- agente de IA. + +Usa una dimensión por vez cuando investigues un cambio. Una diferencia por canal puede venir de la intención del cliente o su comportamiento de compra; una diferencia por Playbook puede venir de su misión; y una diferencia por equipo puede venir del tipo de Derivaciones que recibe. + +## Entiende la distribución del Tiempo de conversión + +La distribución separa las conversaciones convertidas entre **Solo IA** y **Gestionado por el equipo**. + +- **Solo IA:** el camino de conversión no incluyó una Derivación explícita de IA. Un colaborador todavía puede haber participado sin tomar el control mediante una Derivación. +- **Gestionado por el equipo:** la IA derivó explícitamente la conversación antes del resultado. + +Cada gráfico muestra la proporción y cantidad de conversaciones que convirtieron: + +- el mismo día; +- en 1–3 días; +- en 4–7 días; +- en 8–30 días; o +- después de más de 30 días. + +Usa la distribución junto con el promedio. Dos períodos pueden tener un promedio similar aunque uno contenga muchas conversiones en el mismo día y un grupo menor de conversiones muy tardías. + +## Compara Rendimiento con otros reportes + +Usa el reporte cuya base temporal responda tu pregunta: + +| Pregunta | Reporte | +| --- | --- | +| ¿Cómo rindieron finalmente las conversaciones iniciadas durante este período? | Reporte de rendimiento | +| ¿Cuántos ingresos se compraron durante este período? | Reporte de ingresos | +| ¿Cómo rindió la población activada por un Playbook específico? | Reporte del Playbook | +| ¿Cómo rindió la población que recibió una Campaña específica? | Reporte de la Campaña | +| ¿Cómo se resolvieron las conversaciones y cumplieron el SLA? | Reporte de calidad de servicio | + +La misma compra puede aparecer en fechas diferentes entre estos reportes por diseño. Rendimiento usa la fecha de inicio de la conversación, Ingresos usa la fecha de compra y los reportes de fuentes usan su propia fecha de activación o entrega. + +## Convierte el reporte en una acción + +| Si ves... | Revisa... | +| --- | --- | +| Baja la Tasa de conversión | Canal, Playbook, Campaña, camino de IA frente a humano, señales de compra y si los pedidos se conectan con el perfil de cliente correcto. | +| Aumenta el Tiempo de conversión | Distribución, mezcla de canales, complejidad de compra, seguimiento demorado y si las Derivaciones esperan demasiado a un colaborador. | +| Aumenta la Tasa de Derivación | Motivo, Playbook, agente de IA, canal, equipo de destino, conocimiento faltante y reglas de Derivación. | +| Un Playbook convierte bien pero lentamente | Si el período de consideración más largo es esperable para su misión antes de cambiar mensajes o lógica. | +| Un equipo recibe muchas Derivaciones | Destinos de enrutamiento, capacidad del equipo, intenciones repetidas y si la IA debería resolver más de esas solicitudes. | +| La conversión reciente parece más baja | Si las conversaciones comparadas tuvieron el mismo tiempo para convertir antes de sacar una conclusión. | + +Abre conversaciones representativas antes de cambiar un Playbook, prompt, fuente de conocimiento, regla de enrutamiento o equipo de destino. El reporte identifica un patrón; el historial de la conversación y atribución explica la causa. + +## Cuando faltan datos o parecen incorrectos + +Confirma que: + +- los inicios de conversaciones o interacciones estén registrados con la fecha correcta; +- las compras lleguen desde la fuente de eCommerce conectada y se vinculen con el perfil de cliente correcto; +- las compras elegibles se relacionen con la interacción de origen según las reglas de atribución de Hellotext; +- el contexto de Playbook, Campaña, canal, agente de IA, equipo y colaborador esté presente cuando corresponda; +- las Derivaciones explícitas de IA registren el evento y destino; y +- ambas comparaciones usen el mismo período, zona horaria, métrica y desglose. + +Si una compra aparece en Ingresos pero no en Rendimiento, revisa si tiene una interacción de origen elegible. Si los registros de origen existen pero el reporte sigue siendo inconsistente, consulta [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Guías relacionadas + +- [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) +- [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) +- [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) +- [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Derivación de IA al Inbox]({% link _team/ai-handoff-to-inbox.md %}) +- [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/sales-attribution.md b/_i18n/es/analytics-reporting-attribution/sales-attribution.md index 98602c9..5450858 100644 --- a/_i18n/es/analytics-reporting-attribution/sales-attribution.md +++ b/_i18n/es/analytics-reporting-attribution/sales-attribution.md @@ -150,6 +150,7 @@ Los ingresos permanecen en los ingresos del comercio, pero no se atribuyen a Hel ## Guías relacionadas +- [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) - [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) From f5ab9dae81ecc17649e53ff8adb854fcc657d640 Mon Sep 17 00:00:00 2001 From: Martin Caetano Date: Sun, 2 Aug 2026 02:12:59 -0300 Subject: [PATCH 4/5] Add demand insights documentation links --- .../demand-insights-guide.md | 19 +++ _config.yml | 1 + .../analytics-overview.md | 9 ++ .../dashboard-guide.md | 1 + .../data-completeness-and-reporting-gaps.md | 1 + .../demand-insights-guide.md | 143 ++++++++++++++++++ .../analytics-overview.md | 9 ++ .../dashboard-guide.md | 1 + .../data-completeness-and-reporting-gaps.md | 1 + .../demand-insights-guide.md | 143 ++++++++++++++++++ 10 files changed, 328 insertions(+) create mode 100644 _analytics-reporting-attribution/demand-insights-guide.md create mode 100644 _i18n/en/analytics-reporting-attribution/demand-insights-guide.md create mode 100644 _i18n/es/analytics-reporting-attribution/demand-insights-guide.md diff --git a/_analytics-reporting-attribution/demand-insights-guide.md b/_analytics-reporting-attribution/demand-insights-guide.md new file mode 100644 index 0000000..106d143 --- /dev/null +++ b/_analytics-reporting-attribution/demand-insights-guide.md @@ -0,0 +1,19 @@ +--- +languages: ["en", "es"] + +en: + title: Demand insights guide + description: Understand unfulfilled product requests, estimated missed revenue, affected products, and unfulfilled demand rate. +es: + title: Guía de Insights de demanda + description: Entiende solicitudes de producto no satisfechas, ingresos perdidos estimados, productos afectados y tasa de demanda no satisfecha. + +permalink: demand-insights-guide +permalink_es: guia-insights-demanda + +layout: guide +topic: analytics-reporting-attribution +popular: false +--- + +{% translate_file analytics-reporting-attribution/demand-insights-guide.md %} diff --git a/_config.yml b/_config.yml index 925ac41..77787f0 100644 --- a/_config.yml +++ b/_config.yml @@ -89,6 +89,7 @@ collections: - dashboard-guide.md - revenue-report-guide.md - performance-report-guide.md + - demand-insights-guide.md - service-quality-report-guide.md - workload-capacity-report-guide.md - data-completeness-and-reporting-gaps.md diff --git a/_i18n/en/analytics-reporting-attribution/analytics-overview.md b/_i18n/en/analytics-reporting-attribution/analytics-overview.md index 7e0fffd..2224020 100644 --- a/_i18n/en/analytics-reporting-attribution/analytics-overview.md +++ b/_i18n/en/analytics-reporting-attribution/analytics-overview.md @@ -22,6 +22,14 @@ Use it when you need to compare conversion rate, time to conversion, escalation Keep reading: [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}). +## Demand insights + +Demand insights identifies product requests that could not be fulfilled, the products and variants affected, and the estimated value of those missed opportunities. + +Use it when you need to prioritize inventory, catalog, availability, or alternative-recommendation problems based on observed customer demand. + +Keep reading: [Demand insights guide]({% link _analytics-reporting-attribution/demand-insights-guide.md %}). + ## Campaign reports Campaign reports help you review delivery, engagement, clicks, conversions, replies, and attributed revenue for a one-time send. @@ -91,6 +99,7 @@ If you are reviewing your first launch, start with [Measure success in your firs - [Measure success in your first 7 days]({% link _getting-started/measure-success-first-7-days.md %}) - [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Demand insights guide]({% link _analytics-reporting-attribution/demand-insights-guide.md %}) - [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/dashboard-guide.md b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md index 9ff6950..349431e 100644 --- a/_i18n/en/analytics-reporting-attribution/dashboard-guide.md +++ b/_i18n/en/analytics-reporting-attribution/dashboard-guide.md @@ -147,6 +147,7 @@ Recent report results can change while attribution remains open or late data arr - [Playbook reporting]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Demand insights guide]({% link _analytics-reporting-attribution/demand-insights-guide.md %}) - [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Understand response times]({% link _team/understanding-response-times.md %}) - [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index febc013..3a5a834 100644 --- a/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_i18n/en/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -222,6 +222,7 @@ If the event itself is missing, follow [Troubleshoot missing signals or activity - [Analytics overview]({% link _analytics-reporting-attribution/analytics-overview.md %}) - [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Demand insights guide]({% link _analytics-reporting-attribution/demand-insights-guide.md %}) - [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %}) diff --git a/_i18n/en/analytics-reporting-attribution/demand-insights-guide.md b/_i18n/en/analytics-reporting-attribution/demand-insights-guide.md new file mode 100644 index 0000000..a47639a --- /dev/null +++ b/_i18n/en/analytics-reporting-attribution/demand-insights-guide.md @@ -0,0 +1,143 @@ +Use Demand insights to understand what customers tried to buy but could not, which products were affected, and the estimated value of those missed opportunities. + +Open it from the **Demand insights** card under **Business Performance** on the Dashboard. + +## What an unfulfilled request means + +An unfulfilled request is a product-related customer request that Hellotext identified with a supported unavailability reason, such as an out-of-stock product or an unavailable size. + +It is not the same as: + +- an open conversation in Inbox; +- a support question that AI could not answer; +- an AI escalation to a teammate; or +- every product question a customer asks. + +The report needs a supported demand signal and enough product or commerce context to classify the request. A conversation does not become unfulfilled demand merely because it ended without a purchase. + +## How this report counts results + +The selected period is based on when the unfulfilled request began. A later eligible recovery remains connected to that originating request and can update the earlier result. + +For example: **Product request began April 7 → Product became available and customer purchased April 9 → Recovery remains connected to April 7.** + +Recent dates can change while requests remain inside their recovery window. Compare older periods when you need stable results, and compare recent periods at the same age. + +## Read the main metrics + +Select a metric to update the timeline and available breakdowns. + +### Unfulfilled + +The number of supported product requests that Hellotext could not fulfill for the customer. + +One customer can generate more than one request when they ask for different products or variants. This is request volume, not necessarily a count of unique customers or conversations. + +### Lost revenue + +The estimated value associated with purchase requests that could not be completed. + +Hellotext uses the product, value, and commerce context available for the request to estimate the opportunity. This value is directional: + +- it is not completed revenue; +- it is not attributed revenue; +- it does not prove the customer would have purchased; and +- incomplete product or price context can limit the estimate. + +Use it to prioritize repeated and valuable demand patterns, not to reconcile booked sales. + +### Affected SKUs + +The number of unique products or variants connected to at least one unfulfilled demand signal. + +This metric separates breadth from volume. Ten requests for one product create more request volume but do not represent ten affected SKUs. + +### Unfulfilled rate + +The percentage of eligible product-related requests that could not be fulfilled. + +The denominator is the eligible product-demand population, not all Inbox conversations. Review the request count with the rate: a large percentage from a very small population needs different action than the same percentage across thousands of requests. + +## Use the breakdowns + +The available breakdowns depend on the selected metric. + +For **Unfulfilled**, compare by: + +- reason; +- product category; +- product or variant; +- store or region; +- channel; +- AI versus human; +- intent; or +- commerce context. + +For **Lost revenue**, compare by reason, product category, product, variant, store, region, channel, or AI versus human. + +For **Affected SKUs**, compare by product category, reason, store, region, channel, or AI versus human. + +For **Unfulfilled rate**, compare by reason, product category, store, region, channel, or AI versus human. + +Use one dimension at a time when investigating a change. A product category can contain many individual availability problems, while a commerce-context difference can point to catalog or inventory data that is available in one sales environment but missing in another. + +## Understand reasons and commerce context + +The **reason** breakdown groups requests by the supported cause of unfulfillment. Examples can include out of stock or a requested size being unavailable. + +The percentage for a reason represents its share of unfulfilled requests. The count shows how many requests carried that reason. + +**Commerce context** identifies where the purchase was taking place, such as eCommerce, retail, or a marketplace. It helps distinguish a broad product problem from one limited to a store, catalog, or sales environment. + +Do not interpret a missing reason or context as zero demand. It can mean the underlying request arrived without enough structured information for that breakdown. + +## Compare Demand insights with other reports + +| Question | Report | +| --- | --- | +| What did customers try to buy but could not? | Demand insights | +| Which conversations remain unresolved or failed SLA? | Service quality report | +| Which current conversations are waiting for the team? | Workload & capacity report | +| Which completed purchases and revenue were recorded? | Revenue report | +| How did conversations convert after they started? | Performance report | + +Demand insights describes missed product opportunity. It does not replace inventory reporting from the commerce platform or operational conversation reporting from Inbox. + +## Turn the report into an action + +| If you see... | Review... | +| --- | --- | +| Out-of-stock requests concentrated on a product | Inventory timing, catalog synchronization, and whether Back-in-Stock Pounce can notify interested customers when stock returns. | +| Size or variant availability dominates | Variant depth, size availability, catalog data, and alternative recommendations. | +| Lost revenue concentrated in a few products | Replenishment priority, pricing context, recoverability, and repeated customer demand. | +| One commerce context performs worse | Inventory and catalog data for that store, marketplace, or eCommerce integration. | +| Unfulfilled rate rises while request volume is stable | Product mix, reasons, affected categories, and recent inventory changes. | +| Many requests lack product or value detail | Catalog identifiers, variant data, price, currency, intent classification, and integration context. | + +Open representative conversations and verify the source catalog before changing inventory, a Playbook, or product recommendations. The report identifies a demand pattern; the conversation and commerce records explain it. + +## When data is missing or unexpected + +Confirm that: + +- the connected eCommerce, marketplace, or retail source provides current catalog and inventory context; +- customer requests carry a supported unavailability reason; +- product and variant identifiers match the connected catalog; +- price, value, and currency are present when Lost revenue should be estimated; +- store, region, channel, intent, and commerce context are recorded when you use those breakdowns; +- AI or teammate handling context is available for the AI-versus-human comparison; and +- both comparisons use the same date range, timezone, metric, and breakdown. + +If the customer asked for a product but no supported unfulfilled-demand signal exists, troubleshoot the source Playbook, integration, or tracking path first. If the source records exist but the report remains inconsistent, follow [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Related guides + +- [Dashboard guide]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Performance report guide]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Service quality report guide]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Workload & capacity report guide]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) +- [Back-in-Stock Pounce playbook]({% link _journeys/back-in-stock-pounce.md %}) +- [Smart Recommender playbook]({% link _journeys/smart-recommender-playbook.md %}) +- [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}) +- [Data completeness and reporting gaps]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/analytics-overview.md b/_i18n/es/analytics-reporting-attribution/analytics-overview.md index e8652a5..912dde1 100644 --- a/_i18n/es/analytics-reporting-attribution/analytics-overview.md +++ b/_i18n/es/analytics-reporting-attribution/analytics-overview.md @@ -22,6 +22,14 @@ El Reporte de rendimiento sigue las conversaciones desde su inicio hasta resulta Sigue leyendo: [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}). +## Insights de demanda + +Insights de demanda identifica solicitudes de producto que no pudieron satisfacerse, los productos y variantes afectados y el valor estimado de esas oportunidades perdidas. + +Úsalo cuando necesites priorizar problemas de inventario, catálogo, disponibilidad o recomendaciones alternativas a partir de la demanda observada de clientes. + +Sigue leyendo: [Guía de Insights de demanda]({% link _analytics-reporting-attribution/demand-insights-guide.md %}). + ## Reportes de campañas Los reportes de campaña te ayudan a revisar entrega, interacción, clicks, conversiones, respuestas e ingresos atribuidos para un envío puntual. @@ -91,6 +99,7 @@ Si estás revisando tu primer lanzamiento, empieza por [Mide el éxito en tus pr - [Mide el éxito en tus primeros 7 días]({% link _getting-started/measure-success-first-7-days.md %}) - [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Guía de Insights de demanda]({% link _analytics-reporting-attribution/demand-insights-guide.md %}) - [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/dashboard-guide.md b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md index 6db7833..99f20f6 100644 --- a/_i18n/es/analytics-reporting-attribution/dashboard-guide.md +++ b/_i18n/es/analytics-reporting-attribution/dashboard-guide.md @@ -147,6 +147,7 @@ Los resultados recientes pueden cambiar mientras la atribución siga abierta o l - [Reportes de playbooks]({% link _analytics-reporting-attribution/playbook-reporting.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) - [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Guía de Insights de demanda]({% link _analytics-reporting-attribution/demand-insights-guide.md %}) - [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Cómo interpretar los tiempos de respuesta]({% link _team/understanding-response-times.md %}) - [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index f208e63..551dba5 100644 --- a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -222,6 +222,7 @@ Si falta el evento, primero sigue [Soluciona señales o actividad faltante]({% l - [Resumen de analítica, reportes y atribución]({% link _analytics-reporting-attribution/analytics-overview.md %}) - [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) - [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Guía de Insights de demanda]({% link _analytics-reporting-attribution/demand-insights-guide.md %}) - [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) - [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) - [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}) diff --git a/_i18n/es/analytics-reporting-attribution/demand-insights-guide.md b/_i18n/es/analytics-reporting-attribution/demand-insights-guide.md new file mode 100644 index 0000000..e23694e --- /dev/null +++ b/_i18n/es/analytics-reporting-attribution/demand-insights-guide.md @@ -0,0 +1,143 @@ +Usa Insights de demanda para entender qué intentaron comprar los clientes sin poder hacerlo, qué productos fueron afectados y el valor estimado de esas oportunidades perdidas. + +Ábrelo desde la tarjeta **Insights de demanda** dentro de **Rendimiento del negocio** en el Dashboard. + +## Qué significa una solicitud no satisfecha + +Una solicitud no satisfecha es una solicitud de producto que Hellotext identificó con un motivo de falta de disponibilidad compatible, como un producto sin stock o un talle no disponible. + +No es lo mismo que: + +- una conversación abierta en el Inbox; +- una pregunta de atención que la IA no pudo responder; +- una Derivación de IA a un colaborador; ni +- cualquier consulta de producto de un cliente. + +El reporte necesita una señal de demanda compatible y suficiente contexto de producto o comercio para clasificar la solicitud. Una conversación no se convierte en demanda no satisfecha solamente porque terminó sin una compra. + +## Cómo cuenta los resultados este reporte + +El período seleccionado se basa en cuándo comenzó la solicitud no satisfecha. Una recuperación elegible posterior permanece conectada con esa solicitud de origen y puede actualizar el resultado anterior. + +Por ejemplo: **Solicitud de producto iniciada el 7 de abril → Producto disponible y compra realizada el 9 de abril → La recuperación permanece conectada con el 7 de abril.** + +Las fechas recientes pueden cambiar mientras las solicitudes sigan dentro de su ventana de recuperación. Compara períodos anteriores cuando necesites resultados estables y períodos recientes con la misma antigüedad. + +## Interpreta las métricas principales + +Selecciona una métrica para actualizar la línea de tiempo y los desgloses disponibles. + +### No resueltas + +Es la cantidad de solicitudes de producto compatibles que Hellotext no pudo satisfacer para el cliente. + +Un mismo cliente puede generar más de una solicitud cuando pregunta por diferentes productos o variantes. Este es un volumen de solicitudes, no necesariamente una cantidad de clientes únicos o conversaciones. + +### Ingresos perdidos + +Es el valor estimado asociado con solicitudes de compra que no pudieron completarse. + +Hellotext usa el contexto de producto, valor y comercio disponible para la solicitud para estimar la oportunidad. Este valor es orientativo: + +- no son ingresos completados; +- no son ingresos atribuidos; +- no demuestra que el cliente habría comprado; y +- un contexto incompleto de producto o precio puede limitar la estimación. + +Úsalo para priorizar patrones de demanda repetidos y valiosos, no para conciliar ventas registradas. + +### SKUs afectados + +Es la cantidad de productos o variantes únicos relacionados con al menos una señal de demanda no satisfecha. + +Esta métrica separa amplitud de volumen. Diez solicitudes para un mismo producto aumentan el volumen de solicitudes, pero no representan diez SKUs afectados. + +### Tasa no resuelta + +Es el porcentaje de solicitudes elegibles relacionadas con productos que no pudieron satisfacerse. + +El denominador es la población elegible de demanda de productos, no todas las conversaciones del Inbox. Revisa la cantidad de solicitudes junto con la tasa: un porcentaje alto sobre una población muy pequeña requiere una acción diferente al mismo porcentaje entre miles de solicitudes. + +## Usa los desgloses + +Los desgloses disponibles dependen de la métrica seleccionada. + +Para **No resueltas**, compara por: + +- motivo; +- categoría de producto; +- producto o variante; +- tienda o región; +- canal; +- IA frente a humano; +- intención; o +- contexto de comercio. + +Para **Ingresos perdidos**, compara por motivo, categoría de producto, producto, variante, tienda, región, canal o IA frente a humano. + +Para **SKUs afectados**, compara por categoría de producto, motivo, tienda, región, canal o IA frente a humano. + +Para **Tasa no resuelta**, compara por motivo, categoría de producto, tienda, región, canal o IA frente a humano. + +Usa una dimensión por vez cuando investigues un cambio. Una categoría puede contener varios problemas de disponibilidad individuales, mientras una diferencia por contexto de comercio puede señalar datos de catálogo o inventario disponibles en un entorno de venta pero faltantes en otro. + +## Entiende los motivos y el contexto de comercio + +El desglose por **motivo** agrupa solicitudes según la causa compatible de falta de disponibilidad. Algunos ejemplos son falta de stock o talle solicitado no disponible. + +El porcentaje de un motivo representa su proporción entre las solicitudes no satisfechas. La cantidad muestra cuántas solicitudes tienen ese motivo. + +El **contexto de comercio** identifica dónde ocurría la compra, como eCommerce, retail o un marketplace. Ayuda a distinguir un problema general de producto de uno limitado a una tienda, catálogo o entorno de venta. + +No interpretes un motivo o contexto faltante como demanda cero. Puede significar que la solicitud de origen llegó sin suficiente información estructurada para ese desglose. + +## Compara Insights de demanda con otros reportes + +| Pregunta | Reporte | +| --- | --- | +| ¿Qué intentaron comprar los clientes sin poder hacerlo? | Insights de demanda | +| ¿Qué conversaciones siguen sin resolver o incumplieron el SLA? | Reporte de calidad de servicio | +| ¿Qué conversaciones actuales esperan al equipo? | Reporte de carga y capacidad | +| ¿Qué compras e ingresos completados se registraron? | Reporte de ingresos | +| ¿Cómo convirtieron las conversaciones después de comenzar? | Reporte de rendimiento | + +Insights de demanda describe oportunidades de producto perdidas. No reemplaza los reportes de inventario de la plataforma de comercio ni los reportes operativos de conversaciones del Inbox. + +## Convierte el reporte en una acción + +| Si ves... | Revisa... | +| --- | --- | +| Solicitudes sin stock concentradas en un producto | Tiempos de inventario, sincronización del catálogo y si Vuelta a Stock puede notificar a los clientes interesados cuando regrese el stock. | +| Domina la falta de talles o variantes | Profundidad de variantes, disponibilidad de talles, datos del catálogo y recomendaciones alternativas. | +| Ingresos perdidos concentrados en pocos productos | Prioridad de reposición, contexto de precio, posibilidad de recuperación y demanda repetida. | +| Un contexto de comercio tiene peores resultados | Datos de inventario y catálogo de esa tienda, marketplace o integración de eCommerce. | +| Sube la Tasa no resuelta con un volumen estable | Mezcla de productos, motivos, categorías afectadas y cambios recientes de inventario. | +| Muchas solicitudes no tienen producto o valor | Identificadores del catálogo, datos de variantes, precio, moneda, clasificación de intención y contexto de integración. | + +Abre conversaciones representativas y verifica el catálogo de origen antes de cambiar inventario, un Playbook o recomendaciones de productos. El reporte identifica un patrón de demanda; la conversación y los registros de comercio lo explican. + +## Cuando faltan datos o parecen incorrectos + +Confirma que: + +- la fuente conectada de eCommerce, marketplace o retail proporcione información actual del catálogo e inventario; +- las solicitudes de clientes incluyan un motivo compatible de falta de disponibilidad; +- los identificadores de producto y variante coincidan con el catálogo conectado; +- precio, valor y moneda estén presentes cuando deban estimarse los Ingresos perdidos; +- tienda, región, canal, intención y contexto de comercio estén registrados al usar esos desgloses; +- el contexto de gestión por IA o colaborador esté disponible para la comparación entre IA y humano; y +- ambas comparaciones usen el mismo período, zona horaria, métrica y desglose. + +Si el cliente preguntó por un producto pero no existe una señal compatible de demanda no satisfecha, revisa primero el Playbook, integración o camino de tracking de origen. Si los registros existen pero el reporte sigue siendo inconsistente, consulta [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}). + +## Guías relacionadas + +- [Guía del Dashboard]({% link _analytics-reporting-attribution/dashboard-guide.md %}) +- [Guía del Reporte de rendimiento]({% link _analytics-reporting-attribution/performance-report-guide.md %}) +- [Guía del Reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %}) +- [Guía del Reporte de calidad de servicio]({% link _analytics-reporting-attribution/service-quality-report-guide.md %}) +- [Guía del Reporte de carga y capacidad]({% link _analytics-reporting-attribution/workload-capacity-report-guide.md %}) +- [Playbook Vuelta a Stock]({% link _journeys/back-in-stock-pounce.md %}) +- [Playbook Recomendador Inteligente]({% link _journeys/smart-recommender-playbook.md %}) +- [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}) +- [Integridad de datos y diferencias en reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) From e15100bfa60aedf79d7c179bad8b0647a16e1d68 Mon Sep 17 00:00:00 2001 From: Martin Caetano Date: Sun, 2 Aug 2026 02:22:36 -0300 Subject: [PATCH 5/5] Organize analytics documentation navigation and refine Spanish terms --- .../analytics-overview.md | 1 + .../campaign-reporting.md | 1 + .../dashboard-guide.md | 1 + .../data-completeness-and-reporting-gaps.md | 1 + .../demand-insights-guide.md | 1 + .../performance-report-guide.md | 1 + .../playbook-reporting.md | 1 + .../revenue-report-guide.md | 1 + .../sales-attribution.md | 1 + .../service-quality-report-guide.md | 1 + .../tracked-links.md | 1 + .../workload-capacity-report-guide.md | 1 + _data/guide_groups.yml | 17 +++++++++++++++++ _i18n/es.yml | 2 +- .../analytics-overview.md | 4 ++-- .../data-completeness-and-reporting-gaps.md | 4 ++-- .../playbook-reporting.md | 10 +++++----- .../sales-attribution.md | 2 +- 18 files changed, 40 insertions(+), 11 deletions(-) diff --git a/_analytics-reporting-attribution/analytics-overview.md b/_analytics-reporting-attribution/analytics-overview.md index 76c3796..7b70e2b 100644 --- a/_analytics-reporting-attribution/analytics-overview.md +++ b/_analytics-reporting-attribution/analytics-overview.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: foundations en: title: Analytics, reporting, and attribution overview diff --git a/_analytics-reporting-attribution/campaign-reporting.md b/_analytics-reporting-attribution/campaign-reporting.md index 065e508..16ebf0d 100644 --- a/_analytics-reporting-attribution/campaign-reporting.md +++ b/_analytics-reporting-attribution/campaign-reporting.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: source_reporting en: title: Campaign reporting diff --git a/_analytics-reporting-attribution/dashboard-guide.md b/_analytics-reporting-attribution/dashboard-guide.md index 715bf73..fbecf6d 100644 --- a/_analytics-reporting-attribution/dashboard-guide.md +++ b/_analytics-reporting-attribution/dashboard-guide.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: foundations en: title: Dashboard guide diff --git a/_analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index b84d26a..122747e 100644 --- a/_analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: measurement_attribution en: title: Data completeness and reporting gaps diff --git a/_analytics-reporting-attribution/demand-insights-guide.md b/_analytics-reporting-attribution/demand-insights-guide.md index 106d143..a8f11b6 100644 --- a/_analytics-reporting-attribution/demand-insights-guide.md +++ b/_analytics-reporting-attribution/demand-insights-guide.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: business_performance en: title: Demand insights guide diff --git a/_analytics-reporting-attribution/performance-report-guide.md b/_analytics-reporting-attribution/performance-report-guide.md index 52f6ab7..114cbba 100644 --- a/_analytics-reporting-attribution/performance-report-guide.md +++ b/_analytics-reporting-attribution/performance-report-guide.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: business_performance en: title: Performance report guide diff --git a/_analytics-reporting-attribution/playbook-reporting.md b/_analytics-reporting-attribution/playbook-reporting.md index 5eefdfc..9601bb9 100644 --- a/_analytics-reporting-attribution/playbook-reporting.md +++ b/_analytics-reporting-attribution/playbook-reporting.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: source_reporting en: title: Playbook reporting diff --git a/_analytics-reporting-attribution/revenue-report-guide.md b/_analytics-reporting-attribution/revenue-report-guide.md index 6d7923b..6324262 100644 --- a/_analytics-reporting-attribution/revenue-report-guide.md +++ b/_analytics-reporting-attribution/revenue-report-guide.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: business_performance en: title: Revenue report guide diff --git a/_analytics-reporting-attribution/sales-attribution.md b/_analytics-reporting-attribution/sales-attribution.md index e3265ad..62f4df8 100644 --- a/_analytics-reporting-attribution/sales-attribution.md +++ b/_analytics-reporting-attribution/sales-attribution.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: measurement_attribution en: title: How we attribute sales diff --git a/_analytics-reporting-attribution/service-quality-report-guide.md b/_analytics-reporting-attribution/service-quality-report-guide.md index 997a4e3..18c8a82 100644 --- a/_analytics-reporting-attribution/service-quality-report-guide.md +++ b/_analytics-reporting-attribution/service-quality-report-guide.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: operations_experience en: title: Service quality report guide diff --git a/_analytics-reporting-attribution/tracked-links.md b/_analytics-reporting-attribution/tracked-links.md index 8bf4157..1d86d54 100644 --- a/_analytics-reporting-attribution/tracked-links.md +++ b/_analytics-reporting-attribution/tracked-links.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: measurement_attribution en: title: Tracked links diff --git a/_analytics-reporting-attribution/workload-capacity-report-guide.md b/_analytics-reporting-attribution/workload-capacity-report-guide.md index 39d1f77..af9b112 100644 --- a/_analytics-reporting-attribution/workload-capacity-report-guide.md +++ b/_analytics-reporting-attribution/workload-capacity-report-guide.md @@ -1,5 +1,6 @@ --- languages: ["en", "es"] +navigation_group: operations_experience en: title: Workload & capacity report guide diff --git a/_data/guide_groups.yml b/_data/guide_groups.yml index e38e95f..13198ba 100644 --- a/_data/guide_groups.yml +++ b/_data/guide_groups.yml @@ -34,3 +34,20 @@ captures: - key: checkout en: Checkout opt-in es: Suscripción en checkout + +analytics-reporting-attribution: + - key: foundations + en: Start here + es: Primeros pasos + - key: business_performance + en: Business Performance + es: Rendimiento del negocio + - key: operations_experience + en: Operations & Experience + es: Operaciones & Experiencia + - key: source_reporting + en: Source reporting + es: Reportes por fuente + - key: measurement_attribution + en: Measurement & attribution + es: Medición y atribución diff --git a/_i18n/es.yml b/_i18n/es.yml index 21153d4..cd2ab50 100644 --- a/_i18n/es.yml +++ b/_i18n/es.yml @@ -19,7 +19,7 @@ audience: description: Organiza perfiles de cliente, crea segmentos y llega a los clientes correctos. analytics-reporting-attribution: title: Analítica, reportes y atribución - description: Entiende performance, reportes de campañas, ingresos atribuidos y reglas de medición. + description: Entiende rendimiento, reportes de campañas, ingresos atribuidos y reglas de medición. team: title: Inbox y conversaciones description: Gestiona respuestas, responsables, roles y salud de respuesta desde el inbox. diff --git a/_i18n/es/analytics-reporting-attribution/analytics-overview.md b/_i18n/es/analytics-reporting-attribution/analytics-overview.md index 912dde1..289a9a9 100644 --- a/_i18n/es/analytics-reporting-attribution/analytics-overview.md +++ b/_i18n/es/analytics-reporting-attribution/analytics-overview.md @@ -34,7 +34,7 @@ Sigue leyendo: [Guía de Insights de demanda]({% link _analytics-reporting-attri Los reportes de campaña te ayudan a revisar entrega, interacción, clicks, conversiones, respuestas e ingresos atribuidos para un envío puntual. -Usa reportes de campaña cuando necesites evaluar una campaña, comparar performance de mensajes o decidir qué mejorar antes de la próxima campaña. +Usa reportes de campaña cuando necesites evaluar una campaña, comparar el rendimiento de los mensajes o decidir qué mejorar antes de la próxima campaña. Sigue leyendo: [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %}). @@ -84,7 +84,7 @@ Sigue leyendo: ## Antes de comparar resultados -Al revisar performance, verifica: +Al revisar el rendimiento, verifica: - La audiencia y el canal usado. - Si los links y el tracking estaban configurados correctamente. diff --git a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md index 551dba5..f58edc3 100644 --- a/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md +++ b/_i18n/es/analytics-reporting-attribution/data-completeness-and-reporting-gaps.md @@ -43,7 +43,7 @@ El reporte o la sección debe explicar qué fecha utiliza. Estas son las reglas | Reporte de ingresos | Fecha de compra. Las filas de campañas y playbooks identifican la fuente acreditada para compras completadas durante el período seleccionado. | | Rendimiento de campañas | Fecha de entrega del mensaje. Los clicks y compras elegibles registrados después permanecen asignados a la entrega original. | | Reporte de un playbook | Fecha de activación del playbook. Los mensajes posteriores y las compras atribuidas permanecen asignados a la activación original. | -| Performance, Conversaciones y Calidad de servicio | Fecha de inicio de la conversación. La conversión, derivación, resolución y satisfacción posteriores siguen a la conversación de origen. | +| Rendimiento, Conversaciones y Calidad de servicio | Fecha de inicio de la conversación. La conversión, derivación, resolución y satisfacción posteriores siguen a la conversación de origen. | | Rendimiento de canales | Fecha de envío del mensaje. La entrega, interacción y ventas atribuidas posteriores siguen a esos mensajes. | | Insights de demanda | Fecha en que comenzó la solicitud no resuelta. La recuperación posterior sigue a la solicitud original. | | Reseñas y feedback | El feedback recibido usa la fecha de envío de la respuesta; el rendimiento de recopilación usa la fecha de entrega de la solicitud; los seguimientos pendientes muestran el estado actual. | @@ -125,7 +125,7 @@ Después de confirmar el evento, revisa si pertenece a la métrica que estás an - El playbook, ruta o agente debe estar activo y recibir tráfico elegible. - Debe registrarse el evento requerido de disparador, interacción, conversión, derivación o resolución. -- El reporte de un playbook selecciona las fechas de activación originales; un reporte de Performance selecciona las fechas de inicio de las conversaciones. Los resultados elegibles posteriores permanecen vinculados con esa actividad original. +- El reporte de un playbook selecciona las fechas de activación originales; el Reporte de rendimiento selecciona las fechas de inicio de las conversaciones. Los resultados elegibles posteriores permanecen vinculados con esa actividad original. - Un desglose por canal, playbook, IA frente a personas o equipo necesita esa dimensión en la actividad de origen. ### Reportes de operaciones diff --git a/_i18n/es/analytics-reporting-attribution/playbook-reporting.md b/_i18n/es/analytics-reporting-attribution/playbook-reporting.md index 1698f33..f3c4355 100644 --- a/_i18n/es/analytics-reporting-attribution/playbook-reporting.md +++ b/_i18n/es/analytics-reporting-attribution/playbook-reporting.md @@ -1,6 +1,6 @@ Usa esta guía después de que un playbook, agente de IA o ruta haya estado activo suficiente tiempo como para reunir actividad real de clientes. -Reportar un playbook no significa mirar un solo número. Revisa ingresos, performance, atribución y señales operativas juntas para entender si el playbook está creando valor, generando carga para el equipo o perdiendo las señales que necesita. +Reportar un playbook no significa mirar un solo número. Revisa ingresos, rendimiento, atribución y señales operativas juntas para entender si el playbook está creando valor, generando carga para el equipo o perdiendo las señales que necesita. ## Por dónde empezar @@ -8,7 +8,7 @@ Empieza por el reporte que responde la pregunta que tienes. Usa el reporte de **Ingresos** cuando quieres entender ventas atribuidas, la diferencia entre campañas y playbooks, y qué playbooks o rutas recibieron ingresos atribuidos. -Usa el reporte de **Performance** cuando quieres comparar tasa de conversión, tiempo hasta conversión y tasa de derivación entre playbooks, canales, campañas, conversaciones asistidas por IA y conversaciones asistidas por personas. +Usa el **Reporte de rendimiento** cuando quieras comparar tasa de conversión, tiempo hasta conversión y tasa de derivación entre playbooks, canales, campañas, conversaciones asistidas por IA y conversaciones asistidas por personas. Usa el **Inbox** y el historial de conversaciones cuando necesitas entender por qué un playbook derivó, qué preguntó el cliente y si la derivación le dio suficiente contexto al equipo. @@ -25,7 +25,7 @@ La misma compra puede aparecer en fechas diferentes entre reportes porque cada u - El **reporte específico de un playbook** usa la fecha en que se activó el playbook. Todas las métricas, gráficos y tablas siguen las ejecuciones activadas durante el período seleccionado. La actividad posterior de los mensajes y las compras atribuidas se agregan a la fecha de activación original. - El **resumen de Playbooks** usa la fecha de entrega del mensaje para medir resultados. Las compras elegibles posteriores permanecen asignadas a esas entregas. - El **Reporte de ingresos** usa la fecha de compra. Muestra las compras completadas durante el período seleccionado e identifica el playbook, campaña u otra fuente que recibió el crédito. -- El reporte de **Performance** usa la fecha de inicio de la conversación para sus resultados. La conversión, derivación y resolución posteriores permanecen asignadas a la conversación de origen. +- El **Reporte de rendimiento** usa la fecha de inicio de la conversación para sus resultados. La conversión, derivación y resolución posteriores permanecen asignadas a la conversación de origen. Por ejemplo: **Playbook activado el 7 de abril → Compra el 10 de abril → Cuenta el 7 de abril en el reporte del playbook y el 10 de abril en Ingresos.** @@ -51,9 +51,9 @@ Usa reportes de ingresos para responder preguntas como: Si un playbook tiene ingresos fuertes pero muchas derivaciones humanas, igual puede ser valioso. Revisa si esas derivaciones son esperadas, rentables y llegan a la persona o equipo correcto. -## Revisa performance y derivaciones +## Revisa rendimiento y derivaciones -Usa el reporte de Performance para entender si un playbook está sano, no solo si recibió ingresos atribuidos. +Usa el Reporte de rendimiento para entender si un playbook está sano, no solo si recibió ingresos atribuidos. Revisa: diff --git a/_i18n/es/analytics-reporting-attribution/sales-attribution.md b/_i18n/es/analytics-reporting-attribution/sales-attribution.md index 5450858..d3fa0d0 100644 --- a/_i18n/es/analytics-reporting-attribution/sales-attribution.md +++ b/_i18n/es/analytics-reporting-attribution/sales-attribution.md @@ -6,7 +6,7 @@ La métrica resultante son los **ingresos atribuidos**: ingresos vinculados a ac Una venta se atribuye cuando Hellotext recibe un evento de ingresos elegible y puede vincularlo con evidencia de origen compatible para el mismo cliente o pedido. -Los ingresos atribuidos se usan en reportes y, cuando corresponde, en la facturación basada en performance. Por sí solos, no significan que Hellotext haya causado todas las ventas atribuidas ni que el monto completo represente crecimiento incremental. +Los ingresos atribuidos se usan en reportes y, cuando corresponde, en la facturación basada en rendimiento. Por sí solos, no significan que Hellotext haya causado todas las ventas atribuidas ni que el monto completo represente crecimiento incremental. ## Evidencia y precedencia de fuentes