adapty 0.8.3-beta.0 → 0.8.3-beta.1

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 (3) hide show
  1. package/dist/commands/flows/publish.js +14 -1
  2. package/oclif.manifest.json +876 -876
  3. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -2529,13 +2529,15 @@
2529
2529
  "update.js"
2530
2530
  ]
2531
2531
  },
2532
- "asa:automations:create": {
2532
+ "asa:campaigns:bulk-create": {
2533
2533
  "aliases": [],
2534
2534
  "args": {},
2535
- "description": "Create an automation rule from a JSON rule file",
2535
+ "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
2536
2536
  "examples": [
2537
- "<%= config.bin %> asa automations create --file rule.json",
2538
- "<%= config.bin %> asa automations create --file rule.json --run-now"
2537
+ "<%= config.bin %> asa campaigns bulk-create --file structure.json",
2538
+ "cat structure.json | <%= config.bin %> asa campaigns bulk-create --file -",
2539
+ "<%= config.bin %> asa campaigns bulk-create --from-file Campaign_And_Adgroup_Template.xlsx --org-id 1234567",
2540
+ "<%= config.bin %> asa campaigns bulk-create --from-file keywords_template.csv --org-id 1234567 --preview"
2539
2541
  ],
2540
2542
  "flags": {
2541
2543
  "json": {
@@ -2560,62 +2562,58 @@
2560
2562
  "type": "option"
2561
2563
  },
2562
2564
  "file": {
2563
- "description": "JSON file with the rule body, or - to read stdin",
2565
+ "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
2564
2566
  "name": "file",
2565
- "required": true,
2566
2567
  "hasDynamicHelp": false,
2567
2568
  "multiple": false,
2568
2569
  "type": "option"
2569
2570
  },
2570
- "run-now": {
2571
- "description": "Queue the first run right after the rule is stored",
2572
- "name": "run-now",
2571
+ "from-file": {
2572
+ "description": "Apple Ads bulk template (Campaign_And_Adgroup_Template.xlsx or keywords .csv) to convert and submit",
2573
+ "name": "from-file",
2574
+ "hasDynamicHelp": false,
2575
+ "multiple": false,
2576
+ "type": "option"
2577
+ },
2578
+ "org-id": {
2579
+ "description": "Apple org id (campaign_group_id) the converted template will target; required with --from-file",
2580
+ "name": "org-id",
2581
+ "hasDynamicHelp": false,
2582
+ "multiple": false,
2583
+ "type": "option"
2584
+ },
2585
+ "poll-interval": {
2586
+ "description": "Seconds between progress polls",
2587
+ "name": "poll-interval",
2588
+ "default": 5,
2589
+ "hasDynamicHelp": false,
2590
+ "multiple": false,
2591
+ "type": "option"
2592
+ },
2593
+ "preview": {
2594
+ "description": "With --from-file: print the converted request and stop, nothing is created",
2595
+ "name": "preview",
2573
2596
  "allowNo": false,
2574
2597
  "type": "boolean"
2575
- }
2576
- },
2577
- "hasDynamicHelp": false,
2578
- "hiddenAliases": [],
2579
- "id": "asa:automations:create",
2580
- "pluginAlias": "adapty",
2581
- "pluginName": "adapty",
2582
- "pluginType": "core",
2583
- "strict": true,
2584
- "enableJsonFlag": true,
2585
- "isESM": true,
2586
- "relativePath": [
2587
- "dist",
2588
- "commands",
2589
- "asa",
2590
- "automations",
2591
- "create.js"
2592
- ]
2593
- },
2594
- "asa:automations:get": {
2595
- "aliases": [],
2596
- "args": {
2597
- "automation_id": {
2598
- "description": "Automation rule ID (UUID)",
2599
- "name": "automation_id",
2600
- "required": true
2601
- }
2602
- },
2603
- "description": "Show one automation rule with its conditions and actions",
2604
- "examples": [
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,
2598
+ },
2599
+ "timeout": {
2600
+ "description": "Max seconds to wait for the operation to finish",
2601
+ "name": "timeout",
2602
+ "default": 900,
2603
+ "hasDynamicHelp": false,
2604
+ "multiple": false,
2605
+ "type": "option"
2606
+ },
2607
+ "wait": {
2608
+ "description": "Poll the operation until it finishes; --no-wait returns the operation id immediately",
2609
+ "name": "wait",
2610
+ "allowNo": true,
2613
2611
  "type": "boolean"
2614
2612
  }
2615
2613
  },
2616
2614
  "hasDynamicHelp": false,
2617
2615
  "hiddenAliases": [],
2618
- "id": "asa:automations:get",
2616
+ "id": "asa:campaigns:bulk-create",
2619
2617
  "pluginAlias": "adapty",
2620
2618
  "pluginName": "adapty",
2621
2619
  "pluginType": "core",
@@ -2626,16 +2624,18 @@
2626
2624
  "dist",
2627
2625
  "commands",
2628
2626
  "asa",
2629
- "automations",
2630
- "get.js"
2627
+ "campaigns",
2628
+ "bulk-create.js"
2631
2629
  ]
2632
2630
  },
