adapty 0.5.0 → 0.6.0-beta.0

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.
Files changed (16) hide show
  1. package/README.md +15 -1
  2. package/dist/commands/asa/connect.js +2 -1
  3. package/dist/commands/auth/login.js +7 -5
  4. package/dist/commands/flows/config/get.d.ts +14 -0
  5. package/dist/commands/flows/config/get.js +25 -0
  6. package/dist/commands/flows/config/update.d.ts +21 -0
  7. package/dist/commands/flows/config/update.js +84 -0
  8. package/dist/commands/flows/create.d.ts +12 -0
  9. package/dist/commands/flows/create.js +22 -0
  10. package/dist/commands/flows/get.d.ts +14 -0
  11. package/dist/commands/flows/get.js +25 -0
  12. package/dist/commands/flows/list.d.ts +14 -0
  13. package/dist/commands/flows/list.js +20 -0
  14. package/dist/lib/api-schemas.d.ts +28 -0
  15. package/oclif.manifest.json +1385 -1111
  16. package/package.json +7 -1
package/oclif.manifest.json CHANGED
@@ -425,6 +425,85 @@
425
425
  "update.js"
426
426
  ]
427
427
  },
428
+ "asa:connect": {
429
+ "aliases": [],
430
+ "args": {},
431
+ "description": "Connect an Apple Search Ads account to this company",
432
+ "examples": [
433
+ "<%= config.bin %> asa connect",
434
+ "<%= config.bin %> asa connect --no-wait"
435
+ ],
436
+ "flags": {
437
+ "json": {
438
+ "description": "Format output as json.",
439
+ "helpGroup": "GLOBAL",
440
+ "name": "json",
441
+ "allowNo": false,
442
+ "type": "boolean"
443
+ },
444
+ "timeout": {
445
+ "description": "Seconds to wait for the browser step",
446
+ "name": "timeout",
447
+ "default": 300,
448
+ "hasDynamicHelp": false,
449
+ "multiple": false,
450
+ "type": "option"
451
+ },
452
+ "wait": {
453
+ "description": "Wait until Apple Ads reports as connected",
454
+ "name": "wait",
455
+ "allowNo": true,
456
+ "type": "boolean"
457
+ }
458
+ },
459
+ "hasDynamicHelp": false,
460
+ "hiddenAliases": [],
461
+ "id": "asa:connect",
462
+ "pluginAlias": "adapty",
463
+ "pluginName": "adapty",
464
+ "pluginType": "core",
465
+ "strict": true,
466
+ "enableJsonFlag": true,
467
+ "isESM": true,
468
+ "relativePath": [
469
+ "dist",
470
+ "commands",
471
+ "asa",
472
+ "connect.js"
473
+ ]
474
+ },
475
+ "asa:whoami": {
476
+ "aliases": [],
477
+ "args": {},
478
+ "description": "Show which company the token unlocks and whether Apple Ads is connected",
479
+ "examples": [
480
+ "<%= config.bin %> asa whoami"
481
+ ],
482
+ "flags": {
483
+ "json": {
484
+ "description": "Format output as json.",
485
+ "helpGroup": "GLOBAL",
486
+ "name": "json",
487
+ "allowNo": false,
488
+ "type": "boolean"
489
+ }
490
+ },
491
+ "hasDynamicHelp": false,
492
+ "hiddenAliases": [],
493
+ "id": "asa:whoami",
494
+ "pluginAlias": "adapty",
495
+ "pluginName": "adapty",
496
+ "pluginType": "core",
497
+ "strict": true,
498
+ "enableJsonFlag": true,
499
+ "isESM": true,
500
+ "relativePath": [
501
+ "dist",
502
+ "commands",
503
+ "asa",
504
+ "whoami.js"
505
+ ]
506
+ },
428
507
  "auth:login": {
429
508
  "aliases": [],
430
509
  "args": {},
@@ -577,13 +656,12 @@
577
656
  "whoami.js"
578
657
  ]
579
658
  },
