adapty 0.8.1 → 0.8.3-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 (34) hide show
  1. package/README.md +4 -0
  2. package/dist/commands/asa/ad-groups/create.d.ts +1 -0
  3. package/dist/commands/asa/ad-groups/create.js +20 -5
  4. package/dist/commands/asa/ad-groups/update.js +1 -1
  5. package/dist/commands/asa/ads/create.js +1 -1
  6. package/dist/commands/asa/ads/update.js +1 -1
  7. package/dist/commands/asa/automations/create.js +1 -1
  8. package/dist/commands/asa/automations/run.js +1 -1
  9. package/dist/commands/asa/automations/update.js +1 -1
  10. package/dist/commands/asa/campaigns/bulk-create.js +1 -1
  11. package/dist/commands/asa/campaigns/create.d.ts +5 -0
  12. package/dist/commands/asa/campaigns/create.js +16 -4
  13. package/dist/commands/asa/campaigns/update.d.ts +5 -0
  14. package/dist/commands/asa/campaigns/update.js +15 -4
  15. package/dist/commands/asa/keywords/add.js +1 -1
  16. package/dist/commands/asa/keywords/update.js +1 -1
  17. package/dist/commands/asa/negative-keywords/add.js +1 -1
  18. package/dist/commands/asa/product-pages/sync.js +1 -1
  19. package/dist/commands/flows/publish.d.ts +15 -0
  20. package/dist/commands/flows/publish.js +34 -0
  21. package/dist/commands/flows/update.d.ts +15 -0
  22. package/dist/commands/flows/update.js +28 -0
  23. package/dist/commands/placements/create.js +18 -3
  24. package/dist/commands/placements/update.js +18 -3
  25. package/dist/lib/api-schemas.d.ts +10 -1
  26. package/dist/lib/asa-flags.d.ts +22 -1
  27. package/dist/lib/asa-flags.js +47 -0
  28. package/dist/lib/asa-schemas.d.ts +19 -0
  29. package/dist/lib/placement-audiences.d.ts +6 -0
  30. package/dist/lib/placement-audiences.js +25 -0
  31. package/oclif.manifest.json +1746 -1555
  32. package/package.json +3 -2
  33. /package/dist/lib/{asa-confirm.d.ts → confirm.d.ts} +0 -0
  34. /package/dist/lib/{asa-confirm.js → confirm.js} +0 -0
package/oclif.manifest.json CHANGED
@@ -425,36 +425,59 @@
425
425
  "update.js"
426
426
  ]
427
427
  },
428
- "auth:login": {
428
+ "asa:connect": {
429
429
  "aliases": [],
430
430
  "args": {},
431
- "description": "Authenticate with Adapty via browser",
431
+ "description": "Connect an Apple Search Ads account to this company",
432
432
  "examples": [
433
- "<%= config.bin %> auth login"
433
+ "<%= config.bin %> asa connect",
434
+ "<%= config.bin %> asa connect --no-wait"
434
435
  ],
435
- "flags": {},
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
+ },
436
459
  "hasDynamicHelp": false,
437
460
  "hiddenAliases": [],
438
- "id": "auth:login",
461
+ "id": "asa:connect",
439
462
  "pluginAlias": "adapty",
440
463
  "pluginName": "adapty",
441
464
  "pluginType": "core",
442
465
  "strict": true,
443
- "enableJsonFlag": false,
466
+ "enableJsonFlag": true,
444
467
  "isESM": true,
445
468
  "relativePath": [
446
469
  "dist",
447
470
  "commands",
448
- "auth",
449
- "login.js"
471
+ "asa",
472
+ "connect.js"
450
473
  ]
451
474
  },