2633
- "asa:automations:list": {
2631
+ "asa:campaigns:bulk-list": {
2634
2632
  "aliases": [],
2635
2633
  "args": {},
2636
- "description": "List automation rules; status 1 is active, 0 is stopped",
2634
+ "description": "This company's bulk operations, newest first; inspect one with bulk-status",
2637
2635
  "examples": [
2638
- "<%= config.bin %> asa automations list"
2636
+ "<%= config.bin %> asa campaigns bulk-list",
2637
+ "<%= config.bin %> asa campaigns bulk-list --status partial --status failed",
2638
+ "<%= config.bin %> asa campaigns bulk-list --created-from 2026-08-01 --created-to 2026-08-20"
2639
2639
  ],
2640
2640
  "flags": {
2641
2641
  "json": {
@@ -2660,71 +2660,46 @@
2660
2660
  "hasDynamicHelp": false,
2661
2661
  "multiple": false,
2662
2662
  "type": "option"
2663
- }
2664
- },
2665
- "hasDynamicHelp": false,
2666
- "hiddenAliases": [],
2667
- "id": "asa:automations:list",
2668
- "pluginAlias": "adapty",
2669
- "pluginName": "adapty",
2670
- "pluginType": "core",
2671
- "strict": true,
2672
- "enableJsonFlag": true,
2673
- "isESM": true,
2674
- "relativePath": [
2675
- "dist",
2676
- "commands",
2677
- "asa",
2678
- "automations",
2679
- "list.js"
2680
- ]
2681
- },
2682
- "asa:automations:run": {
2683
- "aliases": [],
2684
- "args": {
2685
- "automation_id": {
2686
- "description": "Automation rule ID (UUID)",
2687
- "name": "automation_id",
2688
- "required": true
2689
- }
2690
- },
2691
- "description": "Run an automation rule now; the run is queued, not awaited",
2692
- "examples": [
2693
- "<%= config.bin %> asa automations run UUID",
2694
- "<%= config.bin %> asa automations run UUID --dry-run"
2695
- ],
2696
- "flags": {
2697
- "json": {
2698
- "description": "Format output as json.",
2699
- "helpGroup": "GLOBAL",
2700
- "name": "json",
2701
- "allowNo": false,
2702
- "type": "boolean"
2703
2663
  },
2704
- "yes": {
2705
- "char": "y",
2706
- "description": "Apply without asking; required when the output is piped or --json is used",
2707
- "name": "yes",
2708
- "allowNo": false,
2709
- "type": "boolean"
2664
+ "app": {
2665
+ "description": "Keep only operations of this app (UUID)",
2666
+ "name": "app",
2667
+ "hasDynamicHelp": false,
2668
+ "multiple": false,
2669
+ "type": "option"
2710
2670
  },
2711
- "idempotency-key": {
2712
- "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
2713
- "name": "idempotency-key",
2671
+ "created-from": {
2672
+ "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
2673
+ "name": "created-from",
2714
2674
  "hasDynamicHelp": false,
2715
2675
  "multiple": false,
2716
2676
  "type": "option"
2717
2677
  },
2718
- "dry-run": {
2719
- "description": "Evaluate and log the rule without touching Apple",
2720
- "name": "dry-run",
2721
- "allowNo": false,
2722
- "type": "boolean"
2678
+ "created-to": {
2679
+ "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
2680
+ "name": "created-to",
2681
+ "hasDynamicHelp": false,
2682
+ "multiple": false,
2683
+ "type": "option"
2684
+ },
2685
+ "status": {
2686
+ "description": "Keep only operations in this state; repeatable",
2687
+ "name": "status",
2688
+ "hasDynamicHelp": false,
2689
+ "multiple": true,
2690
+ "options": [
2691
+ "failed",
2692
+ "partial",
2693
+ "pending",
2694
+ "running",
2695
+ "success"
2696
+ ],
2697
+ "type": "option"
2723
2698
  }
2724
2699
  },
2725
2700
  "hasDynamicHelp": false,
2726
2701
  "hiddenAliases": [],
2727
- "id": "asa:automations:run",
2702
+ "id": "asa:campaigns:bulk-list",
2728
2703
  "pluginAlias": "adapty",
2729
2704
  "pluginName": "adapty",
2730
2705
  "pluginType": "core",
@@ -2735,22 +2710,22 @@
2735
2710
  "dist",
2736
2711
  "commands",
2737
2712
  "asa",
2738
- "automations",
2739
- "run.js"
2713
+ "campaigns",
2714
+ "bulk-list.js"
2740
2715
  ]
2741
2716
  },
2742
- "asa:automations:runs": {
2717
+ "asa:campaigns:bulk-status": {
2743
2718
  "aliases": [],
2744
2719
  "args": {
2745
- "automation_id": {
2746
- "description": "Automation rule ID (UUID)",
2747
- "name": "automation_id",
2720
+ "operation-id": {
2721
+ "description": "Bulk operation ID returned by bulk-create",
2722
+ "name": "operation-id",
2748
2723
  "required": true
2749
2724
  }
2750
2725
  },
2751
- "description": "List past runs of an automation rule, including dry runs",
2726
+ "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
2752
2727
  "examples": [
2753
- "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
2728
+ "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
2754
2729
  ],
2755
2730
  "flags": {
2756
2731
  "json": {
@@ -2779,7 +2754,7 @@
2779
2754
  },
2780
2755
  "hasDynamicHelp": false,
2781
2756
  "hiddenAliases": [],
2782
- "id": "asa:automations:runs",
2757
+ "id": "asa:campaigns:bulk-status",
2783
2758
  "pluginAlias": "adapty",
2784
2759
  "pluginName": "adapty",
2785
2760
  "pluginType": "core",
@@ -2790,23 +2765,18 @@
2790
2765
  "dist",
2791
2766
  "commands",
2792
2767
  "asa",
2793
- "automations",
2794
- "runs.js"
2768
+ "campaigns",
2769
+ "bulk-status.js"
2795
2770
  ]
2796
2771
  },
2797
- "asa:automations:update": {
2772
+ "asa:campaigns:create": {
2798
2773
  "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",
2774
+ "args": {},
2775
+ "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",
2807
2776
  "examples": [
2808
- "<%= config.bin %> asa automations update UUID --stop",
2809
- "<%= config.bin %> asa automations update UUID --file rule.json"
2777
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50",
2778
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Max Conv\" --adam-id 123456 --country US --daily-budget 50 --bidding-strategy MAX_CONVERSIONS",
2779
+ "<%= 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"
2810
2780
  ],
2811
2781
  "flags": {
2812
2782
  "json": {
@@ -2816,6 +2786,14 @@
2816
2786
  "allowNo": false,
2817
2787
  "type": "boolean"
2818
2788
  },
2789
+ "currency": {
2790
+ "description": "Currency code for the amounts in this call",
2791
+ "name": "currency",
2792
+ "default": "USD",
2793
+ "hasDynamicHelp": false,
2794
+ "multiple": false,
2795
+ "type": "option"
2796
+ },
2819
2797
  "yes": {
2820
2798
  "char": "y",
2821
2799
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2830,42 +2808,155 @@
2830
2808
  "multiple": false,
2831
2809
  "type": "option"
2832
2810
  },
2833
- "file": {
2834
- "description": "JSON file with the parts to change, or - to read stdin",
2835
- "name": "file",
2811
+ "invoice-advertiser": {
2812
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
2813
+ "name": "invoice-advertiser",
2836
2814
  "hasDynamicHelp": false,
2837
2815
  "multiple": false,
2838
2816
  "type": "option"
2839
2817
  },
2840
- "name": {
2841
- "description": "Rule name",
2842
- "name": "name",
2818
+ "invoice-billing-email": {
2819
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
2820
+ "name": "invoice-billing-email",
2843
2821
  "hasDynamicHelp": false,
2844
2822
  "multiple": false,
2845
2823
  "type": "option"
2846
2824
  },
2847
- "start": {
2848
- "description": "Activate the rule",
2849
- "exclusive": [
2850
- "stop"
2851
- ],
2852
- "name": "start",
2853
- "allowNo": false,
2854
- "type": "boolean"
2825
+ "invoice-contact-email": {
2826
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
2827
+ "name": "invoice-contact-email",
2828
+ "hasDynamicHelp": false,
2829
+ "multiple": false,
2830
+ "type": "option"
2855
2831
  },
2856
- "stop": {
2857
- "description": "Stop the rule and clear its next run",
2858
- "exclusive": [
2859
- "start"
2832
+ "invoice-contact-name": {
2833
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
2834
+ "name": "invoice-contact-name",
2835
+ "hasDynamicHelp": false,
2836
+ "multiple": false,
2837
+ "type": "option"
2838
+ },
2839
+ "invoice-order-number": {
2840
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
2841
+ "name": "invoice-order-number",
2842
+ "hasDynamicHelp": false,
2843
+ "multiple": false,
2844
+ "type": "option"
2845
+ },
2846
+ "ad-channel-type": {
2847
+ "description": "Ad channel type",
2848
+ "name": "ad-channel-type",
2849
+ "default": "SEARCH",
2850
+ "hasDynamicHelp": false,
2851
+ "multiple": false,
2852
+ "options": [
2853
+ "DISPLAY",
2854
+ "SEARCH"
2860
2855
  ],
2861
- "name": "stop",
2862
- "allowNo": false,
2863
- "type": "boolean"
2856
+ "type": "option"
2857
+ },
2858
+ "adam-id": {
2859
+ "description": "App Store app ID (adam_id)",
2860
+ "name": "adam-id",
2861
+ "required": true,
2862
+ "hasDynamicHelp": false,
2863
+ "multiple": false,
2864
+ "type": "option"
2865
+ },
2866
+ "bidding-strategy": {
2867
+ "description": "Bidding strategy; Apple defaults to MANUAL_CPT when omitted",
2868
+ "name": "bidding-strategy",
2869
+ "hasDynamicHelp": false,
2870
+ "multiple": false,
2871
+ "options": [
2872
+ "MANUAL_CPT",
2873
+ "MAX_CONVERSIONS"
2874
+ ],
2875
+ "type": "option"
2876
+ },
2877
+ "billing-event": {
2878
+ "description": "Billing event",
2879
+ "name": "billing-event",
2880
+ "default": "TAPS",
2881
+ "hasDynamicHelp": false,
2882
+ "multiple": false,
2883
+ "options": [
2884
+ "IMPRESSIONS",
2885
+ "TAPS"
2886
+ ],
2887
+ "type": "option"
2888
+ },
2889
+ "budget": {
2890
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
2891
+ "name": "budget",
2892
+ "hasDynamicHelp": false,
2893
+ "multiple": false,
2894
+ "type": "option"
2895
+ },
2896
+ "country": {
2897
+ "description": "Country or region code, repeatable",
2898
+ "name": "country",
2899
+ "required": true,
2900
+ "hasDynamicHelp": false,
2901
+ "multiple": true,
2902
+ "type": "option"
2903
+ },
2904
+ "daily-budget": {
2905
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
2906
+ "name": "daily-budget",
2907
+ "required": true,
2908
+ "hasDynamicHelp": false,
2909
+ "multiple": false,
2910
+ "type": "option"
2911
+ },
2912
+ "name": {
2913
+ "description": "Campaign name",
2914
+ "name": "name",
2915
+ "required": true,
2916
+ "hasDynamicHelp": false,
2917
+ "multiple": false,
2918
+ "type": "option"
2919
+ },
2920
+ "org": {
2921
+ "description": "Campaign group ID (UUID) — see `adapty asa orgs list`",
2922
+ "name": "org",
2923
+ "required": true,
2924
+ "hasDynamicHelp": false,
2925
+ "multiple": false,
2926
+ "type": "option"
2927
+ },
2928
+ "status": {
2929
+ "description": "Initial status",
2930
+ "name": "status",
2931
+ "hasDynamicHelp": false,
2932
+ "multiple": false,
2933
+ "options": [
2934
+ "ENABLED",
2935
+ "PAUSED"
2936
+ ],
2937
+ "type": "option"
2938
+ },
2939
+ "supply-source": {
2940
+ "description": "Supply source, repeatable",
2941
+ "name": "supply-source",
2942
+ "default": [
2943
+ "APPSTORE_SEARCH_RESULTS"
2944
+ ],
2945
+ "hasDynamicHelp": false,
2946
+ "multiple": true,
2947
+ "type": "option"
2948
+ },
2949
+ "target-cpa": {
2950
+ "description": "Target CPA; must be lower than --daily-budget (amount, e.g. 50 or 12.50)",
2951
+ "name": "target-cpa",
2952
+ "hasDynamicHelp": false,
2953
+ "multiple": false,
2954
+ "type": "option"
2864
2955
  }
2865
2956
  },
2866
2957
  "hasDynamicHelp": false,
2867
2958
  "hiddenAliases": [],
2868
- "id": "asa:automations:update",
2959
+ "id": "asa:campaigns:create",
2869
2960
  "pluginAlias": "adapty",
2870
2961
  "pluginName": "adapty",
2871
2962
  "pluginType": "core",
@@ -2876,16 +2967,22 @@
2876
2967
  "dist",
2877
2968
  "commands",
2878
2969
  "asa",
2879
- "automations",
2880
- "update.js"
2970
+ "campaigns",
2971
+ "create.js"
2881
2972
  ]
2882
2973
  },
2883
- "asa:competitors:summary": {
2974
+ "asa:campaigns:get": {
2884
2975
  "aliases": [],
2885
- "args": {},
2886
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2976
+ "args": {
2977
+ "campaign_id": {
2978
+ "description": "Campaign ID (UUID)",
2979
+ "name": "campaign_id",
2980
+ "required": true
2981
+ }
2982
+ },
2983
+ "description": "Show one campaign; read numbers with asa metrics",
2887
2984
  "examples": [
2888
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2985
+ "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
2889
2986
  ],
2890
2987
  "flags": {
2891
2988
  "json": {
@@ -2894,19 +2991,11 @@
2894
2991
  "name": "json",
2895
2992
  "allowNo": false,
2896
2993
  "type": "boolean"
2897
- },
2898
- "app-ids": {
2899
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2900
- "name": "app-ids",
2901
- "required": true,
2902
- "hasDynamicHelp": false,
2903
- "multiple": false,
2904
- "type": "option"
2905
2994
  }
2906
2995
  },
2907
2996
  "hasDynamicHelp": false,
2908
2997
  "hiddenAliases": [],
2909
- "id": "asa:competitors:summary",
2998
+ "id": "asa:campaigns:get",
2910
2999
  "pluginAlias": "adapty",
2911
3000
  "pluginName": "adapty",
2912
3001
  "pluginType": "core",
@@ -2917,17 +3006,17 @@
2917
3006
  "dist",
2918
3007
  "commands",
2919
3008
  "asa",
2920
- "competitors",
2921
- "summary.js"
3009
+ "campaigns",
3010
+ "get.js"
2922
3011
  ]
2923
3012
  },
2924
- "asa:creatives:list": {
3013
+ "asa:campaigns:list": {
2925
3014
  "aliases": [],
2926
3015
  "args": {},
2927
- "description": "List creatives; creative_id is what `asa ads create` needs",
3016
+ "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
2928
3017
  "examples": [
2929
- "<%= config.bin %> asa creatives list",
2930
- "<%= config.bin %> asa creatives list --app APP_UUID"
3018
+ "<%= config.bin %> asa campaigns list",
3019
+ "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
2931
3020
  ],
2932
3021
  "flags": {
2933
3022
  "json": {
@@ -2966,11 +3055,29 @@
2966
3055
  "hasDynamicHelp": false,
2967
3056
  "multiple": true,
2968
3057
  "type": "option"
3058
+ },
3059
+ "search": {
3060
+ "description": "Case-insensitive substring match on the name",
3061
+ "name": "search",
3062
+ "hasDynamicHelp": false,
3063
+ "multiple": false,
3064
+ "type": "option"
3065
+ },
3066
+ "status": {
3067
+ "description": "Keep only rows in this state",
3068
+ "name": "status",
3069
+ "hasDynamicHelp": false,
3070
+ "multiple": false,
3071
+ "options": [
3072
+ "ENABLED",
3073
+ "PAUSED"
3074
+ ],
3075
+ "type": "option"
2969
3076
  }
2970
3077
  },
2971
3078
  "hasDynamicHelp": false,
2972
3079
  "hiddenAliases": [],
2973
- "id": "asa:creatives:list",
3080
+ "id": "asa:campaigns:list",
2974
3081
  "pluginAlias": "adapty",
2975
3082
  "pluginName": "adapty",
2976
3083
  "pluginType": "core",
@@ -2981,17 +3088,24 @@
2981
3088
  "dist",
2982
3089
  "commands",
2983
3090
  "asa",
2984
- "creatives",
3091
+ "campaigns",
2985
3092
  "list.js"
2986
3093
  ]
2987
3094
  },
2988
- "asa:keywords:add": {
3095
+ "asa:campaigns:update": {
2989
3096
  "aliases": [],
2990
- "args": {},
2991
- "description": "Add targeting keywords to an ad group",
3097
+ "args": {
3098
+ "campaign_id": {
3099
+ "description": "Campaign ID (UUID)",
3100
+ "name": "campaign_id",
3101
+ "required": true
3102
+ }
3103
+ },
3104
+ "description": "Change a campaign: budgets, countries, status, schedule or Invoicing Options (all five --invoice-* flags together; they replace the stored set)",
2992
3105
  "examples": [
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"
3106
+ "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3107
+ "<%= config.bin %> asa campaigns update UUID --daily-budget 80",
3108
+ "<%= 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"
2995
3109
  ],
2996
3110
  "flags": {
2997
3111
  "json": {
@@ -3023,63 +3137,102 @@
3023
3137
  "multiple": false,
3024
3138
  "type": "option"
3025
3139
  },
3026
- "ad-group": {
3027
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
3028
- "name": "ad-group",
3029
- "required": true,
3140
+ "invoice-advertiser": {
3141
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
3142
+ "name": "invoice-advertiser",
3030
3143
  "hasDynamicHelp": false,
3031
3144
  "multiple": false,
3032
3145
  "type": "option"
3033
3146
  },
3034
- "bid": {
3035
- "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3036
- "name": "bid",
3147
+ "invoice-billing-email": {
3148
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
3149
+ "name": "invoice-billing-email",
3037
3150
  "hasDynamicHelp": false,
3038
3151
  "multiple": false,
3039
3152
  "type": "option"
3040
3153
  },
3041
- "from-file": {
3042
- "description": "File with one keyword per line, combined with any --text values",
3043
- "name": "from-file",
3154
+ "invoice-contact-email": {
3155
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
3156
+ "name": "invoice-contact-email",
3044
3157
  "hasDynamicHelp": false,
3045
3158
  "multiple": false,
3046
3159
  "type": "option"
3047
3160
  },
3048
- "match-type": {
3049
- "description": "Match type",
3050
- "name": "match-type",
3051
- "default": "BROAD",
3161
+ "invoice-contact-name": {
3162
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
3163
+ "name": "invoice-contact-name",
3052
3164
  "hasDynamicHelp": false,
3053
3165
  "multiple": false,
3054
- "options": [
3055
- "BROAD",
3056
- "EXACT"
3057
- ],
3058
3166
  "type": "option"
3059
3167
  },
3060
- "status": {
3061
- "description": "Keyword status",
3062
- "name": "status",
3063
- "default": "ACTIVE",
3168
+ "invoice-order-number": {
3169
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
3170
+ "name": "invoice-order-number",
3064
3171
  "hasDynamicHelp": false,
3065
3172
  "multiple": false,
3066
- "options": [
3067
- "ACTIVE",
3068
- "PAUSED"
3173
+ "type": "option"
3174
+ },
3175
+ "bidding-strategy": {
3176
+ "description": "Bidding strategy",
3177
+ "name": "bidding-strategy",
3178
+ "hasDynamicHelp": false,
3179
+ "multiple": false,
3180
+ "options": [
3181
+ "MANUAL_CPT",
3182
+ "MAX_CONVERSIONS"
3069
3183
  ],
3070
3184
  "type": "option"
3071
3185
  },
3072
- "text": {
3073
- "description": "Keyword text, repeatable",
3074
- "name": "text",
3186
+ "budget": {
3187
+ "description": "Lifetime budget (amount, e.g. 50 or 12.50)",
3188
+ "name": "budget",
3189
+ "hasDynamicHelp": false,
3190
+ "multiple": false,
3191
+ "type": "option"
3192
+ },
3193
+ "country": {
3194
+ "description": "Replace the country list, repeatable",
3195
+ "name": "country",
3075
3196
  "hasDynamicHelp": false,
3076
3197
  "multiple": true,
3077
3198
  "type": "option"
3199
+ },
3200
+ "daily-budget": {
3201
+ "description": "Daily budget (amount, e.g. 50 or 12.50)",
3202
+ "name": "daily-budget",
3203
+ "hasDynamicHelp": false,
3204
+ "multiple": false,
3205
+ "type": "option"
3206
+ },
3207
+ "name": {
3208
+ "description": "Campaign name",
3209
+ "name": "name",
3210
+ "hasDynamicHelp": false,
3211
+ "multiple": false,
3212
+ "type": "option"
3213
+ },
3214
+ "status": {
3215
+ "description": "Campaign status",
3216
+ "name": "status",
3217
+ "hasDynamicHelp": false,
3218
+ "multiple": false,
3219
+ "options": [
3220
+ "ENABLED",
3221
+ "PAUSED"
3222
+ ],
3223
+ "type": "option"
3224
+ },
3225
+ "target-cpa": {
3226
+ "description": "Target CPA (amount, e.g. 50 or 12.50)",
3227
+ "name": "target-cpa",
3228
+ "hasDynamicHelp": false,
3229
+ "multiple": false,
3230
+ "type": "option"
3078
3231
  }
3079
3232
  },
3080
3233
  "hasDynamicHelp": false,
3081
3234
  "hiddenAliases": [],
3082
- "id": "asa:keywords:add",
3235
+ "id": "asa:campaigns:update",
3083
3236
  "pluginAlias": "adapty",
3084
3237
  "pluginName": "adapty",
3085
3238
  "pluginType": "core",
@@ -3090,17 +3243,58 @@
3090
3243
  "dist",
3091
3244
  "commands",
3092
3245
  "asa",
3093
- "keywords",
3094
- "add.js"
3246
+ "campaigns",
3247
+ "update.js"
3095
3248
  ]
3096
3249
  },
3097
- "asa:keywords:list": {
3250
+ "asa:competitors:summary": {
3098
3251
  "aliases": [],
3099
3252
  "args": {},
3100
- "description": "List targeting keywords; read numbers with asa metrics",
3253
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
3101
3254
  "examples": [
3102
- "<%= config.bin %> asa keywords list",
3103
- "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3255
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
3256
+ ],
3257
+ "flags": {
3258
+ "json": {
3259
+ "description": "Format output as json.",
3260
+ "helpGroup": "GLOBAL",
3261
+ "name": "json",
3262
+ "allowNo": false,
3263
+ "type": "boolean"
3264
+ },
3265
+ "app-ids": {
3266
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
3267
+ "name": "app-ids",
3268
+ "required": true,
3269
+ "hasDynamicHelp": false,
3270
+ "multiple": false,
3271
+ "type": "option"
3272
+ }
3273
+ },
3274
+ "hasDynamicHelp": false,
3275
+ "hiddenAliases": [],
3276
+ "id": "asa:competitors:summary",
3277
+ "pluginAlias": "adapty",
3278
+ "pluginName": "adapty",
3279
+ "pluginType": "core",
3280
+ "strict": true,
3281
+ "enableJsonFlag": true,
3282
+ "isESM": true,
3283
+ "relativePath": [
3284
+ "dist",
3285
+ "commands",
3286
+ "asa",
3287
+ "competitors",
3288
+ "summary.js"
3289
+ ]
3290
+ },
3291
+ "asa:creatives:list": {
3292
+ "aliases": [],
3293
+ "args": {},
3294
+ "description": "List creatives; creative_id is what `asa ads create` needs",
3295
+ "examples": [
3296
+ "<%= config.bin %> asa creatives list",
3297
+ "<%= config.bin %> asa creatives list --app APP_UUID"
3104
3298
  ],
3105
3299
  "flags": {
3106
3300
  "json": {
@@ -3139,43 +3333,11 @@
3139
3333
  "hasDynamicHelp": false,
3140
3334
  "multiple": true,
3141
3335
  "type": "option"
3142
- },
3143
- "search": {
3144
- "description": "Case-insensitive substring match on the name",
3145
- "name": "search",
3146
- "hasDynamicHelp": false,
3147
- "multiple": false,
3148
- "type": "option"
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
- },
3164
- "status": {
3165
- "description": "Keep only rows in this state",
3166
- "name": "status",
3167
- "hasDynamicHelp": false,
3168
- "multiple": false,
3169
- "options": [
3170
- "ACTIVE",
3171
- "PAUSED"
3172
- ],
3173
- "type": "option"
3174
3336
  }
3175
3337
  },
3176
3338
  "hasDynamicHelp": false,
3177
3339
  "hiddenAliases": [],
3178
- "id": "asa:keywords:list",
3340
+ "id": "asa:creatives:list",
3179
3341
  "pluginAlias": "adapty",
3180
3342
  "pluginName": "adapty",
3181
3343
  "pluginType": "core",
@@ -3186,23 +3348,17 @@
3186
3348
  "dist",
3187
3349
  "commands",
3188
3350
  "asa",
3189
- "keywords",
3351
+ "creatives",
3190
3352
  "list.js"
3191
3353
  ]
3192
3354
  },
3193
- "asa:keywords:update": {
3355
+ "asa:keywords:add": {
3194
3356
  "aliases": [],
3195
- "args": {
3196
- "keyword_id": {
3197
- "description": "Keyword ID (UUID), repeatable as extra arguments",
3198
- "name": "keyword_id",
3199
- "required": true
3200
- }
3201
- },
3202
- "description": "Change bid, status, text or match type of keywords",
3357
+ "args": {},
3358
+ "description": "Add targeting keywords to an ad group",
3203
3359
  "examples": [
3204
- "<%= config.bin %> asa keywords update UUID --bid 2.00",
3205
- "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3360
+ "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
3361
+ "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
3206
3362
  ],
3207
3363
  "flags": {
3208
3364
  "json": {
@@ -3234,16 +3390,32 @@
3234
3390
  "multiple": false,
3235
3391
  "type": "option"
3236
3392
  },
3393
+ "ad-group": {
3394
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
3395
+ "name": "ad-group",
3396
+ "required": true,
3397
+ "hasDynamicHelp": false,
3398
+ "multiple": false,
3399
+ "type": "option"
3400
+ },
3237
3401
  "bid": {
3238
- "description": "Bid (amount, e.g. 50 or 12.50)",
3402
+ "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
3239
3403
  "name": "bid",
3240
3404
  "hasDynamicHelp": false,
3241
3405
  "multiple": false,
3242
3406
  "type": "option"
3243
3407
  },
3408
+ "from-file": {
3409
+ "description": "File with one keyword per line, combined with any --text values",
3410
+ "name": "from-file",
3411
+ "hasDynamicHelp": false,
3412
+ "multiple": false,
3413
+ "type": "option"
3414
+ },
3244
3415
  "match-type": {
3245
3416
  "description": "Match type",
3246
3417
  "name": "match-type",
3418
+ "default": "BROAD",
3247
3419
  "hasDynamicHelp": false,
3248
3420
  "multiple": false,
3249
3421
  "options": [
@@ -3255,6 +3427,7 @@
3255
3427
  "status": {
3256
3428
  "description": "Keyword status",
3257
3429
  "name": "status",
3430
+ "default": "ACTIVE",
3258
3431
  "hasDynamicHelp": false,
3259
3432
  "multiple": false,
3260
3433
  "options": [
@@ -3264,20 +3437,20 @@
3264
3437
  "type": "option"
3265
3438
  },
3266
3439
  "text": {
3267
- "description": "Keyword text (only meaningful for a single keyword)",
3440
+ "description": "Keyword text, repeatable",
3268
3441
  "name": "text",
3269
3442
  "hasDynamicHelp": false,
3270
- "multiple": false,
3443
+ "multiple": true,
3271
3444
  "type": "option"
3272
3445
  }
3273
3446
  },
3274
3447
  "hasDynamicHelp": false,
3275
3448
  "hiddenAliases": [],
3276
- "id": "asa:keywords:update",
3449
+ "id": "asa:keywords:add",
3277
3450
  "pluginAlias": "adapty",
3278
3451
  "pluginName": "adapty",
3279
3452
  "pluginType": "core",
3280
- "strict": false,
3453
+ "strict": true,
3281
3454
  "enableJsonFlag": true,
3282
3455
  "isESM": true,
3283
3456
  "relativePath": [
@@ -3285,19 +3458,16 @@
3285
3458
  "commands",
3286
3459
  "asa",
3287
3460
  "keywords",
3288
- "update.js"
3461
+ "add.js"
3289
3462
  ]
3290
3463
  },
3291
- "asa:metrics": {
3464
+ "asa:keywords:list": {
3292
3465
  "aliases": [],
3293
3466
  "args": {},
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.",
3467
+ "description": "List targeting keywords; read numbers with asa metrics",
3295
3468
  "examples": [
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"
3469
+ "<%= config.bin %> asa keywords list",
3470
+ "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
3301
3471
  ],
3302
3472
  "flags": {
3303
3473
  "json": {
@@ -3323,95 +3493,56 @@
3323
3493
  "multiple": false,
3324
3494
  "type": "option"
3325
3495
  },
3326
- "by-days": {
3327
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3328
- "name": "by-days",
3496
+ "app": {
3497
+ "description": "Keep only rows in this app; repeatable",
3498
+ "name": "app",
3329
3499
  "hasDynamicHelp": false,
3330
3500
  "multiple": true,
3331
3501
  "type": "option"
3332
3502
  },
3333
- "date-from": {
3334
- "description": "Start of the period (YYYY-MM-DD)",
3335
- "name": "date-from",
3336
- "required": true,
3503
+ "campaign-group": {
3504
+ "description": "Keep only rows in this campaign group; repeatable",
3505
+ "name": "campaign-group",
3337
3506
  "hasDynamicHelp": false,
3338
- "multiple": false,
3507
+ "multiple": true,
3339
3508
  "type": "option"
3340
3509
  },
3341
- "date-to": {
3342
- "description": "End of the period (YYYY-MM-DD)",
3343
- "name": "date-to",
3344
- "required": true,
3510
+ "search": {
3511
+ "description": "Case-insensitive substring match on the name",
3512
+ "name": "search",
3345
3513
  "hasDynamicHelp": false,
3346
3514
  "multiple": false,
3347
3515
  "type": "option"
3348
3516
  },
3349
- "entity": {
3350
- "description": "What to report on",
3351
- "name": "entity",
3352
- "required": true,
3517
+ "campaign": {
3518
+ "description": "Keep only rows in this campaign; repeatable",
3519
+ "name": "campaign",
3353
3520
  "hasDynamicHelp": false,
3354
- "multiple": false,
3355
- "options": [
3356
- "ad",
3357
- "ad-group",
3358
- "campaign",
3359
- "keyword"
3360
- ],
3521
+ "multiple": true,
3361
3522
  "type": "option"
3362
3523
  },
3363
- "group-by": {
3364
- "description": "Break the rows down by a dimension, repeatable",
3365
- "name": "group-by",
3524
+ "ad-group": {
3525
+ "description": "Keep only rows in this ad group; repeatable",
3526
+ "name": "ad-group",
3366
3527
  "hasDynamicHelp": false,
3367
3528
  "multiple": true,
3368
- "options": [
3369
- "country",
3370
- "day",
3371
- "month",
3372
- "quarter",
3373
- "week",
3374
- "year"
3375
- ],
3376
3529
  "type": "option"
3377
3530
  },
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",
3531
+ "status": {
3532
+ "description": "Keep only rows in this state",
3533
+ "name": "status",
3389
3534
  "hasDynamicHelp": false,
3390
3535
  "multiple": false,
3391
3536
  "options": [
3392
- "asc",
3393
- "desc"
3537
+ "ACTIVE",
3538
+ "PAUSED"
3394
3539
  ],
3395
3540
  "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
3541
  }
3411
3542
  },
3412
3543
  "hasDynamicHelp": false,
3413
3544
  "hiddenAliases": [],
3414
- "id": "asa:metrics",
3545
+ "id": "asa:keywords:list",
3415
3546
  "pluginAlias": "adapty",
3416
3547
  "pluginName": "adapty",
3417
3548
  "pluginType": "core",
@@ -3422,17 +3553,23 @@
3422
3553
  "dist",
3423
3554
  "commands",
3424
3555
  "asa",
3425
- "metrics",
3426
- "index.js"
3556
+ "keywords",
3557
+ "list.js"
3427
3558
  ]
3428
3559
  },
3429
- "asa:metrics:overview": {
3560
+ "asa:keywords:update": {
3430
3561
  "aliases": [],
3431
- "args": {},
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.",
3562
+ "args": {
3563
+ "keyword_id": {
3564
+ "description": "Keyword ID (UUID), repeatable as extra arguments",
3565
+ "name": "keyword_id",
3566
+ "required": true
3567
+ }
3568
+ },
3569
+ "description": "Change bid, status, text or match type of keywords",
3433
3570
  "examples": [
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"
3571
+ "<%= config.bin %> asa keywords update UUID --bid 2.00",
3572
+ "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
3436
3573
  ],
3437
3574
  "flags": {
3438
3575
  "json": {
@@ -3442,81 +3579,80 @@
3442
3579
  "allowNo": false,
3443
3580
  "type": "boolean"
3444
3581
  },
3445
- "by-days": {
3446
- "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3447
- "name": "by-days",
3582
+ "currency": {
3583
+ "description": "Currency code for the amounts in this call",
3584
+ "name": "currency",
3585
+ "default": "USD",
3448
3586
  "hasDynamicHelp": false,
3449
- "multiple": true,
3587
+ "multiple": false,
3450
3588
  "type": "option"
3451
3589
  },
3452
- "date-from": {
3453
- "description": "Start of the period (YYYY-MM-DD)",
3454
- "name": "date-from",
3455
- "required": true,
3590
+ "yes": {
3591
+ "char": "y",
3592
+ "description": "Apply without asking; required when the output is piped or --json is used",
3593
+ "name": "yes",
3594
+ "allowNo": false,
3595
+ "type": "boolean"
3596
+ },
3597
+ "idempotency-key": {
3598
+ "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
3599
+ "name": "idempotency-key",
3456
3600
  "hasDynamicHelp": false,
3457
3601
  "multiple": false,
3458
3602
  "type": "option"
3459
3603
  },
3460
- "date-to": {
3461
- "description": "End of the period (YYYY-MM-DD)",
3462
- "name": "date-to",
3463
- "required": true,
3604
+ "bid": {
3605
+ "description": "Bid (amount, e.g. 50 or 12.50)",
3606
+ "name": "bid",
3464
3607
  "hasDynamicHelp": false,
3465
3608
  "multiple": false,
3466
3609
  "type": "option"
3467
3610
  },
3468
- "entity": {
3469
- "description": "What to report on",
3470
- "name": "entity",
3471
- "required": true,
3611
+ "match-type": {
3612
+ "description": "Match type",
3613
+ "name": "match-type",
3472
3614
  "hasDynamicHelp": false,
3473
3615
  "multiple": false,
3474
3616
  "options": [
3475
- "ad",
3476
- "ad-group",
3477
- "campaign",
3478
- "keyword"
3617
+ "BROAD",
3618
+ "EXACT"
3479
3619
  ],
3480
3620
  "type": "option"
3481
3621
  },
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",
3622
+ "status": {
3623
+ "description": "Keyword status",
3624
+ "name": "status",
3485
3625
  "hasDynamicHelp": false,
3486
- "multiple": true,
3626
+ "multiple": false,
3627
+ "options": [
3628
+ "ACTIVE",
3629
+ "PAUSED"
3630
+ ],
3487
3631
  "type": "option"
3488
3632
  },
3489
- "period-unit": {
3490
- "description": "Bucket size",
3491
- "name": "period-unit",
3492
- "default": "day",
3633
+ "text": {
3634
+ "description": "Keyword text (only meaningful for a single keyword)",
3635
+ "name": "text",
3493
3636
  "hasDynamicHelp": false,
3494
3637
  "multiple": false,
3495
- "options": [
3496
- "day",
3497
- "month",
3498
- "quarter",
3499
- "week",
3500
- "year"
3501
- ],
3502
3638
  "type": "option"
3503
3639
  }
3504
3640
  },
3505
3641
  "hasDynamicHelp": false,
3506
3642
  "hiddenAliases": [],
3507
- "id": "asa:metrics:overview",
3643
+ "id": "asa:keywords:update",
3508
3644
  "pluginAlias": "adapty",
3509
3645
  "pluginName": "adapty",
3510
3646
  "pluginType": "core",
3511
- "strict": true,
3647
+ "strict": false,
3512
3648
  "enableJsonFlag": true,
3513
3649
  "isESM": true,
3514
3650
  "relativePath": [
3515
3651
  "dist",
3516
3652
  "commands",
3517
3653
  "asa",
3518
- "metrics",
3519
- "overview.js"
3654
+ "keywords",
3655
+ "update.js"
3520
3656
  ]
3521
3657
  },
3522
3658
  "asa:negative-keywords:add": {
@@ -3720,12 +3856,16 @@
3720
3856
  "list.js"
3721
3857
  ]
3722
3858
  },
3723
- "asa:orgs:list": {
3859
+ "asa:metrics": {
3724
3860
  "aliases": [],
3725
3861
  "args": {},
3726
- "description": "List the Apple Search Ads organizations this company can spend from",
3862
+ "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.",
3727
3863
  "examples": [
3728
- "<%= config.bin %> asa orgs list"
3864
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3865
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
3866
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --group-by country --page-size 1000",
3867
+ "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
3868
+ "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90"
3729
3869
  ],
3730
3870
  "flags": {
3731
3871
  "json": {
@@ -3750,11 +3890,96 @@
3750
3890
  "hasDynamicHelp": false,
3751
3891
  "multiple": false,
3752
3892
  "type": "option"
3893
+ },
3894
+ "by-days": {
3895
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
3896
+ "name": "by-days",
3897
+ "hasDynamicHelp": false,
3898
+ "multiple": true,
3899
+ "type": "option"
3900
+ },
3901
+ "date-from": {
3902
+ "description": "Start of the period (YYYY-MM-DD)",
3903
+ "name": "date-from",
3904
+ "required": true,
3905
+ "hasDynamicHelp": false,
3906
+ "multiple": false,
3907
+ "type": "option"
3908
+ },
3909
+ "date-to": {
3910
+ "description": "End of the period (YYYY-MM-DD)",
3911
+ "name": "date-to",
3912
+ "required": true,
3913
+ "hasDynamicHelp": false,
3914
+ "multiple": false,
3915
+ "type": "option"
3916
+ },
3917
+ "entity": {
3918
+ "description": "What to report on",
3919
+ "name": "entity",
3920
+ "required": true,
3921
+ "hasDynamicHelp": false,
3922
+ "multiple": false,
3923
+ "options": [
3924
+ "ad",
3925
+ "ad-group",
3926
+ "campaign",
3927
+ "keyword"
3928
+ ],
3929
+ "type": "option"
3930
+ },
3931
+ "group-by": {
3932
+ "description": "Break the rows down by a dimension, repeatable",
3933
+ "name": "group-by",
3934
+ "hasDynamicHelp": false,
3935
+ "multiple": true,
3936
+ "options": [
3937
+ "country",
3938
+ "day",
3939
+ "month",
3940
+ "quarter",
3941
+ "week",
3942
+ "year"
3943
+ ],
3944
+ "type": "option"
3945
+ },
3946
+ "metric": {
3947
+ "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable; omit for every metric; a wrong name fails listing all valid ones",
3948
+ "name": "metric",
3949
+ "hasDynamicHelp": false,
3950
+ "multiple": true,
3951
+ "type": "option"
3952
+ },
3953
+ "order": {
3954
+ "description": "Sort direction",
3955
+ "name": "order",
3956
+ "default": "desc",
3957
+ "hasDynamicHelp": false,
3958
+ "multiple": false,
3959
+ "options": [
3960
+ "asc",
3961
+ "desc"
3962
+ ],
3963
+ "type": "option"
3964
+ },
3965
+ "order-by": {
3966
+ "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
3967
+ "name": "order-by",
3968
+ "hasDynamicHelp": false,
3969
+ "multiple": false,
3970
+ "type": "option"
3971
+ },
3972
+ "order-by-day": {
3973
+ "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
3974
+ "name": "order-by-day",
3975
+ "hasDynamicHelp": false,
3976
+ "multiple": false,
3977
+ "type": "option"
3753
3978
  }
3754
3979
  },
3755
3980
  "hasDynamicHelp": false,
3756
3981
  "hiddenAliases": [],
3757
- "id": "asa:orgs:list",
3982
+ "id": "asa:metrics",
3758
3983
  "pluginAlias": "adapty",
3759
3984
  "pluginName": "adapty",
3760
3985
  "pluginType": "core",
@@ -3765,17 +3990,17 @@
3765
3990
  "dist",
3766
3991
  "commands",
3767
3992
  "asa",
3768
- "orgs",
3769
- "list.js"
3993
+ "metrics",
3994
+ "index.js"
3770
3995
  ]
3771
3996
  },
3772
- "asa:product-pages:list": {
3997
+ "asa:metrics:overview": {
3773
3998
  "aliases": [],
3774
3999
  "args": {},
3775
- "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4000
+ "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.",
3776
4001
  "examples": [
3777
- "<%= config.bin %> asa product-pages list",
3778
- "<%= config.bin %> asa product-pages list --app APP_UUID"
4002
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
4003
+ "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
3779
4004
  ],
3780
4005
  "flags": {
3781
4006
  "json": {
@@ -3785,18 +4010,160 @@
3785
4010
  "allowNo": false,
3786
4011
  "type": "boolean"
3787
4012
  },
3788
- "page": {
3789
- "description": "Page number",
3790
- "name": "page",
3791
- "default": 1,
4013
+ "by-days": {
4014
+ "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
4015
+ "name": "by-days",
3792
4016
  "hasDynamicHelp": false,
3793
- "multiple": false,
4017
+ "multiple": true,
3794
4018
  "type": "option"
3795
4019
  },
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,
4020
+ "date-from": {
4021
+ "description": "Start of the period (YYYY-MM-DD)",
4022
+ "name": "date-from",
4023
+ "required": true,
4024
+ "hasDynamicHelp": false,
4025
+ "multiple": false,
4026
+ "type": "option"
4027
+ },
4028
+ "date-to": {
4029
+ "description": "End of the period (YYYY-MM-DD)",
4030
+ "name": "date-to",
4031
+ "required": true,
4032
+ "hasDynamicHelp": false,
4033
+ "multiple": false,
4034
+ "type": "option"
4035
+ },
4036
+ "entity": {
4037
+ "description": "What to report on",
4038
+ "name": "entity",
4039
+ "required": true,
4040
+ "hasDynamicHelp": false,
4041
+ "multiple": false,
4042
+ "options": [
4043
+ "ad",
4044
+ "ad-group",
4045
+ "campaign",
4046
+ "keyword"
4047
+ ],
4048
+ "type": "option"
4049
+ },
4050
+ "metric": {
4051
+ "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
4052
+ "name": "metric",
4053
+ "hasDynamicHelp": false,
4054
+ "multiple": true,
4055
+ "type": "option"
4056
+ },
4057
+ "period-unit": {
4058
+ "description": "Bucket size",
4059
+ "name": "period-unit",
4060
+ "default": "day",
4061
+ "hasDynamicHelp": false,
4062
+ "multiple": false,
4063
+ "options": [
4064
+ "day",
4065
+ "month",
4066
+ "quarter",
4067
+ "week",
4068
+ "year"
4069
+ ],
4070
+ "type": "option"
4071
+ }
4072
+ },
4073
+ "hasDynamicHelp": false,
4074
+ "hiddenAliases": [],
4075
+ "id": "asa:metrics:overview",
4076
+ "pluginAlias": "adapty",
4077
+ "pluginName": "adapty",
4078
+ "pluginType": "core",
4079
+ "strict": true,
4080
+ "enableJsonFlag": true,
4081
+ "isESM": true,
4082
+ "relativePath": [
4083
+ "dist",
4084
+ "commands",
4085
+ "asa",
4086
+ "metrics",
4087
+ "overview.js"
4088
+ ]
4089
+ },
4090
+ "asa:orgs:list": {
4091
+ "aliases": [],
4092
+ "args": {},
4093
+ "description": "List the Apple Search Ads organizations this company can spend from",
4094
+ "examples": [
4095
+ "<%= config.bin %> asa orgs list"
4096
+ ],
4097
+ "flags": {
4098
+ "json": {
4099
+ "description": "Format output as json.",
4100
+ "helpGroup": "GLOBAL",
4101
+ "name": "json",
4102
+ "allowNo": false,
4103
+ "type": "boolean"
4104
+ },
4105
+ "page": {
4106
+ "description": "Page number",
4107
+ "name": "page",
4108
+ "default": 1,
4109
+ "hasDynamicHelp": false,
4110
+ "multiple": false,
4111
+ "type": "option"
4112
+ },
4113
+ "page-size": {
4114
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4115
+ "name": "page-size",
4116
+ "default": 100,
4117
+ "hasDynamicHelp": false,
4118
+ "multiple": false,
4119
+ "type": "option"
4120
+ }
4121
+ },
4122
+ "hasDynamicHelp": false,
4123
+ "hiddenAliases": [],
4124
+ "id": "asa:orgs:list",
4125
+ "pluginAlias": "adapty",
4126
+ "pluginName": "adapty",
4127
+ "pluginType": "core",
4128
+ "strict": true,
4129
+ "enableJsonFlag": true,
4130
+ "isESM": true,
4131
+ "relativePath": [
4132
+ "dist",
4133
+ "commands",
4134
+ "asa",
4135
+ "orgs",
4136
+ "list.js"
4137
+ ]
4138
+ },
4139
+ "asa:product-pages:list": {
4140
+ "aliases": [],
4141
+ "args": {},
4142
+ "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
4143
+ "examples": [
4144
+ "<%= config.bin %> asa product-pages list",
4145
+ "<%= config.bin %> asa product-pages list --app APP_UUID"
4146
+ ],
4147
+ "flags": {
4148
+ "json": {
4149
+ "description": "Format output as json.",
4150
+ "helpGroup": "GLOBAL",
4151
+ "name": "json",
4152
+ "allowNo": false,
4153
+ "type": "boolean"
4154
+ },
4155
+ "page": {
4156
+ "description": "Page number",
4157
+ "name": "page",
4158
+ "default": 1,
4159
+ "hasDynamicHelp": false,
4160
+ "multiple": false,
4161
+ "type": "option"
4162
+ },
4163
+ "page-size": {
4164
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4165
+ "name": "page-size",
4166
+ "default": 100,
3800
4167
  "hasDynamicHelp": false,
3801
4168
  "multiple": false,
3802
4169
  "type": "option"
@@ -4290,15 +4657,13 @@
4290
4657
  "upload.js"
4291
4658
  ]
4292
4659
  },
4293
- "asa:campaigns:bulk-create": {
4660
+ "asa:automations:create": {
4294
4661
  "aliases": [],
4295
4662
  "args": {},
4296
- "description": "Create a whole campaign structure (campaigns → ad groups → keywords/negative keywords/ads) in one bulk operation",
4663
+ "description": "Create an automation rule from a JSON rule file",
4297
4664
  "examples": [
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"
4665
+ "<%= config.bin %> asa automations create --file rule.json",
4666
+ "<%= config.bin %> asa automations create --file rule.json --run-now"
4302
4667
  ],
4303
4668
  "flags": {
4304
4669
  "json": {
@@ -4323,58 +4688,62 @@
4323
4688
  "type": "option"
4324
4689
  },
4325
4690
  "file": {
4326
- "description": "JSON file with the campaign structure (the POST /bulk-operations/ body); use \"-\" for stdin",
4691
+ "description": "JSON file with the rule body, or - to read stdin",
4327
4692
  "name": "file",
4693
+ "required": true,
4328
4694
  "hasDynamicHelp": false,
4329
4695
  "multiple": false,
4330
4696
  "type": "option"
4331
4697
  },
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,
4350
- "hasDynamicHelp": false,
4351
- "multiple": false,
4352
- "type": "option"
4353
- },
4354
- "preview": {
4355
- "description": "With --from-file: print the converted request and stop, nothing is created",
4356
- "name": "preview",
4698
+ "run-now": {
4699
+ "description": "Queue the first run right after the rule is stored",
4700
+ "name": "run-now",
4357
4701
  "allowNo": false,
4358
4702
  "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,
4703
+ }
4704
+ },
4705
+ "hasDynamicHelp": false,
4706
+ "hiddenAliases": [],
4707
+ "id": "asa:automations:create",
4708
+ "pluginAlias": "adapty",
4709
+ "pluginName": "adapty",
4710
+ "pluginType": "core",
4711
+ "strict": true,
4712
+ "enableJsonFlag": true,
4713
+ "isESM": true,
4714
+ "relativePath": [
4715
+ "dist",
4716
+ "commands",
4717
+ "asa",
4718
+ "automations",
4719
+ "create.js"
4720
+ ]
4721
+ },
4722
+ "asa:automations:get": {
4723
+ "aliases": [],
4724
+ "args": {
4725
+ "automation_id": {
4726
+ "description": "Automation rule ID (UUID)",
4727
+ "name": "automation_id",
4728
+ "required": true
4729
+ }
4730
+ },
4731
+ "description": "Show one automation rule with its conditions and actions",
4732
+ "examples": [
4733
+ "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
4734
+ ],
4735
+ "flags": {
4736
+ "json": {
4737
+ "description": "Format output as json.",
4738
+ "helpGroup": "GLOBAL",
4739
+ "name": "json",
4740
+ "allowNo": false,
4372
4741
  "type": "boolean"
4373
4742
  }
4374
4743
  },
4375
4744
  "hasDynamicHelp": false,
4376
4745
  "hiddenAliases": [],
4377
- "id": "asa:campaigns:bulk-create",
4746
+ "id": "asa:automations:get",
4378
4747
  "pluginAlias": "adapty",
4379
4748
  "pluginName": "adapty",
4380
4749
  "pluginType": "core",
@@ -4385,18 +4754,16 @@
4385
4754
  "dist",
4386
4755
  "commands",
4387
4756
  "asa",
4388
- "campaigns",
4389
- "bulk-create.js"
4757
+ "automations",
4758
+ "get.js"
4390
4759
  ]
4391
4760
  },
4392
- "asa:campaigns:bulk-list": {
4761
+ "asa:automations:list": {
4393
4762
  "aliases": [],
4394
4763
  "args": {},
4395
- "description": "This company's bulk operations, newest first; inspect one with bulk-status",
4764
+ "description": "List automation rules; status 1 is active, 0 is stopped",
4396
4765
  "examples": [
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"
4766
+ "<%= config.bin %> asa automations list"
4400
4767
  ],
4401
4768
  "flags": {
4402
4769
  "json": {
@@ -4421,46 +4788,11 @@
4421
4788
  "hasDynamicHelp": false,
4422
4789
  "multiple": false,
4423
4790
  "type": "option"
4424
- },
4425
- "app": {
4426
- "description": "Keep only operations of this app (UUID)",
4427
- "name": "app",
4428
- "hasDynamicHelp": false,
4429
- "multiple": false,
4430
- "type": "option"
4431
- },
4432
- "created-from": {
4433
- "description": "Keep only operations created on or after this date (YYYY-MM-DD)",
4434
- "name": "created-from",
4435
- "hasDynamicHelp": false,
4436
- "multiple": false,
4437
- "type": "option"
4438
- },
4439
- "created-to": {
4440
- "description": "Keep only operations created on or before this date (YYYY-MM-DD)",
4441
- "name": "created-to",
4442
- "hasDynamicHelp": false,
4443
- "multiple": false,
4444
- "type": "option"
4445
- },
4446
- "status": {
4447
- "description": "Keep only operations in this state; repeatable",
4448
- "name": "status",
4449
- "hasDynamicHelp": false,
4450
- "multiple": true,
4451
- "options": [
4452
- "failed",
4453
- "partial",
4454
- "pending",
4455
- "running",
4456
- "success"
4457
- ],
4458
- "type": "option"
4459
4791
  }
4460
4792
  },
4461
4793
  "hasDynamicHelp": false,
4462
4794
  "hiddenAliases": [],
4463
- "id": "asa:campaigns:bulk-list",
4795
+ "id": "asa:automations:list",
4464
4796
  "pluginAlias": "adapty",
4465
4797
  "pluginName": "adapty",
4466
4798
  "pluginType": "core",
@@ -4471,73 +4803,23 @@
4471
4803
  "dist",
4472
4804
  "commands",
4473
4805
  "asa",
4474
- "campaigns",
4475
- "bulk-list.js"
4806
+ "automations",
4807
+ "list.js"
4476
4808
  ]
4477
4809
  },
4478
- "asa:campaigns:bulk-status": {
4810
+ "asa:automations:run": {
4479
4811
  "aliases": [],
4480
4812
  "args": {
4481
- "operation-id": {
4482
- "description": "Bulk operation ID returned by bulk-create",
4483
- "name": "operation-id",
4813
+ "automation_id": {
4814
+ "description": "Automation rule ID (UUID)",
4815
+ "name": "automation_id",
4484
4816
  "required": true
4485
4817
  }
4486
4818
  },
4487
- "description": "Progress board of one bulk operation: counts, pipelines and the per-object log",
4488
- "examples": [
4489
- "<%= config.bin %> asa campaigns bulk-status 660e8400-e29b-41d4-a716-446655440001"
4490
- ],
4491
- "flags": {
4492
- "json": {
4493
- "description": "Format output as json.",
4494
- "helpGroup": "GLOBAL",
4495
- "name": "json",
4496
- "allowNo": false,
4497
- "type": "boolean"
4498
- },
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,
4511
- "hasDynamicHelp": false,
4512
- "multiple": false,
4513
- "type": "option"
4514
- }
4515
- },
4516
- "hasDynamicHelp": false,
4517
- "hiddenAliases": [],
4518
- "id": "asa:campaigns:bulk-status",
4519
- "pluginAlias": "adapty",
4520
- "pluginName": "adapty",
4521
- "pluginType": "core",
4522
- "strict": true,
4523
- "enableJsonFlag": true,
4524
- "isESM": true,
4525
- "relativePath": [
4526
- "dist",
4527
- "commands",
4528
- "asa",
4529
- "campaigns",
4530
- "bulk-status.js"
4531
- ]
4532
- },
4533
- "asa:campaigns:create": {
4534
- "aliases": [],
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",
4819
+ "description": "Run an automation rule now; the run is queued, not awaited",
4537
4820
  "examples": [
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"
4821
+ "<%= config.bin %> asa automations run UUID",
4822
+ "<%= config.bin %> asa automations run UUID --dry-run"
4541
4823
  ],
4542
4824
  "flags": {
4543
4825
  "json": {
@@ -4547,14 +4829,6 @@
4547
4829
  "allowNo": false,
4548
4830
  "type": "boolean"
4549
4831
  },
4550
- "currency": {
4551
- "description": "Currency code for the amounts in this call",
4552
- "name": "currency",
4553
- "default": "USD",
4554
- "hasDynamicHelp": false,
4555
- "multiple": false,
4556
- "type": "option"
4557
- },
4558
4832
  "yes": {
4559
4833
  "char": "y",
4560
4834
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -4569,155 +4843,16 @@
4569
4843
  "multiple": false,
4570
4844
  "type": "option"
4571
4845
  },
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",
4611
- "hasDynamicHelp": false,
4612
- "multiple": false,
4613
- "options": [
4614
- "DISPLAY",
4615
- "SEARCH"
4616
- ],
4617
- "type": "option"
4618
- },
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",
4713
- "hasDynamicHelp": false,
4714
- "multiple": false,
4715
- "type": "option"
4846
+ "dry-run": {
4847
+ "description": "Evaluate and log the rule without touching Apple",
4848
+ "name": "dry-run",
4849
+ "allowNo": false,
4850
+ "type": "boolean"
4716
4851
  }
4717
4852
  },
4718
4853
  "hasDynamicHelp": false,
4719
4854
  "hiddenAliases": [],
4720
- "id": "asa:campaigns:create",
4855
+ "id": "asa:automations:run",
4721
4856
  "pluginAlias": "adapty",
4722
4857
  "pluginName": "adapty",
4723
4858
  "pluginType": "core",
@@ -4728,56 +4863,22 @@
4728
4863
  "dist",
4729
4864
  "commands",
4730
4865
  "asa",
4731
- "campaigns",
4732
- "create.js"
4866
+ "automations",
4867
+ "run.js"
4733
4868
  ]
4734
4869
  },
4735
- "asa:campaigns:get": {
4870
+ "asa:automations:runs": {
4736
4871
  "aliases": [],
4737
4872
  "args": {
4738
- "campaign_id": {
4739
- "description": "Campaign ID (UUID)",
4740
- "name": "campaign_id",
4873
+ "automation_id": {
4874
+ "description": "Automation rule ID (UUID)",
4875
+ "name": "automation_id",
4741
4876
  "required": true
4742
4877
  }
4743
4878
  },
4744
- "description": "Show one campaign; read numbers with asa metrics",
4745
- "examples": [
4746
- "<%= config.bin %> asa campaigns get 550e8400-e29b-41d4-a716-446655440000"
4747
- ],
4748
- "flags": {
4749
- "json": {
4750
- "description": "Format output as json.",
4751
- "helpGroup": "GLOBAL",
4752
- "name": "json",
4753
- "allowNo": false,
4754
- "type": "boolean"
4755
- }
4756
- },
4757
- "hasDynamicHelp": false,
4758
- "hiddenAliases": [],
4759
- "id": "asa:campaigns:get",
4760
- "pluginAlias": "adapty",
4761
- "pluginName": "adapty",
4762
- "pluginType": "core",
4763
- "strict": true,
4764
- "enableJsonFlag": true,
4765
- "isESM": true,
4766
- "relativePath": [
4767
- "dist",
4768
- "commands",
4769
- "asa",
4770
- "campaigns",
4771
- "get.js"
4772
- ]
4773
- },
4774
- "asa:campaigns:list": {
4775
- "aliases": [],
4776
- "args": {},
4777
- "description": "List Apple Search Ads campaigns; read numbers with asa metrics",
4879
+ "description": "List past runs of an automation rule, including dry runs",
4778
4880
  "examples": [
4779
- "<%= config.bin %> asa campaigns list",
4780
- "<%= config.bin %> asa campaigns list --app APP_UUID --status PAUSED"
4881
+ "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
4781
4882
  ],
4782
4883
  "flags": {
4783
4884
  "json": {
@@ -4802,43 +4903,11 @@
4802
4903
  "hasDynamicHelp": false,
4803
4904
  "multiple": false,
4804
4905
  "type": "option"
4805
- },
4806
- "app": {
4807
- "description": "Keep only rows in this app; repeatable",
4808
- "name": "app",
4809
- "hasDynamicHelp": false,
4810
- "multiple": true,
4811
- "type": "option"
4812
- },
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",
4823
- "hasDynamicHelp": false,
4824
- "multiple": false,
4825
- "type": "option"
4826
- },
4827
- "status": {
4828
- "description": "Keep only rows in this state",
4829
- "name": "status",
4830
- "hasDynamicHelp": false,
4831
- "multiple": false,
4832
- "options": [
4833
- "ENABLED",
4834
- "PAUSED"
4835
- ],
4836
- "type": "option"
4837
4906
  }
4838
4907
  },
4839
4908
  "hasDynamicHelp": false,
4840
4909
  "hiddenAliases": [],
4841
- "id": "asa:campaigns:list",
4910
+ "id": "asa:automations:runs",
4842
4911
  "pluginAlias": "adapty",
4843
4912
  "pluginName": "adapty",
4844
4913
  "pluginType": "core",
@@ -4849,24 +4918,23 @@
4849
4918
  "dist",
4850
4919
  "commands",
4851
4920
  "asa",
4852
- "campaigns",
4853
- "list.js"
4921
+ "automations",
4922
+ "runs.js"
4854
4923
  ]
4855
4924
  },
4856
- "asa:campaigns:update": {
4925
+ "asa:automations:update": {
4857
4926
  "aliases": [],
4858
4927
  "args": {
4859
- "campaign_id": {
4860
- "description": "Campaign ID (UUID)",
4861
- "name": "campaign_id",
4928
+ "automation_id": {
4929
+ "description": "Automation rule ID (UUID)",
4930
+ "name": "automation_id",
4862
4931
  "required": true
4863
4932
  }
4864
4933
  },
4865
- "description": "Change a campaign: budgets, countries, status, schedule or Invoicing Options (all five --invoice-* flags together; they replace the stored set)",
4934
+ "description": "Change an automation rule: stop it, rename it, or replace parts of the rule",
4866
4935
  "examples": [
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"
4936
+ "<%= config.bin %> asa automations update UUID --stop",
4937
+ "<%= config.bin %> asa automations update UUID --file rule.json"
4870
4938
  ],
4871
4939
  "flags": {
4872
4940
  "json": {
@@ -4876,14 +4944,6 @@
4876
4944
  "allowNo": false,
4877
4945
  "type": "boolean"
4878
4946
  },
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
4947
  "yes": {
4888
4948
  "char": "y",
4889
4949
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -4898,102 +4958,42 @@
4898
4958
  "multiple": false,
4899
4959
  "type": "option"
4900
4960
  },
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",
4961
+ "file": {
4962
+ "description": "JSON file with the parts to change, or - to read stdin",
4963
+ "name": "file",
4964
4964
  "hasDynamicHelp": false,
4965
4965
  "multiple": false,
4966
4966
  "type": "option"
4967
4967
  },
4968
4968
  "name": {
4969
- "description": "Campaign name",
4969
+ "description": "Rule name",
4970
4970
  "name": "name",
4971
4971
  "hasDynamicHelp": false,
4972
4972
  "multiple": false,
4973
4973
  "type": "option"
4974
4974
  },
4975
- "status": {
4976
- "description": "Campaign status",
4977
- "name": "status",
4978
- "hasDynamicHelp": false,
4979
- "multiple": false,
4980
- "options": [
4981
- "ENABLED",
4982
- "PAUSED"
4975
+ "start": {
4976
+ "description": "Activate the rule",
4977
+ "exclusive": [
4978
+ "stop"
4983
4979
  ],
4984
- "type": "option"
4980
+ "name": "start",
4981
+ "allowNo": false,
4982
+ "type": "boolean"
4985
4983
  },
4986
- "target-cpa": {
4987
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
4988
- "name": "target-cpa",
4989
- "hasDynamicHelp": false,
4990
- "multiple": false,
4991
- "type": "option"
4984
+ "stop": {
4985
+ "description": "Stop the rule and clear its next run",
4986
+ "exclusive": [
4987
+ "start"
4988
+ ],
4989
+ "name": "stop",
4990
+ "allowNo": false,
4991
+ "type": "boolean"
4992
4992
  }
4993
4993
  },
4994
4994
  "hasDynamicHelp": false,
4995
4995
  "hiddenAliases": [],
4996
- "id": "asa:campaigns:update",
4996
+ "id": "asa:automations:update",
4997
4997
  "pluginAlias": "adapty",
4998
4998
  "pluginName": "adapty",
4999
4999
  "pluginType": "core",
@@ -5004,10 +5004,10 @@
5004
5004
  "dist",
5005
5005
  "commands",
5006
5006
  "asa",
5007
- "campaigns",
5007
+ "automations",
5008
5008
  "update.js"
5009
5009
  ]
5010
5010
  }
5011
5011
  },
5012
- "version": "0.8.3-beta.0"
5012
+ "version": "0.8.3-beta.1"
5013
5013
  }