580
- "asa:connect": {
659
+ "flows:create": {
581
660
  "aliases": [],
582
661
  "args": {},
583
- "description": "Connect an Apple Search Ads account to this company",
662
+ "description": "Create a flow (row only — write its config with `flows config update`)",
584
663
  "examples": [
585
- "<%= config.bin %> asa connect",
586
- "<%= config.bin %> asa connect --no-wait"
664
+ "<%= config.bin %> flows create --app UUID --name \"Onboarding\""
587
665
  ],
588
666
  "flags": {
589
667
  "json": {
@@ -593,24 +671,72 @@
593
671
  "allowNo": false,
594
672
  "type": "boolean"
595
673
  },
596
- "timeout": {
597
- "description": "Seconds to wait for the browser step",
598
- "name": "timeout",
599
- "default": 300,
674
+ "app": {
675
+ "description": "App ID (UUID)",
676
+ "name": "app",
677
+ "required": true,
600
678
  "hasDynamicHelp": false,
601
679
  "multiple": false,
602
680
  "type": "option"
603
681
  },
604
- "wait": {
605
- "description": "Wait until Apple Ads reports as connected",
606
- "name": "wait",
607
- "allowNo": true,
682
+ "name": {
683
+ "description": "Flow name",
684
+ "name": "name",
685
+ "required": true,
686
+ "hasDynamicHelp": false,
687
+ "multiple": false,
688
+ "type": "option"
689
+ }
690
+ },
691
+ "hasDynamicHelp": false,
692
+ "hiddenAliases": [],
693
+ "id": "flows:create",
694
+ "pluginAlias": "adapty",
695
+ "pluginName": "adapty",
696
+ "pluginType": "core",
697
+ "strict": true,
698
+ "enableJsonFlag": true,
699
+ "isESM": true,
700
+ "relativePath": [
701
+ "dist",
702
+ "commands",
703
+ "flows",
704
+ "create.js"
705
+ ]
706
+ },
707
+ "flows:get": {
708
+ "aliases": [],
709
+ "args": {
710
+ "flow_id": {
711
+ "description": "Flow ID (UUID)",
712
+ "name": "flow_id",
713
+ "required": true
714
+ }
715
+ },
716
+ "description": "Get flow details",
717
+ "examples": [
718
+ "<%= config.bin %> flows get --app UUID 550e8400-e29b-41d4-a716-446655440000"
719
+ ],
720
+ "flags": {
721
+ "json": {
722
+ "description": "Format output as json.",
723
+ "helpGroup": "GLOBAL",
724
+ "name": "json",
725
+ "allowNo": false,
608
726
  "type": "boolean"
727
+ },
728
+ "app": {
729
+ "description": "App ID (UUID)",
730
+ "name": "app",
731
+ "required": true,
732
+ "hasDynamicHelp": false,
733
+ "multiple": false,
734
+ "type": "option"
609
735
  }
610
736
  },
611
737
  "hasDynamicHelp": false,
612
738
  "hiddenAliases": [],
613
- "id": "asa:connect",
739
+ "id": "flows:get",
614
740
  "pluginAlias": "adapty",
615
741
  "pluginName": "adapty",
616
742
  "pluginType": "core",
@@ -620,16 +746,16 @@
620
746
  "relativePath": [
621
747
  "dist",
622
748
  "commands",
623
- "asa",
624
- "connect.js"
749
+ "flows",
750
+ "get.js"
625
751
  ]
626
752
  },
627
- "asa:whoami": {
753
+ "flows:list": {
628
754
  "aliases": [],
629
755
  "args": {},
630
- "description": "Show which company the token unlocks and whether Apple Ads is connected",
756
+ "description": "List flows for an app",
631
757
  "examples": [
632
- "<%= config.bin %> asa whoami"
758
+ "<%= config.bin %> flows list --app 550e8400-..."
633
759
  ],
634
760
  "flags": {
635
761
  "json": {
@@ -638,11 +764,35 @@
638
764
  "name": "json",
639
765
  "allowNo": false,
640
766
  "type": "boolean"
767
+ },
768
+ "app": {
769
+ "description": "App ID (UUID)",
770
+ "name": "app",
771
+ "required": true,
772
+ "hasDynamicHelp": false,
773
+ "multiple": false,
774
+ "type": "option"
775
+ },
776
+ "page": {
777
+ "description": "Page number",
778
+ "name": "page",
779
+ "default": 1,
780
+ "hasDynamicHelp": false,
781
+ "multiple": false,
782
+ "type": "option"
783
+ },
784
+ "page-size": {
785
+ "description": "Items per page (max 100)",
786
+ "name": "page-size",
787
+ "default": 20,
788
+ "hasDynamicHelp": false,
789
+ "multiple": false,
790
+ "type": "option"
641
791
  }
642
792
  },
643
793
  "hasDynamicHelp": false,
644
794
  "hiddenAliases": [],
645
- "id": "asa:whoami",
795
+ "id": "flows:list",
646
796
  "pluginAlias": "adapty",
647
797
  "pluginName": "adapty",
648
798
  "pluginType": "core",
@@ -652,8 +802,8 @@
652
802
  "relativePath": [
653
803
  "dist",
654
804
  "commands",
655
- "asa",
656
- "whoami.js"
805
+ "flows",
806
+ "list.js"
657
807
  ]
658
808
  },
659
809
  "paywalls:create": {
@@ -922,13 +1072,12 @@
922
1072
  "update.js"
923
1073
  ]
924
1074
  },
925
- "placements:create": {
1075
+ "products:create": {
926
1076
  "aliases": [],
927
1077
  "args": {},
928
- "description": "Create a placement with a paywall",
1078
+ "description": "Create a product with vendor products per platform",
929
1079
  "examples": [
930
- "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
931
- "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1080
+ "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
932
1081
  ],
933
1082
  "flags": {
934
1083
  "json": {
@@ -946,30 +1095,80 @@
946
1095
  "multiple": false,
947
1096
  "type": "option"
948
1097
  },
949
- "audiences": {
950
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
951
- "name": "audiences",
1098
+ "access-level-id": {
1099
+ "description": "Access level ID (UUID)",
1100
+ "name": "access-level-id",
1101
+ "required": true,
952
1102
  "hasDynamicHelp": false,
953
1103
  "multiple": false,
954
1104
  "type": "option"
955
1105
  },
956
- "developer-id": {
957
- "description": "Developer ID for the placement",
958
- "name": "developer-id",
1106
+ "android-base-plan-id": {
1107
+ "description": "Android base plan ID",
1108
+ "helpGroup": "STORE BINDINGS",
1109
+ "name": "android-base-plan-id",
1110
+ "hasDynamicHelp": false,
1111
+ "multiple": false,
1112
+ "type": "option"
1113
+ },
1114
+ "android-product-id": {
1115
+ "description": "Android product ID",
1116
+ "helpGroup": "STORE BINDINGS",
1117
+ "name": "android-product-id",
1118
+ "hasDynamicHelp": false,
1119
+ "multiple": false,
1120
+ "type": "option"
1121
+ },
1122
+ "ios-product-id": {
1123
+ "description": "iOS product ID",
1124
+ "helpGroup": "STORE BINDINGS",
1125
+ "name": "ios-product-id",
1126
+ "hasDynamicHelp": false,
1127
+ "multiple": false,
1128
+ "type": "option"
1129
+ },
1130
+ "paddle-price-id": {
1131
+ "description": "Paddle price ID (requires --paddle-product-id)",
1132
+ "helpGroup": "STORE BINDINGS",
1133
+ "name": "paddle-price-id",
1134
+ "hasDynamicHelp": false,
1135
+ "multiple": false,
1136
+ "type": "option"
1137
+ },
1138
+ "paddle-product-id": {
1139
+ "description": "Paddle product ID (requires --paddle-price-id)",
1140
+ "helpGroup": "STORE BINDINGS",
1141
+ "name": "paddle-product-id",
1142
+ "hasDynamicHelp": false,
1143
+ "multiple": false,
1144
+ "type": "option"
1145
+ },
1146
+ "period": {
1147
+ "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
1148
+ "name": "period",
959
1149
  "required": true,
960
1150
  "hasDynamicHelp": false,
961
1151
  "multiple": false,
962
1152
  "type": "option"
963
1153
  },
964
- "paywall-id": {
965
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
966
- "name": "paywall-id",
1154
+ "stripe-price-id": {
1155
+ "description": "Stripe price ID (requires --stripe-product-id)",
1156
+ "helpGroup": "STORE BINDINGS",
1157
+ "name": "stripe-price-id",
1158
+ "hasDynamicHelp": false,
1159
+ "multiple": false,
1160
+ "type": "option"
1161
+ },
1162
+ "stripe-product-id": {
1163
+ "description": "Stripe product ID (requires --stripe-price-id)",
1164
+ "helpGroup": "STORE BINDINGS",
1165
+ "name": "stripe-product-id",
967
1166
  "hasDynamicHelp": false,
968
1167
  "multiple": false,
969
1168
  "type": "option"
970
1169
  },
971
1170
  "title": {
972
- "description": "Placement title",
1171
+ "description": "Product title",
973
1172
  "name": "title",
974
1173
  "required": true,
975
1174
  "hasDynamicHelp": false,
@@ -979,7 +1178,7 @@
979
1178
  },
980
1179
  "hasDynamicHelp": false,
981
1180
  "hiddenAliases": [],
982
- "id": "placements:create",
1181
+ "id": "products:create",
983
1182
  "pluginAlias": "adapty",
984
1183
  "pluginName": "adapty",
985
1184
  "pluginType": "core",
@@ -989,22 +1188,22 @@
989
1188
  "relativePath": [
990
1189
  "dist",
991
1190
  "commands",
992
- "placements",
1191
+ "products",
993
1192
  "create.js"
994
1193
  ]
995
1194
  },
996
- "placements:get": {
1195
+ "products:get": {
997
1196
  "aliases": [],
998
1197
  "args": {
999
- "placement_id": {
1000
- "description": "Placement ID (UUID)",
1001
- "name": "placement_id",
1198
+ "product_id": {
1199
+ "description": "Product ID (UUID)",
1200
+ "name": "product_id",
1002
1201
  "required": true
1003
1202
  }
1004
1203
  },
1005
- "description": "Get placement details",
1204
+ "description": "Get product details",
1006
1205
  "examples": [
1007
- "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1206
+ "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1008
1207
  ],
1009
1208
  "flags": {
1010
1209
  "json": {
@@ -1025,7 +1224,7 @@
1025
1224
  },
1026
1225
  "hasDynamicHelp": false,
1027
1226
  "hiddenAliases": [],
1028
- "id": "placements:get",
1227
+ "id": "products:get",
1029
1228
  "pluginAlias": "adapty",
1030
1229
  "pluginName": "adapty",
1031
1230
  "pluginType": "core",
@@ -1035,16 +1234,16 @@
1035
1234
  "relativePath": [
1036
1235
  "dist",
1037
1236
  "commands",
1038
- "placements",
1237
+ "products",
1039
1238
  "get.js"
1040
1239
  ]
1041
1240
  },
1042
- "placements:list": {
1241
+ "products:list": {
1043
1242
  "aliases": [],
1044
1243
  "args": {},
1045
- "description": "List placements for an app",
1244
+ "description": "List products for an app",
1046
1245
  "examples": [
1047
- "<%= config.bin %> placements list --app 550e8400-..."
1246
+ "<%= config.bin %> products list --app 550e8400-..."
1048
1247
  ],
1049
1248
  "flags": {
1050
1249
  "json": {
@@ -1081,7 +1280,7 @@
1081
1280
  },
1082
1281
  "hasDynamicHelp": false,
1083
1282
  "hiddenAliases": [],
1084
- "id": "placements:list",
1283
+ "id": "products:list",
1085
1284
  "pluginAlias": "adapty",
1086
1285
  "pluginName": "adapty",
1087
1286
  "pluginType": "core",
@@ -1091,23 +1290,22 @@
1091
1290
  "relativePath": [
1092
1291
  "dist",
1093
1292
  "commands",
1094
- "placements",
1293
+ "products",
1095
1294
  "list.js"
1096
1295
  ]
1097
1296
  },
1098
- "placements:update": {
1297
+ "products:update": {
1099
1298
  "aliases": [],
1100
1299
  "args": {
1101
- "placement_id": {
1102
- "description": "Placement ID (UUID)",
1103
- "name": "placement_id",
1300
+ "product_id": {
1301
+ "description": "Product ID (UUID)",
1302
+ "name": "product_id",
1104
1303
  "required": true
1105
1304
  }
1106
1305
  },
1107
- "description": "Update a placement",
1306
+ "description": "Update a product (title and access level only)",
1108
1307
  "examples": [
1109
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1110
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1308
+ "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
1111
1309
  ],
1112
1310
  "flags": {
1113
1311
  "json": {
@@ -1125,30 +1323,16 @@
1125
1323
  "multiple": false,
1126
1324
  "type": "option"
1127
1325
  },
1128
- "audiences": {
1129
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1130
- "name": "audiences",
1131
- "hasDynamicHelp": false,
1132
- "multiple": false,
1133
- "type": "option"
1134
- },
1135
- "developer-id": {
1136
- "description": "Developer ID for the placement",
1137
- "name": "developer-id",
1326
+ "access-level-id": {
1327
+ "description": "Access level ID (UUID)",
1328
+ "name": "access-level-id",
1138
1329
  "required": true,
1139
1330
  "hasDynamicHelp": false,
1140
1331
  "multiple": false,
1141
1332
  "type": "option"
1142
1333
  },
1143
- "paywall-id": {
1144
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1145
- "name": "paywall-id",
1146
- "hasDynamicHelp": false,
1147
- "multiple": false,
1148
- "type": "option"
1149
- },
1150
1334
  "title": {
1151
- "description": "Placement title",
1335
+ "description": "Product title",
1152
1336
  "name": "title",
1153
1337
  "required": true,
1154
1338
  "hasDynamicHelp": false,
@@ -1158,7 +1342,7 @@
1158
1342
  },
1159
1343
  "hasDynamicHelp": false,
1160
1344
  "hiddenAliases": [],
1161
- "id": "placements:update",
1345
+ "id": "products:update",
1162
1346
  "pluginAlias": "adapty",
1163
1347
  "pluginName": "adapty",
1164
1348
  "pluginType": "core",
@@ -1168,16 +1352,17 @@
1168
1352
  "relativePath": [
1169
1353
  "dist",
1170
1354
  "commands",
1171
- "placements",
1355
+ "products",
1172
1356
  "update.js"
1173
1357
  ]
1174
1358
  },
1175
- "products:create": {
1359
+ "placements:create": {
1176
1360
  "aliases": [],
1177
1361
  "args": {},
1178
- "description": "Create a product with vendor products per platform",
1362
+ "description": "Create a placement with a paywall",
1179
1363
  "examples": [
1180
- "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
1364
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1365
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1181
1366
  ],
1182
1367
  "flags": {
1183
1368
  "json": {
@@ -1195,80 +1380,30 @@
1195
1380
  "multiple": false,
1196
1381
  "type": "option"
1197
1382
  },
1198
- "access-level-id": {
1199
- "description": "Access level ID (UUID)",
1200
- "name": "access-level-id",
1201
- "required": true,
1202
- "hasDynamicHelp": false,
1203
- "multiple": false,
1204
- "type": "option"
1205
- },
1206
- "android-base-plan-id": {
1207
- "description": "Android base plan ID",
1208
- "helpGroup": "STORE BINDINGS",
1209
- "name": "android-base-plan-id",
1210
- "hasDynamicHelp": false,
1211
- "multiple": false,
1212
- "type": "option"
1213
- },
1214
- "android-product-id": {
1215
- "description": "Android product ID",
1216
- "helpGroup": "STORE BINDINGS",
1217
- "name": "android-product-id",
1218
- "hasDynamicHelp": false,
1219
- "multiple": false,
1220
- "type": "option"
1221
- },
1222
- "ios-product-id": {
1223
- "description": "iOS product ID",
1224
- "helpGroup": "STORE BINDINGS",
1225
- "name": "ios-product-id",
1226
- "hasDynamicHelp": false,
1227
- "multiple": false,
1228
- "type": "option"
1229
- },
1230
- "paddle-price-id": {
1231
- "description": "Paddle price ID (requires --paddle-product-id)",
1232
- "helpGroup": "STORE BINDINGS",
1233
- "name": "paddle-price-id",
1234
- "hasDynamicHelp": false,
1235
- "multiple": false,
1236
- "type": "option"
1237
- },
1238
- "paddle-product-id": {
1239
- "description": "Paddle product ID (requires --paddle-price-id)",
1240
- "helpGroup": "STORE BINDINGS",
1241
- "name": "paddle-product-id",
1383
+ "audiences": {
1384
+ "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1385
+ "name": "audiences",
1242
1386
  "hasDynamicHelp": false,
1243
1387
  "multiple": false,
1244
1388
  "type": "option"
1245
1389
  },
1246
- "period": {
1247
- "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
1248
- "name": "period",
1390
+ "developer-id": {
1391
+ "description": "Developer ID for the placement",
1392
+ "name": "developer-id",
1249
1393
  "required": true,
1250
1394
  "hasDynamicHelp": false,
1251
1395
  "multiple": false,
1252
1396
  "type": "option"
1253
1397
  },
1254
- "stripe-price-id": {
1255
- "description": "Stripe price ID (requires --stripe-product-id)",
1256
- "helpGroup": "STORE BINDINGS",
1257
- "name": "stripe-price-id",
1258
- "hasDynamicHelp": false,
1259
- "multiple": false,
1260
- "type": "option"
1261
- },
1262
- "stripe-product-id": {
1263
- "description": "Stripe product ID (requires --stripe-price-id)",
1264
- "helpGroup": "STORE BINDINGS",
1265
- "name": "stripe-product-id",
1398
+ "paywall-id": {
1399
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1400
+ "name": "paywall-id",
1266
1401
  "hasDynamicHelp": false,
1267
1402
  "multiple": false,
1268
1403
  "type": "option"
1269
1404
  },
1270
1405
  "title": {
1271
- "description": "Product title",
1406
+ "description": "Placement title",
1272
1407
  "name": "title",
1273
1408
  "required": true,
1274
1409
  "hasDynamicHelp": false,
@@ -1278,7 +1413,7 @@
1278
1413
  },
1279
1414
  "hasDynamicHelp": false,
1280
1415
  "hiddenAliases": [],
1281
- "id": "products:create",
1416
+ "id": "placements:create",
1282
1417
  "pluginAlias": "adapty",
1283
1418
  "pluginName": "adapty",
1284
1419
  "pluginType": "core",
@@ -1288,22 +1423,22 @@
1288
1423
  "relativePath": [
1289
1424
  "dist",
1290
1425
  "commands",
1291
- "products",
1426
+ "placements",
1292
1427
  "create.js"
1293
1428
  ]
1294
1429
  },
1295
- "products:get": {
1430
+ "placements:get": {
1296
1431
  "aliases": [],
1297
1432
  "args": {
1298
- "product_id": {
1299
- "description": "Product ID (UUID)",
1300
- "name": "product_id",
1433
+ "placement_id": {
1434
+ "description": "Placement ID (UUID)",
1435
+ "name": "placement_id",
1301
1436
  "required": true
1302
1437
  }
1303
1438
  },
1304
- "description": "Get product details",
1439
+ "description": "Get placement details",
1305
1440
  "examples": [
1306
- "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1441
+ "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1307
1442
  ],
1308
1443
  "flags": {
1309
1444
  "json": {
@@ -1324,7 +1459,7 @@
1324
1459
  },
1325
1460
  "hasDynamicHelp": false,
1326
1461
  "hiddenAliases": [],
1327
- "id": "products:get",
1462
+ "id": "placements:get",
1328
1463
  "pluginAlias": "adapty",
1329
1464
  "pluginName": "adapty",
1330
1465
  "pluginType": "core",
@@ -1334,16 +1469,16 @@
1334
1469
  "relativePath": [
1335
1470
  "dist",
1336
1471
  "commands",
1337
- "products",
1472
+ "placements",
1338
1473
  "get.js"
1339
1474
  ]
1340
1475
  },
1341
- "products:list": {
1476
+ "placements:list": {
1342
1477
  "aliases": [],
1343
1478
  "args": {},
1344
- "description": "List products for an app",
1479
+ "description": "List placements for an app",
1345
1480
  "examples": [
1346
- "<%= config.bin %> products list --app 550e8400-..."
1481
+ "<%= config.bin %> placements list --app 550e8400-..."
1347
1482
  ],
1348
1483
  "flags": {
1349
1484
  "json": {
@@ -1380,7 +1515,7 @@
1380
1515
  },
1381
1516
  "hasDynamicHelp": false,
1382
1517
  "hiddenAliases": [],
1383
- "id": "products:list",
1518
+ "id": "placements:list",
1384
1519
  "pluginAlias": "adapty",
1385
1520
  "pluginName": "adapty",
1386
1521
  "pluginType": "core",
@@ -1390,22 +1525,23 @@
1390
1525
  "relativePath": [
1391
1526
  "dist",
1392
1527
  "commands",
1393
- "products",
1528
+ "placements",
1394
1529
  "list.js"
1395
1530
  ]
1396
1531
  },
1397
- "products:update": {
1532
+ "placements:update": {
1398
1533
  "aliases": [],
1399
1534
  "args": {
1400
- "product_id": {
1401
- "description": "Product ID (UUID)",
1402
- "name": "product_id",
1535
+ "placement_id": {
1536
+ "description": "Placement ID (UUID)",
1537
+ "name": "placement_id",
1403
1538
  "required": true
1404
1539
  }
1405
1540
  },
1406
- "description": "Update a product (title and access level only)",
1541
+ "description": "Update a placement",
1407
1542
  "examples": [
1408
- "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
1543
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1544
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1409
1545
  ],
1410
1546
  "flags": {
1411
1547
  "json": {
@@ -1423,16 +1559,30 @@
1423
1559
  "multiple": false,
1424
1560
  "type": "option"
1425
1561
  },
1426
- "access-level-id": {
1427
- "description": "Access level ID (UUID)",
1428
- "name": "access-level-id",
1562
+ "audiences": {
1563
+ "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1564
+ "name": "audiences",
1565
+ "hasDynamicHelp": false,
1566
+ "multiple": false,
1567
+ "type": "option"
1568
+ },
1569
+ "developer-id": {
1570
+ "description": "Developer ID for the placement",
1571
+ "name": "developer-id",
1429
1572
  "required": true,
1430
1573
  "hasDynamicHelp": false,
1431
1574
  "multiple": false,
1432
1575
  "type": "option"
1433
1576
  },
1577
+ "paywall-id": {
1578
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1579
+ "name": "paywall-id",
1580
+ "hasDynamicHelp": false,
1581
+ "multiple": false,
1582
+ "type": "option"
1583
+ },
1434
1584
  "title": {
1435
- "description": "Product title",
1585
+ "description": "Placement title",
1436
1586
  "name": "title",
1437
1587
  "required": true,
1438
1588
  "hasDynamicHelp": false,
@@ -1442,7 +1592,7 @@
1442
1592
  },
1443
1593
  "hasDynamicHelp": false,
1444
1594
  "hiddenAliases": [],
1445
- "id": "products:update",
1595
+ "id": "placements:update",
1446
1596
  "pluginAlias": "adapty",
1447
1597
  "pluginName": "adapty",
1448
1598
  "pluginType": "core",
@@ -1452,7 +1602,7 @@
1452
1602
  "relativePath": [
1453
1603
  "dist",
1454
1604
  "commands",
1455
- "products",
1605
+ "placements",
1456
1606
  "update.js"
1457
1607
  ]
1458
1608
  },
@@ -1930,12 +2080,13 @@
1930
2080
  "update.js"
1931
2081
  ]
1932
2082
  },
1933
- "asa:ads:create": {
2083
+ "asa:apps:list": {
1934
2084
  "aliases": [],
1935
2085
  "args": {},
1936
- "description": "Create an ad from a creative in an ad group",
2086
+ "description": "List the apps promoted by this company in Apple Search Ads",
1937
2087
  "examples": [
1938
- "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
2088
+ "<%= config.bin %> asa apps list",
2089
+ "<%= config.bin %> asa apps list --page 2 --page-size 50"
1939
2090
  ],
1940
2091
  "flags": {
1941
2092
  "json": {
@@ -1945,45 +2096,94 @@
1945
2096
  "allowNo": false,
1946
2097
  "type": "boolean"
1947
2098
  },
1948
- "yes": {
1949
- "char": "y",
1950
- "description": "Apply without asking; required when the output is piped or --json is used",
1951
- "name": "yes",
1952
- "allowNo": false,
1953
- "type": "boolean"
1954
- },
1955
- "idempotency-key": {
1956
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1957
- "name": "idempotency-key",
1958
- "hasDynamicHelp": false,
1959
- "multiple": false,
1960
- "type": "option"
1961
- },
1962
- "ad-group": {
1963
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
1964
- "name": "ad-group",
1965
- "required": true,
1966
- "hasDynamicHelp": false,
1967
- "multiple": false,
1968
- "type": "option"
1969
- },
1970
- "creative-id": {
1971
- "description": "Apple creative ID from a product page or the default set",
1972
- "name": "creative-id",
1973
- "required": true,
2099
+ "page": {
2100
+ "description": "Page number",
2101
+ "name": "page",
2102
+ "default": 1,
1974
2103
  "hasDynamicHelp": false,
1975
2104
  "multiple": false,
1976
2105
  "type": "option"
1977
2106
  },
1978
- "name": {
1979
- "description": "Ad name",
1980
- "name": "name",
1981
- "required": true,
2107
+ "page-size": {
2108
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2109
+ "name": "page-size",
2110
+ "default": 100,
1982
2111
  "hasDynamicHelp": false,
1983
2112
  "multiple": false,
1984
2113
  "type": "option"
1985
- },
1986
- "status": {
2114
+ }
2115
+ },
2116
+ "hasDynamicHelp": false,
2117
+ "hiddenAliases": [],
2118
+ "id": "asa:apps:list",
2119
+ "pluginAlias": "adapty",
2120
+ "pluginName": "adapty",
2121
+ "pluginType": "core",
2122
+ "strict": true,
2123
+ "enableJsonFlag": true,
2124
+ "isESM": true,
2125
+ "relativePath": [
2126
+ "dist",
2127
+ "commands",
2128
+ "asa",
2129
+ "apps",
2130
+ "list.js"
2131
+ ]
2132
+ },
2133
+ "asa:ads:create": {
2134
+ "aliases": [],
2135
+ "args": {},
2136
+ "description": "Create an ad from a creative in an ad group",
2137
+ "examples": [
2138
+ "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
2139
+ ],
2140
+ "flags": {
2141
+ "json": {
2142
+ "description": "Format output as json.",
2143
+ "helpGroup": "GLOBAL",
2144
+ "name": "json",
2145
+ "allowNo": false,
2146
+ "type": "boolean"
2147
+ },
2148
+ "yes": {
2149
+ "char": "y",
2150
+ "description": "Apply without asking; required when the output is piped or --json is used",
2151
+ "name": "yes",
2152
+ "allowNo": false,
2153
+ "type": "boolean"
2154
+ },
2155
+ "idempotency-key": {
2156
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2157
+ "name": "idempotency-key",
2158
+ "hasDynamicHelp": false,
2159
+ "multiple": false,
2160
+ "type": "option"
2161
+ },
2162
+ "ad-group": {
2163
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
2164
+ "name": "ad-group",
2165
+ "required": true,
2166
+ "hasDynamicHelp": false,
2167
+ "multiple": false,
2168
+ "type": "option"
2169
+ },
2170
+ "creative-id": {
2171
+ "description": "Apple creative ID from a product page or the default set",
2172
+ "name": "creative-id",
2173
+ "required": true,
2174
+ "hasDynamicHelp": false,
2175
+ "multiple": false,
2176
+ "type": "option"
2177
+ },
2178
+ "name": {
2179
+ "description": "Ad name",
2180
+ "name": "name",
2181
+ "required": true,
2182
+ "hasDynamicHelp": false,
2183
+ "multiple": false,
2184
+ "type": "option"
2185
+ },
2186
+ "status": {
1987
2187
  "description": "Initial status",
1988
2188
  "name": "status",
1989
2189
  "hasDynamicHelp": false,
@@ -2211,63 +2411,15 @@
2211
2411
  "update.js"
2212
2412
  ]
2213
2413
  },
2214
- "asa:apps:list": {
2215
- "aliases": [],
2216
- "args": {},
2217
- "description": "List the apps promoted by this company in Apple Search Ads",
2218
- "examples": [
2219
- "<%= config.bin %> asa apps list",
2220
- "<%= config.bin %> asa apps list --page 2 --page-size 50"
2221
- ],
2222
- "flags": {
2223
- "json": {
2224
- "description": "Format output as json.",
2225
- "helpGroup": "GLOBAL",
2226
- "name": "json",
2227
- "allowNo": false,
2228
- "type": "boolean"
2229
- },
2230
- "page": {
2231
- "description": "Page number",
2232
- "name": "page",
2233
- "default": 1,
2234
- "hasDynamicHelp": false,
2235
- "multiple": false,
2236
- "type": "option"
2237
- },
2238
- "page-size": {
2239
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2240
- "name": "page-size",
2241
- "default": 100,
2242
- "hasDynamicHelp": false,
2243
- "multiple": false,
2244
- "type": "option"
2245
- }
2246
- },
2247
- "hasDynamicHelp": false,
2248
- "hiddenAliases": [],
2249
- "id": "asa:apps:list",
2250
- "pluginAlias": "adapty",
2251
- "pluginName": "adapty",
2252
- "pluginType": "core",
2253
- "strict": true,
2254
- "enableJsonFlag": true,
2255
- "isESM": true,
2256
- "relativePath": [
2257
- "dist",
2258
- "commands",
2259
- "asa",
2260
- "apps",
2261
- "list.js"
2262
- ]
2263
- },
2264
- "asa:automations:create": {
2414
+ "asa:campaigns:bulk-create": {
2265
2415
  "aliases": [],
2266
2416
  "args": {},
2267
- "description": "Create an automation rule from a JSON rule file",
2417
+ "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2268
2418
  "examples": [
2269
- "<%= config.bin %> asa automations create --file rule.json",
2270
- "<%= config.bin %> asa automations create --file rule.json --run-now"
2419
+ "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2420
+ "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2421
+ "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2422
+ "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2271
2423
  ],
2272
2424
  "flags": {
2273
2425
  "json": {
@@ -2292,23 +2444,58 @@
2292
2444
  "type": "option"
2293
2445
  },
2294
2446
  "file": {
2295
- "description": "JSON file with the rule body, or - to read stdin",
2447
+ "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2296
2448
  "name": "file",
2297
- "required": true,
2298
2449
  "hasDynamicHelp": false,
2299
2450
  "multiple": false,
2300
2451
  "type": "option"
2301
2452
  },
2302
- "run-now": {
2303
- "description": "Queue the first run right after the rule is stored",
2304
- "name": "run-now",
2453
+ "from-file": {
2454
+ "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2455
+ "name": "from-file",
2456
+ "hasDynamicHelp": false,
2457
+ "multiple": false,
2458
+ "type": "option"
2459
+ },
2460
+ "org-id": {
2461
+ "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2462
+ "name": "org-id",
2463
+ "hasDynamicHelp": false,
2464
+ "multiple": false,
2465
+ "type": "option"
2466
+ },
2467
+ "poll-interval": {
2468
+ "description": "Seconds between progress polls",
2469
+ "name": "poll-interval",
2470
+ "default": 5,
2471
+ "hasDynamicHelp": false,
2472
+ "multiple": false,
2473
+ "type": "option"
2474
+ },
2475
+ "preview": {
2476
+ "description": "With --from-file: print the converted request and stop, nothing is created",
2477
+ "name": "preview",
2305
2478
  "allowNo": false,
2306
2479
  "type": "boolean"
2480
+ },
2481
+ "timeout": {
2482
+ "description": "Max seconds to wait for the operation to finish",
2483
+ "name": "timeout",
2484
+ "default": 900,
2485
+ "hasDynamicHelp": false,
2486
+ "multiple": false,
2487
+ "type": "option"
2488
+ },
2489
+ "wait": {
2490
+ "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2491
+ "name": "wait",
2492
+ "allowNo": true,
2493
+ "type": "boolean"
2307
2494
  }
2308
2495
  },
2309
2496
  "hasDynamicHelp": false,
2310
2497
  "hiddenAliases": [],
2311
- "id": "asa:automations:create",
2498
+ "id": "asa:campaigns:bulk-create",
2312
2499
  "pluginAlias": "adapty",
2313
2500
  "pluginName": "adapty",
2314
2501
  "pluginType": "core",
@@ -2319,55 +2506,22 @@
2319
2506
  "dist",
2320
2507
  "commands",
2321
2508
  "asa",
2322
- "automations",
2323
- "create.js"
2509
+ "campaigns",
2510
+ "bulk-create.js"
2324
2511
  ]
2325
2512
  },
2326
- "asa:automations:get": {
2513
+ "asa:campaigns:bulk-status": {
2327
2514
  "aliases": [],
2328
2515
  "args": {
2329
- "automation_id": {
2330
- "description": "Automation rule ID (UUID)",
2331
- "name": "automation_id",
2516
+ "operation-id": {
2517
+ "description": "Bulk operation ID returned by bulk-create",
2518
+ "name": "operation-id",
2332
2519
  "required": true
2333
2520
  }
2334
2521
  },
2335
- "description": "Show one automation rule with its conditions and actions",
2336
- "examples": [
2337
- "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
2338
- ],
2339
- "flags": {
2340
- "json": {
2341
- "description": "Format output as json.",
2342
- "helpGroup": "GLOBAL",
2343
- "name": "json",
2344
- "allowNo": false,
2345
- "type": "boolean"
2346
- }
2347
- },
2348
- "hasDynamicHelp": false,
2349
- "hiddenAliases": [],
2350
- "id": "asa:automations:get",
2351
- "pluginAlias": "adapty",
2352
- "pluginName": "adapty",
2353
- "pluginType": "core",
2354
- "strict": true,
2355
- "enableJsonFlag": true,
2356
- "isESM": true,
2357
- "relativePath": [
2358
- "dist",
2359
- "commands",
2360
- "asa",
2361
- "automations",
2362
- "get.js"
2363
- ]
2364
- },
2365
- "asa:automations:list": {
2366
- "aliases": [],
2367
- "args": {},
2368
- "description": "List automation rules; status 1 is active, 0 is stopped",
2522
+ "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2369
2523
  "examples": [
2370
- "<%= config.bin %> asa automations list"
2524
+ "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2371
2525
  ],
2372
2526
  "flags": {
2373
2527
  "json": {
@@ -2396,7 +2550,7 @@
2396
2550
  },
2397
2551
  "hasDynamicHelp": false,
2398
2552
  "hiddenAliases": [],
2399
- "id": "asa:automations:list",
2553
+ "id": "asa:campaigns:bulk-status",
2400
2554
  "pluginAlias": "adapty",
2401
2555
  "pluginName": "adapty",
2402
2556
  "pluginType": "core",
@@ -2407,23 +2561,16 @@
2407
2561
  "dist",
2408
2562
  "commands",
2409
2563
  "asa",
2410
- "automations",
2411
- "list.js"
2564
+ "campaigns",
2565
+ "bulk-status.js"
2412
2566
  ]
2413
2567
  },
2414
- "asa:automations:run": {
2568
+ "asa:campaigns:create": {
2415
2569
  "aliases": [],
2416
- "args": {
2417
- "automation_id": {
2418
- "description": "Automation rule ID (UUID)",
2419
- "name": "automation_id",
2420
- "required": true
2421
- }
2422
- },
2423
- "description": "Run an automation rule now; the run is queued, not awaited",
2570
+ "args": {},
2571
+ "description": "Create a campaign in Apple Search Ads",
2424
2572
  "examples": [
2425
- "<%= config.bin %> asa automations run UUID",
2426
- "<%= config.bin %> asa automations run UUID --dry-run"
2573
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
2427
2574
  ],
2428
2575
  "flags": {
2429
2576
  "json": {
@@ -2433,12 +2580,20 @@
2433
2580
  "allowNo": false,
2434
2581
  "type": "boolean"
2435
2582
  },
2436
- "yes": {
2437
- "char": "y",
2438
- "description": "Apply without asking; required when the output is piped or --json is used",
2439
- "name": "yes",
2440
- "allowNo": false,
2441
- "type": "boolean"
2583
+ "currency": {
2584
+ "description": "Currency code for the amounts in this call",
2585
+ "name": "currency",
2586
+ "default": "USD",
2587
+ "hasDynamicHelp": false,
2588
+ "multiple": false,
2589
+ "type": "option"
2590
+ },
2591
+ "yes": {
2592
+ "char": "y",
2593
+ "description": "Apply without asking; required when the output is piped or --json is used",
2594
+ "name": "yes",
2595
+ "allowNo": false,
2596
+ "type": "boolean"
2442
2597
  },
2443
2598
  "idempotency-key": {
2444
2599
  "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
@@ -2447,16 +2602,120 @@
2447
2602
  "multiple": false,
2448
2603
  "type": "option"
2449
2604
  },
2450
- "dry-run": {
2451
- "description": "Evaluate and log the rule without touching Apple",
2452
- "name": "dry-run",
2453
- "allowNo": false,
2454
- "type": "boolean"
2605
+ "ad-channel-type": {
2606
+ "description": "Ad channel type",
2607
+ "name": "ad-channel-type",
2608
+ "default": "SEARCH",
2609
+ "hasDynamicHelp": false,
2610
+ "multiple": false,
2611
+ "options": [
2612
+ "DISPLAY",
2613
+ "SEARCH"
2614
+ ],
2615
+ "type": "option"
2616
+ },
2617
+ "adam-id": {
2618
+ "description": "App Store app ID (adam_id)",
2619
+ "name": "adam-id",
2620
+ "required": true,
2621
+ "hasDynamicHelp": false,
2622
+ "multiple": false,
2623
+ "type": "option"
2624
+ },
2625
+ "bidding-strategy": {
2626
+ "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2627
+ "name": "bidding-strategy",
2628
+ "hasDynamicHelp": false,
2629
+ "multiple": false,
2630
+ "options": [
2631
+ "MANUAL_CPT",
2632
+ "MAX_CONVERSIONS"
2633
+ ],
2634
+ "type": "option"
2635
+ },
2636
+ "billing-event": {
2637
+ "description": "Billing event",
2638
+ "name": "billing-event",
2639
+ "default": "TAPS",
2640
+ "hasDynamicHelp": false,
2641
+ "multiple": false,
2642
+ "options": [
2643
+ "IMPRESSIONS",
2644
+ "TAPS"
2645
+ ],
2646
+ "type": "option"
2647
+ },
2648
+ "budget": {
2649
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2650
+ "name": "budget",
2651
+ "hasDynamicHelp": false,
2652
+ "multiple": false,
2653
+ "type": "option"
2654
+ },
2655
+ "country": {
2656
+ "description": "Country or region code, repeatable",
2657
+ "name": "country",
2658
+ "required": true,
2659
+ "hasDynamicHelp": false,
2660
+ "multiple": true,
2661
+ "type": "option"
2662
+ },
2663
+ "daily-budget": {
2664
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
2665
+ "name": "daily-budget",
2666
+ "required": true,
2667
+ "hasDynamicHelp": false,
2668
+ "multiple": false,
2669
+ "type": "option"
2670
+ },
2671
+ "name": {
2672
+ "description": "Campaign name",
2673
+ "name": "name",
2674
+ "required": true,
2675
+ "hasDynamicHelp": false,
2676
+ "multiple": false,
2677
+ "type": "option"
2678
+ },
2679
+ "org": {
2680
+ "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
2681
+ "name": "org",
2682
+ "required": true,
2683
+ "hasDynamicHelp": false,
2684
+ "multiple": false,
2685
+ "type": "option"
2686
+ },
2687
+ "status": {
2688
+ "description": "Initial status",
2689
+ "name": "status",
2690
+ "hasDynamicHelp": false,
2691
+ "multiple": false,
2692
+ "options": [
2693
+ "ENABLED",
2694
+ "PAUSED"
2695
+ ],
2696
+ "type": "option"
2697
+ },
2698
+ "supply-source": {
2699
+ "description": "Supply source, repeatable",
2700
+ "name": "supply-source",
2701
+ "default": [
2702
+ "APPSTORE_SEARCH_RESULTS"
2703
+ ],
2704
+ "hasDynamicHelp": false,
2705
+ "multiple": true,
2706
+ "type": "option"
2707
+ },
2708
+ "target-cpa": {
2709
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
2710
+ "name": "target-cpa",
2711
+ "hasDynamicHelp": false,
2712
+ "multiple": false,
2713
+ "type": "option"
2455
2714
  }
2456
2715
  },
2457
2716
  "hasDynamicHelp": false,
2458
2717
  "hiddenAliases": [],
2459
- "id": "asa:automations:run",
2718
+ "id": "asa:campaigns:create",
2460
2719
  "pluginAlias": "adapty",
2461
2720
  "pluginName": "adapty",
2462
2721
  "pluginType": "core",
@@ -2467,22 +2726,22 @@
2467
2726
  "dist",
2468
2727
  "commands",
2469
2728
  "asa",
2470
- "automations",
2471
- "run.js"
2729
+ "campaigns",
2730
+ "create.js"
2472
2731
  ]
2473
2732
  },
2474
- "asa:automations:runs": {
2733
+ "asa:campaigns:get": {
2475
2734
  "aliases": [],
2476
2735
  "args": {
2477
- "automation_id": {
2478
- "description": "Automation rule ID (UUID)",
2479
- "name": "automation_id",
2736
+ "campaign_id": {
2737
+ "description": "Campaign ID (UUID)",
2738
+ "name": "campaign_id",
2480
2739
  "required": true
2481
2740
  }
2482
2741
  },
2483
- "description": "List past runs of an automation rule, including dry runs",
2742
+ "description": "Show one campaign; read numbers with asa metrics",
2484
2743
  "examples": [
2485
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2744
+ "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
2486
2745
  ],
2487
2746
  "flags": {
2488
2747
  "json": {
@@ -2491,27 +2750,11 @@
2491
2750
  "name": "json",
2492
2751
  "allowNo": false,
2493
2752
  "type": "boolean"
2494
- },
2495
- "page": {
2496
- "description": "Page number",
2497
- "name": "page",
2498
- "default": 1,
2499
- "hasDynamicHelp": false,
2500
- "multiple": false,
2501
- "type": "option"
2502
- },
2503
- "page-size": {
2504
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2505
- "name": "page-size",
2506
- "default": 100,
2507
- "hasDynamicHelp": false,
2508
- "multiple": false,
2509
- "type": "option"
2510
2753
  }
2511
2754
  },
2512
2755
  "hasDynamicHelp": false,
2513
2756
  "hiddenAliases": [],
2514
- "id": "asa:automations:runs",
2757
+ "id": "asa:campaigns:get",
2515
2758
  "pluginAlias": "adapty",
2516
2759
  "pluginName": "adapty",
2517
2760
  "pluginType": "core",
@@ -2522,23 +2765,17 @@
2522
2765
  "dist",
2523
2766
  "commands",
2524
2767
  "asa",
2525
- "automations",
2526
- "runs.js"
2768
+ "campaigns",
2769
+ "get.js"
2527
2770
  ]
2528
2771
  },
2529
- "asa:automations:update": {
2772
+ "asa:campaigns:list": {
2530
2773
  "aliases": [],
2531
- "args": {
2532
- "automation_id": {
2533
- "description": "Automation rule ID (UUID)",
2534
- "name": "automation_id",
2535
- "required": true
2536
- }
2537
- },
2538
- "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
2774
+ "args": {},
2775
+ "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
2539
2776
  "examples": [
2540
- "<%= config.bin %> asa automations update UUID --stop",
2541
- "<%= config.bin %> asa automations update UUID --file rule.json"
2777
+ "<%= config.bin %> asa campaigns list",
2778
+ "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
2542
2779
  ],
2543
2780
  "flags": {
2544
2781
  "json": {
@@ -2548,56 +2785,58 @@
2548
2785
  "allowNo": false,
2549
2786
  "type": "boolean"
2550
2787
  },
2551
- "yes": {
2552
- "char": "y",
2553
- "description": "Apply without asking; required when the output is piped or --json is used",
2554
- "name": "yes",
2555
- "allowNo": false,
2556
- "type": "boolean"
2557
- },
2558
- "idempotency-key": {
2559
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2560
- "name": "idempotency-key",
2788
+ "page": {
2789
+ "description": "Page number",
2790
+ "name": "page",
2791
+ "default": 1,
2561
2792
  "hasDynamicHelp": false,
2562
2793
  "multiple": false,
2563
2794
  "type": "option"
2564
2795
  },
2565
- "file": {
2566
- "description": "JSON file with the parts to change, or - to read stdin",
2567
- "name": "file",
2796
+ "page-size": {
2797
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2798
+ "name": "page-size",
2799
+ "default": 100,
2568
2800
  "hasDynamicHelp": false,
2569
2801
  "multiple": false,
2570
2802
  "type": "option"
2571
2803
  },
2572
- "name": {
2573
- "description": "Rule name",
2574
- "name": "name",
2804
+ "app": {
2805
+ "description": "Keep only rows in this app; repeatable",
2806
+ "name": "app",
2575
2807
  "hasDynamicHelp": false,
2576
- "multiple": false,
2808
+ "multiple": true,
2577
2809
  "type": "option"
2578
2810
  },
2579
- "start": {
2580
- "description": "Activate the rule",
2581
- "exclusive": [
2582
- "stop"
2583
- ],
2584
- "name": "start",
2585
- "allowNo": false,
2586
- "type": "boolean"
2811
+ "campaign-group": {
2812
+ "description": "Keep only rows in this campaign group; repeatable",
2813
+ "name": "campaign-group",
2814
+ "hasDynamicHelp": false,
2815
+ "multiple": true,
2816
+ "type": "option"
2587
2817
  },
2588
- "stop": {
2589
- "description": "Stop the rule and clear its next run",
2590
- "exclusive": [
2591
- "start"
2818
+ "search": {
2819
+ "description": "Case-insensitive substring match on the name",
2820
+ "name": "search",
2821
+ "hasDynamicHelp": false,
2822
+ "multiple": false,
2823
+ "type": "option"
2824
+ },
2825
+ "status": {
2826
+ "description": "Keep only rows in this state",
2827
+ "name": "status",
2828
+ "hasDynamicHelp": false,
2829
+ "multiple": false,
2830
+ "options": [
2831
+ "ENABLED",
2832
+ "PAUSED"
2592
2833
  ],
2593
- "name": "stop",
2594
- "allowNo": false,
2595
- "type": "boolean"
2834
+ "type": "option"
2596
2835
  }
2597
2836
  },
2598
2837
  "hasDynamicHelp": false,
2599
2838
  "hiddenAliases": [],
2600
- "id": "asa:automations:update",
2839
+ "id": "asa:campaigns:list",
2601
2840
  "pluginAlias": "adapty",
2602
2841
  "pluginName": "adapty",
2603
2842
  "pluginType": "core",
@@ -2608,19 +2847,23 @@
2608
2847
  "dist",
2609
2848
  "commands",
2610
2849
  "asa",
2611
- "automations",
2612
- "update.js"
2850
+ "campaigns",
2851
+ "list.js"
2613
2852
  ]
2614
2853
  },
2615
- "asa:campaigns:bulk-create": {
2854
+ "asa:campaigns:update": {
2616
2855
  "aliases": [],
2617
- "args": {},
2618
- "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2856
+ "args": {
2857
+ "campaign_id": {
2858
+ "description": "Campaign ID (UUID)",
2859
+ "name": "campaign_id",
2860
+ "required": true
2861
+ }
2862
+ },
2863
+ "description": "Change a campaign: budgets, countries, status or schedule",
2619
2864
  "examples": [
2620
- "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2621
- "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2622
- "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2623
- "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2865
+ "<%= config.bin %> asa campaigns update UUID --status PAUSED",
2866
+ "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
2624
2867
  ],
2625
2868
  "flags": {
2626
2869
  "json": {
@@ -2630,6 +2873,14 @@
2630
2873
  "allowNo": false,
2631
2874
  "type": "boolean"
2632
2875
  },
2876
+ "currency": {
2877
+ "description": "Currency code for the amounts in this call",
2878
+ "name": "currency",
2879
+ "default": "USD",
2880
+ "hasDynamicHelp": false,
2881
+ "multiple": false,
2882
+ "type": "option"
2883
+ },
2633
2884
  "yes": {
2634
2885
  "char": "y",
2635
2886
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2644,59 +2895,67 @@
2644
2895
  "multiple": false,
2645
2896
  "type": "option"
2646
2897
  },
2647
- "file": {
2648
- "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2649
- "name": "file",
2898
+ "bidding-strategy": {
2899
+ "description": "Bidding strategy",
2900
+ "name": "bidding-strategy",
2650
2901
  "hasDynamicHelp": false,
2651
2902
  "multiple": false,
2903
+ "options": [
2904
+ "MANUAL_CPT",
2905
+ "MAX_CONVERSIONS"
2906
+ ],
2652
2907
  "type": "option"
2653
2908
  },
2654
- "from-file": {
2655
- "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2656
- "name": "from-file",
2909
+ "budget": {
2910
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2911
+ "name": "budget",
2657
2912
  "hasDynamicHelp": false,
2658
2913
  "multiple": false,
2659
2914
  "type": "option"
2660
2915
  },
2661
- "org-id": {
2662
- "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2663
- "name": "org-id",
2916
+ "country": {
2917
+ "description": "Replace the country list, repeatable",
2918
+ "name": "country",
2664
2919
  "hasDynamicHelp": false,
2665
- "multiple": false,
2920
+ "multiple": true,
2666
2921
  "type": "option"
2667
2922
  },
2668
- "poll-interval": {
2669
- "description": "Seconds between progress polls",
2670
- "name": "poll-interval",
2671
- "default": 5,
2923
+ "daily-budget": {
2924
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
2925
+ "name": "daily-budget",
2672
2926
  "hasDynamicHelp": false,
2673
2927
  "multiple": false,
2674
2928
  "type": "option"
2675
2929
  },
2676
- "preview": {
2677
- "description": "With --from-file: print the converted request and stop, nothing is created",
2678
- "name": "preview",
2679
- "allowNo": false,
2680
- "type": "boolean"
2930
+ "name": {
2931
+ "description": "Campaign name",
2932
+ "name": "name",
2933
+ "hasDynamicHelp": false,
2934
+ "multiple": false,
2935
+ "type": "option"
2681
2936
  },
2682
- "timeout": {
2683
- "description": "Max seconds to wait for the operation to finish",
2684
- "name": "timeout",
2685
- "default": 900,
2937
+ "status": {
2938
+ "description": "Campaign status",
2939
+ "name": "status",
2686
2940
  "hasDynamicHelp": false,
2687
2941
  "multiple": false,
2942
+ "options": [
2943
+ "ENABLED",
2944
+ "PAUSED"
2945
+ ],
2688
2946
  "type": "option"
2689
2947
  },
2690
- "wait": {
2691
- "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2692
- "name": "wait",
2693
- "allowNo": true,
2694
- "type": "boolean"
2948
+ "target-cpa": {
2949
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
2950
+ "name": "target-cpa",
2951
+ "hasDynamicHelp": false,
2952
+ "multiple": false,
2953
+ "type": "option"
2695
2954
  }
2696
2955
  },
2697
2956
  "hasDynamicHelp": false,
2698
2957
  "hiddenAliases": [],
2699
- "id": "asa:campaigns:bulk-create",
2958
+ "id": "asa:campaigns:update",
2700
2959
  "pluginAlias": "adapty",
2701
2960
  "pluginName": "adapty",
2702
2961
  "pluginType": "core",
@@ -2708,21 +2967,57 @@
2708
2967
  "commands",
2709
2968
  "asa",
2710
2969
  "campaigns",
2711
- "bulk-create.js"
2970
+ "update.js"
2712
2971
  ]
2713
2972
  },
2714
- "asa:campaigns:bulk-status": {
2973
+ "asa:competitors:summary": {
2715
2974
  "aliases": [],
2716
- "args": {
2717
- "operation-id": {
2718
- "description": "Bulk operation ID returned by bulk-create",
2719
- "name": "operation-id",
2720
- "required": true
2975
+ "args": {},
2976
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2977
+ "examples": [
2978
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2979
+ ],
2980
+ "flags": {
2981
+ "json": {
2982
+ "description": "Format output as json.",
2983
+ "helpGroup": "GLOBAL",
2984
+ "name": "json",
2985
+ "allowNo": false,
2986
+ "type": "boolean"
2987
+ },
2988
+ "app-ids": {
2989
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2990
+ "name": "app-ids",
2991
+ "required": true,
2992
+ "hasDynamicHelp": false,
2993
+ "multiple": false,
2994
+ "type": "option"
2721
2995
  }
2722
2996
  },
2723
- "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2997
+ "hasDynamicHelp": false,
2998
+ "hiddenAliases": [],
2999
+ "id": "asa:competitors:summary",
3000
+ "pluginAlias": "adapty",
3001
+ "pluginName": "adapty",
3002
+ "pluginType": "core",
3003
+ "strict": true,
3004
+ "enableJsonFlag": true,
3005
+ "isESM": true,
3006
+ "relativePath": [
3007
+ "dist",
3008
+ "commands",
3009
+ "asa",
3010
+ "competitors",
3011
+ "summary.js"
3012
+ ]
3013
+ },
3014
+ "asa:creatives:list": {
3015
+ "aliases": [],
3016
+ "args": {},
3017
+ "description": "List creatives; creative_id is what `asa ads create` needs",
2724
3018
  "examples": [
2725
- "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
3019
+ "<%= config.bin %> asa creatives list",
3020
+ "<%= config.bin %> asa creatives list --app APP_UUID"
2726
3021
  ],
2727
3022
  "flags": {
2728
3023
  "json": {
@@ -2747,11 +3042,25 @@
2747
3042
  "hasDynamicHelp": false,
2748
3043
  "multiple": false,
2749
3044
  "type": "option"
3045
+ },
3046
+ "app": {
3047
+ "description": "Keep only rows in this app; repeatable",
3048
+ "name": "app",
3049
+ "hasDynamicHelp": false,
3050
+ "multiple": true,
3051
+ "type": "option"
3052
+ },
3053
+ "campaign-group": {
3054
+ "description": "Keep only rows in this campaign group; repeatable",
3055
+ "name": "campaign-group",
3056
+ "hasDynamicHelp": false,
3057
+ "multiple": true,
3058
+ "type": "option"
2750
3059
  }
2751
3060
  },
2752
3061
  "hasDynamicHelp": false,
2753
3062
  "hiddenAliases": [],
2754
- "id": "asa:campaigns:bulk-status",
3063
+ "id": "asa:creatives:list",
2755
3064
  "pluginAlias": "adapty",
2756
3065
  "pluginName": "adapty",
2757
3066
  "pluginType": "core",
@@ -2762,16 +3071,17 @@
2762
3071
  "dist",
2763
3072
  "commands",
2764
3073
  "asa",
2765
- "campaigns",
2766
- "bulk-status.js"
3074
+ "creatives",
3075
+ "list.js"
2767
3076
  ]
2768
3077
  },
2769
- "asa:campaigns:create": {
3078
+ "asa:keywords:add": {
2770
3079
  "aliases": [],
2771
3080
  "args": {},
2772
- "description": "Create a campaign in Apple Search Ads",
3081
+ "description": "Add targeting keywords to an ad group",
2773
3082
  "examples": [
2774
- "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
3083
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3084
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
2775
3085
  ],
2776
3086
  "flags": {
2777
3087
  "json": {
@@ -2803,159 +3113,63 @@
2803
3113
  "multiple": false,
2804
3114
  "type": "option"
2805
3115
  },
2806
- "ad-channel-type": {
2807
- "description": "Ad channel type",
2808
- "name": "ad-channel-type",
2809
- "default": "SEARCH",
3116
+ "ad-group": {
3117
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3118
+ "name": "ad-group",
3119
+ "required": true,
2810
3120
  "hasDynamicHelp": false,
2811
3121
  "multiple": false,
2812
- "options": [
2813
- "DISPLAY",
2814
- "SEARCH"
2815
- ],
2816
3122
  "type": "option"
2817
3123
  },
2818
- "adam-id": {
2819
- "description": "App Store app ID (adam_id)",
2820
- "name": "adam-id",
2821
- "required": true,
3124
+ "bid": {
3125
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3126
+ "name": "bid",
2822
3127
  "hasDynamicHelp": false,
2823
3128
  "multiple": false,
2824
3129
  "type": "option"
2825
3130
  },
2826
- "bidding-strategy": {
2827
- "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2828
- "name": "bidding-strategy",
3131
+ "from-file": {
3132
+ "description": "File with one keyword per line, combined with any --text values",
3133
+ "name": "from-file",
2829
3134
  "hasDynamicHelp": false,
2830
3135
  "multiple": false,
2831
- "options": [
2832
- "MANUAL_CPT",
2833
- "MAX_CONVERSIONS"
2834
- ],
2835
3136
  "type": "option"
2836
3137
  },
2837
- "billing-event": {
2838
- "description": "Billing event",
2839
- "name": "billing-event",
2840
- "default": "TAPS",
3138
+ "match-type": {
3139
+ "description": "Match type",
3140
+ "name": "match-type",
3141
+ "default": "BROAD",
2841
3142
  "hasDynamicHelp": false,
2842
3143
  "multiple": false,
2843
3144
  "options": [
2844
- "IMPRESSIONS",
2845
- "TAPS"
3145
+ "BROAD",
3146
+ "EXACT"
2846
3147
  ],
2847
3148
  "type": "option"
2848
3149
  },
2849
- "budget": {
2850
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2851
- "name": "budget",
2852
- "hasDynamicHelp": false,
2853
- "multiple": false,
2854
- "type": "option"
2855
- },
2856
- "country": {
2857
- "description": "Country or region code, repeatable",
2858
- "name": "country",
2859
- "required": true,
2860
- "hasDynamicHelp": false,
2861
- "multiple": true,
2862
- "type": "option"
2863
- },
2864
- "daily-budget": {
2865
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
2866
- "name": "daily-budget",
2867
- "required": true,
2868
- "hasDynamicHelp": false,
2869
- "multiple": false,
2870
- "type": "option"
2871
- },
2872
- "name": {
2873
- "description": "Campaign name",
2874
- "name": "name",
2875
- "required": true,
2876
- "hasDynamicHelp": false,
2877
- "multiple": false,
2878
- "type": "option"
2879
- },
2880
- "org": {
2881
- "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
2882
- "name": "org",
2883
- "required": true,
2884
- "hasDynamicHelp": false,
2885
- "multiple": false,
2886
- "type": "option"
2887
- },
2888
3150
  "status": {
2889
- "description": "Initial status",
3151
+ "description": "Keyword status",
2890
3152
  "name": "status",
3153
+ "default": "ACTIVE",
2891
3154
  "hasDynamicHelp": false,
2892
3155
  "multiple": false,
2893
3156
  "options": [
2894
- "ENABLED",
3157
+ "ACTIVE",
2895
3158
  "PAUSED"
2896
3159
  ],
2897
3160
  "type": "option"
2898
3161
  },
2899
- "supply-source": {
2900
- "description": "Supply source, repeatable",
2901
- "name": "supply-source",
2902
- "default": [
2903
- "APPSTORE_SEARCH_RESULTS"
2904
- ],
3162
+ "text": {
3163
+ "description": "Keyword text, repeatable",
3164
+ "name": "text",
2905
3165
  "hasDynamicHelp": false,
2906
3166
  "multiple": true,
2907
3167
  "type": "option"
2908
- },
2909
- "target-cpa": {
2910
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
2911
- "name": "target-cpa",
2912
- "hasDynamicHelp": false,
2913
- "multiple": false,
2914
- "type": "option"
2915
- }
2916
- },
2917
- "hasDynamicHelp": false,
2918
- "hiddenAliases": [],
2919
- "id": "asa:campaigns:create",
2920
- "pluginAlias": "adapty",
2921
- "pluginName": "adapty",
2922
- "pluginType": "core",
2923
- "strict": true,
2924
- "enableJsonFlag": true,
2925
- "isESM": true,
2926
- "relativePath": [
2927
- "dist",
2928
- "commands",
2929
- "asa",
2930
- "campaigns",
2931
- "create.js"
2932
- ]
2933
- },
2934
- "asa:campaigns:get": {
2935
- "aliases": [],
2936
- "args": {
2937
- "campaign_id": {
2938
- "description": "Campaign ID (UUID)",
2939
- "name": "campaign_id",
2940
- "required": true
2941
- }
2942
- },
2943
- "description": "Show one campaign; read numbers with asa metrics",
2944
- "examples": [
2945
- "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
2946
- ],
2947
- "flags": {
2948
- "json": {
2949
- "description": "Format output as json.",
2950
- "helpGroup": "GLOBAL",
2951
- "name": "json",
2952
- "allowNo": false,
2953
- "type": "boolean"
2954
3168
  }
2955
3169
  },
2956
3170
  "hasDynamicHelp": false,
2957
3171
  "hiddenAliases": [],
2958
- "id": "asa:campaigns:get",
3172
+ "id": "asa:keywords:add",
2959
3173
  "pluginAlias": "adapty",
2960
3174
  "pluginName": "adapty",
2961
3175
  "pluginType": "core",
@@ -2966,17 +3180,17 @@
2966
3180
  "dist",
2967
3181
  "commands",
2968
3182
  "asa",
2969
- "campaigns",
2970
- "get.js"
3183
+ "keywords",
3184
+ "add.js"
2971
3185
  ]
2972
3186
  },
2973
- "asa:campaigns:list": {
3187
+ "asa:keywords:list": {
2974
3188
  "aliases": [],
2975
3189
  "args": {},
2976
- "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
3190
+ "description": "List targeting keywords; read numbers with asa metrics",
2977
3191
  "examples": [
2978
- "<%= config.bin %> asa campaigns list",
2979
- "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
3192
+ "<%= config.bin %> asa keywords list",
3193
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
2980
3194
  ],
2981
3195
  "flags": {
2982
3196
  "json": {
@@ -3023,13 +3237,27 @@
3023
3237
  "multiple": false,
3024
3238
  "type": "option"
3025
3239
  },
3240
+ "campaign": {
3241
+ "description": "Keep only rows in this campaign; repeatable",
3242
+ "name": "campaign",
3243
+ "hasDynamicHelp": false,
3244
+ "multiple": true,
3245
+ "type": "option"
3246
+ },
3247
+ "ad-group": {
3248
+ "description": "Keep only rows in this ad group; repeatable",
3249
+ "name": "ad-group",
3250
+ "hasDynamicHelp": false,
3251
+ "multiple": true,
3252
+ "type": "option"
3253
+ },
3026
3254
  "status": {
3027
3255
  "description": "Keep only rows in this state",
3028
3256
  "name": "status",
3029
3257
  "hasDynamicHelp": false,
3030
3258
  "multiple": false,
3031
3259
  "options": [
3032
- "ENABLED",
3260
+ "ACTIVE",
3033
3261
  "PAUSED"
3034
3262
  ],
3035
3263
  "type": "option"
@@ -3037,7 +3265,7 @@
3037
3265
  },
3038
3266
  "hasDynamicHelp": false,
3039
3267
  "hiddenAliases": [],
3040
- "id": "asa:campaigns:list",
3268
+ "id": "asa:keywords:list",
3041
3269
  "pluginAlias": "adapty",
3042
3270
  "pluginName": "adapty",
3043
3271
  "pluginType": "core",
@@ -3048,23 +3276,23 @@
3048
3276
  "dist",
3049
3277
  "commands",
3050
3278
  "asa",
3051
- "campaigns",
3279
+ "keywords",
3052
3280
  "list.js"
3053
3281
  ]
3054
3282
  },
3055
- "asa:campaigns:update": {
3283
+ "asa:keywords:update": {
3056
3284
  "aliases": [],
3057
3285
  "args": {
3058
- "campaign_id": {
3059
- "description": "Campaign ID (UUID)",
3060
- "name": "campaign_id",
3286
+ "keyword_id": {
3287
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3288
+ "name": "keyword_id",
3061
3289
  "required": true
3062
3290
  }
3063
3291
  },
3064
- "description": "Change a campaign: budgets, countries, status or schedule",
3292
+ "description": "Change bid, status, text or match type of keywords",
3065
3293
  "examples": [
3066
- "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3067
- "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
3294
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3295
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3068
3296
  ],
3069
3297
  "flags": {
3070
3298
  "json": {
@@ -3076,79 +3304,58 @@
3076
3304
  },
3077
3305
  "currency": {
3078
3306
  "description": "Currency code for the amounts in this call",
3079
- "name": "currency",
3080
- "default": "USD",
3081
- "hasDynamicHelp": false,
3082
- "multiple": false,
3083
- "type": "option"
3084
- },
3085
- "yes": {
3086
- "char": "y",
3087
- "description": "Apply without asking; required when the output is piped or --json is used",
3088
- "name": "yes",
3089
- "allowNo": false,
3090
- "type": "boolean"
3091
- },
3092
- "idempotency-key": {
3093
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3094
- "name": "idempotency-key",
3095
- "hasDynamicHelp": false,
3096
- "multiple": false,
3097
- "type": "option"
3098
- },
3099
- "bidding-strategy": {
3100
- "description": "Bidding strategy",
3101
- "name": "bidding-strategy",
3102
- "hasDynamicHelp": false,
3103
- "multiple": false,
3104
- "options": [
3105
- "MANUAL_CPT",
3106
- "MAX_CONVERSIONS"
3107
- ],
3108
- "type": "option"
3109
- },
3110
- "budget": {
3111
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3112
- "name": "budget",
3307
+ "name": "currency",
3308
+ "default": "USD",
3113
3309
  "hasDynamicHelp": false,
3114
3310
  "multiple": false,
3115
3311
  "type": "option"
3116
3312
  },
3117
- "country": {
3118
- "description": "Replace the country list, repeatable",
3119
- "name": "country",
3313
+ "yes": {
3314
+ "char": "y",
3315
+ "description": "Apply without asking; required when the output is piped or --json is used",
3316
+ "name": "yes",
3317
+ "allowNo": false,
3318
+ "type": "boolean"
3319
+ },
3320
+ "idempotency-key": {
3321
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3322
+ "name": "idempotency-key",
3120
3323
  "hasDynamicHelp": false,
3121
- "multiple": true,
3324
+ "multiple": false,
3122
3325
  "type": "option"
3123
3326
  },
3124
- "daily-budget": {
3125
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
3126
- "name": "daily-budget",
3327
+ "bid": {
3328
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3329
+ "name": "bid",
3127
3330
  "hasDynamicHelp": false,
3128
3331
  "multiple": false,
3129
3332
  "type": "option"
3130
3333
  },
3131
- "name": {
3132
- "description": "Campaign name",
3133
- "name": "name",
3334
+ "match-type": {
3335
+ "description": "Match type",
3336
+ "name": "match-type",
3134
3337
  "hasDynamicHelp": false,
3135
3338
  "multiple": false,
3339
+ "options": [
3340
+ "BROAD",
3341
+ "EXACT"
3342
+ ],
3136
3343
  "type": "option"
3137
3344
  },
3138
3345
  "status": {
3139
- "description": "Campaign status",
3346
+ "description": "Keyword status",
3140
3347
  "name": "status",
3141
3348
  "hasDynamicHelp": false,
3142
3349
  "multiple": false,
3143
3350
  "options": [
3144
- "ENABLED",
3351
+ "ACTIVE",
3145
3352
  "PAUSED"
3146
3353
  ],
3147
3354
  "type": "option"
3148
3355
  },
3149
- "target-cpa": {
3150
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
3151
- "name": "target-cpa",
3356
+ "text": {
3357
+ "description": "Keyword text (only meaningful for a single keyword)",
3358
+ "name": "text",
3152
3359
  "hasDynamicHelp": false,
3153
3360
  "multiple": false,
3154
3361
  "type": "option"
@@ -3156,27 +3363,31 @@
3156
3363
  },
3157
3364
  "hasDynamicHelp": false,
3158
3365
  "hiddenAliases": [],
3159
- "id": "asa:campaigns:update",
3366
+ "id": "asa:keywords:update",
3160
3367
  "pluginAlias": "adapty",
3161
3368
  "pluginName": "adapty",
3162
3369
  "pluginType": "core",
3163
- "strict": true,
3370
+ "strict": false,
3164
3371
  "enableJsonFlag": true,
3165
3372
  "isESM": true,
3166
3373
  "relativePath": [
3167
3374
  "dist",
3168
3375
  "commands",
3169
3376
  "asa",
3170
- "campaigns",
3377
+ "keywords",
3171
3378
  "update.js"
3172
3379
  ]
3173
3380
  },
3174
- "asa:competitors:summary": {
3381
+ "asa:metrics": {
3175
3382
  "aliases": [],
3176
3383
  "args": {},
3177
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
3384
+ "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3178
3385
  "examples": [
3179
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
3386
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3387
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3388
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3389
+ "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3390
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3180
3391
  ],
3181
3392
  "flags": {
3182
3393
  "json": {
@@ -3186,18 +3397,111 @@
3186
3397
  "allowNo": false,
3187
3398
  "type": "boolean"
3188
3399
  },
3189
- "app-ids": {
3190
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3191
- "name": "app-ids",
3400
+ "page": {
3401
+ "description": "Page number",
3402
+ "name": "page",
3403
+ "default": 1,
3404
+ "hasDynamicHelp": false,
3405
+ "multiple": false,
3406
+ "type": "option"
3407
+ },
3408
+ "page-size": {
3409
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3410
+ "name": "page-size",
3411
+ "default": 100,
3412
+ "hasDynamicHelp": false,
3413
+ "multiple": false,
3414
+ "type": "option"
3415
+ },
3416
+ "by-days": {
3417
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3418
+ "name": "by-days",
3419
+ "hasDynamicHelp": false,
3420
+ "multiple": true,
3421
+ "type": "option"
3422
+ },
3423
+ "date-from": {
3424
+ "description": "Start of the period (YYYY-MM-DD)",
3425
+ "name": "date-from",
3426
+ "required": true,
3427
+ "hasDynamicHelp": false,
3428
+ "multiple": false,
3429
+ "type": "option"
3430
+ },
3431
+ "date-to": {
3432
+ "description": "End of the period (YYYY-MM-DD)",
3433
+ "name": "date-to",
3192
3434
  "required": true,
3193
3435
  "hasDynamicHelp": false,
3194
3436
  "multiple": false,
3195
3437
  "type": "option"
3438
+ },
3439
+ "entity": {
3440
+ "description": "What to report on",
3441
+ "name": "entity",
3442
+ "required": true,
3443
+ "hasDynamicHelp": false,
3444
+ "multiple": false,
3445
+ "options": [
3446
+ "ad",
3447
+ "ad-group",
3448
+ "campaign",
3449
+ "keyword"
3450
+ ],
3451
+ "type": "option"
3452
+ },
3453
+ "group-by": {
3454
+ "description": "Break the rows down by a dimension, repeatable",
3455
+ "name": "group-by",
3456
+ "hasDynamicHelp": false,
3457
+ "multiple": true,
3458
+ "options": [
3459
+ "country",
3460
+ "day",
3461
+ "month",
3462
+ "quarter",
3463
+ "week",
3464
+ "year"
3465
+ ],
3466
+ "type": "option"
3467
+ },
3468
+ "metric": {
3469
+ "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3470
+ "name": "metric",
3471
+ "hasDynamicHelp": false,
3472
+ "multiple": true,
3473
+ "type": "option"
3474
+ },
3475
+ "order": {
3476
+ "description": "Sort direction",
3477
+ "name": "order",
3478
+ "default": "desc",
3479
+ "hasDynamicHelp": false,
3480
+ "multiple": false,
3481
+ "options": [
3482
+ "asc",
3483
+ "desc"
3484
+ ],
3485
+ "type": "option"
3486
+ },
3487
+ "order-by": {
3488
+ "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3489
+ "name": "order-by",
3490
+ "hasDynamicHelp": false,
3491
+ "multiple": false,
3492
+ "type": "option"
3493
+ },
3494
+ "order-by-day": {
3495
+ "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3496
+ "name": "order-by-day",
3497
+ "hasDynamicHelp": false,
3498
+ "multiple": false,
3499
+ "type": "option"
3196
3500
  }
3197
3501
  },
3198
3502
  "hasDynamicHelp": false,
3199
3503
  "hiddenAliases": [],
3200
- "id": "asa:competitors:summary",
3504
+ "id": "asa:metrics",
3201
3505
  "pluginAlias": "adapty",
3202
3506
  "pluginName": "adapty",
3203
3507
  "pluginType": "core",
@@ -3208,17 +3512,17 @@
3208
3512
  "dist",
3209
3513
  "commands",
3210
3514
  "asa",
3211
- "competitors",
3212
- "summary.js"
3515
+ "metrics",
3516
+ "index.js"
3213
3517
  ]
3214
3518
  },
3215
- "asa:creatives:list": {
3519
+ "asa:metrics:overview": {
3216
3520
  "aliases": [],
3217
3521
  "args": {},
3218
- "description": "List creatives; creative_id is what `asa ads create` needs",
3522
+ "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
3219
3523
  "examples": [
3220
- "<%= config.bin %> asa creatives list",
3221
- "<%= config.bin %> asa creatives list --app APP_UUID"
3524
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3525
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3222
3526
  ],
3223
3527
  "flags": {
3224
3528
  "json": {
@@ -3228,40 +3532,69 @@
3228
3532
  "allowNo": false,
3229
3533
  "type": "boolean"
3230
3534
  },
3231
- "page": {
3232
- "description": "Page number",
3233
- "name": "page",
3234
- "default": 1,
3535
+ "by-days": {
3536
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3537
+ "name": "by-days",
3538
+ "hasDynamicHelp": false,
3539
+ "multiple": true,
3540
+ "type": "option"
3541
+ },
3542
+ "date-from": {
3543
+ "description": "Start of the period (YYYY-MM-DD)",
3544
+ "name": "date-from",
3545
+ "required": true,
3235
3546
  "hasDynamicHelp": false,
3236
3547
  "multiple": false,
3237
3548
  "type": "option"
3238
3549
  },
3239
- "page-size": {
3240
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3241
- "name": "page-size",
3242
- "default": 100,
3550
+ "date-to": {
3551
+ "description": "End of the period (YYYY-MM-DD)",
3552
+ "name": "date-to",
3553
+ "required": true,
3243
3554
  "hasDynamicHelp": false,
3244
3555
  "multiple": false,
3245
3556
  "type": "option"
3246
3557
  },
3247
- "app": {
3248
- "description": "Keep only rows in this app; repeatable",
3249
- "name": "app",
3558
+ "entity": {
3559
+ "description": "What to report on",
3560
+ "name": "entity",
3561
+ "required": true,
3250
3562
  "hasDynamicHelp": false,
3251
- "multiple": true,
3563
+ "multiple": false,
3564
+ "options": [
3565
+ "ad",
3566
+ "ad-group",
3567
+ "campaign",
3568
+ "keyword"
3569
+ ],
3252
3570
  "type": "option"
3253
3571
  },
3254
- "campaign-group": {
3255
- "description": "Keep only rows in this campaign group; repeatable",
3256
- "name": "campaign-group",
3572
+ "metric": {
3573
+ "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3574
+ "name": "metric",
3257
3575
  "hasDynamicHelp": false,
3258
3576
  "multiple": true,
3259
3577
  "type": "option"
3578
+ },
3579
+ "period-unit": {
3580
+ "description": "Bucket size",
3581
+ "name": "period-unit",
3582
+ "default": "day",
3583
+ "hasDynamicHelp": false,
3584
+ "multiple": false,
3585
+ "options": [
3586
+ "day",
3587
+ "month",
3588
+ "quarter",
3589
+ "week",
3590
+ "year"
3591
+ ],
3592
+ "type": "option"
3260
3593
  }
3261
3594
  },
3262
3595
  "hasDynamicHelp": false,
3263
3596
  "hiddenAliases": [],
3264
- "id": "asa:creatives:list",
3597
+ "id": "asa:metrics:overview",
3265
3598
  "pluginAlias": "adapty",
3266
3599
  "pluginName": "adapty",
3267
3600
  "pluginType": "core",
@@ -3272,17 +3605,18 @@
3272
3605
  "dist",
3273
3606
  "commands",
3274
3607
  "asa",
3275
- "creatives",
3276
- "list.js"
3608
+ "metrics",
3609
+ "overview.js"
3277
3610
  ]
3278
3611
  },
3279
- "asa:keywords:add": {
3612
+ "asa:negative-keywords:add": {
3280
3613
  "aliases": [],
3281
3614
  "args": {},
3282
- "description": "Add targeting keywords to an ad group",
3615
+ "description": "Add negative keywords to an ad group or across a campaign",
3283
3616
  "examples": [
3284
- "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3285
- "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3617
+ "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3618
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3619
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3286
3620
  ],
3287
3621
  "flags": {
3288
3622
  "json": {
@@ -3292,14 +3626,6 @@
3292
3626
  "allowNo": false,
3293
3627
  "type": "boolean"
3294
3628
  },
3295
- "currency": {
3296
- "description": "Currency code for the amounts in this call",
3297
- "name": "currency",
3298
- "default": "USD",
3299
- "hasDynamicHelp": false,
3300
- "multiple": false,
3301
- "type": "option"
3302
- },
3303
3629
  "yes": {
3304
3630
  "char": "y",
3305
3631
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3316,22 +3642,29 @@
3316
3642
  },
3317
3643
  "ad-group": {
3318
3644
  "description": "Ad group ID (UUID) — the campaign is resolved from it",
3645
+ "exclusive": [
3646
+ "campaign"
3647
+ ],
3319
3648
  "name": "ad-group",
3320
- "required": true,
3321
3649
  "hasDynamicHelp": false,
3322
3650
  "multiple": false,
3323
3651
  "type": "option"
3324
3652
  },
3325
- "bid": {
3326
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3327
- "name": "bid",
3328
- "hasDynamicHelp": false,
3329
- "multiple": false,
3330
- "type": "option"
3653
+ "all-ad-groups": {
3654
+ "dependsOn": [
3655
+ "campaign"
3656
+ ],
3657
+ "description": "Apply to every ad group of the campaign instead of the campaign itself",
3658
+ "name": "all-ad-groups",
3659
+ "allowNo": false,
3660
+ "type": "boolean"
3331
3661
  },
3332
- "from-file": {
3333
- "description": "File with one keyword per line, combined with any --text values",
3334
- "name": "from-file",
3662
+ "campaign": {
3663
+ "description": "Campaign ID (UUID)",
3664
+ "exclusive": [
3665
+ "ad-group"
3666
+ ],
3667
+ "name": "campaign",
3335
3668
  "hasDynamicHelp": false,
3336
3669
  "multiple": false,
3337
3670
  "type": "option"
@@ -3339,7 +3672,7 @@
3339
3672
  "match-type": {
3340
3673
  "description": "Match type",
3341
3674
  "name": "match-type",
3342
- "default": "BROAD",
3675
+ "default": "EXACT",
3343
3676
  "hasDynamicHelp": false,
3344
3677
  "multiple": false,
3345
3678
  "options": [
@@ -3363,6 +3696,7 @@
3363
3696
  "text": {
3364
3697
  "description": "Keyword text, repeatable",
3365
3698
  "name": "text",
3699
+ "required": true,
3366
3700
  "hasDynamicHelp": false,
3367
3701
  "multiple": true,
3368
3702
  "type": "option"
@@ -3370,7 +3704,7 @@
3370
3704
  },
3371
3705
  "hasDynamicHelp": false,
3372
3706
  "hiddenAliases": [],
3373
- "id": "asa:keywords:add",
3707
+ "id": "asa:negative-keywords:add",
3374
3708
  "pluginAlias": "adapty",
3375
3709
  "pluginName": "adapty",
3376
3710
  "pluginType": "core",
@@ -3381,17 +3715,17 @@
3381
3715
  "dist",
3382
3716
  "commands",
3383
3717
  "asa",
3384
- "keywords",
3718
+ "negative-keywords",
3385
3719
  "add.js"
3386
3720
  ]
3387
3721
  },
3388
- "asa:keywords:list": {
3722
+ "asa:negative-keywords:list": {
3389
3723
  "aliases": [],
3390
3724
  "args": {},
3391
- "description": "List targeting keywords; read numbers with asa metrics",
3725
+ "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3392
3726
  "examples": [
3393
- "<%= config.bin %> asa keywords list",
3394
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3727
+ "<%= config.bin %> asa negative-keywords list",
3728
+ "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3395
3729
  ],
3396
3730
  "flags": {
3397
3731
  "json": {
@@ -3452,21 +3786,16 @@
3452
3786
  "multiple": true,
3453
3787
  "type": "option"
3454
3788
  },
3455
- "status": {
3456
- "description": "Keep only rows in this state",
3457
- "name": "status",
3458
- "hasDynamicHelp": false,
3459
- "multiple": false,
3460
- "options": [
3461
- "ACTIVE",
3462
- "PAUSED"
3463
- ],
3464
- "type": "option"
3789
+ "campaign-level-only": {
3790
+ "description": "Keep only campaign-level rows (ad_group_id is null)",
3791
+ "name": "campaign-level-only",
3792
+ "allowNo": false,
3793
+ "type": "boolean"
3465
3794
  }
3466
3795
  },
3467
3796
  "hasDynamicHelp": false,
3468
3797
  "hiddenAliases": [],
3469
- "id": "asa:keywords:list",
3798
+ "id": "asa:negative-keywords:list",
3470
3799
  "pluginAlias": "adapty",
3471
3800
  "pluginName": "adapty",
3472
3801
  "pluginType": "core",
@@ -3477,23 +3806,16 @@
3477
3806
  "dist",
3478
3807
  "commands",
3479
3808
  "asa",
3480
- "keywords",
3809
+ "negative-keywords",
3481
3810
  "list.js"
3482
3811
  ]
3483
3812
  },
3484
- "asa:keywords:update": {
3813
+ "asa:orgs:list": {
3485
3814
  "aliases": [],
3486
- "args": {
3487
- "keyword_id": {
3488
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3489
- "name": "keyword_id",
3490
- "required": true
3491
- }
3492
- },
3493
- "description": "Change bid, status, text or match type of keywords",
3815
+ "args": {},
3816
+ "description": "List the Apple Search Ads organizations this company can spend from",
3494
3817
  "examples": [
3495
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3496
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3818
+ "<%= config.bin %> asa orgs list"
3497
3819
  ],
3498
3820
  "flags": {
3499
3821
  "json": {
@@ -3503,60 +3825,18 @@
3503
3825
  "allowNo": false,
3504
3826
  "type": "boolean"
3505
3827
  },
3506
- "currency": {
3507
- "description": "Currency code for the amounts in this call",
3508
- "name": "currency",
3509
- "default": "USD",
3510
- "hasDynamicHelp": false,
3511
- "multiple": false,
3512
- "type": "option"
3513
- },
3514
- "yes": {
3515
- "char": "y",
3516
- "description": "Apply without asking; required when the output is piped or --json is used",
3517
- "name": "yes",
3518
- "allowNo": false,
3519
- "type": "boolean"
3520
- },
3521
- "idempotency-key": {
3522
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3523
- "name": "idempotency-key",
3524
- "hasDynamicHelp": false,
3525
- "multiple": false,
3526
- "type": "option"
3527
- },
3528
- "bid": {
3529
- "description": "Bid (amount, e.g. 50 or 12.50)",
3530
- "name": "bid",
3531
- "hasDynamicHelp": false,
3532
- "multiple": false,
3533
- "type": "option"
3534
- },
3535
- "match-type": {
3536
- "description": "Match type",
3537
- "name": "match-type",
3538
- "hasDynamicHelp": false,
3539
- "multiple": false,
3540
- "options": [
3541
- "BROAD",
3542
- "EXACT"
3543
- ],
3544
- "type": "option"
3545
- },
3546
- "status": {
3547
- "description": "Keyword status",
3548
- "name": "status",
3828
+ "page": {
3829
+ "description": "Page number",
3830
+ "name": "page",
3831
+ "default": 1,
3549
3832
  "hasDynamicHelp": false,
3550
3833
  "multiple": false,
3551
- "options": [
3552
- "ACTIVE",
3553
- "PAUSED"
3554
- ],
3555
3834
  "type": "option"
3556
3835
  },
3557
- "text": {
3558
- "description": "Keyword text (only meaningful for a single keyword)",
3559
- "name": "text",
3836
+ "page-size": {
3837
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3838
+ "name": "page-size",
3839
+ "default": 100,
3560
3840
  "hasDynamicHelp": false,
3561
3841
  "multiple": false,
3562
3842
  "type": "option"
@@ -3564,31 +3844,28 @@
3564
3844
  },
3565
3845
  "hasDynamicHelp": false,
3566
3846
  "hiddenAliases": [],
3567
- "id": "asa:keywords:update",
3847
+ "id": "asa:orgs:list",
3568
3848
  "pluginAlias": "adapty",
3569
3849
  "pluginName": "adapty",
3570
3850
  "pluginType": "core",
3571
- "strict": false,
3851
+ "strict": true,
3572
3852
  "enableJsonFlag": true,
3573
3853
  "isESM": true,
3574
3854
  "relativePath": [
3575
3855
  "dist",
3576
3856
  "commands",
3577
3857
  "asa",
3578
- "keywords",
3579
- "update.js"
3858
+ "orgs",
3859
+ "list.js"
3580
3860
  ]
3581
3861
  },
3582
- "asa:metrics": {
3862
+ "asa:product-pages:list": {
3583
3863
  "aliases": [],
3584
3864
  "args": {},
3585
- "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3865
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
3586
3866
  "examples": [
3587
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3588
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3589
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3590
- "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3591
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3867
+ "<%= config.bin %> asa product-pages list",
3868
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
3592
3869
  ],
3593
3870
  "flags": {
3594
3871
  "json": {
@@ -3614,87 +3891,71 @@
3614
3891
  "multiple": false,
3615
3892
  "type": "option"
3616
3893
  },
3617
- "by-days": {
3618
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3619
- "name": "by-days",
3620
- "hasDynamicHelp": false,
3621
- "multiple": true,
3622
- "type": "option"
3623
- },
3624
- "date-from": {
3625
- "description": "Start of the period (YYYY-MM-DD)",
3626
- "name": "date-from",
3627
- "required": true,
3628
- "hasDynamicHelp": false,
3629
- "multiple": false,
3630
- "type": "option"
3631
- },
3632
- "date-to": {
3633
- "description": "End of the period (YYYY-MM-DD)",
3634
- "name": "date-to",
3635
- "required": true,
3636
- "hasDynamicHelp": false,
3637
- "multiple": false,
3638
- "type": "option"
3639
- },
3640
- "entity": {
3641
- "description": "What to report on",
3642
- "name": "entity",
3643
- "required": true,
3644
- "hasDynamicHelp": false,
3645
- "multiple": false,
3646
- "options": [
3647
- "ad",
3648
- "ad-group",
3649
- "campaign",
3650
- "keyword"
3651
- ],
3652
- "type": "option"
3653
- },
3654
- "group-by": {
3655
- "description": "Break the rows down by a dimension, repeatable",
3656
- "name": "group-by",
3894
+ "app": {
3895
+ "description": "Keep only rows in this app; repeatable",
3896
+ "name": "app",
3657
3897
  "hasDynamicHelp": false,
3658
3898
  "multiple": true,
3659
- "options": [
3660
- "country",
3661
- "day",
3662
- "month",
3663
- "quarter",
3664
- "week",
3665
- "year"
3666
- ],
3667
3899
  "type": "option"
3668
3900
  },
3669
- "metric": {
3670
- "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3671
- "name": "metric",
3901
+ "campaign-group": {
3902
+ "description": "Keep only rows in this campaign group; repeatable",
3903
+ "name": "campaign-group",
3672
3904
  "hasDynamicHelp": false,
3673
3905
  "multiple": true,
3674
3906
  "type": "option"
3907
+ }
3908
+ },
3909
+ "hasDynamicHelp": false,
3910
+ "hiddenAliases": [],
3911
+ "id": "asa:product-pages:list",
3912
+ "pluginAlias": "adapty",
3913
+ "pluginName": "adapty",
3914
+ "pluginType": "core",
3915
+ "strict": true,
3916
+ "enableJsonFlag": true,
3917
+ "isESM": true,
3918
+ "relativePath": [
3919
+ "dist",
3920
+ "commands",
3921
+ "asa",
3922
+ "product-pages",
3923
+ "list.js"
3924
+ ]
3925
+ },
3926
+ "asa:product-pages:sync": {
3927
+ "aliases": [],
3928
+ "args": {},
3929
+ "description": "Refresh custom product pages from Apple",
3930
+ "examples": [
3931
+ "<%= config.bin %> asa product-pages sync",
3932
+ "<%= config.bin %> asa product-pages sync --adam-id 123456"
3933
+ ],
3934
+ "flags": {
3935
+ "json": {
3936
+ "description": "Format output as json.",
3937
+ "helpGroup": "GLOBAL",
3938
+ "name": "json",
3939
+ "allowNo": false,
3940
+ "type": "boolean"
3675
3941
  },
3676
- "order": {
3677
- "description": "Sort direction",
3678
- "name": "order",
3679
- "default": "desc",
3680
- "hasDynamicHelp": false,
3681
- "multiple": false,
3682
- "options": [
3683
- "asc",
3684
- "desc"
3685
- ],
3686
- "type": "option"
3942
+ "yes": {
3943
+ "char": "y",
3944
+ "description": "Apply without asking; required when the output is piped or --json is used",
3945
+ "name": "yes",
3946
+ "allowNo": false,
3947
+ "type": "boolean"
3687
3948
  },
3688
- "order-by": {
3689
- "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3690
- "name": "order-by",
3949
+ "idempotency-key": {
3950
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3951
+ "name": "idempotency-key",
3691
3952
  "hasDynamicHelp": false,
3692
3953
  "multiple": false,
3693
3954
  "type": "option"
3694
3955
  },
3695
- "order-by-day": {
3696
- "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3697
- "name": "order-by-day",
3956
+ "adam-id": {
3957
+ "description": "Limit the refresh to one app; omit to cover every app",
3958
+ "name": "adam-id",
3698
3959
  "hasDynamicHelp": false,
3699
3960
  "multiple": false,
3700
3961
  "type": "option"
@@ -3702,7 +3963,7 @@
3702
3963
  },
3703
3964
  "hasDynamicHelp": false,
3704
3965
  "hiddenAliases": [],
3705
- "id": "asa:metrics",
3966
+ "id": "asa:product-pages:sync",
3706
3967
  "pluginAlias": "adapty",
3707
3968
  "pluginName": "adapty",
3708
3969
  "pluginType": "core",
@@ -3713,17 +3974,17 @@
3713
3974
  "dist",
3714
3975
  "commands",
3715
3976
  "asa",
3716
- "metrics",
3717
- "index.js"
3977
+ "product-pages",
3978
+ "sync.js"
3718
3979
  ]
3719
3980
  },
3720
- "asa:metrics:overview": {
3981
+ "asa:search-terms:list": {
3721
3982
  "aliases": [],
3722
3983
  "args": {},
3723
- "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
3984
+ "description": "List the search terms your ads matched, with their metrics",
3724
3985
  "examples": [
3725
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3726
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3986
+ "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
3987
+ "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
3727
3988
  ],
3728
3989
  "flags": {
3729
3990
  "json": {
@@ -3733,69 +3994,75 @@
3733
3994
  "allowNo": false,
3734
3995
  "type": "boolean"
3735
3996
  },
3736
- "by-days": {
3737
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3738
- "name": "by-days",
3997
+ "page": {
3998
+ "description": "Page number",
3999
+ "name": "page",
4000
+ "default": 1,
3739
4001
  "hasDynamicHelp": false,
3740
- "multiple": true,
4002
+ "multiple": false,
4003
+ "type": "option"
4004
+ },
4005
+ "page-size": {
4006
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4007
+ "name": "page-size",
4008
+ "default": 100,
4009
+ "hasDynamicHelp": false,
4010
+ "multiple": false,
3741
4011
  "type": "option"
3742
4012
  },
3743
4013
  "date-from": {
3744
- "description": "Start of the period (YYYY-MM-DD)",
4014
+ "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
3745
4015
  "name": "date-from",
3746
- "required": true,
3747
4016
  "hasDynamicHelp": false,
3748
4017
  "multiple": false,
3749
4018
  "type": "option"
3750
4019
  },
3751
4020
  "date-to": {
3752
- "description": "End of the period (YYYY-MM-DD)",
4021
+ "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
3753
4022
  "name": "date-to",
3754
- "required": true,
3755
4023
  "hasDynamicHelp": false,
3756
4024
  "multiple": false,
3757
4025
  "type": "option"
3758
4026
  },
3759
- "entity": {
3760
- "description": "What to report on",
3761
- "name": "entity",
3762
- "required": true,
4027
+ "app": {
4028
+ "description": "Keep only rows in this app; repeatable",
4029
+ "name": "app",
3763
4030
  "hasDynamicHelp": false,
3764
- "multiple": false,
3765
- "options": [
3766
- "ad",
3767
- "ad-group",
3768
- "campaign",
3769
- "keyword"
3770
- ],
4031
+ "multiple": true,
3771
4032
  "type": "option"
3772
4033
  },
3773
- "metric": {
3774
- "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3775
- "name": "metric",
4034
+ "campaign-group": {
4035
+ "description": "Keep only rows in this campaign group; repeatable",
4036
+ "name": "campaign-group",
3776
4037
  "hasDynamicHelp": false,
3777
4038
  "multiple": true,
3778
4039
  "type": "option"
3779
4040
  },
3780
- "period-unit": {
3781
- "description": "Bucket size",
3782
- "name": "period-unit",
3783
- "default": "day",
4041
+ "search": {
4042
+ "description": "Case-insensitive substring match on the name",
4043
+ "name": "search",
3784
4044
  "hasDynamicHelp": false,
3785
4045
  "multiple": false,
3786
- "options": [
3787
- "day",
3788
- "month",
3789
- "quarter",
3790
- "week",
3791
- "year"
3792
- ],
4046
+ "type": "option"
4047
+ },
4048
+ "campaign": {
4049
+ "description": "Keep only rows in this campaign; repeatable",
4050
+ "name": "campaign",
4051
+ "hasDynamicHelp": false,
4052
+ "multiple": true,
4053
+ "type": "option"
4054
+ },
4055
+ "ad-group": {
4056
+ "description": "Keep only rows in this ad group; repeatable",
4057
+ "name": "ad-group",
4058
+ "hasDynamicHelp": false,
4059
+ "multiple": true,
3793
4060
  "type": "option"
3794
4061
  }
3795
4062
  },
3796
4063
  "hasDynamicHelp": false,
3797
4064
  "hiddenAliases": [],
3798
- "id": "asa:metrics:overview",
4065
+ "id": "asa:search-terms:list",
3799
4066
  "pluginAlias": "adapty",
3800
4067
  "pluginName": "adapty",
3801
4068
  "pluginType": "core",
@@ -3806,18 +4073,22 @@
3806
4073
  "dist",
3807
4074
  "commands",
3808
4075
  "asa",
3809
- "metrics",
3810
- "overview.js"
4076
+ "search-terms",
4077
+ "list.js"
3811
4078
  ]
3812
4079
  },
3813
- "asa:negative-keywords:add": {
4080
+ "flows:config:get": {
3814
4081
  "aliases": [],
3815
- "args": {},
3816
- "description": "Add negative keywords to an ad group or across a campaign",
4082
+ "args": {
4083
+ "flow_id": {
4084
+ "description": "Flow ID (UUID)",
4085
+ "name": "flow_id",
4086
+ "required": true
4087
+ }
4088
+ },
4089
+ "description": "Read the flow builder config (404 until the config has been written at least once)",
3817
4090
  "examples": [
3818
- "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3819
- "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3820
- "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
4091
+ "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
3821
4092
  ],
3822
4093
  "flags": {
3823
4094
  "json": {
@@ -3827,85 +4098,95 @@
3827
4098
  "allowNo": false,
3828
4099
  "type": "boolean"
3829
4100
  },
3830
- "yes": {
3831
- "char": "y",
3832
- "description": "Apply without asking; required when the output is piped or --json is used",
3833
- "name": "yes",
3834
- "allowNo": false,
3835
- "type": "boolean"
3836
- },
3837
- "idempotency-key": {
3838
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3839
- "name": "idempotency-key",
4101
+ "app": {
4102
+ "description": "App ID (UUID)",
4103
+ "name": "app",
4104
+ "required": true,
3840
4105
  "hasDynamicHelp": false,
3841
4106
  "multiple": false,
3842
4107
  "type": "option"
4108
+ }
4109
+ },
4110
+ "hasDynamicHelp": false,
4111
+ "hiddenAliases": [],
4112
+ "id": "flows:config:get",
4113
+ "pluginAlias": "adapty",
4114
+ "pluginName": "adapty",
4115
+ "pluginType": "core",
4116
+ "strict": true,
4117
+ "enableJsonFlag": true,
4118
+ "isESM": true,
4119
+ "relativePath": [
4120
+ "dist",
4121
+ "commands",
4122
+ "flows",
4123
+ "config",
4124
+ "get.js"
4125
+ ]
4126
+ },
4127
+ "flows:config:update": {
4128
+ "aliases": [],
4129
+ "args": {
4130
+ "flow_id": {
4131
+ "description": "Flow ID (UUID)",
4132
+ "name": "flow_id",
4133
+ "required": true
4134
+ }
4135
+ },
4136
+ "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4137
+ "examples": [
4138
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4139
+ "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4140
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4141
+ ],
4142
+ "flags": {
4143
+ "json": {
4144
+ "description": "Format output as json.",
4145
+ "helpGroup": "GLOBAL",
4146
+ "name": "json",
4147
+ "allowNo": false,
4148
+ "type": "boolean"
3843
4149
  },
3844
- "ad-group": {
3845
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
3846
- "exclusive": [
3847
- "campaign"
3848
- ],
3849
- "name": "ad-group",
4150
+ "app": {
4151
+ "description": "App ID (UUID)",
4152
+ "name": "app",
4153
+ "required": true,
3850
4154
  "hasDynamicHelp": false,
3851
4155
  "multiple": false,
3852
4156
  "type": "option"
3853
4157
  },
3854
- "all-ad-groups": {
3855
- "dependsOn": [
3856
- "campaign"
3857
- ],
3858
- "description": "Apply to every ad group of the campaign instead of the campaign itself",
3859
- "name": "all-ad-groups",
3860
- "allowNo": false,
3861
- "type": "boolean"
3862
- },
3863
- "campaign": {
3864
- "description": "Campaign ID (UUID)",
3865
- "exclusive": [
3866
- "ad-group"
3867
- ],
3868
- "name": "campaign",
4158
+ "config": {
4159
+ "description": "Builder config as a JSON string",
4160
+ "name": "config",
3869
4161
  "hasDynamicHelp": false,
3870
4162
  "multiple": false,
3871
4163
  "type": "option"
3872
4164
  },
3873
- "match-type": {
3874
- "description": "Match type",
3875
- "name": "match-type",
3876
- "default": "EXACT",
4165
+ "config-file": {
4166
+ "description": "JSON file with the builder config, or - to read stdin",
4167
+ "name": "config-file",
3877
4168
  "hasDynamicHelp": false,
3878
4169
  "multiple": false,
3879
- "options": [
3880
- "BROAD",
3881
- "EXACT"
3882
- ],
3883
4170
  "type": "option"
3884
4171
  },
3885
- "status": {
3886
- "description": "Keyword status",
3887
- "name": "status",
3888
- "default": "ACTIVE",
4172
+ "expected-updated-at": {
4173
+ "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4174
+ "name": "expected-updated-at",
3889
4175
  "hasDynamicHelp": false,
3890
4176
  "multiple": false,
3891
- "options": [
3892
- "ACTIVE",
3893
- "PAUSED"
3894
- ],
3895
4177
  "type": "option"
3896
4178
  },
3897
- "text": {
3898
- "description": "Keyword text, repeatable",
3899
- "name": "text",
3900
- "required": true,
4179
+ "remote-configs": {
4180
+ "description": "JSON array of remote config entries: [{locale, data}]",
4181
+ "name": "remote-configs",
3901
4182
  "hasDynamicHelp": false,
3902
- "multiple": true,
4183
+ "multiple": false,
3903
4184
  "type": "option"
3904
4185
  }
3905
4186
  },
3906
4187
  "hasDynamicHelp": false,
3907
4188
  "hiddenAliases": [],
3908
- "id": "asa:negative-keywords:add",
4189
+ "id": "flows:config:update",
3909
4190
  "pluginAlias": "adapty",
3910
4191
  "pluginName": "adapty",
3911
4192
  "pluginType": "core",
@@ -3915,18 +4196,18 @@
3915
4196
  "relativePath": [
3916
4197
  "dist",
3917
4198
  "commands",
3918
- "asa",
3919
- "negative-keywords",
3920
- "add.js"
4199
+ "flows",
4200
+ "config",
4201
+ "update.js"
3921
4202
  ]
3922
4203
  },
3923
- "asa:negative-keywords:list": {
4204
+ "asa:automations:create": {
3924
4205
  "aliases": [],
3925
4206
  "args": {},
3926
- "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
4207
+ "description": "Create an automation rule from a JSON rule file",
3927
4208
  "examples": [
3928
- "<%= config.bin %> asa negative-keywords list",
3929
- "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
4209
+ "<%= config.bin %> asa automations create --file rule.json",
4210
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
3930
4211
  ],
3931
4212
  "flags": {
3932
4213
  "json": {
@@ -3936,67 +4217,38 @@
3936
4217
  "allowNo": false,
3937
4218
  "type": "boolean"
3938
4219
  },
3939
- "page": {
3940
- "description": "Page number",
3941
- "name": "page",
3942
- "default": 1,
3943
- "hasDynamicHelp": false,
3944
- "multiple": false,
3945
- "type": "option"
3946
- },
3947
- "page-size": {
3948
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3949
- "name": "page-size",
3950
- "default": 100,
3951
- "hasDynamicHelp": false,
3952
- "multiple": false,
3953
- "type": "option"
3954
- },
3955
- "app": {
3956
- "description": "Keep only rows in this app; repeatable",
3957
- "name": "app",
3958
- "hasDynamicHelp": false,
3959
- "multiple": true,
3960
- "type": "option"
3961
- },
3962
- "campaign-group": {
3963
- "description": "Keep only rows in this campaign group; repeatable",
3964
- "name": "campaign-group",
3965
- "hasDynamicHelp": false,
3966
- "multiple": true,
3967
- "type": "option"
4220
+ "yes": {
4221
+ "char": "y",
4222
+ "description": "Apply without asking; required when the output is piped or --json is used",
4223
+ "name": "yes",
4224
+ "allowNo": false,
4225
+ "type": "boolean"
3968
4226
  },
3969
- "search": {
3970
- "description": "Case-insensitive substring match on the name",
3971
- "name": "search",
4227
+ "idempotency-key": {
4228
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4229
+ "name": "idempotency-key",
3972
4230
  "hasDynamicHelp": false,
3973
4231
  "multiple": false,
3974
4232
  "type": "option"
3975
4233
  },
3976
- "campaign": {
3977
- "description": "Keep only rows in this campaign; repeatable",
3978
- "name": "campaign",
3979
- "hasDynamicHelp": false,
3980
- "multiple": true,
3981
- "type": "option"
3982
- },
3983
- "ad-group": {
3984
- "description": "Keep only rows in this ad group; repeatable",
3985
- "name": "ad-group",
4234
+ "file": {
4235
+ "description": "JSON file with the rule body, or - to read stdin",
4236
+ "name": "file",
4237
+ "required": true,
3986
4238
  "hasDynamicHelp": false,
3987
- "multiple": true,
4239
+ "multiple": false,
3988
4240
  "type": "option"
3989
4241
  },
3990
- "campaign-level-only": {
3991
- "description": "Keep only campaign-level rows (ad_group_id is null)",
3992
- "name": "campaign-level-only",
4242
+ "run-now": {
4243
+ "description": "Queue the first run right after the rule is stored",
4244
+ "name": "run-now",
3993
4245
  "allowNo": false,
3994
4246
  "type": "boolean"
3995
4247
  }
3996
4248
  },
3997
4249
  "hasDynamicHelp": false,
3998
4250
  "hiddenAliases": [],
3999
- "id": "asa:negative-keywords:list",
4251
+ "id": "asa:automations:create",
4000
4252
  "pluginAlias": "adapty",
4001
4253
  "pluginName": "adapty",
4002
4254
  "pluginType": "core",
@@ -4007,16 +4259,22 @@
4007
4259
  "dist",
4008
4260
  "commands",
4009
4261
  "asa",
4010
- "negative-keywords",
4011
- "list.js"
4262
+ "automations",
4263
+ "create.js"
4012
4264
  ]
4013
4265
  },
4014
- "asa:orgs:list": {
4266
+ "asa:automations:get": {
4015
4267
  "aliases": [],
4016
- "args": {},
4017
- "description": "List the Apple Search Ads organizations this company can spend from",
4268
+ "args": {
4269
+ "automation_id": {
4270
+ "description": "Automation rule ID (UUID)",
4271
+ "name": "automation_id",
4272
+ "required": true
4273
+ }
4274
+ },
4275
+ "description": "Show one automation rule with its conditions and actions",
4018
4276
  "examples": [
4019
- "<%= config.bin %> asa orgs list"
4277
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
4020
4278
  ],
4021
4279
  "flags": {
4022
4280
  "json": {
@@ -4025,27 +4283,11 @@
4025
4283
  "name": "json",
4026
4284
  "allowNo": false,
4027
4285
  "type": "boolean"
4028
- },
4029
- "page": {
4030
- "description": "Page number",
4031
- "name": "page",
4032
- "default": 1,
4033
- "hasDynamicHelp": false,
4034
- "multiple": false,
4035
- "type": "option"
4036
- },
4037
- "page-size": {
4038
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4039
- "name": "page-size",
4040
- "default": 100,
4041
- "hasDynamicHelp": false,
4042
- "multiple": false,
4043
- "type": "option"
4044
4286
  }
4045
4287
  },
4046
4288
  "hasDynamicHelp": false,
4047
4289
  "hiddenAliases": [],
4048
- "id": "asa:orgs:list",
4290
+ "id": "asa:automations:get",
4049
4291
  "pluginAlias": "adapty",
4050
4292
  "pluginName": "adapty",
4051
4293
  "pluginType": "core",
@@ -4056,17 +4298,16 @@
4056
4298
  "dist",
4057
4299
  "commands",
4058
4300
  "asa",
4059
- "orgs",
4060
- "list.js"
4301
+ "automations",
4302
+ "get.js"
4061
4303
  ]
4062
4304
  },
4063
- "asa:product-pages:list": {
4305
+ "asa:automations:list": {
4064
4306
  "aliases": [],
4065
4307
  "args": {},
4066
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4308
+ "description": "List automation rules; status 1 is active, 0 is stopped",
4067
4309
  "examples": [
4068
- "<%= config.bin %> asa product-pages list",
4069
- "<%= config.bin %> asa product-pages list --app APP_UUID"
4310
+ "<%= config.bin %> asa automations list"
4070
4311
  ],
4071
4312
  "flags": {
4072
4313
  "json": {
@@ -4091,25 +4332,11 @@
4091
4332
  "hasDynamicHelp": false,
4092
4333
  "multiple": false,
4093
4334
  "type": "option"
4094
- },
4095
- "app": {
4096
- "description": "Keep only rows in this app; repeatable",
4097
- "name": "app",
4098
- "hasDynamicHelp": false,
4099
- "multiple": true,
4100
- "type": "option"
4101
- },
4102
- "campaign-group": {
4103
- "description": "Keep only rows in this campaign group; repeatable",
4104
- "name": "campaign-group",
4105
- "hasDynamicHelp": false,
4106
- "multiple": true,
4107
- "type": "option"
4108
4335
  }
4109
4336
  },
4110
4337
  "hasDynamicHelp": false,
4111
4338
  "hiddenAliases": [],
4112
- "id": "asa:product-pages:list",
4339
+ "id": "asa:automations:list",
4113
4340
  "pluginAlias": "adapty",
4114
4341
  "pluginName": "adapty",
4115
4342
  "pluginType": "core",
@@ -4120,17 +4347,23 @@
4120
4347
  "dist",
4121
4348
  "commands",
4122
4349
  "asa",
4123
- "product-pages",
4350
+ "automations",
4124
4351
  "list.js"
4125
4352
  ]
4126
4353
  },
4127
- "asa:product-pages:sync": {
4354
+ "asa:automations:run": {
4128
4355
  "aliases": [],
4129
- "args": {},
4130
- "description": "Refresh custom product pages from Apple",
4356
+ "args": {
4357
+ "automation_id": {
4358
+ "description": "Automation rule ID (UUID)",
4359
+ "name": "automation_id",
4360
+ "required": true
4361
+ }
4362
+ },
4363
+ "description": "Run an automation rule now; the run is queued, not awaited",
4131
4364
  "examples": [
4132
- "<%= config.bin %> asa product-pages sync",
4133
- "<%= config.bin %> asa product-pages sync --adam-id 123456"
4365
+ "<%= config.bin %> asa automations run UUID",
4366
+ "<%= config.bin %> asa automations run UUID --dry-run"
4134
4367
  ],
4135
4368
  "flags": {
4136
4369
  "json": {
@@ -4154,17 +4387,16 @@
4154
4387
  "multiple": false,
4155
4388
  "type": "option"
4156
4389
  },
4157
- "adam-id": {
4158
- "description": "Limit the refresh to one app; omit to cover every app",
4159
- "name": "adam-id",
4160
- "hasDynamicHelp": false,
4161
- "multiple": false,
4162
- "type": "option"
4390
+ "dry-run": {
4391
+ "description": "Evaluate and log the rule without touching Apple",
4392
+ "name": "dry-run",
4393
+ "allowNo": false,
4394
+ "type": "boolean"
4163
4395
  }
4164
4396
  },
4165
4397
  "hasDynamicHelp": false,
4166
4398
  "hiddenAliases": [],
4167
- "id": "asa:product-pages:sync",
4399
+ "id": "asa:automations:run",
4168
4400
  "pluginAlias": "adapty",
4169
4401
  "pluginName": "adapty",
4170
4402
  "pluginType": "core",
@@ -4175,17 +4407,22 @@
4175
4407
  "dist",
4176
4408
  "commands",
4177
4409
  "asa",
4178
- "product-pages",
4179
- "sync.js"
4410
+ "automations",
4411
+ "run.js"
4180
4412
  ]
4181
4413
  },
4182
- "asa:search-terms:list": {
4414
+ "asa:automations:runs": {
4183
4415
  "aliases": [],
4184
- "args": {},
4185
- "description": "List the search terms your ads matched, with their metrics",
4416
+ "args": {
4417
+ "automation_id": {
4418
+ "description": "Automation rule ID (UUID)",
4419
+ "name": "automation_id",
4420
+ "required": true
4421
+ }
4422
+ },
4423
+ "description": "List past runs of an automation rule, including dry runs",
4186
4424
  "examples": [
4187
- "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4188
- "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4425
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
4189
4426
  ],
4190
4427
  "flags": {
4191
4428
  "json": {
@@ -4210,60 +4447,97 @@
4210
4447
  "hasDynamicHelp": false,
4211
4448
  "multiple": false,
4212
4449
  "type": "option"
4450
+ }
4451
+ },
4452
+ "hasDynamicHelp": false,
4453
+ "hiddenAliases": [],
4454
+ "id": "asa:automations:runs",
4455
+ "pluginAlias": "adapty",
4456
+ "pluginName": "adapty",
4457
+ "pluginType": "core",
4458
+ "strict": true,
4459
+ "enableJsonFlag": true,
4460
+ "isESM": true,
4461
+ "relativePath": [
4462
+ "dist",
4463
+ "commands",
4464
+ "asa",
4465
+ "automations",
4466
+ "runs.js"
4467
+ ]
4468
+ },
4469
+ "asa:automations:update": {
4470
+ "aliases": [],
4471
+ "args": {
4472
+ "automation_id": {
4473
+ "description": "Automation rule ID (UUID)",
4474
+ "name": "automation_id",
4475
+ "required": true
4476
+ }
4477
+ },
4478
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
4479
+ "examples": [
4480
+ "<%= config.bin %> asa automations update UUID --stop",
4481
+ "<%= config.bin %> asa automations update UUID --file rule.json"
4482
+ ],
4483
+ "flags": {
4484
+ "json": {
4485
+ "description": "Format output as json.",
4486
+ "helpGroup": "GLOBAL",
4487
+ "name": "json",
4488
+ "allowNo": false,
4489
+ "type": "boolean"
4213
4490
  },
4214
- "date-from": {
4215
- "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4216
- "name": "date-from",
4217
- "hasDynamicHelp": false,
4218
- "multiple": false,
4219
- "type": "option"
4491
+ "yes": {
4492
+ "char": "y",
4493
+ "description": "Apply without asking; required when the output is piped or --json is used",
4494
+ "name": "yes",
4495
+ "allowNo": false,
4496
+ "type": "boolean"
4220
4497
  },
4221
- "date-to": {
4222
- "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4223
- "name": "date-to",
4498
+ "idempotency-key": {
4499
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4500
+ "name": "idempotency-key",
4224
4501
  "hasDynamicHelp": false,
4225
4502
  "multiple": false,
4226
4503
  "type": "option"
4227
4504
  },
4228
- "app": {
4229
- "description": "Keep only rows in this app; repeatable",
4230
- "name": "app",
4231
- "hasDynamicHelp": false,
4232
- "multiple": true,
4233
- "type": "option"
4234
- },
4235
- "campaign-group": {
4236
- "description": "Keep only rows in this campaign group; repeatable",
4237
- "name": "campaign-group",
4505
+ "file": {
4506
+ "description": "JSON file with the parts to change, or - to read stdin",
4507
+ "name": "file",
4238
4508
  "hasDynamicHelp": false,
4239
- "multiple": true,
4509
+ "multiple": false,
4240
4510
  "type": "option"
4241
4511
  },
4242
- "search": {
4243
- "description": "Case-insensitive substring match on the name",
4244
- "name": "search",
4512
+ "name": {
4513
+ "description": "Rule name",
4514
+ "name": "name",
4245
4515
  "hasDynamicHelp": false,
4246
4516
  "multiple": false,
4247
4517
  "type": "option"
4248
4518
  },
4249
- "campaign": {
4250
- "description": "Keep only rows in this campaign; repeatable",
4251
- "name": "campaign",
4252
- "hasDynamicHelp": false,
4253
- "multiple": true,
4254
- "type": "option"
4519
+ "start": {
4520
+ "description": "Activate the rule",
4521
+ "exclusive": [
4522
+ "stop"
4523
+ ],
4524
+ "name": "start",
4525
+ "allowNo": false,
4526
+ "type": "boolean"
4255
4527
  },
4256
- "ad-group": {
4257
- "description": "Keep only rows in this ad group; repeatable",
4258
- "name": "ad-group",
4259
- "hasDynamicHelp": false,
4260
- "multiple": true,
4261
- "type": "option"
4528
+ "stop": {
4529
+ "description": "Stop the rule and clear its next run",
4530
+ "exclusive": [
4531
+ "start"
4532
+ ],
4533
+ "name": "stop",
4534
+ "allowNo": false,
4535
+ "type": "boolean"
4262
4536
  }
4263
4537
  },
4264
4538
  "hasDynamicHelp": false,
4265
4539
  "hiddenAliases": [],
4266
- "id": "asa:search-terms:list",
4540
+ "id": "asa:automations:update",
4267
4541
  "pluginAlias": "adapty",
4268
4542
  "pluginName": "adapty",
4269
4543
  "pluginType": "core",
@@ -4274,10 +4548,10 @@
4274
4548
  "dist",
4275
4549
  "commands",
4276
4550
  "asa",
4277
- "search-terms",
4278
- "list.js"
4551
+ "automations",
4552
+ "update.js"
4279
4553
  ]
4280
4554
  }
4281
4555
  },
4282
- "version": "0.5.0"
4556
+ "version": "0.6.0-beta.0"
4283
4557
  }