adapty 0.8.7 → 0.8.8

package/oclif.manifest.json

@@ -504,6 +504,275 @@
         "whoami.js"
       ]
     },
+    "attribution:dimensions": {
+      "aliases": [],
+      "args": {},
+      "description": "List the dimensions an attribution report can group or filter by (not scoped to an app)",
+      "examples": [
+        "<%= config.bin %> attribution dimensions",
+        "<%= config.bin %> attribution dimensions --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:dimensions",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "dimensions.js"
+      ]
+    },
+    "attribution:metrics": {
+      "aliases": [],
+      "args": {},
+      "description": "List the metrics an attribution report can ask for (not scoped to an app)",
+      "examples": [
+        "<%= config.bin %> attribution metrics",
+        "<%= config.bin %> attribution metrics --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:metrics",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "metrics.js"
+      ]
+    },
+    "attribution:report": {
+      "aliases": [],
+      "args": {},
+      "description": "Run an Attribution report for an app: metrics over a period, grouped by dimensions",
+      "examples": [
+        "<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign",
+        "<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend --group-by date --granularity week --filter country=US,GB --sort spend:desc",
+        "<%= config.bin %> attribution report --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --metrics spend,installs,d7_roas --group-by campaign --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metrics": {
+          "description": "Metric names, as `adapty attribution metrics` lists them (repeatable or comma-separated)",
+          "name": "metrics",
+          "required": true,
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "group-by": {
+          "description": "Dimensions to group rows by (repeatable or comma-separated)",
+          "name": "group-by",
+          "required": true,
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "date",
+            "campaign",
+            "adset",
+            "ad",
+            "keyword",
+            "channel",
+            "country",
+            "store"
+          ],
+          "type": "option"
+        },
+        "granularity": {
+          "description": "Date bucket; required with --group-by date, and allowed only with it",
+          "name": "granularity",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ],
+          "type": "option"
+        },
+        "filter": {
+          "description": "Keep rows whose dimension has one of the values: dimension=value[,value] (repeatable; `\\,` for a comma inside a value)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "revenue-basis": {
+          "description": "Which revenue the revenue metrics use; the backend default applies when omitted",
+          "name": "revenue-basis",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gross",
+            "proceeds",
+            "net"
+          ],
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort rows by a requested metric or dimension: field[:asc|desc] (ascending by default)",
+          "name": "sort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:report",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "report.js"
+      ]
+    },
+    "attribution:values": {
+      "aliases": [],
+      "args": {},
+      "description": "List the values a dimension takes for an app over a period: what a report --filter can use",
+      "examples": [
+        "<%= config.bin %> attribution values --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --dimension campaign",
+        "<%= config.bin %> attribution values --app APP_UUID --date-from 2026-08-01 --date-to 2026-08-31 --dimension country --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "First day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "Last day of the period, inclusive (YYYY-MM-DD, in the app timezone)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dimension": {
+          "description": "A filterable dimension, as `adapty attribution dimensions` lists it",
+          "name": "dimension",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "revenue-basis": {
+          "description": "Which revenue the revenue metrics use; the backend default applies when omitted",
+          "name": "revenue-basis",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "gross",
+            "proceeds",
+            "net"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "attribution:values",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "attribution",
+        "values.js"
+      ]
+    },
     "auth:login": {
       "aliases": [],
       "args": {},
@@ -3029,47 +3298,6 @@
         "update.js"
       ]
     },
-    "asa:competitors:summary": {
-      "aliases": [],
-      "args": {},
-      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
-      "examples": [
-        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app-ids": {
-          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
-          "name": "app-ids",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:competitors:summary",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "competitors",
-        "summary.js"
-      ]
-    },
     "asa:campaigns:bulk-create": {
       "aliases": [],
       "args": {},
@@ -3788,13 +4016,12 @@
         "update.js"
       ]
     },