452
- "auth:logout": {
475
+ "asa:whoami": {
453
476
  "aliases": [],
454
477
  "args": {},
455
- "description": "Remove stored authentication token",
478
+ "description": "Show which company the token unlocks and whether Apple Ads is connected",
456
479
  "examples": [
457
- "<%= config.bin %> auth logout"
480
+ "<%= config.bin %> asa whoami"
458
481
  ],
459
482
  "flags": {
460
483
  "json": {
@@ -467,7 +490,7 @@
467
490
  },
468
491
  "hasDynamicHelp": false,
469
492
  "hiddenAliases": [],
470
- "id": "auth:logout",
493
+ "id": "asa:whoami",
471
494
  "pluginAlias": "adapty",
472
495
  "pluginName": "adapty",
473
496
  "pluginType": "core",
@@ -477,48 +500,40 @@
477
500
  "relativePath": [
478
501
  "dist",
479
502
  "commands",
480
- "auth",
481
- "logout.js"
503
+ "asa",
504
+ "whoami.js"
482
505
  ]
483
506
  },
484
- "auth:revoke": {
507
+ "auth:login": {
485
508
  "aliases": [],
486
509
  "args": {},
487
- "description": "Revoke the current authentication token",
510
+ "description": "Authenticate with Adapty via browser",
488
511
  "examples": [
489
- "<%= config.bin %> auth revoke"
512
+ "<%= config.bin %> auth login"
490
513
  ],
491
- "flags": {
492
- "json": {
493
- "description": "Format output as json.",
494
- "helpGroup": "GLOBAL",
495
- "name": "json",
496
- "allowNo": false,
497
- "type": "boolean"
498
- }
499
- },
514
+ "flags": {},
500
515
  "hasDynamicHelp": false,
501
516
  "hiddenAliases": [],
502
- "id": "auth:revoke",
517
+ "id": "auth:login",
503
518
  "pluginAlias": "adapty",
504
519
  "pluginName": "adapty",
505
520
  "pluginType": "core",
506
521
  "strict": true,
507
- "enableJsonFlag": true,
522
+ "enableJsonFlag": false,
508
523
  "isESM": true,
509
524
  "relativePath": [
510
525
  "dist",
511
526
  "commands",
512
527
  "auth",
513
- "revoke.js"
528
+ "login.js"
514
529
  ]
515
530
  },
516
- "auth:status": {
531
+ "auth:logout": {
517
532
  "aliases": [],
518
533
  "args": {},
519
- "description": "Show current authentication state (local only)",
534
+ "description": "Remove stored authentication token",
520
535
  "examples": [
521
- "<%= config.bin %> auth status"
536
+ "<%= config.bin %> auth logout"
522
537
  ],
523
538
  "flags": {
524
539
  "json": {
@@ -531,7 +546,7 @@
531
546
  },
532
547
  "hasDynamicHelp": false,
533
548
  "hiddenAliases": [],
534
- "id": "auth:status",
549
+ "id": "auth:logout",
535
550
  "pluginAlias": "adapty",
536
551
  "pluginName": "adapty",
537
552
  "pluginType": "core",
@@ -542,15 +557,15 @@
542
557
  "dist",
543
558
  "commands",
544
559
  "auth",
545
- "status.js"
560
+ "logout.js"
546
561
  ]
547
562
  },
548
- "auth:whoami": {
563
+ "auth:revoke": {
549
564
  "aliases": [],
550
565
  "args": {},
551
- "description": "Show current user info from server (verifies token)",
566
+ "description": "Revoke the current authentication token",
552
567
  "examples": [
553
- "<%= config.bin %> auth whoami"
568
+ "<%= config.bin %> auth revoke"
554
569
  ],
555
570
  "flags": {
556
571
  "json": {
@@ -563,7 +578,7 @@
563
578
  },
564
579
  "hasDynamicHelp": false,
565
580
  "hiddenAliases": [],
566
- "id": "auth:whoami",
581
+ "id": "auth:revoke",
567
582
  "pluginAlias": "adapty",
568
583
  "pluginName": "adapty",
569
584
  "pluginType": "core",
@@ -574,16 +589,15 @@
574
589
  "dist",
575
590
  "commands",
576
591
  "auth",
577
- "whoami.js"
592
+ "revoke.js"
578
593
  ]
579
594
  },
580
- "asa:connect": {
595
+ "auth:status": {
581
596
  "aliases": [],
582
597
  "args": {},
583
- "description": "Connect an Apple Search Ads account to this company",
598
+ "description": "Show current authentication state (local only)",
584
599
  "examples": [
585
- "<%= config.bin %> asa connect",
586
- "<%= config.bin %> asa connect --no-wait"
600
+ "<%= config.bin %> auth status"
587
601
  ],
588
602
  "flags": {
589
603
  "json": {
@@ -592,25 +606,11 @@
592
606
  "name": "json",
593
607
  "allowNo": false,
594
608
  "type": "boolean"
595
- },
596
- "timeout": {
597
- "description": "Seconds to wait for the browser step",
598
- "name": "timeout",
599
- "default": 300,
600
- "hasDynamicHelp": false,
601
- "multiple": false,
602
- "type": "option"
603
- },
604
- "wait": {
605
- "description": "Wait until Apple Ads reports as connected",
606
- "name": "wait",
607
- "allowNo": true,
608
- "type": "boolean"
609
609
  }
610
610
  },
611
611
  "hasDynamicHelp": false,
612
612
  "hiddenAliases": [],
613
- "id": "asa:connect",
613
+ "id": "auth:status",
614
614
  "pluginAlias": "adapty",
615
615
  "pluginName": "adapty",
616
616
  "pluginType": "core",
@@ -620,16 +620,16 @@
620
620
  "relativePath": [
621
621
  "dist",
622
622
  "commands",
623
- "asa",
624
- "connect.js"
623
+ "auth",
624
+ "status.js"
625
625
  ]
626
626
  },
627
- "asa:whoami": {
627
+ "auth:whoami": {
628
628
  "aliases": [],
629
629
  "args": {},
630
- "description": "Show which company the token unlocks and whether Apple Ads is connected",
630
+ "description": "Show current user info from server (verifies token)",
631
631
  "examples": [
632
- "<%= config.bin %> asa whoami"
632
+ "<%= config.bin %> auth whoami"
633
633
  ],
634
634
  "flags": {
635
635
  "json": {
@@ -642,7 +642,7 @@
642
642
  },
643
643
  "hasDynamicHelp": false,
644
644
  "hiddenAliases": [],
645
- "id": "asa:whoami",
645
+ "id": "auth:whoami",
646
646
  "pluginAlias": "adapty",
647
647
  "pluginName": "adapty",
648
648
  "pluginType": "core",
@@ -652,7 +652,7 @@
652
652
  "relativePath": [
653
653
  "dist",
654
654
  "commands",
655
- "asa",
655
+ "auth",
656
656
  "whoami.js"
657
657
  ]
658
658
  },
@@ -806,13 +806,18 @@
806
806
  "list.js"
807
807
  ]
808
808
  },
809
- "placements:create": {
809
+ "flows:publish": {
810
810
  "aliases": [],
811
- "args": {},
812
- "description": "Create a placement with a paywall",
811
+ "args": {
812
+ "flow_id": {
813
+ "description": "Flow ID (UUID)",
814
+ "name": "flow_id",
815
+ "required": true
816
+ }
817
+ },
818
+ "description": "Publish a flow (async — publication completes in the background)",
813
819
  "examples": [
814
- "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
815
- "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
820
+ "<%= config.bin %> flows publish --app UUID 550e8400-e29b-41d4-a716-446655440000"
816
821
  ],
817
822
  "flags": {
818
823
  "json": {
@@ -830,40 +835,17 @@
830
835
  "multiple": false,
831
836
  "type": "option"
832
837
  },
833
- "audiences": {
834
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
835
- "name": "audiences",
836
- "hasDynamicHelp": false,
837
- "multiple": false,
838
- "type": "option"
839
- },
840
- "developer-id": {
841
- "description": "Developer ID for the placement",
842
- "name": "developer-id",
843
- "required": true,
844
- "hasDynamicHelp": false,
845
- "multiple": false,
846
- "type": "option"
847
- },
848
- "paywall-id": {
849
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
850
- "name": "paywall-id",
851
- "hasDynamicHelp": false,
852
- "multiple": false,
853
- "type": "option"
854
- },
855
- "title": {
856
- "description": "Placement title",
857
- "name": "title",
858
- "required": true,
859
- "hasDynamicHelp": false,
860
- "multiple": false,
861
- "type": "option"
838
+ "yes": {
839
+ "char": "y",
840
+ "description": "Apply without asking; required when the output is piped or --json is used",
841
+ "name": "yes",
842
+ "allowNo": false,
843
+ "type": "boolean"
862
844
  }
863
845
  },
864
846
  "hasDynamicHelp": false,
865
847
  "hiddenAliases": [],
866
- "id": "placements:create",
848
+ "id": "flows:publish",
867
849
  "pluginAlias": "adapty",
868
850
  "pluginName": "adapty",
869
851
  "pluginType": "core",
@@ -873,22 +855,22 @@
873
855
  "relativePath": [
874
856
  "dist",
875
857
  "commands",
876
- "placements",
877
- "create.js"
858
+ "flows",
859
+ "publish.js"
878
860
  ]
879
861
  },
880
- "placements:get": {
862
+ "flows:update": {
881
863
  "aliases": [],
882
864
  "args": {
883
- "placement_id": {
884
- "description": "Placement ID (UUID)",
885
- "name": "placement_id",
865
+ "flow_id": {
866
+ "description": "Flow ID (UUID)",
867
+ "name": "flow_id",
886
868
  "required": true
887
869
  }
888
870
  },
889
- "description": "Get placement details",
871
+ "description": "Rename a flow",
890
872
  "examples": [
891
- "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
873
+ "<%= config.bin %> flows update --app UUID 550e8400-e29b-41d4-a716-446655440000 --name \"Onboarding v2\""
892
874
  ],
893
875
  "flags": {
894
876
  "json": {
@@ -905,11 +887,19 @@
905
887
  "hasDynamicHelp": false,
906
888
  "multiple": false,
907
889
  "type": "option"
890
+ },
891
+ "name": {
892
+ "description": "New flow name",
893
+ "name": "name",
894
+ "required": true,
895
+ "hasDynamicHelp": false,
896
+ "multiple": false,
897
+ "type": "option"
908
898
  }
909
899
  },
910
900
  "hasDynamicHelp": false,
911
901
  "hiddenAliases": [],
912
- "id": "placements:get",
902
+ "id": "flows:update",
913
903
  "pluginAlias": "adapty",
914
904
  "pluginName": "adapty",
915
905
  "pluginType": "core",
@@ -919,16 +909,16 @@
919
909
  "relativePath": [
920
910
  "dist",
921
911
  "commands",
922
- "placements",
923
- "get.js"
912
+ "flows",
913
+ "update.js"
924
914
  ]
925
915
  },
926
- "placements:list": {
916
+ "paywalls:create": {
927
917
  "aliases": [],
928
918
  "args": {},
929
- "description": "List placements for an app",
919
+ "description": "Create a paywall with products",
930
920
  "examples": [
931
- "<%= config.bin %> placements list --app 550e8400-..."
921
+ "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
932
922
  ],
933
923
  "flags": {
934
924
  "json": {
@@ -946,18 +936,18 @@
946
936
  "multiple": false,
947
937
  "type": "option"
948
938
  },
949
- "page": {
950
- "description": "Page number",
951
- "name": "page",
952
- "default": 1,
939
+ "product-id": {
940
+ "description": "Product ID (UUID). Repeat for multiple.",
941
+ "name": "product-id",
942
+ "required": true,
953
943
  "hasDynamicHelp": false,
954
- "multiple": false,
944
+ "multiple": true,
955
945
  "type": "option"
956
946
  },
957
- "page-size": {
958
- "description": "Items per page (max 100)",
959
- "name": "page-size",
960
- "default": 20,
947
+ "title": {
948
+ "description": "Paywall title",
949
+ "name": "title",
950
+ "required": true,
961
951
  "hasDynamicHelp": false,
962
952
  "multiple": false,
963
953
  "type": "option"
@@ -965,7 +955,7 @@
965
955
  },
966
956
  "hasDynamicHelp": false,
967
957
  "hiddenAliases": [],
968
- "id": "placements:list",
958
+ "id": "paywalls:create",
969
959
  "pluginAlias": "adapty",
970
960
  "pluginName": "adapty",
971
961
  "pluginType": "core",
@@ -975,23 +965,22 @@
975
965
  "relativePath": [
976
966
  "dist",
977
967
  "commands",
978
- "placements",
979
- "list.js"
968
+ "paywalls",
969
+ "create.js"
980
970
  ]
981
971
  },
982
- "placements:update": {
972
+ "paywalls:get": {
983
973
  "aliases": [],
984
974
  "args": {
985
- "placement_id": {
986
- "description": "Placement ID (UUID)",
987
- "name": "placement_id",
975
+ "paywall_id": {
976
+ "description": "Paywall ID (UUID)",
977
+ "name": "paywall_id",
988
978
  "required": true
989
979
  }
990
980
  },
991
- "description": "Update a placement",
981
+ "description": "Get paywall details",
992
982
  "examples": [
993
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
994
- "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
983
+ "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
995
984
  ],
996
985
  "flags": {
997
986
  "json": {
@@ -1008,41 +997,11 @@
1008
997
  "hasDynamicHelp": false,
1009
998
  "multiple": false,
1010
999
  "type": "option"
1011
- },
1012
- "audiences": {
1013
- "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
1014
- "name": "audiences",
1015
- "hasDynamicHelp": false,
1016
- "multiple": false,
1017
- "type": "option"
1018
- },
1019
- "developer-id": {
1020
- "description": "Developer ID for the placement",
1021
- "name": "developer-id",
1022
- "required": true,
1023
- "hasDynamicHelp": false,
1024
- "multiple": false,
1025
- "type": "option"
1026
- },
1027
- "paywall-id": {
1028
- "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1029
- "name": "paywall-id",
1030
- "hasDynamicHelp": false,
1031
- "multiple": false,
1032
- "type": "option"
1033
- },
1034
- "title": {
1035
- "description": "Placement title",
1036
- "name": "title",
1037
- "required": true,
1038
- "hasDynamicHelp": false,
1039
- "multiple": false,
1040
- "type": "option"
1041
1000
  }
1042
1001
  },
1043
1002
  "hasDynamicHelp": false,
1044
1003
  "hiddenAliases": [],
1045
- "id": "placements:update",
1004
+ "id": "paywalls:get",
1046
1005
  "pluginAlias": "adapty",
1047
1006
  "pluginName": "adapty",
1048
1007
  "pluginType": "core",
@@ -1052,16 +1011,16 @@
1052
1011
  "relativePath": [
1053
1012
  "dist",
1054
1013
  "commands",
1055
- "placements",
1056
- "update.js"
1014
+ "paywalls",
1015
+ "get.js"
1057
1016
  ]
1058
1017
  },
1059
- "paywalls:create": {
1018
+ "paywalls:list": {
1060
1019
  "aliases": [],
1061
1020
  "args": {},
1062
- "description": "Create a paywall with products",
1021
+ "description": "List paywalls for an app",
1063
1022
  "examples": [
1064
- "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
1023
+ "<%= config.bin %> paywalls list --app 550e8400-..."
1065
1024
  ],
1066
1025
  "flags": {
1067
1026
  "json": {
@@ -1079,18 +1038,18 @@
1079
1038
  "multiple": false,
1080
1039
  "type": "option"
1081
1040
  },
1082
- "product-id": {
1083
- "description": "Product ID (UUID). Repeat for multiple.",
1084
- "name": "product-id",
1085
- "required": true,
1041
+ "page": {
1042
+ "description": "Page number",
1043
+ "name": "page",
1044
+ "default": 1,
1086
1045
  "hasDynamicHelp": false,
1087
- "multiple": true,
1046
+ "multiple": false,
1088
1047
  "type": "option"
1089
1048
  },
1090
- "title": {
1091
- "description": "Paywall title",
1092
- "name": "title",
1093
- "required": true,
1049
+ "page-size": {
1050
+ "description": "Items per page (max 100)",
1051
+ "name": "page-size",
1052
+ "default": 20,
1094
1053
  "hasDynamicHelp": false,
1095
1054
  "multiple": false,
1096
1055
  "type": "option"
@@ -1098,7 +1057,7 @@
1098
1057
  },
1099
1058
  "hasDynamicHelp": false,
1100
1059
  "hiddenAliases": [],
1101
- "id": "paywalls:create",
1060
+ "id": "paywalls:list",
1102
1061
  "pluginAlias": "adapty",
1103
1062
  "pluginName": "adapty",
1104
1063
  "pluginType": "core",
@@ -1109,10 +1068,10 @@
1109
1068
  "dist",
1110
1069
  "commands",
1111
1070
  "paywalls",
1112
- "create.js"
1071
+ "list.js"
1113
1072
  ]
1114
1073
  },
1115
- "paywalls:get": {
1074
+ "paywalls:placements": {
1116
1075
  "aliases": [],
1117
1076
  "args": {
1118
1077
  "paywall_id": {
@@ -1121,9 +1080,9 @@
1121
1080
  "required": true
1122
1081
  }
1123
1082
  },
1124
- "description": "Get paywall details",
1083
+ "description": "List placements that currently use this paywall",
1125
1084
  "examples": [
1126
- "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1085
+ "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
1127
1086
  ],
1128
1087
  "flags": {
1129
1088
  "json": {
@@ -1144,7 +1103,7 @@
1144
1103
  },
1145
1104
  "hasDynamicHelp": false,
1146
1105
  "hiddenAliases": [],
1147
- "id": "paywalls:get",
1106
+ "id": "paywalls:placements",
1148
1107
  "pluginAlias": "adapty",
1149
1108
  "pluginName": "adapty",
1150
1109
  "pluginType": "core",
@@ -1155,15 +1114,21 @@
1155
1114
  "dist",
1156
1115
  "commands",
1157
1116
  "paywalls",
1158
- "get.js"
1117
+ "placements.js"
1159
1118
  ]
1160
1119
  },
1161
- "paywalls:list": {
1120
+ "paywalls:update": {
1162
1121
  "aliases": [],
1163
- "args": {},
1164
- "description": "List paywalls for an app",
1122
+ "args": {
1123
+ "paywall_id": {
1124
+ "description": "Paywall ID (UUID)",
1125
+ "name": "paywall_id",
1126
+ "required": true
1127
+ }
1128
+ },
1129
+ "description": "Update a paywall",
1165
1130
  "examples": [
1166
- "<%= config.bin %> paywalls list --app 550e8400-..."
1131
+ "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
1167
1132
  ],
1168
1133
  "flags": {
1169
1134
  "json": {
@@ -1181,18 +1146,18 @@
1181
1146
  "multiple": false,
1182
1147
  "type": "option"
1183
1148
  },
1184
- "page": {
1185
- "description": "Page number",
1186
- "name": "page",
1187
- "default": 1,
1149
+ "product-id": {
1150
+ "description": "Product ID (UUID). Repeat for multiple.",
1151
+ "name": "product-id",
1152
+ "required": true,
1188
1153
  "hasDynamicHelp": false,
1189
- "multiple": false,
1154
+ "multiple": true,
1190
1155
  "type": "option"
1191
1156
  },
1192
- "page-size": {
1193
- "description": "Items per page (max 100)",
1194
- "name": "page-size",
1195
- "default": 20,
1157
+ "title": {
1158
+ "description": "Paywall title",
1159
+ "name": "title",
1160
+ "required": true,
1196
1161
  "hasDynamicHelp": false,
1197
1162
  "multiple": false,
1198
1163
  "type": "option"
@@ -1200,7 +1165,7 @@
1200
1165
  },
1201
1166
  "hasDynamicHelp": false,
1202
1167
  "hiddenAliases": [],
1203
- "id": "paywalls:list",
1168
+ "id": "paywalls:update",
1204
1169
  "pluginAlias": "adapty",
1205
1170
  "pluginName": "adapty",
1206
1171
  "pluginType": "core",
@@ -1211,21 +1176,17 @@
1211
1176
  "dist",
1212
1177
  "commands",
1213
1178
  "paywalls",
1214
- "list.js"
1179
+ "update.js"
1215
1180
  ]
1216
1181
  },
1217
- "paywalls:placements": {
1182
+ "placements:create": {
1218
1183
  "aliases": [],
1219
- "args": {
1220
- "paywall_id": {
1221
- "description": "Paywall ID (UUID)",
1222
- "name": "paywall_id",
1223
- "required": true
1224
- }
1225
- },
1226
- "description": "List placements that currently use this paywall",
1184
+ "args": {},
1185
+ "description": "Create a placement with a paywall",
1227
1186
  "examples": [
1228
- "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
1187
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1188
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
1189
+ "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1229
1190
  ],
1230
1191
  "flags": {
1231
1192
  "json": {
@@ -1242,63 +1203,31 @@
1242
1203
  "hasDynamicHelp": false,
1243
1204
  "multiple": false,
1244
1205
  "type": "option"
1245
- }
1246
- },
1247
- "hasDynamicHelp": false,
1248
- "hiddenAliases": [],
1249
- "id": "paywalls:placements",
1250
- "pluginAlias": "adapty",
1251
- "pluginName": "adapty",
1252
- "pluginType": "core",
1253
- "strict": true,
1254
- "enableJsonFlag": true,
1255
- "isESM": true,
1256
- "relativePath": [
1257
- "dist",
1258
- "commands",
1259
- "paywalls",
1260
- "placements.js"
1261
- ]
1262
- },
1263
- "paywalls:update": {
1264
- "aliases": [],
1265
- "args": {
1266
- "paywall_id": {
1267
- "description": "Paywall ID (UUID)",
1268
- "name": "paywall_id",
1269
- "required": true
1270
- }
1271
- },
1272
- "description": "Update a paywall",
1273
- "examples": [
1274
- "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
1275
- ],
1276
- "flags": {
1277
- "json": {
1278
- "description": "Format output as json.",
1279
- "helpGroup": "GLOBAL",
1280
- "name": "json",
1281
- "allowNo": false,
1282
- "type": "boolean"
1283
1206
  },
1284
- "app": {
1285
- "description": "App ID (UUID)",
1286
- "name": "app",
1287
- "required": true,
1207
+ "audiences": {
1208
+ "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
1209
+ "name": "audiences",
1288
1210
  "hasDynamicHelp": false,
1289
1211
  "multiple": false,
1290
1212
  "type": "option"
1291
1213
  },
1292
- "product-id": {
1293
- "description": "Product ID (UUID). Repeat for multiple.",
1294
- "name": "product-id",
1214
+ "developer-id": {
1215
+ "description": "Developer ID for the placement",
1216
+ "name": "developer-id",
1295
1217
  "required": true,
1296
1218
  "hasDynamicHelp": false,
1297
- "multiple": true,
1219
+ "multiple": false,
1220
+ "type": "option"
1221
+ },
1222
+ "paywall-id": {
1223
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1224
+ "name": "paywall-id",
1225
+ "hasDynamicHelp": false,
1226
+ "multiple": false,
1298
1227
  "type": "option"
1299
1228
  },
1300
1229
  "title": {
1301
- "description": "Paywall title",
1230
+ "description": "Placement title",
1302
1231
  "name": "title",
1303
1232
  "required": true,
1304
1233
  "hasDynamicHelp": false,
@@ -1308,7 +1237,7 @@
1308
1237
  },
1309
1238
  "hasDynamicHelp": false,
1310
1239
  "hiddenAliases": [],
1311
- "id": "paywalls:update",
1240
+ "id": "placements:create",
1312
1241
  "pluginAlias": "adapty",
1313
1242
  "pluginName": "adapty",
1314
1243
  "pluginType": "core",
@@ -1318,22 +1247,22 @@
1318
1247
  "relativePath": [
1319
1248
  "dist",
1320
1249
  "commands",
1321
- "paywalls",
1322
- "update.js"
1250
+ "placements",
1251
+ "create.js"
1323
1252
  ]
1324
1253
  },
1325
- "segments:get": {
1254
+ "placements:get": {
1326
1255
  "aliases": [],
1327
1256
  "args": {
1328
- "segment_id": {
1329
- "description": "Segment ID (UUID)",
1330
- "name": "segment_id",
1257
+ "placement_id": {
1258
+ "description": "Placement ID (UUID)",
1259
+ "name": "placement_id",
1331
1260
  "required": true
1332
1261
  }
1333
1262
  },
1334
- "description": "Get segment details",
1263
+ "description": "Get placement details",
1335
1264
  "examples": [
1336
- "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1265
+ "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1337
1266
  ],
1338
1267
  "flags": {
1339
1268
  "json": {
@@ -1354,7 +1283,7 @@
1354
1283
  },
1355
1284
  "hasDynamicHelp": false,
1356
1285
  "hiddenAliases": [],
1357
- "id": "segments:get",
1286
+ "id": "placements:get",
1358
1287
  "pluginAlias": "adapty",
1359
1288
  "pluginName": "adapty",
1360
1289
  "pluginType": "core",
@@ -1364,16 +1293,16 @@
1364
1293
  "relativePath": [
1365
1294
  "dist",
1366
1295
  "commands",
1367
- "segments",
1296
+ "placements",
1368
1297
  "get.js"
1369
1298
  ]
1370
1299
  },
1371
- "segments:list": {
1300
+ "placements:list": {
1372
1301
  "aliases": [],
1373
1302
  "args": {},
1374
- "description": "List segments for an app",
1303
+ "description": "List placements for an app",
1375
1304
  "examples": [
1376
- "<%= config.bin %> segments list --app 550e8400-..."
1305
+ "<%= config.bin %> placements list --app 550e8400-..."
1377
1306
  ],
1378
1307
  "flags": {
1379
1308
  "json": {
@@ -1410,7 +1339,7 @@
1410
1339
  },
1411
1340
  "hasDynamicHelp": false,
1412
1341
  "hiddenAliases": [],
1413
- "id": "segments:list",
1342
+ "id": "placements:list",
1414
1343
  "pluginAlias": "adapty",
1415
1344
  "pluginName": "adapty",
1416
1345
  "pluginType": "core",
@@ -1420,16 +1349,24 @@
1420
1349
  "relativePath": [
1421
1350
  "dist",
1422
1351
  "commands",
1423
- "segments",
1352
+ "placements",
1424
1353
  "list.js"
1425
1354
  ]
1426
1355
  },
1427
- "products:create": {
1356
+ "placements:update": {
1428
1357
  "aliases": [],
1429
- "args": {},
1430
- "description": "Create a product with vendor products per platform",
1358
+ "args": {
1359
+ "placement_id": {
1360
+ "description": "Placement ID (UUID)",
1361
+ "name": "placement_id",
1362
+ "required": true
1363
+ }
1364
+ },
1365
+ "description": "Update a placement",
1431
1366
  "examples": [
1432
- "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
1367
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
1368
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
1369
+ "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
1433
1370
  ],
1434
1371
  "flags": {
1435
1372
  "json": {
@@ -1447,48 +1384,118 @@
1447
1384
  "multiple": false,
1448
1385
  "type": "option"
1449
1386
  },
1450
- "access-level-id": {
1451
- "description": "Access level ID (UUID)",
1452
- "name": "access-level-id",
1453
- "required": true,
1454
- "hasDynamicHelp": false,
1455
- "multiple": false,
1456
- "type": "option"
1457
- },
1458
- "android-base-plan-id": {
1459
- "description": "Android base plan ID",
1460
- "helpGroup": "STORE BINDINGS",
1461
- "name": "android-base-plan-id",
1387
+ "audiences": {
1388
+ "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
1389
+ "name": "audiences",
1462
1390
  "hasDynamicHelp": false,
1463
1391
  "multiple": false,
1464
1392
  "type": "option"
1465
1393
  },
1466
- "android-product-id": {
1467
- "description": "Android product ID",
1468
- "helpGroup": "STORE BINDINGS",
1469
- "name": "android-product-id",
1394
+ "developer-id": {
1395
+ "description": "Developer ID for the placement",
1396
+ "name": "developer-id",
1397
+ "required": true,
1470
1398
  "hasDynamicHelp": false,
1471
1399
  "multiple": false,
1472
1400
  "type": "option"
1473
1401
  },
1474
- "ios-product-id": {
1475
- "description": "iOS product ID",
1476
- "helpGroup": "STORE BINDINGS",
1477
- "name": "ios-product-id",
1402
+ "paywall-id": {
1403
+ "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
1404
+ "name": "paywall-id",
1478
1405
  "hasDynamicHelp": false,
1479
1406
  "multiple": false,
1480
1407
  "type": "option"
1481
1408
  },
1482
- "paddle-price-id": {
1483
- "description": "Paddle price ID (requires --paddle-product-id)",
1484
- "helpGroup": "STORE BINDINGS",
1485
- "name": "paddle-price-id",
1409
+ "title": {
1410
+ "description": "Placement title",
1411
+ "name": "title",
1412
+ "required": true,
1486
1413
  "hasDynamicHelp": false,
1487
1414
  "multiple": false,
1488
1415
  "type": "option"
1489
- },
1490
- "paddle-product-id": {
1491
- "description": "Paddle product ID (requires --paddle-price-id)",
1416
+ }
1417
+ },
1418
+ "hasDynamicHelp": false,
1419
+ "hiddenAliases": [],
1420
+ "id": "placements:update",
1421
+ "pluginAlias": "adapty",
1422
+ "pluginName": "adapty",
1423
+ "pluginType": "core",
1424
+ "strict": true,
1425
+ "enableJsonFlag": true,
1426
+ "isESM": true,
1427
+ "relativePath": [
1428
+ "dist",
1429
+ "commands",
1430
+ "placements",
1431
+ "update.js"
1432
+ ]
1433
+ },
1434
+ "products:create": {
1435
+ "aliases": [],
1436
+ "args": {},
1437
+ "description": "Create a product with vendor products per platform",
1438
+ "examples": [
1439
+ "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
1440
+ ],
1441
+ "flags": {
1442
+ "json": {
1443
+ "description": "Format output as json.",
1444
+ "helpGroup": "GLOBAL",
1445
+ "name": "json",
1446
+ "allowNo": false,
1447
+ "type": "boolean"
1448
+ },
1449
+ "app": {
1450
+ "description": "App ID (UUID)",
1451
+ "name": "app",
1452
+ "required": true,
1453
+ "hasDynamicHelp": false,
1454
+ "multiple": false,
1455
+ "type": "option"
1456
+ },
1457
+ "access-level-id": {
1458
+ "description": "Access level ID (UUID)",
1459
+ "name": "access-level-id",
1460
+ "required": true,
1461
+ "hasDynamicHelp": false,
1462
+ "multiple": false,
1463
+ "type": "option"
1464
+ },
1465
+ "android-base-plan-id": {
1466
+ "description": "Android base plan ID",
1467
+ "helpGroup": "STORE BINDINGS",
1468
+ "name": "android-base-plan-id",
1469
+ "hasDynamicHelp": false,
1470
+ "multiple": false,
1471
+ "type": "option"
1472
+ },
1473
+ "android-product-id": {
1474
+ "description": "Android product ID",
1475
+ "helpGroup": "STORE BINDINGS",
1476
+ "name": "android-product-id",
1477
+ "hasDynamicHelp": false,
1478
+ "multiple": false,
1479
+ "type": "option"
1480
+ },
1481
+ "ios-product-id": {
1482
+ "description": "iOS product ID",
1483
+ "helpGroup": "STORE BINDINGS",
1484
+ "name": "ios-product-id",
1485
+ "hasDynamicHelp": false,
1486
+ "multiple": false,
1487
+ "type": "option"
1488
+ },
1489
+ "paddle-price-id": {
1490
+ "description": "Paddle price ID (requires --paddle-product-id)",
1491
+ "helpGroup": "STORE BINDINGS",
1492
+ "name": "paddle-price-id",
1493
+ "hasDynamicHelp": false,
1494
+ "multiple": false,
1495
+ "type": "option"
1496
+ },
1497
+ "paddle-product-id": {
1498
+ "description": "Paddle product ID (requires --paddle-price-id)",
1492
1499
  "helpGroup": "STORE BINDINGS",
1493
1500
  "name": "paddle-product-id",
1494
1501
  "hasDynamicHelp": false,
@@ -1708,12 +1715,18 @@
1708
1715
  "update.js"
1709
1716
  ]
1710
1717
  },
1711
- "asa:ads:create": {
1718
+ "segments:get": {
1712
1719
  "aliases": [],
1713
- "args": {},
1714
- "description": "Create an ad from a creative in an ad group",
1720
+ "args": {
1721
+ "segment_id": {
1722
+ "description": "Segment ID (UUID)",
1723
+ "name": "segment_id",
1724
+ "required": true
1725
+ }
1726
+ },
1727
+ "description": "Get segment details",
1715
1728
  "examples": [
1716
- "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
1729
+ "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
1717
1730
  ],
1718
1731
  "flags": {
1719
1732
  "json": {
@@ -1723,59 +1736,18 @@
1723
1736
  "allowNo": false,
1724
1737
  "type": "boolean"
1725
1738
  },
1726
- "yes": {
1727
- "char": "y",
1728
- "description": "Apply without asking; required when the output is piped or --json is used",
1729
- "name": "yes",
1730
- "allowNo": false,
1731
- "type": "boolean"
1732
- },
1733
- "idempotency-key": {
1734
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1735
- "name": "idempotency-key",
1736
- "hasDynamicHelp": false,
1737
- "multiple": false,
1738
- "type": "option"
1739
- },
1740
- "ad-group": {
1741
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
1742
- "name": "ad-group",
1743
- "required": true,
1744
- "hasDynamicHelp": false,
1745
- "multiple": false,
1746
- "type": "option"
1747
- },
1748
- "creative-id": {
1749
- "description": "Apple creative ID from a product page or the default set",
1750
- "name": "creative-id",
1751
- "required": true,
1752
- "hasDynamicHelp": false,
1753
- "multiple": false,
1754
- "type": "option"
1755
- },
1756
- "name": {
1757
- "description": "Ad name",
1758
- "name": "name",
1739
+ "app": {
1740
+ "description": "App ID (UUID)",
1741
+ "name": "app",
1759
1742
  "required": true,
1760
1743
  "hasDynamicHelp": false,
1761
1744
  "multiple": false,
1762
1745
  "type": "option"
1763
- },
1764
- "status": {
1765
- "description": "Initial status",
1766
- "name": "status",
1767
- "hasDynamicHelp": false,
1768
- "multiple": false,
1769
- "options": [
1770
- "ENABLED",
1771
- "PAUSED"
1772
- ],
1773
- "type": "option"
1774
1746
  }
1775
1747
  },
1776
1748
  "hasDynamicHelp": false,
1777
1749
  "hiddenAliases": [],
1778
- "id": "asa:ads:create",
1750
+ "id": "segments:get",
1779
1751
  "pluginAlias": "adapty",
1780
1752
  "pluginName": "adapty",
1781
1753
  "pluginType": "core",
@@ -1785,23 +1757,16 @@
1785
1757
  "relativePath": [
1786
1758
  "dist",
1787
1759
  "commands",
1788
- "asa",
1789
- "ads",
1790
- "create.js"
1760
+ "segments",
1761
+ "get.js"
1791
1762
  ]
1792
1763
  },
1793
- "asa:ads:get": {
1764
+ "segments:list": {
1794
1765
  "aliases": [],
1795
- "args": {
1796
- "ad_id": {
1797
- "description": "Ad ID (UUID)",
1798
- "name": "ad_id",
1799
- "required": true
1800
- }
1801
- },
1802
- "description": "Show one ad and its serving state",
1766
+ "args": {},
1767
+ "description": "List segments for an app",
1803
1768
  "examples": [
1804
- "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
1769
+ "<%= config.bin %> segments list --app 550e8400-..."
1805
1770
  ],
1806
1771
  "flags": {
1807
1772
  "json": {
@@ -1810,11 +1775,35 @@
1810
1775
  "name": "json",
1811
1776
  "allowNo": false,
1812
1777
  "type": "boolean"
1778
+ },
1779
+ "app": {
1780
+ "description": "App ID (UUID)",
1781
+ "name": "app",
1782
+ "required": true,
1783
+ "hasDynamicHelp": false,
1784
+ "multiple": false,
1785
+ "type": "option"
1786
+ },
1787
+ "page": {
1788
+ "description": "Page number",
1789
+ "name": "page",
1790
+ "default": 1,
1791
+ "hasDynamicHelp": false,
1792
+ "multiple": false,
1793
+ "type": "option"
1794
+ },
1795
+ "page-size": {
1796
+ "description": "Items per page (max 100)",
1797
+ "name": "page-size",
1798
+ "default": 20,
1799
+ "hasDynamicHelp": false,
1800
+ "multiple": false,
1801
+ "type": "option"
1813
1802
  }
1814
1803
  },
1815
1804
  "hasDynamicHelp": false,
1816
1805
  "hiddenAliases": [],
1817
- "id": "asa:ads:get",
1806
+ "id": "segments:list",
1818
1807
  "pluginAlias": "adapty",
1819
1808
  "pluginName": "adapty",
1820
1809
  "pluginType": "core",
@@ -1824,18 +1813,18 @@
1824
1813
  "relativePath": [
1825
1814
  "dist",
1826
1815
  "commands",
1827
- "asa",
1828
- "ads",
1829
- "get.js"
1816
+ "segments",
1817
+ "list.js"
1830
1818
  ]
1831
1819
  },
1832
- "asa:ads:list": {
1820
+ "asa:ad-groups:create": {
1833
1821
  "aliases": [],
1834
1822
  "args": {},
1835
- "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
1823
+ "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
1836
1824
  "examples": [
1837
- "<%= config.bin %> asa ads list",
1838
- "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
1825
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1826
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM",
1827
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
1839
1828
  ],
1840
1829
  "flags": {
1841
1830
  "json": {
@@ -1845,214 +1834,63 @@
1845
1834
  "allowNo": false,
1846
1835
  "type": "boolean"
1847
1836
  },
1848
- "page": {
1849
- "description": "Page number",
1850
- "name": "page",
1851
- "default": 1,
1837
+ "currency": {
1838
+ "description": "Currency code for the amounts in this call",
1839
+ "name": "currency",
1840
+ "default": "USD",
1852
1841
  "hasDynamicHelp": false,
1853
1842
  "multiple": false,
1854
1843
  "type": "option"
1855
1844
  },
1856
- "page-size": {
1857
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
1858
- "name": "page-size",
1859
- "default": 100,
1845
+ "end-time": {
1846
+ "description": "Schedule end (YYYY-MM-DD)",
1847
+ "name": "end-time",
1860
1848
  "hasDynamicHelp": false,
1861
1849
  "multiple": false,
1862
1850
  "type": "option"
1863
1851
  },
1864
- "ad-group": {
1865
- "description": "Keep only rows in this ad group; repeatable",
1866
- "name": "ad-group",
1852
+ "start-time": {
1853
+ "description": "Schedule start (YYYY-MM-DD), defaults to today",
1854
+ "name": "start-time",
1867
1855
  "hasDynamicHelp": false,
1868
- "multiple": true,
1856
+ "multiple": false,
1869
1857
  "type": "option"
1870
1858
  },
1871
- "campaign": {
1872
- "description": "Keep only rows in this campaign; repeatable",
1873
- "name": "campaign",
1859
+ "pricing-model": {
1860
+ "description": "Pricing model; Apple requires one on every ad group",
1861
+ "name": "pricing-model",
1862
+ "default": "CPC",
1874
1863
  "hasDynamicHelp": false,
1875
- "multiple": true,
1864
+ "multiple": false,
1865
+ "options": [
1866
+ "CPC",
1867
+ "CPM"
1868
+ ],
1876
1869
  "type": "option"
1877
1870
  },
1878
- "campaign-group": {
1879
- "description": "Keep only rows in this campaign group; repeatable",
1880
- "name": "campaign-group",
1881
- "hasDynamicHelp": false,
1882
- "multiple": true,
1883
- "type": "option"
1871
+ "yes": {
1872
+ "char": "y",
1873
+ "description": "Apply without asking; required when the output is piped or --json is used",
1874
+ "name": "yes",
1875
+ "allowNo": false,
1876
+ "type": "boolean"
1884
1877
  },
1885
- "search": {
1886
- "description": "Case-insensitive substring match on the name",
1887
- "name": "search",
1878
+ "idempotency-key": {
1879
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1880
+ "name": "idempotency-key",
1888
1881
  "hasDynamicHelp": false,
1889
1882
  "multiple": false,
1890
1883
  "type": "option"
1891
1884
  },
1892
- "status": {
1893
- "description": "Keep only rows in this state",
1894
- "name": "status",
1895
- "hasDynamicHelp": false,
1896
- "multiple": false,
1897
- "options": [
1898
- "ENABLED",
1899
- "PAUSED"
1900
- ],
1901
- "type": "option"
1902
- }
1903
- },
1904
- "hasDynamicHelp": false,
1905
- "hiddenAliases": [],
1906
- "id": "asa:ads:list",
1907
- "pluginAlias": "adapty",
1908
- "pluginName": "adapty",
1909
- "pluginType": "core",
1910
- "strict": true,
1911
- "enableJsonFlag": true,
1912
- "isESM": true,
1913
- "relativePath": [
1914
- "dist",
1915
- "commands",
1916
- "asa",
1917
- "ads",
1918
- "list.js"
1919
- ]
1920
- },
1921
- "asa:ads:update": {
1922
- "aliases": [],
1923
- "args": {
1924
- "ad_id": {
1925
- "description": "Ad ID (UUID)",
1926
- "name": "ad_id",
1927
- "required": true
1928
- }
1929
- },
1930
- "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
1931
- "examples": [
1932
- "<%= config.bin %> asa ads update UUID --status PAUSED"
1933
- ],
1934
- "flags": {
1935
- "json": {
1936
- "description": "Format output as json.",
1937
- "helpGroup": "GLOBAL",
1938
- "name": "json",
1939
- "allowNo": false,
1940
- "type": "boolean"
1941
- },
1942
- "yes": {
1943
- "char": "y",
1944
- "description": "Apply without asking; required when the output is piped or --json is used",
1945
- "name": "yes",
1946
- "allowNo": false,
1947
- "type": "boolean"
1948
- },
1949
- "idempotency-key": {
1950
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
1951
- "name": "idempotency-key",
1952
- "hasDynamicHelp": false,
1953
- "multiple": false,
1954
- "type": "option"
1955
- },
1956
- "name": {
1957
- "description": "Ad name",
1958
- "name": "name",
1959
- "hasDynamicHelp": false,
1960
- "multiple": false,
1961
- "type": "option"
1962
- },
1963
- "status": {
1964
- "description": "Ad status",
1965
- "name": "status",
1966
- "hasDynamicHelp": false,
1967
- "multiple": false,
1968
- "options": [
1969
- "ENABLED",
1970
- "PAUSED"
1971
- ],
1972
- "type": "option"
1973
- }
1974
- },
1975
- "hasDynamicHelp": false,
1976
- "hiddenAliases": [],
1977
- "id": "asa:ads:update",
1978
- "pluginAlias": "adapty",
1979
- "pluginName": "adapty",
1980
- "pluginType": "core",
1981
- "strict": true,
1982
- "enableJsonFlag": true,
1983
- "isESM": true,
1984
- "relativePath": [
1985
- "dist",
1986
- "commands",
1987
- "asa",
1988
- "ads",
1989
- "update.js"
1990
- ]
1991
- },
1992
- "asa:ad-groups:create": {
1993
- "aliases": [],
1994
- "args": {},
1995
- "description": "Create an ad group inside a campaign",
1996
- "examples": [
1997
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1998
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM"
1999
- ],
2000
- "flags": {
2001
- "json": {
2002
- "description": "Format output as json.",
2003
- "helpGroup": "GLOBAL",
2004
- "name": "json",
2005
- "allowNo": false,
2006
- "type": "boolean"
2007
- },
2008
- "currency": {
2009
- "description": "Currency code for the amounts in this call",
2010
- "name": "currency",
2011
- "default": "USD",
2012
- "hasDynamicHelp": false,
2013
- "multiple": false,
2014
- "type": "option"
2015
- },
2016
- "end-time": {
2017
- "description": "Schedule end (YYYY-MM-DD)",
2018
- "name": "end-time",
2019
- "hasDynamicHelp": false,
2020
- "multiple": false,
2021
- "type": "option"
2022
- },
2023
- "start-time": {
2024
- "description": "Schedule start (YYYY-MM-DD), defaults to today",
2025
- "name": "start-time",
2026
- "hasDynamicHelp": false,
2027
- "multiple": false,
2028
- "type": "option"
2029
- },
2030
- "pricing-model": {
2031
- "description": "Pricing model; Apple requires one on every ad group",
2032
- "name": "pricing-model",
2033
- "default": "CPC",
2034
- "hasDynamicHelp": false,
2035
- "multiple": false,
2036
- "options": [
2037
- "CPC",
2038
- "CPM"
1885
+ "automated": {
1886
+ "description": "Create the automated ad group a Max Conversions campaign needs (no bid, no schedule, always ENABLED)",
1887
+ "exclusive": [
1888
+ "automated-keywords"
2039
1889
  ],
2040
- "type": "option"
2041
- },
2042
- "yes": {
2043
- "char": "y",
2044
- "description": "Apply without asking; required when the output is piped or --json is used",
2045
- "name": "yes",
1890
+ "name": "automated",
2046
1891
  "allowNo": false,
2047
1892
  "type": "boolean"
2048
1893
  },
2049
- "idempotency-key": {
2050
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2051
- "name": "idempotency-key",
2052
- "hasDynamicHelp": false,
2053
- "multiple": false,
2054
- "type": "option"
2055
- },
2056
1894
  "automated-keywords": {
2057
1895
  "description": "Let Apple add keywords automatically",
2058
1896
  "name": "automated-keywords",
@@ -2075,9 +1913,8 @@
2075
1913
  "type": "option"
2076
1914
  },
2077
1915
  "default-bid": {
2078
- "description": "Default bid (amount, e.g. 50 or 12.50)",
1916
+ "description": "Default bid; required unless --automated is set (amount, e.g. 50 or 12.50)",
2079
1917
  "name": "default-bid",
2080
- "required": true,
2081
1918
  "hasDynamicHelp": false,
2082
1919
  "multiple": false,
2083
1920
  "type": "option"
@@ -2411,13 +2248,12 @@
2411
2248
  "list.js"
2412
2249
  ]
2413
2250
  },
2414
- "asa:automations:create": {
2251
+ "asa:ads:create": {
2415
2252
  "aliases": [],
2416
2253
  "args": {},
2417
- "description": "Create an automation rule from a JSON rule file",
2254
+ "description": "Create an ad from a creative in an ad group",
2418
2255
  "examples": [
2419
- "<%= config.bin %> asa automations create --file rule.json",
2420
- "<%= config.bin %> asa automations create --file rule.json --run-now"
2256
+ "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
2421
2257
  ],
2422
2258
  "flags": {
2423
2259
  "json": {
@@ -2441,24 +2277,45 @@
2441
2277
  "multiple": false,
2442
2278
  "type": "option"
2443
2279
  },
2444
- "file": {
2445
- "description": "JSON file with the rule body, or - to read stdin",
2446
- "name": "file",
2280
+ "ad-group": {
2281
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
2282
+ "name": "ad-group",
2447
2283
  "required": true,
2448
2284
  "hasDynamicHelp": false,
2449
2285
  "multiple": false,
2450
2286
  "type": "option"
2451
2287
  },
2452
- "run-now": {
2453
- "description": "Queue the first run right after the rule is stored",
2454
- "name": "run-now",
2455
- "allowNo": false,
2456
- "type": "boolean"
2288
+ "creative-id": {
2289
+ "description": "Apple creative ID from a product page or the default set",
2290
+ "name": "creative-id",
2291
+ "required": true,
2292
+ "hasDynamicHelp": false,
2293
+ "multiple": false,
2294
+ "type": "option"
2295
+ },
2296
+ "name": {
2297
+ "description": "Ad name",
2298
+ "name": "name",
2299
+ "required": true,
2300
+ "hasDynamicHelp": false,
2301
+ "multiple": false,
2302
+ "type": "option"
2303
+ },
2304
+ "status": {
2305
+ "description": "Initial status",
2306
+ "name": "status",
2307
+ "hasDynamicHelp": false,
2308
+ "multiple": false,
2309
+ "options": [
2310
+ "ENABLED",
2311
+ "PAUSED"
2312
+ ],
2313
+ "type": "option"
2457
2314
  }
2458
2315
  },
2459
2316
  "hasDynamicHelp": false,
2460
2317
  "hiddenAliases": [],
2461
- "id": "asa:automations:create",
2318
+ "id": "asa:ads:create",
2462
2319
  "pluginAlias": "adapty",
2463
2320
  "pluginName": "adapty",
2464
2321
  "pluginType": "core",
@@ -2469,22 +2326,22 @@
2469
2326
  "dist",
2470
2327
  "commands",
2471
2328
  "asa",
2472
- "automations",
2329
+ "ads",
2473
2330
  "create.js"
2474
2331
  ]
2475
2332
  },
2476
- "asa:automations:get": {
2333
+ "asa:ads:get": {
2477
2334
  "aliases": [],
2478
2335
  "args": {
2479
- "automation_id": {
2480
- "description": "Automation rule ID (UUID)",
2481
- "name": "automation_id",
2336
+ "ad_id": {
2337
+ "description": "Ad ID (UUID)",
2338
+ "name": "ad_id",
2482
2339
  "required": true
2483
2340
  }
2484
2341
  },
2485
- "description": "Show one automation rule with its conditions and actions",
2342
+ "description": "Show one ad and its serving state",
2486
2343
  "examples": [
2487
- "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
2344
+ "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
2488
2345
  ],
2489
2346
  "flags": {
2490
2347
  "json": {
@@ -2497,7 +2354,7 @@
2497
2354
  },
2498
2355
  "hasDynamicHelp": false,
2499
2356
  "hiddenAliases": [],
2500
- "id": "asa:automations:get",
2357
+ "id": "asa:ads:get",
2501
2358
  "pluginAlias": "adapty",
2502
2359
  "pluginName": "adapty",
2503
2360
  "pluginType": "core",
@@ -2508,16 +2365,17 @@
2508
2365
  "dist",
2509
2366
  "commands",
2510
2367
  "asa",
2511
- "automations",
2368
+ "ads",
2512
2369
  "get.js"
2513
2370
  ]
2514
2371
  },
2515
- "asa:automations:list": {
2372
+ "asa:ads:list": {
2516
2373
  "aliases": [],
2517
2374
  "args": {},
2518
- "description": "List automation rules; status 1 is active, 0 is stopped",
2375
+ "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
2519
2376
  "examples": [
2520
- "<%= config.bin %> asa automations list"
2377
+ "<%= config.bin %> asa ads list",
2378
+ "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
2521
2379
  ],
2522
2380
  "flags": {
2523
2381
  "json": {
@@ -2542,38 +2400,76 @@
2542
2400
  "hasDynamicHelp": false,
2543
2401
  "multiple": false,
2544
2402
  "type": "option"
2545
- }
2546
- },
2547
- "hasDynamicHelp": false,
2548
- "hiddenAliases": [],
2549
- "id": "asa:automations:list",
2550
- "pluginAlias": "adapty",
2551
- "pluginName": "adapty",
2552
- "pluginType": "core",
2553
- "strict": true,
2554
- "enableJsonFlag": true,
2555
- "isESM": true,
2556
- "relativePath": [
2557
- "dist",
2558
- "commands",
2559
- "asa",
2560
- "automations",
2561
- "list.js"
2562
- ]
2563
- },
2564
- "asa:automations:run": {
2565
- "aliases": [],
2566
- "args": {
2567
- "automation_id": {
2568
- "description": "Automation rule ID (UUID)",
2569
- "name": "automation_id",
2403
+ },
2404
+ "ad-group": {
2405
+ "description": "Keep only rows in this ad group; repeatable",
2406
+ "name": "ad-group",
2407
+ "hasDynamicHelp": false,
2408
+ "multiple": true,
2409
+ "type": "option"
2410
+ },
2411
+ "campaign": {
2412
+ "description": "Keep only rows in this campaign; repeatable",
2413
+ "name": "campaign",
2414
+ "hasDynamicHelp": false,
2415
+ "multiple": true,
2416
+ "type": "option"
2417
+ },
2418
+ "campaign-group": {
2419
+ "description": "Keep only rows in this campaign group; repeatable",
2420
+ "name": "campaign-group",
2421
+ "hasDynamicHelp": false,
2422
+ "multiple": true,
2423
+ "type": "option"
2424
+ },
2425
+ "search": {
2426
+ "description": "Case-insensitive substring match on the name",
2427
+ "name": "search",
2428
+ "hasDynamicHelp": false,
2429
+ "multiple": false,
2430
+ "type": "option"
2431
+ },
2432
+ "status": {
2433
+ "description": "Keep only rows in this state",
2434
+ "name": "status",
2435
+ "hasDynamicHelp": false,
2436
+ "multiple": false,
2437
+ "options": [
2438
+ "ENABLED",
2439
+ "PAUSED"
2440
+ ],
2441
+ "type": "option"
2442
+ }
2443
+ },
2444
+ "hasDynamicHelp": false,
2445
+ "hiddenAliases": [],
2446
+ "id": "asa:ads:list",
2447
+ "pluginAlias": "adapty",
2448
+ "pluginName": "adapty",
2449
+ "pluginType": "core",
2450
+ "strict": true,
2451
+ "enableJsonFlag": true,
2452
+ "isESM": true,
2453
+ "relativePath": [
2454
+ "dist",
2455
+ "commands",
2456
+ "asa",
2457
+ "ads",
2458
+ "list.js"
2459
+ ]
2460
+ },
2461
+ "asa:ads:update": {
2462
+ "aliases": [],
2463
+ "args": {
2464
+ "ad_id": {
2465
+ "description": "Ad ID (UUID)",
2466
+ "name": "ad_id",
2570
2467
  "required": true
2571
2468
  }
2572
2469
  },
2573
- "description": "Run an automation rule now; the run is queued, not awaited",
2470
+ "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
2574
2471
  "examples": [
2575
- "<%= config.bin %> asa automations run UUID",
2576
- "<%= config.bin %> asa automations run UUID --dry-run"
2472
+ "<%= config.bin %> asa ads update UUID --status PAUSED"
2577
2473
  ],
2578
2474
  "flags": {
2579
2475
  "json": {
@@ -2597,16 +2493,90 @@
2597
2493
  "multiple": false,
2598
2494
  "type": "option"
2599
2495
  },
2600
- "dry-run": {
2601
- "description": "Evaluate and log the rule without touching Apple",
2602
- "name": "dry-run",
2496
+ "name": {
2497
+ "description": "Ad name",
2498
+ "name": "name",
2499
+ "hasDynamicHelp": false,
2500
+ "multiple": false,
2501
+ "type": "option"
2502
+ },
2503
+ "status": {
2504
+ "description": "Ad status",
2505
+ "name": "status",
2506
+ "hasDynamicHelp": false,
2507
+ "multiple": false,
2508
+ "options": [
2509
+ "ENABLED",
2510
+ "PAUSED"
2511
+ ],
2512
+ "type": "option"
2513
+ }
2514
+ },
2515
+ "hasDynamicHelp": false,
2516
+ "hiddenAliases": [],
2517
+ "id": "asa:ads:update",
2518
+ "pluginAlias": "adapty",
2519
+ "pluginName": "adapty",
2520
+ "pluginType": "core",
2521
+ "strict": true,
2522
+ "enableJsonFlag": true,
2523
+ "isESM": true,
2524
+ "relativePath": [
2525
+ "dist",
2526
+ "commands",
2527
+ "asa",
2528
+ "ads",
2529
+ "update.js"
2530
+ ]
2531
+ },
2532
+ "asa:automations:create": {
2533
+ "aliases": [],
2534
+ "args": {},
2535
+ "description": "Create an automation rule from a JSON rule file",
2536
+ "examples": [
2537
+ "<%= config.bin %> asa automations create --file rule.json",
2538
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
2539
+ ],
2540
+ "flags": {
2541
+ "json": {
2542
+ "description": "Format output as json.",
2543
+ "helpGroup": "GLOBAL",
2544
+ "name": "json",
2545
+ "allowNo": false,
2546
+ "type": "boolean"
2547
+ },
2548
+ "yes": {
2549
+ "char": "y",
2550
+ "description": "Apply without asking; required when the output is piped or --json is used",
2551
+ "name": "yes",
2552
+ "allowNo": false,
2553
+ "type": "boolean"
2554
+ },
2555
+ "idempotency-key": {
2556
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2557
+ "name": "idempotency-key",
2558
+ "hasDynamicHelp": false,
2559
+ "multiple": false,
2560
+ "type": "option"
2561
+ },
2562
+ "file": {
2563
+ "description": "JSON file with the rule body, or - to read stdin",
2564
+ "name": "file",
2565
+ "required": true,
2566
+ "hasDynamicHelp": false,
2567
+ "multiple": false,
2568
+ "type": "option"
2569
+ },
2570
+ "run-now": {
2571
+ "description": "Queue the first run right after the rule is stored",
2572
+ "name": "run-now",
2603
2573
  "allowNo": false,
2604
2574
  "type": "boolean"
2605
2575
  }
2606
2576
  },
2607
2577
  "hasDynamicHelp": false,
2608
2578
  "hiddenAliases": [],
2609
- "id": "asa:automations:run",
2579
+ "id": "asa:automations:create",
2610
2580
  "pluginAlias": "adapty",
2611
2581
  "pluginName": "adapty",
2612
2582
  "pluginType": "core",
@@ -2618,10 +2588,10 @@
2618
2588
  "commands",
2619
2589
  "asa",
2620
2590
  "automations",
2621
- "run.js"
2591
+ "create.js"
2622
2592
  ]
2623
2593
  },
2624
- "asa:automations:runs": {
2594
+ "asa:automations:get": {
2625
2595
  "aliases": [],
2626
2596
  "args": {
2627
2597
  "automation_id": {
@@ -2630,9 +2600,42 @@
2630
2600
  "required": true
2631
2601
  }
2632
2602
  },
2633
- "description": "List past runs of an automation rule, including dry runs",
2603
+ "description": "Show one automation rule with its conditions and actions",
2634
2604
  "examples": [
2635
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2605
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
2606
+ ],
2607
+ "flags": {
2608
+ "json": {
2609
+ "description": "Format output as json.",
2610
+ "helpGroup": "GLOBAL",
2611
+ "name": "json",
2612
+ "allowNo": false,
2613
+ "type": "boolean"
2614
+ }
2615
+ },
2616
+ "hasDynamicHelp": false,
2617
+ "hiddenAliases": [],
2618
+ "id": "asa:automations:get",
2619
+ "pluginAlias": "adapty",
2620
+ "pluginName": "adapty",
2621
+ "pluginType": "core",
2622
+ "strict": true,
2623
+ "enableJsonFlag": true,
2624
+ "isESM": true,
2625
+ "relativePath": [
2626
+ "dist",
2627
+ "commands",
2628
+ "asa",
2629
+ "automations",
2630
+ "get.js"
2631
+ ]
2632
+ },
2633
+ "asa:automations:list": {
2634
+ "aliases": [],
2635
+ "args": {},
2636
+ "description": "List automation rules; status 1 is active, 0 is stopped",
2637
+ "examples": [
2638
+ "<%= config.bin %> asa automations list"
2636
2639
  ],
2637
2640
  "flags": {
2638
2641
  "json": {
@@ -2661,7 +2664,7 @@
2661
2664
  },
2662
2665
  "hasDynamicHelp": false,
2663
2666
  "hiddenAliases": [],
2664
- "id": "asa:automations:runs",
2667
+ "id": "asa:automations:list",
2665
2668
  "pluginAlias": "adapty",
2666
2669
  "pluginName": "adapty",
2667
2670
  "pluginType": "core",
@@ -2673,10 +2676,10 @@
2673
2676
  "commands",
2674
2677
  "asa",
2675
2678
  "automations",
2676
- "runs.js"
2679
+ "list.js"
2677
2680
  ]
2678
2681
  },
2679
- "asa:automations:update": {
2682
+ "asa:automations:run": {
2680
2683
  "aliases": [],
2681
2684
  "args": {
2682
2685
  "automation_id": {
@@ -2685,10 +2688,10 @@
2685
2688
  "required": true
2686
2689
  }
2687
2690
  },
2688
- "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
2691
+ "description": "Run an automation rule now; the run is queued, not awaited",
2689
2692
  "examples": [
2690
- "<%= config.bin %> asa automations update UUID --stop",
2691
- "<%= config.bin %> asa automations update UUID --file rule.json"
2693
+ "<%= config.bin %> asa automations run UUID",
2694
+ "<%= config.bin %> asa automations run UUID --dry-run"
2692
2695
  ],
2693
2696
  "flags": {
2694
2697
  "json": {
@@ -2712,42 +2715,16 @@
2712
2715
  "multiple": false,
2713
2716
  "type": "option"
2714
2717
  },
2715
- "file": {
2716
- "description": "JSON file with the parts to change, or - to read stdin",
2717
- "name": "file",
2718
- "hasDynamicHelp": false,
2719
- "multiple": false,
2720
- "type": "option"
2721
- },
2722
- "name": {
2723
- "description": "Rule name",
2724
- "name": "name",
2725
- "hasDynamicHelp": false,
2726
- "multiple": false,
2727
- "type": "option"
2728
- },
2729
- "start": {
2730
- "description": "Activate the rule",
2731
- "exclusive": [
2732
- "stop"
2733
- ],
2734
- "name": "start",
2735
- "allowNo": false,
2736
- "type": "boolean"
2737
- },
2738
- "stop": {
2739
- "description": "Stop the rule and clear its next run",
2740
- "exclusive": [
2741
- "start"
2742
- ],
2743
- "name": "stop",
2718
+ "dry-run": {
2719
+ "description": "Evaluate and log the rule without touching Apple",
2720
+ "name": "dry-run",
2744
2721
  "allowNo": false,
2745
2722
  "type": "boolean"
2746
2723
  }
2747
2724
  },
2748
2725
  "hasDynamicHelp": false,
2749
2726
  "hiddenAliases": [],
2750
- "id": "asa:automations:update",
2727
+ "id": "asa:automations:run",
2751
2728
  "pluginAlias": "adapty",
2752
2729
  "pluginName": "adapty",
2753
2730
  "pluginType": "core",
@@ -2759,18 +2736,77 @@
2759
2736
  "commands",
2760
2737
  "asa",
2761
2738
  "automations",
2762
- "update.js"
2739
+ "run.js"
2763
2740
  ]
2764
2741
  },
2765
- "asa:campaigns:bulk-create": {
2742
+ "asa:automations:runs": {
2766
2743
  "aliases": [],
2767
- "args": {},
2768
- "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2744
+ "args": {
2745
+ "automation_id": {
2746
+ "description": "Automation rule ID (UUID)",
2747
+ "name": "automation_id",
2748
+ "required": true
2749
+ }
2750
+ },
2751
+ "description": "List past runs of an automation rule, including dry runs",
2769
2752
  "examples": [
2770
- "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2771
- "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2772
- "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2773
- "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2753
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2754
+ ],
2755
+ "flags": {
2756
+ "json": {
2757
+ "description": "Format output as json.",
2758
+ "helpGroup": "GLOBAL",
2759
+ "name": "json",
2760
+ "allowNo": false,
2761
+ "type": "boolean"
2762
+ },
2763
+ "page": {
2764
+ "description": "Page number",
2765
+ "name": "page",
2766
+ "default": 1,
2767
+ "hasDynamicHelp": false,
2768
+ "multiple": false,
2769
+ "type": "option"
2770
+ },
2771
+ "page-size": {
2772
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2773
+ "name": "page-size",
2774
+ "default": 100,
2775
+ "hasDynamicHelp": false,
2776
+ "multiple": false,
2777
+ "type": "option"
2778
+ }
2779
+ },
2780
+ "hasDynamicHelp": false,
2781
+ "hiddenAliases": [],
2782
+ "id": "asa:automations:runs",
2783
+ "pluginAlias": "adapty",
2784
+ "pluginName": "adapty",
2785
+ "pluginType": "core",
2786
+ "strict": true,
2787
+ "enableJsonFlag": true,
2788
+ "isESM": true,
2789
+ "relativePath": [
2790
+ "dist",
2791
+ "commands",
2792
+ "asa",
2793
+ "automations",
2794
+ "runs.js"
2795
+ ]
2796
+ },
2797
+ "asa:automations:update": {
2798
+ "aliases": [],
2799
+ "args": {
2800
+ "automation_id": {
2801
+ "description": "Automation rule ID (UUID)",
2802
+ "name": "automation_id",
2803
+ "required": true
2804
+ }
2805
+ },
2806
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
2807
+ "examples": [
2808
+ "<%= config.bin %> asa automations update UUID --stop",
2809
+ "<%= config.bin %> asa automations update UUID --file rule.json"
2774
2810
  ],
2775
2811
  "flags": {
2776
2812
  "json": {
@@ -2795,58 +2831,41 @@
2795
2831
  "type": "option"
2796
2832
  },
2797
2833
  "file": {
2798
- "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2834
+ "description": "JSON file with the parts to change, or - to read stdin",
2799
2835
  "name": "file",
2800
2836
  "hasDynamicHelp": false,
2801
2837
  "multiple": false,
2802
2838
  "type": "option"
2803
2839
  },
2804
- "from-file": {
2805
- "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2806
- "name": "from-file",
2807
- "hasDynamicHelp": false,
2808
- "multiple": false,
2809
- "type": "option"
2810
- },
2811
- "org-id": {
2812
- "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2813
- "name": "org-id",
2814
- "hasDynamicHelp": false,
2815
- "multiple": false,
2816
- "type": "option"
2817
- },
2818
- "poll-interval": {
2819
- "description": "Seconds between progress polls",
2820
- "name": "poll-interval",
2821
- "default": 5,
2840
+ "name": {
2841
+ "description": "Rule name",
2842
+ "name": "name",
2822
2843
  "hasDynamicHelp": false,
2823
2844
  "multiple": false,
2824
2845
  "type": "option"
2825
2846
  },
2826
- "preview": {
2827
- "description": "With --from-file: print the converted request and stop, nothing is created",
2828
- "name": "preview",
2847
+ "start": {
2848
+ "description": "Activate the rule",
2849
+ "exclusive": [
2850
+ "stop"
2851
+ ],
2852
+ "name": "start",
2829
2853
  "allowNo": false,
2830
2854
  "type": "boolean"
2831
2855
  },
2832
- "timeout": {
2833
- "description": "Max seconds to wait for the operation to finish",
2834
- "name": "timeout",
2835
- "default": 900,
2836
- "hasDynamicHelp": false,
2837
- "multiple": false,
2838
- "type": "option"
2839
- },
2840
- "wait": {
2841
- "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2842
- "name": "wait",
2843
- "allowNo": true,
2856
+ "stop": {
2857
+ "description": "Stop the rule and clear its next run",
2858
+ "exclusive": [
2859
+ "start"
2860
+ ],
2861
+ "name": "stop",
2862
+ "allowNo": false,
2844
2863
  "type": "boolean"
2845
2864
  }
2846
2865
  },
2847
2866
  "hasDynamicHelp": false,
2848
2867
  "hiddenAliases": [],
2849
- "id": "asa:campaigns:bulk-create",
2868
+ "id": "asa:automations:update",
2850
2869
  "pluginAlias": "adapty",
2851
2870
  "pluginName": "adapty",
2852
2871
  "pluginType": "core",
@@ -2857,18 +2876,16 @@
2857
2876
  "dist",
2858
2877
  "commands",
2859
2878
  "asa",
2860
- "campaigns",
2861
- "bulk-create.js"
2879
+ "automations",
2880
+ "update.js"
2862
2881
  ]
2863
2882
  },
2864
- "asa:campaigns:bulk-list": {
2883
+ "asa:competitors:summary": {
2865
2884
  "aliases": [],
2866
2885
  "args": {},
2867
- "description": "This company's bulk operations, newest first; inspect one with bulk-status",
2886
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2868
2887
  "examples": [
2869
- "<%= config.bin %> asa campaigns bulk-list",
2870
- "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
2871
- "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
2888
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2872
2889
  ],
2873
2890
  "flags": {
2874
2891
  "json": {
@@ -2878,61 +2895,18 @@
2878
2895
  "allowNo": false,
2879
2896
  "type": "boolean"
2880
2897
  },
2881
- "page": {
2882
- "description": "Page number",
2883
- "name": "page",
2884
- "default": 1,
2885
- "hasDynamicHelp": false,
2886
- "multiple": false,
2887
- "type": "option"
2888
- },
2889
- "page-size": {
2890
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2891
- "name": "page-size",
2892
- "default": 100,
2893
- "hasDynamicHelp": false,
2894
- "multiple": false,
2895
- "type": "option"
2896
- },
2897
- "app": {
2898
- "description": "Keep only operations of this app (UUID)",
2899
- "name": "app",
2900
- "hasDynamicHelp": false,
2901
- "multiple": false,
2902
- "type": "option"
2903
- },
2904
- "created-from": {
2905
- "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
2906
- "name": "created-from",
2907
- "hasDynamicHelp": false,
2908
- "multiple": false,
2909
- "type": "option"
2910
- },
2911
- "created-to": {
2912
- "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
2913
- "name": "created-to",
2898
+ "app-ids": {
2899
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2900
+ "name": "app-ids",
2901
+ "required": true,
2914
2902
  "hasDynamicHelp": false,
2915
2903
  "multiple": false,
2916
2904
  "type": "option"
2917
- },
2918
- "status": {
2919
- "description": "Keep only operations in this state; repeatable",
2920
- "name": "status",
2921
- "hasDynamicHelp": false,
2922
- "multiple": true,
2923
- "options": [
2924
- "failed",
2925
- "partial",
2926
- "pending",
2927
- "running",
2928
- "success"
2929
- ],
2930
- "type": "option"
2931
2905
  }
2932
2906
  },
2933
2907
  "hasDynamicHelp": false,
2934
2908
  "hiddenAliases": [],
2935
- "id": "asa:campaigns:bulk-list",
2909
+ "id": "asa:competitors:summary",
2936
2910
  "pluginAlias": "adapty",
2937
2911
  "pluginName": "adapty",
2938
2912
  "pluginType": "core",
@@ -2943,22 +2917,17 @@
2943
2917
  "dist",
2944
2918
  "commands",
2945
2919
  "asa",
2946
- "campaigns",
2947
- "bulk-list.js"
2920
+ "competitors",
2921
+ "summary.js"
2948
2922
  ]
2949
2923
  },
2950
- "asa:campaigns:bulk-status": {
2924
+ "asa:creatives:list": {
2951
2925
  "aliases": [],
2952
- "args": {
2953
- "operation-id": {
2954
- "description": "Bulk operation ID returned by bulk-create",
2955
- "name": "operation-id",
2956
- "required": true
2957
- }
2958
- },
2959
- "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2926
+ "args": {},
2927
+ "description": "List creatives; creative_id is what `asa ads create` needs",
2960
2928
  "examples": [
2961
- "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2929
+ "<%= config.bin %> asa creatives list",
2930
+ "<%= config.bin %> asa creatives list --app APP_UUID"
2962
2931
  ],
2963
2932
  "flags": {
2964
2933
  "json": {
@@ -2983,11 +2952,25 @@
2983
2952
  "hasDynamicHelp": false,
2984
2953
  "multiple": false,
2985
2954
  "type": "option"
2955
+ },
2956
+ "app": {
2957
+ "description": "Keep only rows in this app; repeatable",
2958
+ "name": "app",
2959
+ "hasDynamicHelp": false,
2960
+ "multiple": true,
2961
+ "type": "option"
2962
+ },
2963
+ "campaign-group": {
2964
+ "description": "Keep only rows in this campaign group; repeatable",
2965
+ "name": "campaign-group",
2966
+ "hasDynamicHelp": false,
2967
+ "multiple": true,
2968
+ "type": "option"
2986
2969
  }
2987
2970
  },
2988
2971
  "hasDynamicHelp": false,
2989
2972
  "hiddenAliases": [],
2990
- "id": "asa:campaigns:bulk-status",
2973
+ "id": "asa:creatives:list",
2991
2974
  "pluginAlias": "adapty",
2992
2975
  "pluginName": "adapty",
2993
2976
  "pluginType": "core",
@@ -2998,16 +2981,17 @@
2998
2981
  "dist",
2999
2982
  "commands",
3000
2983
  "asa",
3001
- "campaigns",
3002
- "bulk-status.js"
2984
+ "creatives",
2985
+ "list.js"
3003
2986
  ]
3004
2987
  },
3005
- "asa:campaigns:create": {
2988
+ "asa:keywords:add": {
3006
2989
  "aliases": [],
3007
2990
  "args": {},
3008
- "description": "Create a campaign in Apple Search Ads",
2991
+ "description": "Add targeting keywords to an ad group",
3009
2992
  "examples": [
3010
- "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
2993
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
2994
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3011
2995
  ],
3012
2996
  "flags": {
3013
2997
  "json": {
@@ -3039,159 +3023,63 @@
3039
3023
  "multiple": false,
3040
3024
  "type": "option"
3041
3025
  },
3042
- "ad-channel-type": {
3043
- "description": "Ad channel type",
3044
- "name": "ad-channel-type",
3045
- "default": "SEARCH",
3026
+ "ad-group": {
3027
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3028
+ "name": "ad-group",
3029
+ "required": true,
3046
3030
  "hasDynamicHelp": false,
3047
3031
  "multiple": false,
3048
- "options": [
3049
- "DISPLAY",
3050
- "SEARCH"
3051
- ],
3052
3032
  "type": "option"
3053
3033
  },
3054
- "adam-id": {
3055
- "description": "App Store app ID (adam_id)",
3056
- "name": "adam-id",
3057
- "required": true,
3034
+ "bid": {
3035
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3036
+ "name": "bid",
3058
3037
  "hasDynamicHelp": false,
3059
3038
  "multiple": false,
3060
3039
  "type": "option"
3061
3040
  },
3062
- "bidding-strategy": {
3063
- "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
3064
- "name": "bidding-strategy",
3041
+ "from-file": {
3042
+ "description": "File with one keyword per line, combined with any --text values",
3043
+ "name": "from-file",
3065
3044
  "hasDynamicHelp": false,
3066
3045
  "multiple": false,
3067
- "options": [
3068
- "MANUAL_CPT",
3069
- "MAX_CONVERSIONS"
3070
- ],
3071
3046
  "type": "option"
3072
3047
  },
3073
- "billing-event": {
3074
- "description": "Billing event",
3075
- "name": "billing-event",
3076
- "default": "TAPS",
3077
- "hasDynamicHelp": false,
3078
- "multiple": false,
3079
- "options": [
3080
- "IMPRESSIONS",
3081
- "TAPS"
3082
- ],
3083
- "type": "option"
3084
- },
3085
- "budget": {
3086
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3087
- "name": "budget",
3088
- "hasDynamicHelp": false,
3089
- "multiple": false,
3090
- "type": "option"
3091
- },
3092
- "country": {
3093
- "description": "Country or region code, repeatable",
3094
- "name": "country",
3095
- "required": true,
3096
- "hasDynamicHelp": false,
3097
- "multiple": true,
3098
- "type": "option"
3099
- },
3100
- "daily-budget": {
3101
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
3102
- "name": "daily-budget",
3103
- "required": true,
3104
- "hasDynamicHelp": false,
3105
- "multiple": false,
3106
- "type": "option"
3107
- },
3108
- "name": {
3109
- "description": "Campaign name",
3110
- "name": "name",
3111
- "required": true,
3112
- "hasDynamicHelp": false,
3113
- "multiple": false,
3114
- "type": "option"
3115
- },
3116
- "org": {
3117
- "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
3118
- "name": "org",
3119
- "required": true,
3048
+ "match-type": {
3049
+ "description": "Match type",
3050
+ "name": "match-type",
3051
+ "default": "BROAD",
3120
3052
  "hasDynamicHelp": false,
3121
3053
  "multiple": false,
3054
+ "options": [
3055
+ "BROAD",
3056
+ "EXACT"
3057
+ ],
3122
3058
  "type": "option"
3123
3059
  },
3124
3060
  "status": {
3125
- "description": "Initial status",
3061
+ "description": "Keyword status",
3126
3062
  "name": "status",
3063
+ "default": "ACTIVE",
3127
3064
  "hasDynamicHelp": false,
3128
3065
  "multiple": false,
3129
3066
  "options": [
3130
- "ENABLED",
3067
+ "ACTIVE",
3131
3068
  "PAUSED"
3132
3069
  ],
3133
3070
  "type": "option"
3134
3071
  },
3135
- "supply-source": {
3136
- "description": "Supply source, repeatable",
3137
- "name": "supply-source",
3138
- "default": [
3139
- "APPSTORE_SEARCH_RESULTS"
3140
- ],
3072
+ "text": {
3073
+ "description": "Keyword text, repeatable",
3074
+ "name": "text",
3141
3075
  "hasDynamicHelp": false,
3142
3076
  "multiple": true,
3143
3077
  "type": "option"
3144
- },
3145
- "target-cpa": {
3146
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
3147
- "name": "target-cpa",
3148
- "hasDynamicHelp": false,
3149
- "multiple": false,
3150
- "type": "option"
3151
- }
3152
- },
3153
- "hasDynamicHelp": false,
3154
- "hiddenAliases": [],
3155
- "id": "asa:campaigns:create",
3156
- "pluginAlias": "adapty",
3157
- "pluginName": "adapty",
3158
- "pluginType": "core",
3159
- "strict": true,
3160
- "enableJsonFlag": true,
3161
- "isESM": true,
3162
- "relativePath": [
3163
- "dist",
3164
- "commands",
3165
- "asa",
3166
- "campaigns",
3167
- "create.js"
3168
- ]
3169
- },
3170
- "asa:campaigns:get": {
3171
- "aliases": [],
3172
- "args": {
3173
- "campaign_id": {
3174
- "description": "Campaign ID (UUID)",
3175
- "name": "campaign_id",
3176
- "required": true
3177
- }
3178
- },
3179
- "description": "Show one campaign; read numbers with asa metrics",
3180
- "examples": [
3181
- "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
3182
- ],
3183
- "flags": {
3184
- "json": {
3185
- "description": "Format output as json.",
3186
- "helpGroup": "GLOBAL",
3187
- "name": "json",
3188
- "allowNo": false,
3189
- "type": "boolean"
3190
3078
  }
3191
3079
  },
3192
3080
  "hasDynamicHelp": false,
3193
3081
  "hiddenAliases": [],
3194
- "id": "asa:campaigns:get",
3082
+ "id": "asa:keywords:add",
3195
3083
  "pluginAlias": "adapty",
3196
3084
  "pluginName": "adapty",
3197
3085
  "pluginType": "core",
@@ -3202,17 +3090,17 @@
3202
3090
  "dist",
3203
3091
  "commands",
3204
3092
  "asa",
3205
- "campaigns",
3206
- "get.js"
3093
+ "keywords",
3094
+ "add.js"
3207
3095
  ]
3208
3096
  },
3209
- "asa:campaigns:list": {
3097
+ "asa:keywords:list": {
3210
3098
  "aliases": [],
3211
3099
  "args": {},
3212
- "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
3100
+ "description": "List targeting keywords; read numbers with asa metrics",
3213
3101
  "examples": [
3214
- "<%= config.bin %> asa campaigns list",
3215
- "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
3102
+ "<%= config.bin %> asa keywords list",
3103
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3216
3104
  ],
3217
3105
  "flags": {
3218
3106
  "json": {
@@ -3259,13 +3147,27 @@
3259
3147
  "multiple": false,
3260
3148
  "type": "option"
3261
3149
  },
3150
+ "campaign": {
3151
+ "description": "Keep only rows in this campaign; repeatable",
3152
+ "name": "campaign",
3153
+ "hasDynamicHelp": false,
3154
+ "multiple": true,
3155
+ "type": "option"
3156
+ },
3157
+ "ad-group": {
3158
+ "description": "Keep only rows in this ad group; repeatable",
3159
+ "name": "ad-group",
3160
+ "hasDynamicHelp": false,
3161
+ "multiple": true,
3162
+ "type": "option"
3163
+ },
3262
3164
  "status": {
3263
3165
  "description": "Keep only rows in this state",
3264
3166
  "name": "status",
3265
3167
  "hasDynamicHelp": false,
3266
3168
  "multiple": false,
3267
3169
  "options": [
3268
- "ENABLED",
3170
+ "ACTIVE",
3269
3171
  "PAUSED"
3270
3172
  ],
3271
3173
  "type": "option"
@@ -3273,7 +3175,7 @@
3273
3175
  },
3274
3176
  "hasDynamicHelp": false,
3275
3177
  "hiddenAliases": [],
3276
- "id": "asa:campaigns:list",
3178
+ "id": "asa:keywords:list",
3277
3179
  "pluginAlias": "adapty",
3278
3180
  "pluginName": "adapty",
3279
3181
  "pluginType": "core",
@@ -3284,23 +3186,23 @@
3284
3186
  "dist",
3285
3187
  "commands",
3286
3188
  "asa",
3287
- "campaigns",
3189
+ "keywords",
3288
3190
  "list.js"
3289
3191
  ]
3290
3192
  },
3291
- "asa:campaigns:update": {
3193
+ "asa:keywords:update": {
3292
3194
  "aliases": [],
3293
3195
  "args": {
3294
- "campaign_id": {
3295
- "description": "Campaign ID (UUID)",
3296
- "name": "campaign_id",
3196
+ "keyword_id": {
3197
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3198
+ "name": "keyword_id",
3297
3199
  "required": true
3298
3200
  }
3299
3201
  },
3300
- "description": "Change a campaign: budgets, countries, status or schedule",
3202
+ "description": "Change bid, status, text or match type of keywords",
3301
3203
  "examples": [
3302
- "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3303
- "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
3204
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3205
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3304
3206
  ],
3305
3207
  "flags": {
3306
3208
  "json": {
@@ -3332,59 +3234,38 @@
3332
3234
  "multiple": false,
3333
3235
  "type": "option"
3334
3236
  },
3335
- "bidding-strategy": {
3336
- "description": "Bidding strategy",
3337
- "name": "bidding-strategy",
3338
- "hasDynamicHelp": false,
3339
- "multiple": false,
3340
- "options": [
3341
- "MANUAL_CPT",
3342
- "MAX_CONVERSIONS"
3343
- ],
3344
- "type": "option"
3345
- },
3346
- "budget": {
3347
- "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3348
- "name": "budget",
3349
- "hasDynamicHelp": false,
3350
- "multiple": false,
3351
- "type": "option"
3352
- },
3353
- "country": {
3354
- "description": "Replace the country list, repeatable",
3355
- "name": "country",
3356
- "hasDynamicHelp": false,
3357
- "multiple": true,
3358
- "type": "option"
3359
- },
3360
- "daily-budget": {
3361
- "description": "Daily budget (amount, e.g. 50 or 12.50)",
3362
- "name": "daily-budget",
3237
+ "bid": {
3238
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3239
+ "name": "bid",
3363
3240
  "hasDynamicHelp": false,
3364
3241
  "multiple": false,
3365
3242
  "type": "option"
3366
3243
  },
3367
- "name": {
3368
- "description": "Campaign name",
3369
- "name": "name",
3244
+ "match-type": {
3245
+ "description": "Match type",
3246
+ "name": "match-type",
3370
3247
  "hasDynamicHelp": false,
3371
3248
  "multiple": false,
3249
+ "options": [
3250
+ "BROAD",
3251
+ "EXACT"
3252
+ ],
3372
3253
  "type": "option"
3373
3254
  },
3374
3255
  "status": {
3375
- "description": "Campaign status",
3256
+ "description": "Keyword status",
3376
3257
  "name": "status",
3377
3258
  "hasDynamicHelp": false,
3378
3259
  "multiple": false,
3379
3260
  "options": [
3380
- "ENABLED",
3261
+ "ACTIVE",
3381
3262
  "PAUSED"
3382
3263
  ],
3383
3264
  "type": "option"
3384
3265
  },
3385
- "target-cpa": {
3386
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
3387
- "name": "target-cpa",
3266
+ "text": {
3267
+ "description": "Keyword text (only meaningful for a single keyword)",
3268
+ "name": "text",
3388
3269
  "hasDynamicHelp": false,
3389
3270
  "multiple": false,
3390
3271
  "type": "option"
@@ -3392,27 +3273,31 @@
3392
3273
  },
3393
3274
  "hasDynamicHelp": false,
3394
3275
  "hiddenAliases": [],
3395
- "id": "asa:campaigns:update",
3276
+ "id": "asa:keywords:update",
3396
3277
  "pluginAlias": "adapty",
3397
3278
  "pluginName": "adapty",
3398
3279
  "pluginType": "core",
3399
- "strict": true,
3280
+ "strict": false,
3400
3281
  "enableJsonFlag": true,
3401
3282
  "isESM": true,
3402
3283
  "relativePath": [
3403
3284
  "dist",
3404
3285
  "commands",
3405
3286
  "asa",
3406
- "campaigns",
3287
+ "keywords",
3407
3288
  "update.js"
3408
3289
  ]
3409
3290
  },
3410
- "asa:competitors:summary": {
3291
+ "asa:metrics": {
3411
3292
  "aliases": [],
3412
3293
  "args": {},
3413
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
3294
+ "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 finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at 20000 breakdown\nrows (entities × countries × periods); over it the call fails with 422 cli_response_too_large — coarsen\nthe grouping, narrow the window, or reduce page[size]. Budget: 5 metrics calls per minute, at most\n2 per 10 seconds, one at a time.",
3414
3295
  "examples": [
3415
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
3296
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3297
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3298
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3299
+ "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3300
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3416
3301
  ],
3417
3302
  "flags": {
3418
3303
  "json": {
@@ -3422,19 +3307,112 @@
3422
3307
  "allowNo": false,
3423
3308
  "type": "boolean"
3424
3309
  },
3425
- "app-ids": {
3426
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3427
- "name": "app-ids",
3310
+ "page": {
3311
+ "description": "Page number",
3312
+ "name": "page",
3313
+ "default": 1,
3314
+ "hasDynamicHelp": false,
3315
+ "multiple": false,
3316
+ "type": "option"
3317
+ },
3318
+ "page-size": {
3319
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3320
+ "name": "page-size",
3321
+ "default": 100,
3322
+ "hasDynamicHelp": false,
3323
+ "multiple": false,
3324
+ "type": "option"
3325
+ },
3326
+ "by-days": {
3327
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3328
+ "name": "by-days",
3329
+ "hasDynamicHelp": false,
3330
+ "multiple": true,
3331
+ "type": "option"
3332
+ },
3333
+ "date-from": {
3334
+ "description": "Start of the period (YYYY-MM-DD)",
3335
+ "name": "date-from",
3428
3336
  "required": true,
3429
3337
  "hasDynamicHelp": false,
3430
3338
  "multiple": false,
3431
3339
  "type": "option"
3432
- }
3433
- },
3434
- "hasDynamicHelp": false,
3435
- "hiddenAliases": [],
3436
- "id": "asa:competitors:summary",
3437
- "pluginAlias": "adapty",
3340
+ },
3341
+ "date-to": {
3342
+ "description": "End of the period (YYYY-MM-DD)",
3343
+ "name": "date-to",
3344
+ "required": true,
3345
+ "hasDynamicHelp": false,
3346
+ "multiple": false,
3347
+ "type": "option"
3348
+ },
3349
+ "entity": {
3350
+ "description": "What to report on",
3351
+ "name": "entity",
3352
+ "required": true,
3353
+ "hasDynamicHelp": false,
3354
+ "multiple": false,
3355
+ "options": [
3356
+ "ad",
3357
+ "ad-group",
3358
+ "campaign",
3359
+ "keyword"
3360
+ ],
3361
+ "type": "option"
3362
+ },
3363
+ "group-by": {
3364
+ "description": "Break the rows down by a dimension, repeatable",
3365
+ "name": "group-by",
3366
+ "hasDynamicHelp": false,
3367
+ "multiple": true,
3368
+ "options": [
3369
+ "country",
3370
+ "day",
3371
+ "month",
3372
+ "quarter",
3373
+ "week",
3374
+ "year"
3375
+ ],
3376
+ "type": "option"
3377
+ },
3378
+ "metric": {
3379
+ "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3380
+ "name": "metric",
3381
+ "hasDynamicHelp": false,
3382
+ "multiple": true,
3383
+ "type": "option"
3384
+ },
3385
+ "order": {
3386
+ "description": "Sort direction",
3387
+ "name": "order",
3388
+ "default": "desc",
3389
+ "hasDynamicHelp": false,
3390
+ "multiple": false,
3391
+ "options": [
3392
+ "asc",
3393
+ "desc"
3394
+ ],
3395
+ "type": "option"
3396
+ },
3397
+ "order-by": {
3398
+ "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3399
+ "name": "order-by",
3400
+ "hasDynamicHelp": false,
3401
+ "multiple": false,
3402
+ "type": "option"
3403
+ },
3404
+ "order-by-day": {
3405
+ "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3406
+ "name": "order-by-day",
3407
+ "hasDynamicHelp": false,
3408
+ "multiple": false,
3409
+ "type": "option"
3410
+ }
3411
+ },
3412
+ "hasDynamicHelp": false,
3413
+ "hiddenAliases": [],
3414
+ "id": "asa:metrics",
3415
+ "pluginAlias": "adapty",
3438
3416
  "pluginName": "adapty",
3439
3417
  "pluginType": "core",
3440
3418
  "strict": true,
@@ -3444,17 +3422,17 @@
3444
3422
  "dist",
3445
3423
  "commands",
3446
3424
  "asa",
3447
- "competitors",
3448
- "summary.js"
3425
+ "metrics",
3426
+ "index.js"
3449
3427
  ]
3450
3428
  },
3451
- "asa:creatives:list": {
3429
+ "asa:metrics:overview": {
3452
3430
  "aliases": [],
3453
3431
  "args": {},
3454
- "description": "List creatives; creative_id is what `asa ads create` needs",
3432
+ "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.",
3455
3433
  "examples": [
3456
- "<%= config.bin %> asa creatives list",
3457
- "<%= config.bin %> asa creatives list --app APP_UUID"
3434
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3435
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3458
3436
  ],
3459
3437
  "flags": {
3460
3438
  "json": {
@@ -3464,40 +3442,69 @@
3464
3442
  "allowNo": false,
3465
3443
  "type": "boolean"
3466
3444
  },
3467
- "page": {
3468
- "description": "Page number",
3469
- "name": "page",
3470
- "default": 1,
3445
+ "by-days": {
3446
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3447
+ "name": "by-days",
3448
+ "hasDynamicHelp": false,
3449
+ "multiple": true,
3450
+ "type": "option"
3451
+ },
3452
+ "date-from": {
3453
+ "description": "Start of the period (YYYY-MM-DD)",
3454
+ "name": "date-from",
3455
+ "required": true,
3471
3456
  "hasDynamicHelp": false,
3472
3457
  "multiple": false,
3473
3458
  "type": "option"
3474
3459
  },
3475
- "page-size": {
3476
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3477
- "name": "page-size",
3478
- "default": 100,
3460
+ "date-to": {
3461
+ "description": "End of the period (YYYY-MM-DD)",
3462
+ "name": "date-to",
3463
+ "required": true,
3479
3464
  "hasDynamicHelp": false,
3480
3465
  "multiple": false,
3481
3466
  "type": "option"
3482
3467
  },
3483
- "app": {
3484
- "description": "Keep only rows in this app; repeatable",
3485
- "name": "app",
3468
+ "entity": {
3469
+ "description": "What to report on",
3470
+ "name": "entity",
3471
+ "required": true,
3486
3472
  "hasDynamicHelp": false,
3487
- "multiple": true,
3473
+ "multiple": false,
3474
+ "options": [
3475
+ "ad",
3476
+ "ad-group",
3477
+ "campaign",
3478
+ "keyword"
3479
+ ],
3488
3480
  "type": "option"
3489
3481
  },
3490
- "campaign-group": {
3491
- "description": "Keep only rows in this campaign group; repeatable",
3492
- "name": "campaign-group",
3482
+ "metric": {
3483
+ "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
3484
+ "name": "metric",
3493
3485
  "hasDynamicHelp": false,
3494
3486
  "multiple": true,
3495
3487
  "type": "option"
3488
+ },
3489
+ "period-unit": {
3490
+ "description": "Bucket size",
3491
+ "name": "period-unit",
3492
+ "default": "day",
3493
+ "hasDynamicHelp": false,
3494
+ "multiple": false,
3495
+ "options": [
3496
+ "day",
3497
+ "month",
3498
+ "quarter",
3499
+ "week",
3500
+ "year"
3501
+ ],
3502
+ "type": "option"
3496
3503
  }
3497
3504
  },
3498
3505
  "hasDynamicHelp": false,
3499
3506
  "hiddenAliases": [],
3500
- "id": "asa:creatives:list",
3507
+ "id": "asa:metrics:overview",
3501
3508
  "pluginAlias": "adapty",
3502
3509
  "pluginName": "adapty",
3503
3510
  "pluginType": "core",
@@ -3508,17 +3515,18 @@
3508
3515
  "dist",
3509
3516
  "commands",
3510
3517
  "asa",
3511
- "creatives",
3512
- "list.js"
3518
+ "metrics",
3519
+ "overview.js"
3513
3520
  ]
3514
3521
  },
3515
- "asa:keywords:add": {
3522
+ "asa:negative-keywords:add": {
3516
3523
  "aliases": [],
3517
3524
  "args": {},
3518
- "description": "Add targeting keywords to an ad group",
3525
+ "description": "Add negative keywords to an ad group or across a campaign",
3519
3526
  "examples": [
3520
- "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3521
- "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3527
+ "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
3528
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
3529
+ "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
3522
3530
  ],
3523
3531
  "flags": {
3524
3532
  "json": {
@@ -3528,14 +3536,6 @@
3528
3536
  "allowNo": false,
3529
3537
  "type": "boolean"
3530
3538
  },
3531
- "currency": {
3532
- "description": "Currency code for the amounts in this call",
3533
- "name": "currency",
3534
- "default": "USD",
3535
- "hasDynamicHelp": false,
3536
- "multiple": false,
3537
- "type": "option"
3538
- },
3539
3539
  "yes": {
3540
3540
  "char": "y",
3541
3541
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -3552,22 +3552,29 @@
3552
3552
  },
3553
3553
  "ad-group": {
3554
3554
  "description": "Ad group ID (UUID) — the campaign is resolved from it",
3555
+ "exclusive": [
3556
+ "campaign"
3557
+ ],
3555
3558
  "name": "ad-group",
3556
- "required": true,
3557
3559
  "hasDynamicHelp": false,
3558
3560
  "multiple": false,
3559
3561
  "type": "option"
3560
3562
  },
3561
- "bid": {
3562
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3563
- "name": "bid",
3564
- "hasDynamicHelp": false,
3565
- "multiple": false,
3566
- "type": "option"
3563
+ "all-ad-groups": {
3564
+ "dependsOn": [
3565
+ "campaign"
3566
+ ],
3567
+ "description": "Apply to every ad group of the campaign instead of the campaign itself",
3568
+ "name": "all-ad-groups",
3569
+ "allowNo": false,
3570
+ "type": "boolean"
3567
3571
  },
3568
- "from-file": {
3569
- "description": "File with one keyword per line, combined with any --text values",
3570
- "name": "from-file",
3572
+ "campaign": {
3573
+ "description": "Campaign ID (UUID)",
3574
+ "exclusive": [
3575
+ "ad-group"
3576
+ ],
3577
+ "name": "campaign",
3571
3578
  "hasDynamicHelp": false,
3572
3579
  "multiple": false,
3573
3580
  "type": "option"
@@ -3575,7 +3582,7 @@
3575
3582
  "match-type": {
3576
3583
  "description": "Match type",
3577
3584
  "name": "match-type",
3578
- "default": "BROAD",
3585
+ "default": "EXACT",
3579
3586
  "hasDynamicHelp": false,
3580
3587
  "multiple": false,
3581
3588
  "options": [
@@ -3599,6 +3606,7 @@
3599
3606
  "text": {
3600
3607
  "description": "Keyword text, repeatable",
3601
3608
  "name": "text",
3609
+ "required": true,
3602
3610
  "hasDynamicHelp": false,
3603
3611
  "multiple": true,
3604
3612
  "type": "option"
@@ -3606,7 +3614,7 @@
3606
3614
  },
3607
3615
  "hasDynamicHelp": false,
3608
3616
  "hiddenAliases": [],
3609
- "id": "asa:keywords:add",
3617
+ "id": "asa:negative-keywords:add",
3610
3618
  "pluginAlias": "adapty",
3611
3619
  "pluginName": "adapty",
3612
3620
  "pluginType": "core",
@@ -3617,17 +3625,17 @@
3617
3625
  "dist",
3618
3626
  "commands",
3619
3627
  "asa",
3620
- "keywords",
3628
+ "negative-keywords",
3621
3629
  "add.js"
3622
3630
  ]
3623
3631
  },
3624
- "asa:keywords:list": {
3632
+ "asa:negative-keywords:list": {
3625
3633
  "aliases": [],
3626
3634
  "args": {},
3627
- "description": "List targeting keywords; read numbers with asa metrics",
3635
+ "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
3628
3636
  "examples": [
3629
- "<%= config.bin %> asa keywords list",
3630
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3637
+ "<%= config.bin %> asa negative-keywords list",
3638
+ "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
3631
3639
  ],
3632
3640
  "flags": {
3633
3641
  "json": {
@@ -3688,21 +3696,16 @@
3688
3696
  "multiple": true,
3689
3697
  "type": "option"
3690
3698
  },
3691
- "status": {
3692
- "description": "Keep only rows in this state",
3693
- "name": "status",
3694
- "hasDynamicHelp": false,
3695
- "multiple": false,
3696
- "options": [
3697
- "ACTIVE",
3698
- "PAUSED"
3699
- ],
3700
- "type": "option"
3699
+ "campaign-level-only": {
3700
+ "description": "Keep only campaign-level rows (ad_group_id is null)",
3701
+ "name": "campaign-level-only",
3702
+ "allowNo": false,
3703
+ "type": "boolean"
3701
3704
  }
3702
3705
  },
3703
3706
  "hasDynamicHelp": false,
3704
3707
  "hiddenAliases": [],
3705
- "id": "asa:keywords:list",
3708
+ "id": "asa:negative-keywords:list",
3706
3709
  "pluginAlias": "adapty",
3707
3710
  "pluginName": "adapty",
3708
3711
  "pluginType": "core",
@@ -3713,23 +3716,16 @@
3713
3716
  "dist",
3714
3717
  "commands",
3715
3718
  "asa",
3716
- "keywords",
3719
+ "negative-keywords",
3717
3720
  "list.js"
3718
3721
  ]
3719
3722
  },
3720
- "asa:keywords:update": {
3723
+ "asa:orgs:list": {
3721
3724
  "aliases": [],
3722
- "args": {
3723
- "keyword_id": {
3724
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3725
- "name": "keyword_id",
3726
- "required": true
3727
- }
3728
- },
3729
- "description": "Change bid, status, text or match type of keywords",
3725
+ "args": {},
3726
+ "description": "List the Apple Search Ads organizations this company can spend from",
3730
3727
  "examples": [
3731
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3732
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3728
+ "<%= config.bin %> asa orgs list"
3733
3729
  ],
3734
3730
  "flags": {
3735
3731
  "json": {
@@ -3739,60 +3735,137 @@
3739
3735
  "allowNo": false,
3740
3736
  "type": "boolean"
3741
3737
  },
3742
- "currency": {
3743
- "description": "Currency code for the amounts in this call",
3744
- "name": "currency",
3745
- "default": "USD",
3738
+ "page": {
3739
+ "description": "Page number",
3740
+ "name": "page",
3741
+ "default": 1,
3746
3742
  "hasDynamicHelp": false,
3747
3743
  "multiple": false,
3748
3744
  "type": "option"
3749
3745
  },
3750
- "yes": {
3751
- "char": "y",
3752
- "description": "Apply without asking; required when the output is piped or --json is used",
3753
- "name": "yes",
3746
+ "page-size": {
3747
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3748
+ "name": "page-size",
3749
+ "default": 100,
3750
+ "hasDynamicHelp": false,
3751
+ "multiple": false,
3752
+ "type": "option"
3753
+ }
3754
+ },
3755
+ "hasDynamicHelp": false,
3756
+ "hiddenAliases": [],
3757
+ "id": "asa:orgs:list",
3758
+ "pluginAlias": "adapty",
3759
+ "pluginName": "adapty",
3760
+ "pluginType": "core",
3761
+ "strict": true,
3762
+ "enableJsonFlag": true,
3763
+ "isESM": true,
3764
+ "relativePath": [
3765
+ "dist",
3766
+ "commands",
3767
+ "asa",
3768
+ "orgs",
3769
+ "list.js"
3770
+ ]
3771
+ },
3772
+ "asa:product-pages:list": {
3773
+ "aliases": [],
3774
+ "args": {},
3775
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
3776
+ "examples": [
3777
+ "<%= config.bin %> asa product-pages list",
3778
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
3779
+ ],
3780
+ "flags": {
3781
+ "json": {
3782
+ "description": "Format output as json.",
3783
+ "helpGroup": "GLOBAL",
3784
+ "name": "json",
3754
3785
  "allowNo": false,
3755
3786
  "type": "boolean"
3756
3787
  },
3757
- "idempotency-key": {
3758
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3759
- "name": "idempotency-key",
3788
+ "page": {
3789
+ "description": "Page number",
3790
+ "name": "page",
3791
+ "default": 1,
3760
3792
  "hasDynamicHelp": false,
3761
3793
  "multiple": false,
3762
3794
  "type": "option"
3763
3795
  },
3764
- "bid": {
3765
- "description": "Bid (amount, e.g. 50 or 12.50)",
3766
- "name": "bid",
3796
+ "page-size": {
3797
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
3798
+ "name": "page-size",
3799
+ "default": 100,
3767
3800
  "hasDynamicHelp": false,
3768
3801
  "multiple": false,
3769
3802
  "type": "option"
3770
3803
  },
3771
- "match-type": {
3772
- "description": "Match type",
3773
- "name": "match-type",
3804
+ "app": {
3805
+ "description": "Keep only rows in this app; repeatable",
3806
+ "name": "app",
3774
3807
  "hasDynamicHelp": false,
3775
- "multiple": false,
3776
- "options": [
3777
- "BROAD",
3778
- "EXACT"
3779
- ],
3808
+ "multiple": true,
3780
3809
  "type": "option"
3781
3810
  },
3782
- "status": {
3783
- "description": "Keyword status",
3784
- "name": "status",
3811
+ "campaign-group": {
3812
+ "description": "Keep only rows in this campaign group; repeatable",
3813
+ "name": "campaign-group",
3814
+ "hasDynamicHelp": false,
3815
+ "multiple": true,
3816
+ "type": "option"
3817
+ }
3818
+ },
3819
+ "hasDynamicHelp": false,
3820
+ "hiddenAliases": [],
3821
+ "id": "asa:product-pages:list",
3822
+ "pluginAlias": "adapty",
3823
+ "pluginName": "adapty",
3824
+ "pluginType": "core",
3825
+ "strict": true,
3826
+ "enableJsonFlag": true,
3827
+ "isESM": true,
3828
+ "relativePath": [
3829
+ "dist",
3830
+ "commands",
3831
+ "asa",
3832
+ "product-pages",
3833
+ "list.js"
3834
+ ]
3835
+ },
3836
+ "asa:product-pages:sync": {
3837
+ "aliases": [],
3838
+ "args": {},
3839
+ "description": "Refresh custom product pages from Apple",
3840
+ "examples": [
3841
+ "<%= config.bin %> asa product-pages sync",
3842
+ "<%= config.bin %> asa product-pages sync --adam-id 123456"
3843
+ ],
3844
+ "flags": {
3845
+ "json": {
3846
+ "description": "Format output as json.",
3847
+ "helpGroup": "GLOBAL",
3848
+ "name": "json",
3849
+ "allowNo": false,
3850
+ "type": "boolean"
3851
+ },
3852
+ "yes": {
3853
+ "char": "y",
3854
+ "description": "Apply without asking; required when the output is piped or --json is used",
3855
+ "name": "yes",
3856
+ "allowNo": false,
3857
+ "type": "boolean"
3858
+ },
3859
+ "idempotency-key": {
3860
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3861
+ "name": "idempotency-key",
3785
3862
  "hasDynamicHelp": false,
3786
3863
  "multiple": false,
3787
- "options": [
3788
- "ACTIVE",
3789
- "PAUSED"
3790
- ],
3791
3864
  "type": "option"
3792
3865
  },
3793
- "text": {
3794
- "description": "Keyword text (only meaningful for a single keyword)",
3795
- "name": "text",
3866
+ "adam-id": {
3867
+ "description": "Limit the refresh to one app; omit to cover every app",
3868
+ "name": "adam-id",
3796
3869
  "hasDynamicHelp": false,
3797
3870
  "multiple": false,
3798
3871
  "type": "option"
@@ -3800,31 +3873,28 @@
3800
3873
  },
3801
3874
  "hasDynamicHelp": false,
3802
3875
  "hiddenAliases": [],
3803
- "id": "asa:keywords:update",
3876
+ "id": "asa:product-pages:sync",
3804
3877
  "pluginAlias": "adapty",
3805
3878
  "pluginName": "adapty",
3806
3879
  "pluginType": "core",
3807
- "strict": false,
3880
+ "strict": true,
3808
3881
  "enableJsonFlag": true,
3809
3882
  "isESM": true,
3810
3883
  "relativePath": [
3811
3884
  "dist",
3812
3885
  "commands",
3813
3886
  "asa",
3814
- "keywords",
3815
- "update.js"
3887
+ "product-pages",
3888
+ "sync.js"
3816
3889
  ]
3817
3890
  },
3818
- "asa:metrics": {
3891
+ "asa:search-terms:list": {
3819
3892
  "aliases": [],
3820
3893
  "args": {},
3821
- "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 finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at 20000 breakdown\nrows (entities × countries × periods); over it the call fails with 422 cli_response_too_large — coarsen\nthe grouping, narrow the window, or reduce page[size]. Budget: 5 metrics calls per minute, at most\n2 per 10 seconds, one at a time.",
3894
+ "description": "List the search terms your ads matched, with their metrics",
3822
3895
  "examples": [
3823
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3824
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3825
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3826
- "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3827
- "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3896
+ "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
3897
+ "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
3828
3898
  ],
3829
3899
  "flags": {
3830
3900
  "json": {
@@ -3850,95 +3920,59 @@
3850
3920
  "multiple": false,
3851
3921
  "type": "option"
3852
3922
  },
3853
- "by-days": {
3854
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3855
- "name": "by-days",
3856
- "hasDynamicHelp": false,
3857
- "multiple": true,
3858
- "type": "option"
3859
- },
3860
3923
  "date-from": {
3861
- "description": "Start of the period (YYYY-MM-DD)",
3924
+ "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
3862
3925
  "name": "date-from",
3863
- "required": true,
3864
3926
  "hasDynamicHelp": false,
3865
3927
  "multiple": false,
3866
3928
  "type": "option"
3867
3929
  },
3868
3930
  "date-to": {
3869
- "description": "End of the period (YYYY-MM-DD)",
3931
+ "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
3870
3932
  "name": "date-to",
3871
- "required": true,
3872
- "hasDynamicHelp": false,
3873
- "multiple": false,
3874
- "type": "option"
3875
- },
3876
- "entity": {
3877
- "description": "What to report on",
3878
- "name": "entity",
3879
- "required": true,
3880
3933
  "hasDynamicHelp": false,
3881
3934
  "multiple": false,
3882
- "options": [
3883
- "ad",
3884
- "ad-group",
3885
- "campaign",
3886
- "keyword"
3887
- ],
3888
3935
  "type": "option"
3889
3936
  },
3890
- "group-by": {
3891
- "description": "Break the rows down by a dimension, repeatable",
3892
- "name": "group-by",
3937
+ "app": {
3938
+ "description": "Keep only rows in this app; repeatable",
3939
+ "name": "app",
3893
3940
  "hasDynamicHelp": false,
3894
3941
  "multiple": true,
3895
- "options": [
3896
- "country",
3897
- "day",
3898
- "month",
3899
- "quarter",
3900
- "week",
3901
- "year"
3902
- ],
3903
3942
  "type": "option"
3904
3943
  },
3905
- "metric": {
3906
- "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3907
- "name": "metric",
3944
+ "campaign-group": {
3945
+ "description": "Keep only rows in this campaign group; repeatable",
3946
+ "name": "campaign-group",
3908
3947
  "hasDynamicHelp": false,
3909
3948
  "multiple": true,
3910
3949
  "type": "option"
3911
3950
  },
3912
- "order": {
3913
- "description": "Sort direction",
3914
- "name": "order",
3915
- "default": "desc",
3951
+ "search": {
3952
+ "description": "Case-insensitive substring match on the name",
3953
+ "name": "search",
3916
3954
  "hasDynamicHelp": false,
3917
3955
  "multiple": false,
3918
- "options": [
3919
- "asc",
3920
- "desc"
3921
- ],
3922
3956
  "type": "option"
3923
3957
  },
3924
- "order-by": {
3925
- "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3926
- "name": "order-by",
3958
+ "campaign": {
3959
+ "description": "Keep only rows in this campaign; repeatable",
3960
+ "name": "campaign",
3927
3961
  "hasDynamicHelp": false,
3928
- "multiple": false,
3962
+ "multiple": true,
3929
3963
  "type": "option"
3930
3964
  },
3931
- "order-by-day": {
3932
- "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3933
- "name": "order-by-day",
3965
+ "ad-group": {
3966
+ "description": "Keep only rows in this ad group; repeatable",
3967
+ "name": "ad-group",
3934
3968
  "hasDynamicHelp": false,
3935
- "multiple": false,
3969
+ "multiple": true,
3936
3970
  "type": "option"
3937
3971
  }
3938
3972
  },
3939
3973
  "hasDynamicHelp": false,
3940
3974
  "hiddenAliases": [],
3941
- "id": "asa:metrics",
3975
+ "id": "asa:search-terms:list",
3942
3976
  "pluginAlias": "adapty",
3943
3977
  "pluginName": "adapty",
3944
3978
  "pluginType": "core",
@@ -3949,17 +3983,22 @@
3949
3983
  "dist",
3950
3984
  "commands",
3951
3985
  "asa",
3952
- "metrics",
3953
- "index.js"
3986
+ "search-terms",
3987
+ "list.js"
3954
3988
  ]
3955
3989
  },
3956
- "asa:metrics:overview": {
3990
+ "flows:config:get": {
3957
3991
  "aliases": [],
3958
- "args": {},
3959
- "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.",
3992
+ "args": {
3993
+ "flow_id": {
3994
+ "description": "Flow ID (UUID)",
3995
+ "name": "flow_id",
3996
+ "required": true
3997
+ }
3998
+ },
3999
+ "description": "Read the flow builder config (404 until the config has been written at least once)",
3960
4000
  "examples": [
3961
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3962
- "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
4001
+ "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
3963
4002
  ],
3964
4003
  "flags": {
3965
4004
  "json": {
@@ -3969,69 +4008,18 @@
3969
4008
  "allowNo": false,
3970
4009
  "type": "boolean"
3971
4010
  },
3972
- "by-days": {
3973
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3974
- "name": "by-days",
4011
+ "app": {
4012
+ "description": "App ID (UUID)",
4013
+ "name": "app",
4014
+ "required": true,
3975
4015
  "hasDynamicHelp": false,
3976
- "multiple": true,
3977
- "type": "option"
3978
- },
3979
- "date-from": {
3980
- "description": "Start of the period (YYYY-MM-DD)",
3981
- "name": "date-from",
3982
- "required": true,
3983
- "hasDynamicHelp": false,
3984
- "multiple": false,
3985
- "type": "option"
3986
- },
3987
- "date-to": {
3988
- "description": "End of the period (YYYY-MM-DD)",
3989
- "name": "date-to",
3990
- "required": true,
3991
- "hasDynamicHelp": false,
3992
- "multiple": false,
3993
- "type": "option"
3994
- },
3995
- "entity": {
3996
- "description": "What to report on",
3997
- "name": "entity",
3998
- "required": true,
3999
- "hasDynamicHelp": false,
4000
- "multiple": false,
4001
- "options": [
4002
- "ad",
4003
- "ad-group",
4004
- "campaign",
4005
- "keyword"
4006
- ],
4007
- "type": "option"
4008
- },
4009
- "metric": {
4010
- "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
4011
- "name": "metric",
4012
- "hasDynamicHelp": false,
4013
- "multiple": true,
4014
- "type": "option"
4015
- },
4016
- "period-unit": {
4017
- "description": "Bucket size",
4018
- "name": "period-unit",
4019
- "default": "day",
4020
- "hasDynamicHelp": false,
4021
- "multiple": false,
4022
- "options": [
4023
- "day",
4024
- "month",
4025
- "quarter",
4026
- "week",
4027
- "year"
4028
- ],
4016
+ "multiple": false,
4029
4017
  "type": "option"
4030
4018
  }
4031
4019
  },
4032
4020
  "hasDynamicHelp": false,
4033
4021
  "hiddenAliases": [],
4034
- "id": "asa:metrics:overview",
4022
+ "id": "flows:config:get",
4035
4023
  "pluginAlias": "adapty",
4036
4024
  "pluginName": "adapty",
4037
4025
  "pluginType": "core",
@@ -4041,19 +4029,26 @@
4041
4029
  "relativePath": [
4042
4030
  "dist",
4043
4031
  "commands",
4044
- "asa",
4045
- "metrics",
4046
- "overview.js"
4032
+ "flows",
4033
+ "config",
4034
+ "get.js"
4047
4035
  ]
4048
4036
  },
4049
- "asa:negative-keywords:add": {
4037
+ "flows:config:preview": {
4050
4038
  "aliases": [],
4051
- "args": {},
4052
- "description": "Add negative keywords to an ad group or across a campaign",
4039
+ "args": {
4040
+ "config_file": {
4041
+ "description": "Path to a local flow config JSON file",
4042
+ "name": "config_file",
4043
+ "required": true
4044
+ }
4045
+ },
4046
+ "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
4053
4047
  "examples": [
4054
- "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
4055
- "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
4056
- "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
4048
+ "<%= config.bin %> flows config preview ./config.json",
4049
+ "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4050
+ "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
4051
+ "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
4057
4052
  ],
4058
4053
  "flags": {
4059
4054
  "json": {
@@ -4063,85 +4058,37 @@
4063
4058
  "allowNo": false,
4064
4059
  "type": "boolean"
4065
4060
  },
4066
- "yes": {
4067
- "char": "y",
4068
- "description": "Apply without asking; required when the output is piped or --json is used",
4069
- "name": "yes",
4070
- "allowNo": false,
4071
- "type": "boolean"
4072
- },
4073
- "idempotency-key": {
4074
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4075
- "name": "idempotency-key",
4076
- "hasDynamicHelp": false,
4077
- "multiple": false,
4078
- "type": "option"
4079
- },
4080
- "ad-group": {
4081
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
4082
- "exclusive": [
4083
- "campaign"
4084
- ],
4085
- "name": "ad-group",
4086
- "hasDynamicHelp": false,
4087
- "multiple": false,
4088
- "type": "option"
4089
- },
4090
- "all-ad-groups": {
4091
- "dependsOn": [
4092
- "campaign"
4093
- ],
4094
- "description": "Apply to every ad group of the campaign instead of the campaign itself",
4095
- "name": "all-ad-groups",
4096
- "allowNo": false,
4097
- "type": "boolean"
4098
- },
4099
- "campaign": {
4100
- "description": "Campaign ID (UUID)",
4101
- "exclusive": [
4102
- "ad-group"
4103
- ],
4104
- "name": "campaign",
4061
+ "device": {
4062
+ "description": "Device frame to render in",
4063
+ "name": "device",
4064
+ "default": "iphone-14",
4105
4065
  "hasDynamicHelp": false,
4106
4066
  "multiple": false,
4107
4067
  "type": "option"
4108
4068
  },
4109
- "match-type": {
4110
- "description": "Match type",
4111
- "name": "match-type",
4112
- "default": "EXACT",
4069
+ "orientation": {
4070
+ "description": "Device orientation to render in",
4071
+ "name": "orientation",
4072
+ "default": "portrait",
4113
4073
  "hasDynamicHelp": false,
4114
4074
  "multiple": false,
4115
4075
  "options": [
4116
- "BROAD",
4117
- "EXACT"
4076
+ "landscape",
4077
+ "portrait"
4118
4078
  ],
4119
4079
  "type": "option"
4120
4080
  },
4121
- "status": {
4122
- "description": "Keyword status",
4123
- "name": "status",
4124
- "default": "ACTIVE",
4081
+ "screen": {
4082
+ "description": "Screen ID to render (default: the flow's first screen)",
4083
+ "name": "screen",
4125
4084
  "hasDynamicHelp": false,
4126
4085
  "multiple": false,
4127
- "options": [
4128
- "ACTIVE",
4129
- "PAUSED"
4130
- ],
4131
- "type": "option"
4132
- },
4133
- "text": {
4134
- "description": "Keyword text, repeatable",
4135
- "name": "text",
4136
- "required": true,
4137
- "hasDynamicHelp": false,
4138
- "multiple": true,
4139
4086
  "type": "option"
4140
4087
  }
4141
4088
  },
4142
4089
  "hasDynamicHelp": false,
4143
4090
  "hiddenAliases": [],
4144
- "id": "asa:negative-keywords:add",
4091
+ "id": "flows:config:preview",
4145
4092
  "pluginAlias": "adapty",
4146
4093
  "pluginName": "adapty",
4147
4094
  "pluginType": "core",
@@ -4151,18 +4098,25 @@
4151
4098
  "relativePath": [
4152
4099
  "dist",
4153
4100
  "commands",
4154
- "asa",
4155
- "negative-keywords",
4156
- "add.js"
4101
+ "flows",
4102
+ "config",
4103
+ "preview.js"
4157
4104
  ]
4158
4105
  },
4159
- "asa:negative-keywords:list": {
4106
+ "flows:config:update": {
4160
4107
  "aliases": [],
4161
- "args": {},
4162
- "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
4108
+ "args": {
4109
+ "flow_id": {
4110
+ "description": "Flow ID (UUID)",
4111
+ "name": "flow_id",
4112
+ "required": true
4113
+ }
4114
+ },
4115
+ "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4163
4116
  "examples": [
4164
- "<%= config.bin %> asa negative-keywords list",
4165
- "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
4117
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4118
+ "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4119
+ "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4166
4120
  ],
4167
4121
  "flags": {
4168
4122
  "json": {
@@ -4172,67 +4126,46 @@
4172
4126
  "allowNo": false,
4173
4127
  "type": "boolean"
4174
4128
  },
4175
- "page": {
4176
- "description": "Page number",
4177
- "name": "page",
4178
- "default": 1,
4179
- "hasDynamicHelp": false,
4180
- "multiple": false,
4181
- "type": "option"
4182
- },
4183
- "page-size": {
4184
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4185
- "name": "page-size",
4186
- "default": 100,
4187
- "hasDynamicHelp": false,
4188
- "multiple": false,
4189
- "type": "option"
4190
- },
4191
4129
  "app": {
4192
- "description": "Keep only rows in this app; repeatable",
4130
+ "description": "App ID (UUID)",
4193
4131
  "name": "app",
4132
+ "required": true,
4194
4133
  "hasDynamicHelp": false,
4195
- "multiple": true,
4134
+ "multiple": false,
4196
4135
  "type": "option"
4197
4136
  },
4198
- "campaign-group": {
4199
- "description": "Keep only rows in this campaign group; repeatable",
4200
- "name": "campaign-group",
4137
+ "config": {
4138
+ "description": "Builder config as a JSON string",
4139
+ "name": "config",
4201
4140
  "hasDynamicHelp": false,
4202
- "multiple": true,
4141
+ "multiple": false,
4203
4142
  "type": "option"
4204
4143
  },
4205
- "search": {
4206
- "description": "Case-insensitive substring match on the name",
4207
- "name": "search",
4144
+ "config-file": {
4145
+ "description": "JSON file with the builder config, or - to read stdin",
4146
+ "name": "config-file",
4208
4147
  "hasDynamicHelp": false,
4209
4148
  "multiple": false,
4210
4149
  "type": "option"
4211
4150
  },
4212
- "campaign": {
4213
- "description": "Keep only rows in this campaign; repeatable",
4214
- "name": "campaign",
4151
+ "expected-updated-at": {
4152
+ "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4153
+ "name": "expected-updated-at",
4215
4154
  "hasDynamicHelp": false,
4216
- "multiple": true,
4155
+ "multiple": false,
4217
4156
  "type": "option"
4218
4157
  },
4219
- "ad-group": {
4220
- "description": "Keep only rows in this ad group; repeatable",
4221
- "name": "ad-group",
4158
+ "remote-configs": {
4159
+ "description": "JSON array of remote config entries: [{locale, data}]",
4160
+ "name": "remote-configs",
4222
4161
  "hasDynamicHelp": false,
4223
- "multiple": true,
4162
+ "multiple": false,
4224
4163
  "type": "option"
4225
- },
4226
- "campaign-level-only": {
4227
- "description": "Keep only campaign-level rows (ad_group_id is null)",
4228
- "name": "campaign-level-only",
4229
- "allowNo": false,
4230
- "type": "boolean"
4231
4164
  }
4232
4165
  },
4233
4166
  "hasDynamicHelp": false,
4234
4167
  "hiddenAliases": [],
4235
- "id": "asa:negative-keywords:list",
4168
+ "id": "flows:config:update",
4236
4169
  "pluginAlias": "adapty",
4237
4170
  "pluginName": "adapty",
4238
4171
  "pluginType": "core",
@@ -4242,17 +4175,25 @@
4242
4175
  "relativePath": [
4243
4176
  "dist",
4244
4177
  "commands",
4245
- "asa",
4246
- "negative-keywords",
4247
- "list.js"
4178
+ "flows",
4179
+ "config",
4180
+ "update.js"
4248
4181
  ]
4249
4182
  },
4250
- "asa:orgs:list": {
4183
+ "flows:config:validate": {
4251
4184
  "aliases": [],
4252
- "args": {},
4253
- "description": "List the Apple Search Ads organizations this company can spend from",
4185
+ "args": {
4186
+ "flow_id": {
4187
+ "description": "Flow ID (UUID)",
4188
+ "name": "flow_id",
4189
+ "required": true
4190
+ }
4191
+ },
4192
+ "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4254
4193
  "examples": [
4255
- "<%= config.bin %> asa orgs list"
4194
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4195
+ "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4196
+ "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4256
4197
  ],
4257
4198
  "flags": {
4258
4199
  "json": {
@@ -4262,18 +4203,24 @@
4262
4203
  "allowNo": false,
4263
4204
  "type": "boolean"
4264
4205
  },
4265
- "page": {
4266
- "description": "Page number",
4267
- "name": "page",
4268
- "default": 1,
4206
+ "app": {
4207
+ "description": "App ID (UUID)",
4208
+ "name": "app",
4209
+ "required": true,
4269
4210
  "hasDynamicHelp": false,
4270
4211
  "multiple": false,
4271
4212
  "type": "option"
4272
4213
  },
4273
- "page-size": {
4274
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4275
- "name": "page-size",
4276
- "default": 100,
4214
+ "config": {
4215
+ "description": "Builder config as a JSON string",
4216
+ "name": "config",
4217
+ "hasDynamicHelp": false,
4218
+ "multiple": false,
4219
+ "type": "option"
4220
+ },
4221
+ "config-file": {
4222
+ "description": "JSON file with the builder config, or - to read stdin",
4223
+ "name": "config-file",
4277
4224
  "hasDynamicHelp": false,
4278
4225
  "multiple": false,
4279
4226
  "type": "option"
@@ -4281,7 +4228,7 @@
4281
4228
  },
4282
4229
  "hasDynamicHelp": false,
4283
4230
  "hiddenAliases": [],
4284
- "id": "asa:orgs:list",
4231
+ "id": "flows:config:validate",
4285
4232
  "pluginAlias": "adapty",
4286
4233
  "pluginName": "adapty",
4287
4234
  "pluginType": "core",
@@ -4291,18 +4238,23 @@
4291
4238
  "relativePath": [
4292
4239
  "dist",
4293
4240
  "commands",
4294
- "asa",
4295
- "orgs",
4296
- "list.js"
4241
+ "flows",
4242
+ "config",
4243
+ "validate.js"
4297
4244
  ]
4298
4245
  },
4299
- "asa:product-pages:list": {
4246
+ "flows:media:upload": {
4300
4247
  "aliases": [],
4301
- "args": {},
4302
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4248
+ "args": {
4249
+ "file": {
4250
+ "description": "Path to the image file to upload",
4251
+ "name": "file",
4252
+ "required": true
4253
+ }
4254
+ },
4255
+ "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
4303
4256
  "examples": [
4304
- "<%= config.bin %> asa product-pages list",
4305
- "<%= config.bin %> asa product-pages list --app APP_UUID"
4257
+ "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
4306
4258
  ],
4307
4259
  "flags": {
4308
4260
  "json": {
@@ -4312,40 +4264,18 @@
4312
4264
  "allowNo": false,
4313
4265
  "type": "boolean"
4314
4266
  },
4315
- "page": {
4316
- "description": "Page number",
4317
- "name": "page",
4318
- "default": 1,
4319
- "hasDynamicHelp": false,
4320
- "multiple": false,
4321
- "type": "option"
4322
- },
4323
- "page-size": {
4324
- "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4325
- "name": "page-size",
4326
- "default": 100,
4327
- "hasDynamicHelp": false,
4328
- "multiple": false,
4329
- "type": "option"
4330
- },
4331
4267
  "app": {
4332
- "description": "Keep only rows in this app; repeatable",
4268
+ "description": "App ID (UUID)",
4333
4269
  "name": "app",
4270
+ "required": true,
4334
4271
  "hasDynamicHelp": false,
4335
- "multiple": true,
4336
- "type": "option"
4337
- },
4338
- "campaign-group": {
4339
- "description": "Keep only rows in this campaign group; repeatable",
4340
- "name": "campaign-group",
4341
- "hasDynamicHelp": false,
4342
- "multiple": true,
4272
+ "multiple": false,
4343
4273
  "type": "option"
4344
4274
  }
4345
4275
  },
4346
4276
  "hasDynamicHelp": false,
4347
4277
  "hiddenAliases": [],
4348
- "id": "asa:product-pages:list",
4278
+ "id": "flows:media:upload",
4349
4279
  "pluginAlias": "adapty",
4350
4280
  "pluginName": "adapty",
4351
4281
  "pluginType": "core",
@@ -4355,18 +4285,20 @@
4355
4285
  "relativePath": [
4356
4286
  "dist",
4357
4287
  "commands",
4358
- "asa",
4359
- "product-pages",
4360
- "list.js"
4288
+ "flows",
4289
+ "media",
4290
+ "upload.js"
4361
4291
  ]
4362
4292
  },
4363
- "asa:product-pages:sync": {
4293
+ "asa:campaigns:bulk-create": {
4364
4294
  "aliases": [],
4365
4295
  "args": {},
4366
- "description": "Refresh custom product pages from Apple",
4296
+ "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
4367
4297
  "examples": [
4368
- "<%= config.bin %> asa product-pages sync",
4369
- "<%= config.bin %> asa product-pages sync --adam-id 123456"
4298
+ "<%= config.bin %> asa campaigns bulk-create --file structure.json",
4299
+ "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
4300
+ "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
4301
+ "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
4370
4302
  ],
4371
4303
  "flags": {
4372
4304
  "json": {
@@ -4390,17 +4322,59 @@
4390
4322
  "multiple": false,
4391
4323
  "type": "option"
4392
4324
  },
4393
- "adam-id": {
4394
- "description": "Limit the refresh to one app; omit to cover every app",
4395
- "name": "adam-id",
4325
+ "file": {
4326
+ "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
4327
+ "name": "file",
4328
+ "hasDynamicHelp": false,
4329
+ "multiple": false,
4330
+ "type": "option"
4331
+ },
4332
+ "from-file": {
4333
+ "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
4334
+ "name": "from-file",
4335
+ "hasDynamicHelp": false,
4336
+ "multiple": false,
4337
+ "type": "option"
4338
+ },
4339
+ "org-id": {
4340
+ "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
4341
+ "name": "org-id",
4342
+ "hasDynamicHelp": false,
4343
+ "multiple": false,
4344
+ "type": "option"
4345
+ },
4346
+ "poll-interval": {
4347
+ "description": "Seconds between progress polls",
4348
+ "name": "poll-interval",
4349
+ "default": 5,
4396
4350
  "hasDynamicHelp": false,
4397
4351
  "multiple": false,
4398
4352
  "type": "option"
4353
+ },
4354
+ "preview": {
4355
+ "description": "With --from-file: print the converted request and stop, nothing is created",
4356
+ "name": "preview",
4357
+ "allowNo": false,
4358
+ "type": "boolean"
4359
+ },
4360
+ "timeout": {
4361
+ "description": "Max seconds to wait for the operation to finish",
4362
+ "name": "timeout",
4363
+ "default": 900,
4364
+ "hasDynamicHelp": false,
4365
+ "multiple": false,
4366
+ "type": "option"
4367
+ },
4368
+ "wait": {
4369
+ "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
4370
+ "name": "wait",
4371
+ "allowNo": true,
4372
+ "type": "boolean"
4399
4373
  }
4400
4374
  },
4401
4375
  "hasDynamicHelp": false,
4402
4376
  "hiddenAliases": [],
4403
- "id": "asa:product-pages:sync",
4377
+ "id": "asa:campaigns:bulk-create",
4404
4378
  "pluginAlias": "adapty",
4405
4379
  "pluginName": "adapty",
4406
4380
  "pluginType": "core",
@@ -4411,17 +4385,18 @@
4411
4385
  "dist",
4412
4386
  "commands",
4413
4387
  "asa",
4414
- "product-pages",
4415
- "sync.js"
4388
+ "campaigns",
4389
+ "bulk-create.js"
4416
4390
  ]
4417
4391
  },
4418
- "asa:search-terms:list": {
4392
+ "asa:campaigns:bulk-list": {
4419
4393
  "aliases": [],
4420
4394
  "args": {},
4421
- "description": "List the search terms your ads matched, with their metrics",
4395
+ "description": "This company's bulk operations, newest first; inspect one with bulk-status",
4422
4396
  "examples": [
4423
- "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
4424
- "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
4397
+ "<%= config.bin %> asa campaigns bulk-list",
4398
+ "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
4399
+ "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
4425
4400
  ],
4426
4401
  "flags": {
4427
4402
  "json": {
@@ -4447,59 +4422,45 @@
4447
4422
  "multiple": false,
4448
4423
  "type": "option"
4449
4424
  },
4450
- "date-from": {
4451
- "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
4452
- "name": "date-from",
4453
- "hasDynamicHelp": false,
4454
- "multiple": false,
4455
- "type": "option"
4456
- },
4457
- "date-to": {
4458
- "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
4459
- "name": "date-to",
4460
- "hasDynamicHelp": false,
4461
- "multiple": false,
4462
- "type": "option"
4463
- },
4464
4425
  "app": {
4465
- "description": "Keep only rows in this app; repeatable",
4426
+ "description": "Keep only operations of this app (UUID)",
4466
4427
  "name": "app",
4467
4428
  "hasDynamicHelp": false,
4468
- "multiple": true,
4469
- "type": "option"
4470
- },
4471
- "campaign-group": {
4472
- "description": "Keep only rows in this campaign group; repeatable",
4473
- "name": "campaign-group",
4474
- "hasDynamicHelp": false,
4475
- "multiple": true,
4429
+ "multiple": false,
4476
4430
  "type": "option"
4477
4431
  },
4478
- "search": {
4479
- "description": "Case-insensitive substring match on the name",
4480
- "name": "search",
4432
+ "created-from": {
4433
+ "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
4434
+ "name": "created-from",
4481
4435
  "hasDynamicHelp": false,
4482
4436
  "multiple": false,
4483
4437
  "type": "option"
4484
4438
  },
4485
- "campaign": {
4486
- "description": "Keep only rows in this campaign; repeatable",
4487
- "name": "campaign",
4439
+ "created-to": {
4440
+ "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
4441
+ "name": "created-to",
4488
4442
  "hasDynamicHelp": false,
4489
- "multiple": true,
4443
+ "multiple": false,
4490
4444
  "type": "option"
4491
4445
  },
4492
- "ad-group": {
4493
- "description": "Keep only rows in this ad group; repeatable",
4494
- "name": "ad-group",
4446
+ "status": {
4447
+ "description": "Keep only operations in this state; repeatable",
4448
+ "name": "status",
4495
4449
  "hasDynamicHelp": false,
4496
4450
  "multiple": true,
4451
+ "options": [
4452
+ "failed",
4453
+ "partial",
4454
+ "pending",
4455
+ "running",
4456
+ "success"
4457
+ ],
4497
4458
  "type": "option"
4498
4459
  }
4499
4460
  },
4500
4461
  "hasDynamicHelp": false,
4501
4462
  "hiddenAliases": [],
4502
- "id": "asa:search-terms:list",
4463
+ "id": "asa:campaigns:bulk-list",
4503
4464
  "pluginAlias": "adapty",
4504
4465
  "pluginName": "adapty",
4505
4466
  "pluginType": "core",
@@ -4510,22 +4471,22 @@
4510
4471
  "dist",
4511
4472
  "commands",
4512
4473
  "asa",
4513
- "search-terms",
4514
- "list.js"
4474
+ "campaigns",
4475
+ "bulk-list.js"
4515
4476
  ]
4516
4477
  },
4517
- "flows:config:get": {
4478
+ "asa:campaigns:bulk-status": {
4518
4479
  "aliases": [],
4519
4480
  "args": {
4520
- "flow_id": {
4521
- "description": "Flow ID (UUID)",
4522
- "name": "flow_id",
4481
+ "operation-id": {
4482
+ "description": "Bulk operation ID returned by bulk-create",
4483
+ "name": "operation-id",
4523
4484
  "required": true
4524
4485
  }
4525
4486
  },
4526
- "description": "Read the flow builder config (404 until the config has been written at least once)",
4487
+ "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
4527
4488
  "examples": [
4528
- "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
4489
+ "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
4529
4490
  ],
4530
4491
  "flags": {
4531
4492
  "json": {
@@ -4535,10 +4496,18 @@
4535
4496
  "allowNo": false,
4536
4497
  "type": "boolean"
4537
4498
  },
4538
- "app": {
4539
- "description": "App ID (UUID)",
4540
- "name": "app",
4541
- "required": true,
4499
+ "page": {
4500
+ "description": "Page number",
4501
+ "name": "page",
4502
+ "default": 1,
4503
+ "hasDynamicHelp": false,
4504
+ "multiple": false,
4505
+ "type": "option"
4506
+ },
4507
+ "page-size": {
4508
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4509
+ "name": "page-size",
4510
+ "default": 100,
4542
4511
  "hasDynamicHelp": false,
4543
4512
  "multiple": false,
4544
4513
  "type": "option"
@@ -4546,7 +4515,7 @@
4546
4515
  },
4547
4516
  "hasDynamicHelp": false,
4548
4517
  "hiddenAliases": [],
4549
- "id": "flows:config:get",
4518
+ "id": "asa:campaigns:bulk-status",
4550
4519
  "pluginAlias": "adapty",
4551
4520
  "pluginName": "adapty",
4552
4521
  "pluginType": "core",
@@ -4556,26 +4525,19 @@
4556
4525
  "relativePath": [
4557
4526
  "dist",
4558
4527
  "commands",
4559
- "flows",
4560
- "config",
4561
- "get.js"
4528
+ "asa",
4529
+ "campaigns",
4530
+ "bulk-status.js"
4562
4531
  ]
4563
4532
  },
4564
- "flows:config:preview": {
4533
+ "asa:campaigns:create": {
4565
4534
  "aliases": [],
4566
- "args": {
4567
- "config_file": {
4568
- "description": "Path to a local flow config JSON file",
4569
- "name": "config_file",
4570
- "required": true
4571
- }
4572
- },
4573
- "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
4535
+ "args": {},
4536
+ "description": "Create a campaign in Apple Search Ads. A Max Conversions campaign also needs an automated ad group (`asa ad-groups create --automated`); line-of-credit organizations must pass all five --invoice-* flags",
4574
4537
  "examples": [
4575
- "<%= config.bin %> flows config preview ./config.json",
4576
- "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
4577
- "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
4578
- "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
4538
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50",
4539
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Max Conv\" --adam-id 123456 --country US --daily-budget 50 --bidding-strategy MAX_CONVERSIONS",
4540
+ "<%= config.bin %> asa campaigns create --org UUID --name \"LOC push\" --adam-id 123456 --country US --daily-budget 50 --invoice-advertiser \"Acme Inc\" --invoice-order-number PO-42 --invoice-contact-name \"Jane Doe\" --invoice-contact-email jane@acme.com --invoice-billing-email billing@acme.com"
4579
4541
  ],
4580
4542
  "flags": {
4581
4543
  "json": {
@@ -4585,29 +4547,169 @@
4585
4547
  "allowNo": false,
4586
4548
  "type": "boolean"
4587
4549
  },
4588
- "device": {
4589
- "description": "Device frame to render in",
4590
- "name": "device",
4591
- "default": "iphone-14",
4550
+ "currency": {
4551
+ "description": "Currency code for the amounts in this call",
4552
+ "name": "currency",
4553
+ "default": "USD",
4592
4554
  "hasDynamicHelp": false,
4593
4555
  "multiple": false,
4594
4556
  "type": "option"
4595
4557
  },
4596
- "orientation": {
4597
- "description": "Device orientation to render in",
4598
- "name": "orientation",
4599
- "default": "portrait",
4558
+ "yes": {
4559
+ "char": "y",
4560
+ "description": "Apply without asking; required when the output is piped or --json is used",
4561
+ "name": "yes",
4562
+ "allowNo": false,
4563
+ "type": "boolean"
4564
+ },
4565
+ "idempotency-key": {
4566
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4567
+ "name": "idempotency-key",
4568
+ "hasDynamicHelp": false,
4569
+ "multiple": false,
4570
+ "type": "option"
4571
+ },
4572
+ "invoice-advertiser": {
4573
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
4574
+ "name": "invoice-advertiser",
4575
+ "hasDynamicHelp": false,
4576
+ "multiple": false,
4577
+ "type": "option"
4578
+ },
4579
+ "invoice-billing-email": {
4580
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
4581
+ "name": "invoice-billing-email",
4582
+ "hasDynamicHelp": false,
4583
+ "multiple": false,
4584
+ "type": "option"
4585
+ },
4586
+ "invoice-contact-email": {
4587
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
4588
+ "name": "invoice-contact-email",
4589
+ "hasDynamicHelp": false,
4590
+ "multiple": false,
4591
+ "type": "option"
4592
+ },
4593
+ "invoice-contact-name": {
4594
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
4595
+ "name": "invoice-contact-name",
4596
+ "hasDynamicHelp": false,
4597
+ "multiple": false,
4598
+ "type": "option"
4599
+ },
4600
+ "invoice-order-number": {
4601
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
4602
+ "name": "invoice-order-number",
4603
+ "hasDynamicHelp": false,
4604
+ "multiple": false,
4605
+ "type": "option"
4606
+ },
4607
+ "ad-channel-type": {
4608
+ "description": "Ad channel type",
4609
+ "name": "ad-channel-type",
4610
+ "default": "SEARCH",
4600
4611
  "hasDynamicHelp": false,
4601
4612
  "multiple": false,
4602
4613
  "options": [
4603
- "landscape",
4604
- "portrait"
4614
+ "DISPLAY",
4615
+ "SEARCH"
4605
4616
  ],
4606
4617
  "type": "option"
4607
4618
  },
4608
- "screen": {
4609
- "description": "Screen ID to render (default: the flow's first screen)",
4610
- "name": "screen",
4619
+ "adam-id": {
4620
+ "description": "App Store app ID (adam_id)",
4621
+ "name": "adam-id",
4622
+ "required": true,
4623
+ "hasDynamicHelp": false,
4624
+ "multiple": false,
4625
+ "type": "option"
4626
+ },
4627
+ "bidding-strategy": {
4628
+ "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
4629
+ "name": "bidding-strategy",
4630
+ "hasDynamicHelp": false,
4631
+ "multiple": false,
4632
+ "options": [
4633
+ "MANUAL_CPT",
4634
+ "MAX_CONVERSIONS"
4635
+ ],
4636
+ "type": "option"
4637
+ },
4638
+ "billing-event": {
4639
+ "description": "Billing event",
4640
+ "name": "billing-event",
4641
+ "default": "TAPS",
4642
+ "hasDynamicHelp": false,
4643
+ "multiple": false,
4644
+ "options": [
4645
+ "IMPRESSIONS",
4646
+ "TAPS"
4647
+ ],
4648
+ "type": "option"
4649
+ },
4650
+ "budget": {
4651
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
4652
+ "name": "budget",
4653
+ "hasDynamicHelp": false,
4654
+ "multiple": false,
4655
+ "type": "option"
4656
+ },
4657
+ "country": {
4658
+ "description": "Country or region code, repeatable",
4659
+ "name": "country",
4660
+ "required": true,
4661
+ "hasDynamicHelp": false,
4662
+ "multiple": true,
4663
+ "type": "option"
4664
+ },
4665
+ "daily-budget": {
4666
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
4667
+ "name": "daily-budget",
4668
+ "required": true,
4669
+ "hasDynamicHelp": false,
4670
+ "multiple": false,
4671
+ "type": "option"
4672
+ },
4673
+ "name": {
4674
+ "description": "Campaign name",
4675
+ "name": "name",
4676
+ "required": true,
4677
+ "hasDynamicHelp": false,
4678
+ "multiple": false,
4679
+ "type": "option"
4680
+ },
4681
+ "org": {
4682
+ "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
4683
+ "name": "org",
4684
+ "required": true,
4685
+ "hasDynamicHelp": false,
4686
+ "multiple": false,
4687
+ "type": "option"
4688
+ },
4689
+ "status": {
4690
+ "description": "Initial status",
4691
+ "name": "status",
4692
+ "hasDynamicHelp": false,
4693
+ "multiple": false,
4694
+ "options": [
4695
+ "ENABLED",
4696
+ "PAUSED"
4697
+ ],
4698
+ "type": "option"
4699
+ },
4700
+ "supply-source": {
4701
+ "description": "Supply source, repeatable",
4702
+ "name": "supply-source",
4703
+ "default": [
4704
+ "APPSTORE_SEARCH_RESULTS"
4705
+ ],
4706
+ "hasDynamicHelp": false,
4707
+ "multiple": true,
4708
+ "type": "option"
4709
+ },
4710
+ "target-cpa": {
4711
+ "description": "Target CPA; must be lower than --daily-budget (amount, e.g. 50 or 12.50)",
4712
+ "name": "target-cpa",
4611
4713
  "hasDynamicHelp": false,
4612
4714
  "multiple": false,
4613
4715
  "type": "option"
@@ -4615,7 +4717,7 @@
4615
4717
  },
4616
4718
  "hasDynamicHelp": false,
4617
4719
  "hiddenAliases": [],
4618
- "id": "flows:config:preview",
4720
+ "id": "asa:campaigns:create",
4619
4721
  "pluginAlias": "adapty",
4620
4722
  "pluginName": "adapty",
4621
4723
  "pluginType": "core",
@@ -4625,25 +4727,23 @@
4625
4727
  "relativePath": [
4626
4728
  "dist",
4627
4729
  "commands",
4628
- "flows",
4629
- "config",
4630
- "preview.js"
4730
+ "asa",
4731
+ "campaigns",
4732
+ "create.js"
4631
4733
  ]
4632
4734
  },
4633
- "flows:config:update": {
4735
+ "asa:campaigns:get": {
4634
4736
  "aliases": [],
4635
4737
  "args": {
4636
- "flow_id": {
4637
- "description": "Flow ID (UUID)",
4638
- "name": "flow_id",
4738
+ "campaign_id": {
4739
+ "description": "Campaign ID (UUID)",
4740
+ "name": "campaign_id",
4639
4741
  "required": true
4640
4742
  }
4641
4743
  },
4642
- "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
4744
+ "description": "Show one campaign; read numbers with asa metrics",
4643
4745
  "examples": [
4644
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
4645
- "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
4646
- "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
4746
+ "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
4647
4747
  ],
4648
4748
  "flags": {
4649
4749
  "json": {
@@ -4652,47 +4752,11 @@
4652
4752
  "name": "json",
4653
4753
  "allowNo": false,
4654
4754
  "type": "boolean"
4655
- },
4656
- "app": {
4657
- "description": "App ID (UUID)",
4658
- "name": "app",
4659
- "required": true,
4660
- "hasDynamicHelp": false,
4661
- "multiple": false,
4662
- "type": "option"
4663
- },
4664
- "config": {
4665
- "description": "Builder config as a JSON string",
4666
- "name": "config",
4667
- "hasDynamicHelp": false,
4668
- "multiple": false,
4669
- "type": "option"
4670
- },
4671
- "config-file": {
4672
- "description": "JSON file with the builder config, or - to read stdin",
4673
- "name": "config-file",
4674
- "hasDynamicHelp": false,
4675
- "multiple": false,
4676
- "type": "option"
4677
- },
4678
- "expected-updated-at": {
4679
- "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
4680
- "name": "expected-updated-at",
4681
- "hasDynamicHelp": false,
4682
- "multiple": false,
4683
- "type": "option"
4684
- },
4685
- "remote-configs": {
4686
- "description": "JSON array of remote config entries: [{locale, data}]",
4687
- "name": "remote-configs",
4688
- "hasDynamicHelp": false,
4689
- "multiple": false,
4690
- "type": "option"
4691
4755
  }
4692
4756
  },
4693
4757
  "hasDynamicHelp": false,
4694
4758
  "hiddenAliases": [],
4695
- "id": "flows:config:update",
4759
+ "id": "asa:campaigns:get",
4696
4760
  "pluginAlias": "adapty",
4697
4761
  "pluginName": "adapty",
4698
4762
  "pluginType": "core",
@@ -4702,25 +4766,18 @@
4702
4766
  "relativePath": [
4703
4767
  "dist",
4704
4768
  "commands",
4705
- "flows",
4706
- "config",
4707
- "update.js"
4769
+ "asa",
4770
+ "campaigns",
4771
+ "get.js"
4708
4772
  ]
4709
4773
  },
4710
- "flows:config:validate": {
4774
+ "asa:campaigns:list": {
4711
4775
  "aliases": [],
4712
- "args": {
4713
- "flow_id": {
4714
- "description": "Flow ID (UUID)",
4715
- "name": "flow_id",
4716
- "required": true
4717
- }
4718
- },
4719
- "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
4776
+ "args": {},
4777
+ "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
4720
4778
  "examples": [
4721
- "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
4722
- "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
4723
- "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
4779
+ "<%= config.bin %> asa campaigns list",
4780
+ "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
4724
4781
  ],
4725
4782
  "flags": {
4726
4783
  "json": {
@@ -4730,32 +4787,58 @@
4730
4787
  "allowNo": false,
4731
4788
  "type": "boolean"
4732
4789
  },
4790
+ "page": {
4791
+ "description": "Page number",
4792
+ "name": "page",
4793
+ "default": 1,
4794
+ "hasDynamicHelp": false,
4795
+ "multiple": false,
4796
+ "type": "option"
4797
+ },
4798
+ "page-size": {
4799
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4800
+ "name": "page-size",
4801
+ "default": 100,
4802
+ "hasDynamicHelp": false,
4803
+ "multiple": false,
4804
+ "type": "option"
4805
+ },
4733
4806
  "app": {
4734
- "description": "App ID (UUID)",
4807
+ "description": "Keep only rows in this app; repeatable",
4735
4808
  "name": "app",
4736
- "required": true,
4737
4809
  "hasDynamicHelp": false,
4738
- "multiple": false,
4810
+ "multiple": true,
4739
4811
  "type": "option"
4740
4812
  },
4741
- "config": {
4742
- "description": "Builder config as a JSON string",
4743
- "name": "config",
4813
+ "campaign-group": {
4814
+ "description": "Keep only rows in this campaign group; repeatable",
4815
+ "name": "campaign-group",
4816
+ "hasDynamicHelp": false,
4817
+ "multiple": true,
4818
+ "type": "option"
4819
+ },
4820
+ "search": {
4821
+ "description": "Case-insensitive substring match on the name",
4822
+ "name": "search",
4744
4823
  "hasDynamicHelp": false,
4745
4824
  "multiple": false,
4746
4825
  "type": "option"
4747
4826
  },
4748
- "config-file": {
4749
- "description": "JSON file with the builder config, or - to read stdin",
4750
- "name": "config-file",
4827
+ "status": {
4828
+ "description": "Keep only rows in this state",
4829
+ "name": "status",
4751
4830
  "hasDynamicHelp": false,
4752
4831
  "multiple": false,
4832
+ "options": [
4833
+ "ENABLED",
4834
+ "PAUSED"
4835
+ ],
4753
4836
  "type": "option"
4754
4837
  }
4755
4838
  },
4756
4839
  "hasDynamicHelp": false,
4757
4840
  "hiddenAliases": [],
4758
- "id": "flows:config:validate",
4841
+ "id": "asa:campaigns:list",
4759
4842
  "pluginAlias": "adapty",
4760
4843
  "pluginName": "adapty",
4761
4844
  "pluginType": "core",
@@ -4765,23 +4848,25 @@
4765
4848
  "relativePath": [
4766
4849
  "dist",
4767
4850
  "commands",
4768
- "flows",
4769
- "config",
4770
- "validate.js"
4851
+ "asa",
4852
+ "campaigns",
4853
+ "list.js"
4771
4854
  ]
4772
4855
  },
4773
- "flows:media:upload": {
4856
+ "asa:campaigns:update": {
4774
4857
  "aliases": [],
4775
4858
  "args": {
4776
- "file": {
4777
- "description": "Path to the image file to upload",
4778
- "name": "file",
4859
+ "campaign_id": {
4860
+ "description": "Campaign ID (UUID)",
4861
+ "name": "campaign_id",
4779
4862
  "required": true
4780
4863
  }
4781
4864
  },
4782
- "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
4865
+ "description": "Change a campaign: budgets, countries, status, schedule or Invoicing Options (all five --invoice-* flags together; they replace the stored set)",
4783
4866
  "examples": [
4784
- "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
4867
+ "<%= config.bin %> asa campaigns update UUID --status PAUSED",
4868
+ "<%= config.bin %> asa campaigns update UUID --daily-budget 80",
4869
+ "<%= config.bin %> asa campaigns update UUID --invoice-advertiser \"Acme Inc\" --invoice-order-number PO-42 --invoice-contact-name \"Jane Doe\" --invoice-contact-email jane@acme.com --invoice-billing-email billing@acme.com"
4785
4870
  ],
4786
4871
  "flags": {
4787
4872
  "json": {
@@ -4791,10 +4876,116 @@
4791
4876
  "allowNo": false,
4792
4877
  "type": "boolean"
4793
4878
  },
4794
- "app": {
4795
- "description": "App ID (UUID)",
4796
- "name": "app",
4797
- "required": true,
4879
+ "currency": {
4880
+ "description": "Currency code for the amounts in this call",
4881
+ "name": "currency",
4882
+ "default": "USD",
4883
+ "hasDynamicHelp": false,
4884
+ "multiple": false,
4885
+ "type": "option"
4886
+ },
4887
+ "yes": {
4888
+ "char": "y",
4889
+ "description": "Apply without asking; required when the output is piped or --json is used",
4890
+ "name": "yes",
4891
+ "allowNo": false,
4892
+ "type": "boolean"
4893
+ },
4894
+ "idempotency-key": {
4895
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
4896
+ "name": "idempotency-key",
4897
+ "hasDynamicHelp": false,
4898
+ "multiple": false,
4899
+ "type": "option"
4900
+ },
4901
+ "invoice-advertiser": {
4902
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
4903
+ "name": "invoice-advertiser",
4904
+ "hasDynamicHelp": false,
4905
+ "multiple": false,
4906
+ "type": "option"
4907
+ },
4908
+ "invoice-billing-email": {
4909
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
4910
+ "name": "invoice-billing-email",
4911
+ "hasDynamicHelp": false,
4912
+ "multiple": false,
4913
+ "type": "option"
4914
+ },
4915
+ "invoice-contact-email": {
4916
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
4917
+ "name": "invoice-contact-email",
4918
+ "hasDynamicHelp": false,
4919
+ "multiple": false,
4920
+ "type": "option"
4921
+ },
4922
+ "invoice-contact-name": {
4923
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
4924
+ "name": "invoice-contact-name",
4925
+ "hasDynamicHelp": false,
4926
+ "multiple": false,
4927
+ "type": "option"
4928
+ },
4929
+ "invoice-order-number": {
4930
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
4931
+ "name": "invoice-order-number",
4932
+ "hasDynamicHelp": false,
4933
+ "multiple": false,
4934
+ "type": "option"
4935
+ },
4936
+ "bidding-strategy": {
4937
+ "description": "Bidding strategy",
4938
+ "name": "bidding-strategy",
4939
+ "hasDynamicHelp": false,
4940
+ "multiple": false,
4941
+ "options": [
4942
+ "MANUAL_CPT",
4943
+ "MAX_CONVERSIONS"
4944
+ ],
4945
+ "type": "option"
4946
+ },
4947
+ "budget": {
4948
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
4949
+ "name": "budget",
4950
+ "hasDynamicHelp": false,
4951
+ "multiple": false,
4952
+ "type": "option"
4953
+ },
4954
+ "country": {
4955
+ "description": "Replace the country list, repeatable",
4956
+ "name": "country",
4957
+ "hasDynamicHelp": false,
4958
+ "multiple": true,
4959
+ "type": "option"
4960
+ },
4961
+ "daily-budget": {
4962
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
4963
+ "name": "daily-budget",
4964
+ "hasDynamicHelp": false,
4965
+ "multiple": false,
4966
+ "type": "option"
4967
+ },
4968
+ "name": {
4969
+ "description": "Campaign name",
4970
+ "name": "name",
4971
+ "hasDynamicHelp": false,
4972
+ "multiple": false,
4973
+ "type": "option"
4974
+ },
4975
+ "status": {
4976
+ "description": "Campaign status",
4977
+ "name": "status",
4978
+ "hasDynamicHelp": false,
4979
+ "multiple": false,
4980
+ "options": [
4981
+ "ENABLED",
4982
+ "PAUSED"
4983
+ ],
4984
+ "type": "option"
4985
+ },
4986
+ "target-cpa": {
4987
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
4988
+ "name": "target-cpa",
4798
4989
  "hasDynamicHelp": false,
4799
4990
  "multiple": false,
4800
4991
  "type": "option"
@@ -4802,7 +4993,7 @@
4802
4993
  },
4803
4994
  "hasDynamicHelp": false,
4804
4995
  "hiddenAliases": [],
4805
- "id": "flows:media:upload",
4996
+ "id": "asa:campaigns:update",
4806
4997
  "pluginAlias": "adapty",
4807
4998
  "pluginName": "adapty",
4808
4999
  "pluginType": "core",
@@ -4812,11 +5003,11 @@
4812
5003
  "relativePath": [
4813
5004
  "dist",
4814
5005
  "commands",
4815
- "flows",
4816
- "media",
4817
- "upload.js"
5006
+ "asa",
5007
+ "campaigns",
5008
+ "update.js"
4818
5009
  ]
4819
5010
  }
4820
5011
  },
4821
- "version": "0.8.1"
5012
+ "version": "0.8.3-beta.0"
4822
5013
  }