@vitrina/api 11.49.1 → 11.49.3

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
  * }
@@ -131569,6 +131573,8 @@ interface components {
131569
131573
  * @enum {string}
131570
131574
  */
131571
131575
  joins_state?: "ready" | "pending" | "unavailable";
131576
+ /** @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. */
131577
+ joins_complete?: boolean;
131572
131578
  };
131573
131579
  previous: {
131574
131580
  spend: number | null;
@@ -131611,6 +131617,8 @@ interface components {
131611
131617
  * @enum {string}
131612
131618
  */
131613
131619
  joins_state?: "ready" | "pending" | "unavailable";
131620
+ /** @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. */
131621
+ joins_complete?: boolean;
131614
131622
  };
131615
131623
  /** @description `grain=day` only: every day of the window, oldest first. */
131616
131624
  days?: components["schemas"]["AdsOverviewDay"][];
@@ -131847,10 +131855,16 @@ interface components {
131847
131855
  /** @description Spend ÷ people (CLP). */
131848
131856
  cost_per_person: number | null;
131849
131857
  };
131858
+ /** @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. */
131859
+ lead: {
131860
+ /** @enum {string} */
131861
+ metric: "accepted" | "cash";
131862
+ value: number | null;
131863
+ };
131850
131864
  /** @description 1 = the best ad; null = not ranked (too little spend or people). */
131851
131865
  rank: number | null;
131852
131866
  /**
131853
- * @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.
131867
+ * @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.
131854
131868
  * @enum {string}
131855
131869
  */
131856
131870
  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
  * }
@@ -131569,6 +131573,8 @@ interface components {
131569
131573
  * @enum {string}
131570
131574
  */
131571
131575
  joins_state?: "ready" | "pending" | "unavailable";
131576
+ /** @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. */
131577
+ joins_complete?: boolean;
131572
131578
  };
131573
131579
  previous: {
131574
131580
  spend: number | null;
@@ -131611,6 +131617,8 @@ interface components {
131611
131617
  * @enum {string}
131612
131618
  */
131613
131619
  joins_state?: "ready" | "pending" | "unavailable";
131620
+ /** @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. */
131621
+ joins_complete?: boolean;
131614
131622
  };
131615
131623
  /** @description `grain=day` only: every day of the window, oldest first. */
131616
131624
  days?: components["schemas"]["AdsOverviewDay"][];
@@ -131847,10 +131855,16 @@ interface components {
131847
131855
  /** @description Spend ÷ people (CLP). */
131848
131856
  cost_per_person: number | null;
131849
131857
  };
131858
+ /** @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. */
131859
+ lead: {
131860
+ /** @enum {string} */
131861
+ metric: "accepted" | "cash";
131862
+ value: number | null;
131863
+ };
131850
131864
  /** @description 1 = the best ad; null = not ranked (too little spend or people). */
131851
131865
  rank: number | null;
131852
131866
  /**
131853
- * @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.
131867
+ * @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.
131854
131868
  * @enum {string}
131855
131869
  */
131856
131870
  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.1",
3
+ "version": "11.49.3",
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",