@getlatedev/node 0.2.1301 → 0.2.1302

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.mts CHANGED
@@ -46431,6 +46431,10 @@ type GetTikTokSmartPlusMaterialReportResponse = ({
46431
46431
  pageSize?: number;
46432
46432
  totalRows?: number;
46433
46433
  totalPages?: number;
46434
+ /**
46435
+ * Rows TikTok declared that a read and its retry could not return. 0 when the result is complete.
46436
+ */
46437
+ missingRows?: number;
46434
46438
  rows?: Array<{
46435
46439
  /**
46436
46440
  * TikTok main material id
package/dist/index.d.ts CHANGED
@@ -46431,6 +46431,10 @@ type GetTikTokSmartPlusMaterialReportResponse = ({
46431
46431
  pageSize?: number;
46432
46432
  totalRows?: number;
46433
46433
  totalPages?: number;
46434
+ /**
46435
+ * Rows TikTok declared that a read and its retry could not return. 0 when the result is complete.
46436
+ */
46437
+ missingRows?: number;
46434
46438
  rows?: Array<{
46435
46439
  /**
46436
46440
  * TikTok main material id
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@getlatedev/node",
39
- version: "0.2.1301",
39
+ version: "0.2.1302",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@getlatedev/node",
8
- version: "0.2.1301",
8
+ version: "0.2.1302",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getlatedev/node",
3
- "version": "0.2.1301",
3
+ "version": "0.2.1302",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -11992,7 +11992,7 @@ export const listAdsTikTokIdentities = <ThrowOnError extends boolean = false>(op
11992
11992
 
11993
11993
  /**
11994
11994
  * Per-creative performance inside TikTok Smart+ ads
11995
- * Breaks a Smart+ ad (or ad group) down by creative material, one row per Spark post, video or image, from TikTok's Smart+ material report. For a Spark post `tiktokItemId` is the TikTok post id. Conversion metrics are TikTok web (pixel) events. `purchases`, `purchaseValue` and `roas` come from Complete Payment, or from Place an Order (legacy ON_WEB_ORDER pixels) when that reports more; the two are never summed. TikTok allows two dimensions per report, so rows are keyed by the Smart+ ad (`level=ad`) or by the ad group (`level=adGroup`), not both. A row is identified by `smartPlusAdId` + `materialId` at `level=ad` and by `adGroupId` + `materialId` at `level=adGroup`; each appears once across all pages. Rows are sorted by `spend` descending, then the Smart+ ad or ad group id, then `materialId`, and the full result is cached for 10 minutes per account, advertiser and query, so pages read within that window are consistent and `totalRows` counts distinct rows. The result can hold more rows than TikTok's unfiltered report declares, because the per-ad reads also return listed Smart+ ads that report leaves out. When the slices come back with fewer rows than TikTok declares on two reads, the call answers 502 instead of a short result. Metrics TikTok returns empty come back as null.
11995
+ * Breaks a Smart+ ad (or ad group) down by creative material, one row per Spark post, video or image, from TikTok's Smart+ material report. For a Spark post `tiktokItemId` is the TikTok post id. Conversion metrics are TikTok web (pixel) events. `purchases`, `purchaseValue` and `roas` come from Complete Payment, or from Place an Order (legacy ON_WEB_ORDER pixels) when that reports more; the two are never summed. TikTok allows two dimensions per report, so rows are keyed by the Smart+ ad (`level=ad`) or by the ad group (`level=adGroup`), not both. A row is identified by `smartPlusAdId` + `materialId` at `level=ad` and by `adGroupId` + `materialId` at `level=adGroup`; each appears once across all pages. Rows are sorted by `spend` descending, then the Smart+ ad or ad group id, then `materialId`, and the full result is cached for 10 minutes per account, advertiser and query, so pages read within that window are consistent and `totalRows` counts distinct rows. When the result spans more than one TikTok page it is read per Smart+ ad (or ad group) listed on the advertiser, every status included, and those reads can return more rows than TikTok's unfiltered report declares, so `totalRows` can be larger than that count; when the unfiltered report fits one page (100 rows or fewer) it is served as is. Each TikTok read is checked against the row count it declares itself, and a short read is retried once. A shortfall of at most 2 rows (or 1% of the rows, whichever is more) is served with `missingRows` set to that number; a larger one answers 502 instead of a short result. Metrics TikTok returns empty come back as null.
11996
11996
  */
11997
11997
  export const getTikTokSmartPlusMaterialReport = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTikTokSmartPlusMaterialReportData, ThrowOnError>) => {
11998
11998
  return (options?.client ?? client).get<GetTikTokSmartPlusMaterialReportResponse, GetTikTokSmartPlusMaterialReportError, ThrowOnError>({
@@ -47100,6 +47100,10 @@ export type GetTikTokSmartPlusMaterialReportResponse = ({
47100
47100
  pageSize?: number;
47101
47101
  totalRows?: number;
47102
47102
  totalPages?: number;
47103
+ /**
47104
+ * Rows TikTok declared that a read and its retry could not return. 0 when the result is complete.
47105
+ */
47106
+ missingRows?: number;
47103
47107
  rows?: Array<{
47104
47108
  /**
47105
47109
  * TikTok main material id