@vitrina/api 11.49.0 → 11.49.2

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
@@ -104485,6 +104485,10 @@ interface paths {
104485
104485
  * "first_payment_return": 0.09,
104486
104486
  * "cost_per_person": 1113
104487
104487
  * },
104488
+ * "lead": {
104489
+ * "metric": "accepted",
104490
+ * "value": 23.22
104491
+ * },
104488
104492
  * "rank": 1,
104489
104493
  * "verdict": "best"
104490
104494
  * }
@@ -131303,6 +131307,13 @@ interface components {
131303
131307
  previous_measured: boolean;
131304
131308
  /** @description The earliest ad touch Vitrina holds (an imported history, a conversation an ad opened). Bounds the people views («antes de medir»), never a ratio. */
131305
131309
  touches_from?: string | null;
131310
+ /** @description CONVERSATION-family coverage: conversations, people and cost per conversation count from the first ad-opened conversation or lead (`measured_from`), never from the money start above. Say «Medimos desde» with this date next to those figures, and show «—» for their comparisons when `previous_measured` is false. */
131311
+ conversations?: {
131312
+ measured_from: string | null;
131313
+ from: string;
131314
+ clipped: boolean;
131315
+ previous_measured: boolean;
131316
+ };
131306
131317
  /** @description `true` when the measurement start could not be read: every ratio (return, primer pago, MER, accepted plans) is unknown — show «—», never a return over days nobody measured. */
131307
131318
  start_unknown?: boolean;
131308
131319
  };
@@ -131840,10 +131851,16 @@ interface components {
131840
131851
  /** @description Spend ÷ people (CLP). */
131841
131852
  cost_per_person: number | null;
131842
131853
  };
131854
+ /** @description The metric that RANKED the ad — the accepted-quote return, or (with `cash_evidence.used_for_ranking`) the better of it and the cash return. A surface naming the winner displays exactly this metric. */
131855
+ lead: {
131856
+ /** @enum {string} */
131857
+ metric: "accepted" | "cash";
131858
+ value: number | null;
131859
+ };
131843
131860
  /** @description 1 = the best ad; null = not ranked (too little spend or people). */
131844
131861
  rank: number | null;
131845
131862
  /**
131846
- * @description `best` rank 1 · `pays` returns ≥ 1× · `refresh` returns ≥ 1× but wears out · `pause` meets every pause rule · `thin` too little data · `watch` the rest. Never a probability.
131863
+ * @description `best` rank 1 with a return on its `lead` metric (at most one row) · `pays` returns ≥ 1× · `refresh` returns ≥ 1× but wears out · `pause` meets every pause rule · `thin` too little data · `watch` the rest. Never a probability.
131847
131864
  * @enum {string}
131848
131865
  */
131849
131866
  verdict: "best" | "pays" | "refresh" | "pause" | "watch" | "thin";
package/dist/index.d.ts CHANGED
@@ -104485,6 +104485,10 @@ interface paths {
104485
104485
  * "first_payment_return": 0.09,
104486
104486
  * "cost_per_person": 1113
104487
104487
  * },
104488
+ * "lead": {
104489
+ * "metric": "accepted",
104490
+ * "value": 23.22
104491
+ * },
104488
104492
  * "rank": 1,
104489
104493
  * "verdict": "best"
104490
104494
  * }
@@ -131303,6 +131307,13 @@ interface components {
131303
131307
  previous_measured: boolean;
131304
131308
  /** @description The earliest ad touch Vitrina holds (an imported history, a conversation an ad opened). Bounds the people views («antes de medir»), never a ratio. */
131305
131309
  touches_from?: string | null;
131310
+ /** @description CONVERSATION-family coverage: conversations, people and cost per conversation count from the first ad-opened conversation or lead (`measured_from`), never from the money start above. Say «Medimos desde» with this date next to those figures, and show «—» for their comparisons when `previous_measured` is false. */
131311
+ conversations?: {
131312
+ measured_from: string | null;
131313
+ from: string;
131314
+ clipped: boolean;
131315
+ previous_measured: boolean;
131316
+ };
131306
131317
  /** @description `true` when the measurement start could not be read: every ratio (return, primer pago, MER, accepted plans) is unknown — show «—», never a return over days nobody measured. */
131307
131318
  start_unknown?: boolean;
131308
131319
  };
@@ -131840,10 +131851,16 @@ interface components {
131840
131851
  /** @description Spend ÷ people (CLP). */
131841
131852
  cost_per_person: number | null;
131842
131853
  };
131854
+ /** @description The metric that RANKED the ad — the accepted-quote return, or (with `cash_evidence.used_for_ranking`) the better of it and the cash return. A surface naming the winner displays exactly this metric. */
131855
+ lead: {
131856
+ /** @enum {string} */
131857
+ metric: "accepted" | "cash";
131858
+ value: number | null;
131859
+ };
131843
131860
  /** @description 1 = the best ad; null = not ranked (too little spend or people). */
131844
131861
  rank: number | null;
131845
131862
  /**
131846
- * @description `best` rank 1 · `pays` returns ≥ 1× · `refresh` returns ≥ 1× but wears out · `pause` meets every pause rule · `thin` too little data · `watch` the rest. Never a probability.
131863
+ * @description `best` rank 1 with a return on its `lead` metric (at most one row) · `pays` returns ≥ 1× · `refresh` returns ≥ 1× but wears out · `pause` meets every pause rule · `thin` too little data · `watch` the rest. Never a probability.
131847
131864
  * @enum {string}
131848
131865
  */
131849
131866
  verdict: "best" | "pays" | "refresh" | "pause" | "watch" | "thin";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vitrina/api",
3
- "version": "11.49.0",
3
+ "version": "11.49.2",
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",