@vitrina/api 11.49.2 → 11.49.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -131339,6 +131339,8 @@ interface components {
131339
131339
  return: number | null;
131340
131340
  /** @description The recorded value of the accepted presupuestos / closed sales of the conversations the entity opened (CLP) — pipeline, never cash. `null` = unknown. */
131341
131341
  accepted_value?: number | null;
131342
+ /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
131343
+ accepted_count?: number | null;
131342
131344
  /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
131343
131345
  accepted_return?: number | null;
131344
131346
  /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
@@ -131403,6 +131405,8 @@ interface components {
131403
131405
  return: number | null;
131404
131406
  /** @description The recorded value of the accepted presupuestos / closed sales of the conversations the entity opened (CLP) — pipeline, never cash. `null` = unknown. */
131405
131407
  accepted_value?: number | null;
131408
+ /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
131409
+ accepted_count?: number | null;
131406
131410
  /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
131407
131411
  accepted_return?: number | null;
131408
131412
  /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
@@ -131478,6 +131482,8 @@ interface components {
131478
131482
  return: number | null;
131479
131483
  /** @description The recorded value of the accepted presupuestos / closed sales of the conversations the entity opened (CLP) — pipeline, never cash. `null` = unknown. */
131480
131484
  accepted_value?: number | null;
131485
+ /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
131486
+ accepted_count?: number | null;
131481
131487
  /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
131482
131488
  accepted_return?: number | null;
131483
131489
  /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
@@ -131573,6 +131579,8 @@ interface components {
131573
131579
  * @enum {string}
131574
131580
  */
131575
131581
  joins_state?: "ready" | "pending" | "unavailable";
131582
+ /** @description `false` when the attribution credit behind the joins could not be read in full (the engine returned its per-call maximum for a single day): the people, accepted-plan and first-payment figures may undercount. Say so next to them. On `current` only. */
131583
+ joins_complete?: boolean;
131576
131584
  };
131577
131585
  previous: {
131578
131586
  spend: number | null;
@@ -131615,6 +131623,8 @@ interface components {
131615
131623
  * @enum {string}
131616
131624
  */
131617
131625
  joins_state?: "ready" | "pending" | "unavailable";
131626
+ /** @description `false` when the attribution credit behind the joins could not be read in full (the engine returned its per-call maximum for a single day): the people, accepted-plan and first-payment figures may undercount. Say so next to them. On `current` only. */
131627
+ joins_complete?: boolean;
131618
131628
  };
131619
131629
  /** @description `grain=day` only: every day of the window, oldest first. */
131620
131630
  days?: components["schemas"]["AdsOverviewDay"][];
@@ -131700,6 +131710,8 @@ interface components {
131700
131710
  roas: number | null;
131701
131711
  direct_cash_value: number | null;
131702
131712
  inherited_cash_value: number | null;
131713
+ /** @description PEOPLE the campaign brought: the engine’s credited `lead_created` count when it sends counts per type, else the distinct people whose conversation one of its ads opened in the conversation window — each person once per campaign. `null` = unknown. */
131714
+ people?: number | null;
131703
131715
  /** @description Closes over the WHOLE period credited to this campaign: the outcomes Vitrina recorded at the closed stage (`closed_won`) with `occurred_at` in the period (America/Santiago days) that the attribution engine matched to an ad, each counted once on its largest-credit campaign — the same rows the feed shows as `stage: closed_won, matched: true` with this `ad.campaign`, so it does not move while paging the feed. `null` = unknown (never 0): the campaign credit is not available yet (it warms in the background; retry shortly), the campaign is outside the credited set read (the top 25 by outcomes), or the period starts more than 92 days ago. */
131704
131716
  closed_outcome_count: number | null;
131705
131717
  /** @description The campaign’s highest-spend ad among the top-50 scored ads of the creatives read (the rolling window nearest this range: 7d / 14d / 28d); `null` when unknown. */
@@ -131719,6 +131731,15 @@ interface components {
131719
131731
  conversational?: components["schemas"]["AdsConversational"];
131720
131732
  }[];
131721
131733
  coverage?: components["schemas"]["AdsCoverage"] & unknown;
131734
+ /** @description The rows reconciled with the headline, in PEOPLE. `null`/absent = not known yet (the credit is warming): print no remainder. */
131735
+ people?: {
131736
+ /** @description People from ads: exactly `/ads/overview` `current.attributed_people` for the same window. */
131737
+ attributed: number;
131738
+ /** @description Of `attributed`, the people whose ad credit is filed on one of the campaigns in `data`. */
131739
+ placed: number;
131740
+ /** @description `attributed − placed`: people from ads no row places yet. The only remainder Campañas prints. */
131741
+ unplaced: number;
131742
+ } | null;
131722
131743
  /** @description Measurement gaps overlapping the window (W1.1). Days inside a gap whose `metrics` list a figure carry NO measured value for it — the engine may report 0 there; render «sin datos», never the 0. */
131723
131744
  gaps: components["schemas"]["AdsGap"][];
131724
131745
  };
package/dist/index.d.ts CHANGED
@@ -131339,6 +131339,8 @@ interface components {
131339
131339
  return: number | null;
131340
131340
  /** @description The recorded value of the accepted presupuestos / closed sales of the conversations the entity opened (CLP) — pipeline, never cash. `null` = unknown. */
131341
131341
  accepted_value?: number | null;
131342
+ /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
131343
+ accepted_count?: number | null;
131342
131344
  /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
131343
131345
  accepted_return?: number | null;
131344
131346
  /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
@@ -131403,6 +131405,8 @@ interface components {
131403
131405
  return: number | null;
131404
131406
  /** @description The recorded value of the accepted presupuestos / closed sales of the conversations the entity opened (CLP) — pipeline, never cash. `null` = unknown. */
131405
131407
  accepted_value?: number | null;
131408
+ /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
131409
+ accepted_count?: number | null;
131406
131410
  /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
131407
131411
  accepted_return?: number | null;
131408
131412
  /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
@@ -131478,6 +131482,8 @@ interface components {
131478
131482
  return: number | null;
131479
131483
  /** @description The recorded value of the accepted presupuestos / closed sales of the conversations the entity opened (CLP) — pipeline, never cash. `null` = unknown. */
131480
131484
  accepted_value?: number | null;
131485
+ /** @description How many accepted presupuestos / closed sales `accepted_value` is. Totals and campaign rows: the engine-credited list Resumen sums. */
131486
+ accepted_count?: number | null;
131481
131487
  /** @description `accepted_value` ÷ spend («Retorno en presupuestos»). `null` = unknown or no spend. */
131482
131488
  accepted_return?: number | null;
131483
131489
  /** @description Meta’s OWN figures (its 7-day window, every sender) — never added to Vitrina’s. */
@@ -131573,6 +131579,8 @@ interface components {
131573
131579
  * @enum {string}
131574
131580
  */
131575
131581
  joins_state?: "ready" | "pending" | "unavailable";
131582
+ /** @description `false` when the attribution credit behind the joins could not be read in full (the engine returned its per-call maximum for a single day): the people, accepted-plan and first-payment figures may undercount. Say so next to them. On `current` only. */
131583
+ joins_complete?: boolean;
131576
131584
  };
131577
131585
  previous: {
131578
131586
  spend: number | null;
@@ -131615,6 +131623,8 @@ interface components {
131615
131623
  * @enum {string}
131616
131624
  */
131617
131625
  joins_state?: "ready" | "pending" | "unavailable";
131626
+ /** @description `false` when the attribution credit behind the joins could not be read in full (the engine returned its per-call maximum for a single day): the people, accepted-plan and first-payment figures may undercount. Say so next to them. On `current` only. */
131627
+ joins_complete?: boolean;
131618
131628
  };
131619
131629
  /** @description `grain=day` only: every day of the window, oldest first. */
131620
131630
  days?: components["schemas"]["AdsOverviewDay"][];
@@ -131700,6 +131710,8 @@ interface components {
131700
131710
  roas: number | null;
131701
131711
  direct_cash_value: number | null;
131702
131712
  inherited_cash_value: number | null;
131713
+ /** @description PEOPLE the campaign brought: the engine’s credited `lead_created` count when it sends counts per type, else the distinct people whose conversation one of its ads opened in the conversation window — each person once per campaign. `null` = unknown. */
131714
+ people?: number | null;
131703
131715
  /** @description Closes over the WHOLE period credited to this campaign: the outcomes Vitrina recorded at the closed stage (`closed_won`) with `occurred_at` in the period (America/Santiago days) that the attribution engine matched to an ad, each counted once on its largest-credit campaign — the same rows the feed shows as `stage: closed_won, matched: true` with this `ad.campaign`, so it does not move while paging the feed. `null` = unknown (never 0): the campaign credit is not available yet (it warms in the background; retry shortly), the campaign is outside the credited set read (the top 25 by outcomes), or the period starts more than 92 days ago. */
131704
131716
  closed_outcome_count: number | null;
131705
131717
  /** @description The campaign’s highest-spend ad among the top-50 scored ads of the creatives read (the rolling window nearest this range: 7d / 14d / 28d); `null` when unknown. */
@@ -131719,6 +131731,15 @@ interface components {
131719
131731
  conversational?: components["schemas"]["AdsConversational"];
131720
131732
  }[];
131721
131733
  coverage?: components["schemas"]["AdsCoverage"] & unknown;
131734
+ /** @description The rows reconciled with the headline, in PEOPLE. `null`/absent = not known yet (the credit is warming): print no remainder. */
131735
+ people?: {
131736
+ /** @description People from ads: exactly `/ads/overview` `current.attributed_people` for the same window. */
131737
+ attributed: number;
131738
+ /** @description Of `attributed`, the people whose ad credit is filed on one of the campaigns in `data`. */
131739
+ placed: number;
131740
+ /** @description `attributed − placed`: people from ads no row places yet. The only remainder Campañas prints. */
131741
+ unplaced: number;
131742
+ } | null;
131722
131743
  /** @description Measurement gaps overlapping the window (W1.1). Days inside a gap whose `metrics` list a figure carry NO measured value for it — the engine may report 0 there; render «sin datos», never the 0. */
131723
131744
  gaps: components["schemas"]["AdsGap"][];
131724
131745
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vitrina/api",
3
- "version": "11.49.2",
3
+ "version": "11.49.4",
4
4
  "description": "Typed TypeScript SDK for the Vitrina API pública — generated from the committed openapi.public.json (ADR 0106).",
5
5
  "type": "module",
6
6
  "license": "MIT",