-    "asa:keywords:add": {
+    "asa:competitors:summary": {
       "aliases": [],
       "args": {},
-      "description": "Add targeting keywords to an ad group",
+      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
       "examples": [
-        "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
-        "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
+        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
       ],
       "flags": {
         "json": {
@@ -3804,13 +4031,119 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "app-ids": {
+          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
+          "name": "app-ids",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:competitors:summary",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "competitors",
+        "summary.js"
+      ]
+    },
+    "asa:creatives:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List creatives; creative_id is what `asa ads create` needs",
+      "examples": [
+        "<%= config.bin %> asa creatives list",
+        "<%= config.bin %> asa creatives list --app APP_UUID"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:creatives:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "creatives",
+        "list.js"
+      ]
+    },
+    "asa:keywords:add": {
+      "aliases": [],
+      "args": {},
+      "description": "Add targeting keywords to an ad group",
+      "examples": [
+        "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
+        "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "yes": {
           "char": "y",
@@ -4609,13 +4942,62 @@
         "list.js"
       ]
     },
-    "asa:creatives:list": {
+    "asa:orgs:list": {
       "aliases": [],
       "args": {},
-      "description": "List creatives; creative_id is what `asa ads create` needs",
+      "description": "List the Apple Search Ads organizations this company can spend from",
       "examples": [
-        "<%= config.bin %> asa creatives list",
-        "<%= config.bin %> asa creatives list --app APP_UUID"
+        "<%= config.bin %> asa orgs list"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:orgs:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "orgs",
+        "list.js"
+      ]
+    },
+    "asa:product-pages:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
+      "examples": [
+        "<%= config.bin %> asa product-pages list",
+        "<%= config.bin %> asa product-pages list --app APP_UUID"
       ],
       "flags": {
         "json": {
@@ -4658,7 +5040,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:creatives:list",
+      "id": "asa:product-pages:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4669,16 +5051,17 @@
         "dist",
         "commands",
         "asa",
-        "creatives",
+        "product-pages",
         "list.js"
       ]
     },
-    "asa:orgs:list": {
+    "asa:product-pages:sync": {
       "aliases": [],
       "args": {},
-      "description": "List the Apple Search Ads organizations this company can spend from",
+      "description": "Refresh custom product pages from Apple",
       "examples": [
-        "<%= config.bin %> asa orgs list"
+        "<%= config.bin %> asa product-pages sync",
+        "<%= config.bin %> asa product-pages sync --adam-id 123456"
       ],
       "flags": {
         "json": {
@@ -4688,18 +5071,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "idempotency-key": {
+          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
+          "name": "idempotency-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
+        "adam-id": {
+          "description": "Limit the refresh to one app; omit to cover every app",
+          "name": "adam-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4707,7 +5095,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:orgs:list",
+      "id": "asa:product-pages:sync",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4718,8 +5106,8 @@
         "dist",
         "commands",
         "asa",
-        "orgs",
-        "list.js"
+        "product-pages",
+        "sync.js"
       ]
     },
     "asa:search-terms:list": {
@@ -4821,125 +5209,6 @@
         "list.js"
       ]
     },
-    "asa:product-pages:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
-      "examples": [
-        "<%= config.bin %> asa product-pages list",
-        "<%= config.bin %> asa product-pages list --app APP_UUID"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "app": {
-          "description": "Keep only rows in this app; repeatable",
-          "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:product-pages:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "product-pages",
-        "list.js"
-      ]
-    },
-    "asa:product-pages:sync": {
-      "aliases": [],
-      "args": {},
-      "description": "Refresh custom product pages from Apple",
-      "examples": [
-        "<%= config.bin %> asa product-pages sync",
-        "<%= config.bin %> asa product-pages sync --adam-id 123456"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "idempotency-key": {
-          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
-          "name": "idempotency-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "adam-id": {
-          "description": "Limit the refresh to one app; omit to cover every app",
-          "name": "adam-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:product-pages:sync",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "product-pages",
-        "sync.js"
-      ]
-    },
     "flows:config:get": {
       "aliases": [],
       "args": {
@@ -5244,5 +5513,5 @@
       ]
     }
   },
-  "version": "0.8.7"
+  "version": "0.8.8"
 }