adapty 0.8.0 → 0.8.2

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.
@@ -425,59 +425,36 @@
425
425
  "update.js"
426
426
  ]
427
427
  },
428
- "asa:connect": {
428
+ "auth:login": {
429
429
  "aliases": [],
430
430
  "args": {},
431
- "description": "Connect an Apple Search Ads account to this company",
431
+ "description": "Authenticate with Adapty via browser",
432
432
  "examples": [
433
- "<%= config.bin %> asa connect",
434
- "<%= config.bin %> asa connect --no-wait"
433
+ "<%= config.bin %> auth login"
435
434
  ],
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
- },
435
+ "flags": {},
459
436
  "hasDynamicHelp": false,
460
437
  "hiddenAliases": [],
461
- "id": "asa:connect",
438
+ "id": "auth:login",
462
439
  "pluginAlias": "adapty",
463
440
  "pluginName": "adapty",
464
441
  "pluginType": "core",
465
442
  "strict": true,
466
- "enableJsonFlag": true,
443
+ "enableJsonFlag": false,
467
444
  "isESM": true,
468
445
  "relativePath": [
469
446
  "dist",
470
447
  "commands",
471
- "asa",
472
- "connect.js"
448
+ "auth",
449
+ "login.js"
473
450
  ]
474
451
  },
475
- "asa:whoami": {
452
+ "auth:logout": {
476
453
  "aliases": [],
477
454
  "args": {},
478
- "description": "Show which company the token unlocks and whether Apple Ads is connected",
455
+ "description": "Remove stored authentication token",
479
456
  "examples": [
480
- "<%= config.bin %> asa whoami"
457
+ "<%= config.bin %> auth logout"
481
458
  ],
482
459
  "flags": {
483
460
  "json": {
@@ -490,7 +467,7 @@
490
467
  },
491
468
  "hasDynamicHelp": false,
492
469
  "hiddenAliases": [],
493
- "id": "asa:whoami",
470
+ "id": "auth:logout",
494
471
  "pluginAlias": "adapty",
495
472
  "pluginName": "adapty",
496
473
  "pluginType": "core",
@@ -500,40 +477,48 @@
500
477
  "relativePath": [
501
478
  "dist",
502
479
  "commands",
503
- "asa",
504
- "whoami.js"
480
+ "auth",
481
+ "logout.js"
505
482
  ]
506
483
  },
507
- "auth:login": {
484
+ "auth:revoke": {
508
485
  "aliases": [],
509
486
  "args": {},
510
- "description": "Authenticate with Adapty via browser",
487
+ "description": "Revoke the current authentication token",
511
488
  "examples": [
512
- "<%= config.bin %> auth login"
489
+ "<%= config.bin %> auth revoke"
513
490
  ],
514
- "flags": {},
491
+ "flags": {
492
+ "json": {
493
+ "description": "Format output as json.",
494
+ "helpGroup": "GLOBAL",
495
+ "name": "json",
496
+ "allowNo": false,
497
+ "type": "boolean"
498
+ }
499
+ },
515
500
  "hasDynamicHelp": false,
516
501
  "hiddenAliases": [],
517
- "id": "auth:login",
502
+ "id": "auth:revoke",
518
503
  "pluginAlias": "adapty",
519
504
  "pluginName": "adapty",
520
505
  "pluginType": "core",
521
506
  "strict": true,
522
- "enableJsonFlag": false,
507
+ "enableJsonFlag": true,
523
508
  "isESM": true,
524
509
  "relativePath": [
525
510
  "dist",
526
511
  "commands",
527
512
  "auth",
528
- "login.js"
513
+ "revoke.js"
529
514
  ]
530
515
  },
531
- "auth:logout": {
516
+ "auth:status": {
532
517
  "aliases": [],
533
518
  "args": {},
534
- "description": "Remove stored authentication token",
519
+ "description": "Show current authentication state (local only)",
535
520
  "examples": [
536
- "<%= config.bin %> auth logout"
521
+ "<%= config.bin %> auth status"
537
522
  ],
538
523
  "flags": {
539
524
  "json": {
@@ -546,7 +531,7 @@
546
531
  },
547
532
  "hasDynamicHelp": false,
548
533
  "hiddenAliases": [],
549
- "id": "auth:logout",
534
+ "id": "auth:status",
550
535
  "pluginAlias": "adapty",
551
536
  "pluginName": "adapty",
552
537
  "pluginType": "core",
@@ -557,15 +542,15 @@
557
542
  "dist",
558
543
  "commands",
559
544
  "auth",
560
- "logout.js"
545
+ "status.js"
561
546
  ]
562
547
  },
563
- "auth:revoke": {
548
+ "auth:whoami": {
564
549
  "aliases": [],
565
550
  "args": {},
566
- "description": "Revoke the current authentication token",
551
+ "description": "Show current user info from server (verifies token)",
567
552
  "examples": [
568
- "<%= config.bin %> auth revoke"
553
+ "<%= config.bin %> auth whoami"
569
554
  ],
570
555
  "flags": {
571
556
  "json": {
@@ -578,7 +563,7 @@
578
563
  },
579
564
  "hasDynamicHelp": false,
580
565
  "hiddenAliases": [],
581
- "id": "auth:revoke",
566
+ "id": "auth:whoami",
582
567
  "pluginAlias": "adapty",
583
568
  "pluginName": "adapty",
584
569
  "pluginType": "core",
@@ -589,15 +574,16 @@
589
574
  "dist",
590
575
  "commands",
591
576
  "auth",
592
- "revoke.js"
577
+ "whoami.js"
593
578
  ]
594
579
  },
595
- "auth:status": {
580
+ "asa:connect": {
596
581
  "aliases": [],
597
582
  "args": {},
598
- "description": "Show current authentication state (local only)",
583
+ "description": "Connect an Apple Search Ads account to this company",
599
584
  "examples": [
600
- "<%= config.bin %> auth status"
585
+ "<%= config.bin %> asa connect",
586
+ "<%= config.bin %> asa connect --no-wait"
601
587
  ],
602
588
  "flags": {
603
589
  "json": {
@@ -606,11 +592,25 @@
606
592
  "name": "json",
607
593
  "allowNo": false,
608
594
  "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": "auth:status",
613
+ "id": "asa:connect",
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
- "auth",
624
- "status.js"
623
+ "asa",
624
+ "connect.js"
625
625
  ]
626
626
  },
627
- "auth:whoami": {
627
+ "asa:whoami": {
628
628
  "aliases": [],
629
629
  "args": {},
630
- "description": "Show current user info from server (verifies token)",
630
+ "description": "Show which company the token unlocks and whether Apple Ads is connected",
631
631
  "examples": [
632
- "<%= config.bin %> auth whoami"
632
+ "<%= config.bin %> asa whoami"
633
633
  ],
634
634
  "flags": {
635
635
  "json": {
@@ -642,7 +642,7 @@
642
642
  },
643
643
  "hasDynamicHelp": false,
644
644
  "hiddenAliases": [],
645
- "id": "auth:whoami",
645
+ "id": "asa: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
- "auth",
655
+ "asa",
656
656
  "whoami.js"
657
657
  ]
658
658
  },
@@ -1708,13 +1708,12 @@
1708
1708
  "list.js"
1709
1709
  ]
1710
1710
  },
1711
- "asa:ad-groups:create": {
1711
+ "asa:ads:create": {
1712
1712
  "aliases": [],
1713
1713
  "args": {},
1714
- "description": "Create an ad group inside a campaign",
1714
+ "description": "Create an ad from a creative in an ad group",
1715
1715
  "examples": [
1716
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
1717
- "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM"
1716
+ "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
1718
1717
  ],
1719
1718
  "flags": {
1720
1719
  "json": {
@@ -1724,40 +1723,6 @@
1724
1723
  "allowNo": false,
1725
1724
  "type": "boolean"
1726
1725
  },
1727
- "currency": {
1728
- "description": "Currency code for the amounts in this call",
1729
- "name": "currency",
1730
- "default": "USD",
1731
- "hasDynamicHelp": false,
1732
- "multiple": false,
1733
- "type": "option"
1734
- },
1735
- "end-time": {
1736
- "description": "Schedule end (YYYY-MM-DD)",
1737
- "name": "end-time",
1738
- "hasDynamicHelp": false,
1739
- "multiple": false,
1740
- "type": "option"
1741
- },
1742
- "start-time": {
1743
- "description": "Schedule start (YYYY-MM-DD), defaults to today",
1744
- "name": "start-time",
1745
- "hasDynamicHelp": false,
1746
- "multiple": false,
1747
- "type": "option"
1748
- },
1749
- "pricing-model": {
1750
- "description": "Pricing model; Apple requires one on every ad group",
1751
- "name": "pricing-model",
1752
- "default": "CPC",
1753
- "hasDynamicHelp": false,
1754
- "multiple": false,
1755
- "options": [
1756
- "CPC",
1757
- "CPM"
1758
- ],
1759
- "type": "option"
1760
- },
1761
1726
  "yes": {
1762
1727
  "char": "y",
1763
1728
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -1772,37 +1737,24 @@
1772
1737
  "multiple": false,
1773
1738
  "type": "option"
1774
1739
  },
1775
- "automated-keywords": {
1776
- "description": "Let Apple add keywords automatically",
1777
- "name": "automated-keywords",
1778
- "allowNo": true,
1779
- "type": "boolean"
1780
- },
1781
- "campaign": {
1782
- "description": "Campaign ID (UUID)",
1783
- "name": "campaign",
1740
+ "ad-group": {
1741
+ "description": "Ad group ID (UUID) — the campaign is resolved from it",
1742
+ "name": "ad-group",
1784
1743
  "required": true,
1785
1744
  "hasDynamicHelp": false,
1786
1745
  "multiple": false,
1787
1746
  "type": "option"
1788
1747
  },
1789
- "cpa-goal": {
1790
- "description": "CPA goal (amount, e.g. 50 or 12.50)",
1791
- "name": "cpa-goal",
1792
- "hasDynamicHelp": false,
1793
- "multiple": false,
1794
- "type": "option"
1795
- },
1796
- "default-bid": {
1797
- "description": "Default bid (amount, e.g. 50 or 12.50)",
1798
- "name": "default-bid",
1748
+ "creative-id": {
1749
+ "description": "Apple creative ID from a product page or the default set",
1750
+ "name": "creative-id",
1799
1751
  "required": true,
1800
1752
  "hasDynamicHelp": false,
1801
1753
  "multiple": false,
1802
1754
  "type": "option"
1803
1755
  },
1804
1756
  "name": {
1805
- "description": "Ad group name",
1757
+ "description": "Ad name",
1806
1758
  "name": "name",
1807
1759
  "required": true,
1808
1760
  "hasDynamicHelp": false,
@@ -1823,7 +1775,7 @@
1823
1775
  },
1824
1776
  "hasDynamicHelp": false,
1825
1777
  "hiddenAliases": [],
1826
- "id": "asa:ad-groups:create",
1778
+ "id": "asa:ads:create",
1827
1779
  "pluginAlias": "adapty",
1828
1780
  "pluginName": "adapty",
1829
1781
  "pluginType": "core",
@@ -1834,22 +1786,22 @@
1834
1786
  "dist",
1835
1787
  "commands",
1836
1788
  "asa",
1837
- "ad-groups",
1789
+ "ads",
1838
1790
  "create.js"
1839
1791
  ]
1840
1792
  },
1841
- "asa:ad-groups:get": {
1793
+ "asa:ads:get": {
1842
1794
  "aliases": [],
1843
1795
  "args": {
1844
- "ad_group_id": {
1845
- "description": "Ad group ID (UUID)",
1846
- "name": "ad_group_id",
1796
+ "ad_id": {
1797
+ "description": "Ad ID (UUID)",
1798
+ "name": "ad_id",
1847
1799
  "required": true
1848
1800
  }
1849
1801
  },
1850
- "description": "Show one ad group; read numbers with asa metrics",
1802
+ "description": "Show one ad and its serving state",
1851
1803
  "examples": [
1852
- "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
1804
+ "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
1853
1805
  ],
1854
1806
  "flags": {
1855
1807
  "json": {
@@ -1862,7 +1814,7 @@
1862
1814
  },
1863
1815
  "hasDynamicHelp": false,
1864
1816
  "hiddenAliases": [],
1865
- "id": "asa:ad-groups:get",
1817
+ "id": "asa:ads:get",
1866
1818
  "pluginAlias": "adapty",
1867
1819
  "pluginName": "adapty",
1868
1820
  "pluginType": "core",
@@ -1873,17 +1825,17 @@
1873
1825
  "dist",
1874
1826
  "commands",
1875
1827
  "asa",
1876
- "ad-groups",
1828
+ "ads",
1877
1829
  "get.js"
1878
1830
  ]
1879
1831
  },
1880
- "asa:ad-groups:list": {
1832
+ "asa:ads:list": {
1881
1833
  "aliases": [],
1882
1834
  "args": {},
1883
- "description": "List ad groups; read numbers with asa metrics",
1835
+ "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
1884
1836
  "examples": [
1885
- "<%= config.bin %> asa ad-groups list",
1886
- "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
1837
+ "<%= config.bin %> asa ads list",
1838
+ "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
1887
1839
  ],
1888
1840
  "flags": {
1889
1841
  "json": {
@@ -1909,9 +1861,16 @@
1909
1861
  "multiple": false,
1910
1862
  "type": "option"
1911
1863
  },
1912
- "app": {
1913
- "description": "Keep only rows in this app; repeatable",
1914
- "name": "app",
1864
+ "ad-group": {
1865
+ "description": "Keep only rows in this ad group; repeatable",
1866
+ "name": "ad-group",
1867
+ "hasDynamicHelp": false,
1868
+ "multiple": true,
1869
+ "type": "option"
1870
+ },
1871
+ "campaign": {
1872
+ "description": "Keep only rows in this campaign; repeatable",
1873
+ "name": "campaign",
1915
1874
  "hasDynamicHelp": false,
1916
1875
  "multiple": true,
1917
1876
  "type": "option"
@@ -1930,13 +1889,6 @@
1930
1889
  "multiple": false,
1931
1890
  "type": "option"
1932
1891
  },
1933
- "campaign": {
1934
- "description": "Keep only rows in this campaign; repeatable",
1935
- "name": "campaign",
1936
- "hasDynamicHelp": false,
1937
- "multiple": true,
1938
- "type": "option"
1939
- },
1940
1892
  "status": {
1941
1893
  "description": "Keep only rows in this state",
1942
1894
  "name": "status",
@@ -1951,7 +1903,7 @@
1951
1903
  },
1952
1904
  "hasDynamicHelp": false,
1953
1905
  "hiddenAliases": [],
1954
- "id": "asa:ad-groups:list",
1906
+ "id": "asa:ads:list",
1955
1907
  "pluginAlias": "adapty",
1956
1908
  "pluginName": "adapty",
1957
1909
  "pluginType": "core",
@@ -1962,23 +1914,22 @@
1962
1914
  "dist",
1963
1915
  "commands",
1964
1916
  "asa",
1965
- "ad-groups",
1917
+ "ads",
1966
1918
  "list.js"
1967
1919
  ]
1968
1920
  },
1969
- "asa:ad-groups:update": {
1921
+ "asa:ads:update": {
1970
1922
  "aliases": [],
1971
1923
  "args": {
1972
- "ad_group_id": {
1973
- "description": "Ad group ID (UUID)",
1974
- "name": "ad_group_id",
1924
+ "ad_id": {
1925
+ "description": "Ad ID (UUID)",
1926
+ "name": "ad_id",
1975
1927
  "required": true
1976
1928
  }
1977
1929
  },
1978
- "description": "Change an ad group: bid, CPA goal, status or schedule",
1930
+ "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
1979
1931
  "examples": [
1980
- "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
1981
- "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
1932
+ "<%= config.bin %> asa ads update UUID --status PAUSED"
1982
1933
  ],
1983
1934
  "flags": {
1984
1935
  "json": {
@@ -1988,28 +1939,6 @@
1988
1939
  "allowNo": false,
1989
1940
  "type": "boolean"
1990
1941
  },
1991
- "currency": {
1992
- "description": "Currency code for the amounts in this call",
1993
- "name": "currency",
1994
- "default": "USD",
1995
- "hasDynamicHelp": false,
1996
- "multiple": false,
1997
- "type": "option"
1998
- },
1999
- "end-time": {
2000
- "description": "Schedule end (YYYY-MM-DD)",
2001
- "name": "end-time",
2002
- "hasDynamicHelp": false,
2003
- "multiple": false,
2004
- "type": "option"
2005
- },
2006
- "start-time": {
2007
- "description": "Schedule start (YYYY-MM-DD), defaults to today",
2008
- "name": "start-time",
2009
- "hasDynamicHelp": false,
2010
- "multiple": false,
2011
- "type": "option"
2012
- },
2013
1942
  "yes": {
2014
1943
  "char": "y",
2015
1944
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2024,35 +1953,15 @@
2024
1953
  "multiple": false,
2025
1954
  "type": "option"
2026
1955
  },
2027
- "automated-keywords": {
2028
- "description": "Let Apple add keywords automatically",
2029
- "name": "automated-keywords",
2030
- "allowNo": true,
2031
- "type": "boolean"
2032
- },
2033
- "cpa-goal": {
2034
- "description": "CPA goal (amount, e.g. 50 or 12.50)",
2035
- "name": "cpa-goal",
2036
- "hasDynamicHelp": false,
2037
- "multiple": false,
2038
- "type": "option"
2039
- },
2040
- "default-bid": {
2041
- "description": "Default bid (amount, e.g. 50 or 12.50)",
2042
- "name": "default-bid",
2043
- "hasDynamicHelp": false,
2044
- "multiple": false,
2045
- "type": "option"
2046
- },
2047
1956
  "name": {
2048
- "description": "Ad group name",
1957
+ "description": "Ad name",
2049
1958
  "name": "name",
2050
1959
  "hasDynamicHelp": false,
2051
1960
  "multiple": false,
2052
1961
  "type": "option"
2053
1962
  },
2054
1963
  "status": {
2055
- "description": "Ad group status",
1964
+ "description": "Ad status",
2056
1965
  "name": "status",
2057
1966
  "hasDynamicHelp": false,
2058
1967
  "multiple": false,
@@ -2065,7 +1974,7 @@
2065
1974
  },
2066
1975
  "hasDynamicHelp": false,
2067
1976
  "hiddenAliases": [],
2068
- "id": "asa:ad-groups:update",
1977
+ "id": "asa:ads:update",
2069
1978
  "pluginAlias": "adapty",
2070
1979
  "pluginName": "adapty",
2071
1980
  "pluginType": "core",
@@ -2076,16 +1985,18 @@
2076
1985
  "dist",
2077
1986
  "commands",
2078
1987
  "asa",
2079
- "ad-groups",
1988
+ "ads",
2080
1989
  "update.js"
2081
1990
  ]
2082
1991
  },
2083
- "asa:ads:create": {
1992
+ "asa:ad-groups:create": {
2084
1993
  "aliases": [],
2085
1994
  "args": {},
2086
- "description": "Create an ad from a creative in an ad group",
1995
+ "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
2087
1996
  "examples": [
2088
- "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
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
+ "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
2089
2000
  ],
2090
2001
  "flags": {
2091
2002
  "json": {
@@ -2095,6 +2006,40 @@
2095
2006
  "allowNo": false,
2096
2007
  "type": "boolean"
2097
2008
  },
2009
+ "currency": {
2010
+ "description": "Currency code for the amounts in this call",
2011
+ "name": "currency",
2012
+ "default": "USD",
2013
+ "hasDynamicHelp": false,
2014
+ "multiple": false,
2015
+ "type": "option"
2016
+ },
2017
+ "end-time": {
2018
+ "description": "Schedule end (YYYY-MM-DD)",
2019
+ "name": "end-time",
2020
+ "hasDynamicHelp": false,
2021
+ "multiple": false,
2022
+ "type": "option"
2023
+ },
2024
+ "start-time": {
2025
+ "description": "Schedule start (YYYY-MM-DD), defaults to today",
2026
+ "name": "start-time",
2027
+ "hasDynamicHelp": false,
2028
+ "multiple": false,
2029
+ "type": "option"
2030
+ },
2031
+ "pricing-model": {
2032
+ "description": "Pricing model; Apple requires one on every ad group",
2033
+ "name": "pricing-model",
2034
+ "default": "CPC",
2035
+ "hasDynamicHelp": false,
2036
+ "multiple": false,
2037
+ "options": [
2038
+ "CPC",
2039
+ "CPM"
2040
+ ],
2041
+ "type": "option"
2042
+ },
2098
2043
  "yes": {
2099
2044
  "char": "y",
2100
2045
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2109,24 +2054,45 @@
2109
2054
  "multiple": false,
2110
2055
  "type": "option"
2111
2056
  },
2112
- "ad-group": {
2113
- "description": "Ad group ID (UUID) — the campaign is resolved from it",
2114
- "name": "ad-group",
2057
+ "automated": {
2058
+ "description": "Create the automated ad group a Max Conversions campaign needs (no bid, no schedule, always ENABLED)",
2059
+ "exclusive": [
2060
+ "automated-keywords"
2061
+ ],
2062
+ "name": "automated",
2063
+ "allowNo": false,
2064
+ "type": "boolean"
2065
+ },
2066
+ "automated-keywords": {
2067
+ "description": "Let Apple add keywords automatically",
2068
+ "name": "automated-keywords",
2069
+ "allowNo": true,
2070
+ "type": "boolean"
2071
+ },
2072
+ "campaign": {
2073
+ "description": "Campaign ID (UUID)",
2074
+ "name": "campaign",
2115
2075
  "required": true,
2116
2076
  "hasDynamicHelp": false,
2117
2077
  "multiple": false,
2118
2078
  "type": "option"
2119
2079
  },
2120
- "creative-id": {
2121
- "description": "Apple creative ID from a product page or the default set",
2122
- "name": "creative-id",
2123
- "required": true,
2080
+ "cpa-goal": {
2081
+ "description": "CPA goal (amount, e.g. 50 or 12.50)",
2082
+ "name": "cpa-goal",
2083
+ "hasDynamicHelp": false,
2084
+ "multiple": false,
2085
+ "type": "option"
2086
+ },
2087
+ "default-bid": {
2088
+ "description": "Default bid; required unless --automated is set (amount, e.g. 50 or 12.50)",
2089
+ "name": "default-bid",
2124
2090
  "hasDynamicHelp": false,
2125
2091
  "multiple": false,
2126
2092
  "type": "option"
2127
2093
  },
2128
2094
  "name": {
2129
- "description": "Ad name",
2095
+ "description": "Ad group name",
2130
2096
  "name": "name",
2131
2097
  "required": true,
2132
2098
  "hasDynamicHelp": false,
@@ -2147,7 +2113,7 @@
2147
2113
  },
2148
2114
  "hasDynamicHelp": false,
2149
2115
  "hiddenAliases": [],
2150
- "id": "asa:ads:create",
2116
+ "id": "asa:ad-groups:create",
2151
2117
  "pluginAlias": "adapty",
2152
2118
  "pluginName": "adapty",
2153
2119
  "pluginType": "core",
@@ -2158,22 +2124,22 @@
2158
2124
  "dist",
2159
2125
  "commands",
2160
2126
  "asa",
2161
- "ads",
2127
+ "ad-groups",
2162
2128
  "create.js"
2163
2129
  ]
2164
2130
  },
2165
- "asa:ads:get": {
2131
+ "asa:ad-groups:get": {
2166
2132
  "aliases": [],
2167
2133
  "args": {
2168
- "ad_id": {
2169
- "description": "Ad ID (UUID)",
2170
- "name": "ad_id",
2134
+ "ad_group_id": {
2135
+ "description": "Ad group ID (UUID)",
2136
+ "name": "ad_group_id",
2171
2137
  "required": true
2172
2138
  }
2173
2139
  },
2174
- "description": "Show one ad and its serving state",
2140
+ "description": "Show one ad group; read numbers with asa metrics",
2175
2141
  "examples": [
2176
- "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
2142
+ "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
2177
2143
  ],
2178
2144
  "flags": {
2179
2145
  "json": {
@@ -2186,7 +2152,7 @@
2186
2152
  },
2187
2153
  "hasDynamicHelp": false,
2188
2154
  "hiddenAliases": [],
2189
- "id": "asa:ads:get",
2155
+ "id": "asa:ad-groups:get",
2190
2156
  "pluginAlias": "adapty",
2191
2157
  "pluginName": "adapty",
2192
2158
  "pluginType": "core",
@@ -2197,17 +2163,17 @@
2197
2163
  "dist",
2198
2164
  "commands",
2199
2165
  "asa",
2200
- "ads",
2166
+ "ad-groups",
2201
2167
  "get.js"
2202
2168
  ]
2203
2169
  },
2204
- "asa:ads:list": {
2170
+ "asa:ad-groups:list": {
2205
2171
  "aliases": [],
2206
2172
  "args": {},
2207
- "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
2173
+ "description": "List ad groups; read numbers with asa metrics",
2208
2174
  "examples": [
2209
- "<%= config.bin %> asa ads list",
2210
- "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
2175
+ "<%= config.bin %> asa ad-groups list",
2176
+ "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
2211
2177
  ],
2212
2178
  "flags": {
2213
2179
  "json": {
@@ -2233,16 +2199,9 @@
2233
2199
  "multiple": false,
2234
2200
  "type": "option"
2235
2201
  },
2236
- "ad-group": {
2237
- "description": "Keep only rows in this ad group; repeatable",
2238
- "name": "ad-group",
2239
- "hasDynamicHelp": false,
2240
- "multiple": true,
2241
- "type": "option"
2242
- },
2243
- "campaign": {
2244
- "description": "Keep only rows in this campaign; repeatable",
2245
- "name": "campaign",
2202
+ "app": {
2203
+ "description": "Keep only rows in this app; repeatable",
2204
+ "name": "app",
2246
2205
  "hasDynamicHelp": false,
2247
2206
  "multiple": true,
2248
2207
  "type": "option"
@@ -2261,6 +2220,13 @@
2261
2220
  "multiple": false,
2262
2221
  "type": "option"
2263
2222
  },
2223
+ "campaign": {
2224
+ "description": "Keep only rows in this campaign; repeatable",
2225
+ "name": "campaign",
2226
+ "hasDynamicHelp": false,
2227
+ "multiple": true,
2228
+ "type": "option"
2229
+ },
2264
2230
  "status": {
2265
2231
  "description": "Keep only rows in this state",
2266
2232
  "name": "status",
@@ -2275,7 +2241,7 @@
2275
2241
  },
2276
2242
  "hasDynamicHelp": false,
2277
2243
  "hiddenAliases": [],
2278
- "id": "asa:ads:list",
2244
+ "id": "asa:ad-groups:list",
2279
2245
  "pluginAlias": "adapty",
2280
2246
  "pluginName": "adapty",
2281
2247
  "pluginType": "core",
@@ -2286,22 +2252,23 @@
2286
2252
  "dist",
2287
2253
  "commands",
2288
2254
  "asa",
2289
- "ads",
2255
+ "ad-groups",
2290
2256
  "list.js"
2291
2257
  ]
2292
2258
  },
2293
- "asa:ads:update": {
2259
+ "asa:ad-groups:update": {
2294
2260
  "aliases": [],
2295
2261
  "args": {
2296
- "ad_id": {
2297
- "description": "Ad ID (UUID)",
2298
- "name": "ad_id",
2262
+ "ad_group_id": {
2263
+ "description": "Ad group ID (UUID)",
2264
+ "name": "ad_group_id",
2299
2265
  "required": true
2300
2266
  }
2301
2267
  },
2302
- "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
2268
+ "description": "Change an ad group: bid, CPA goal, status or schedule",
2303
2269
  "examples": [
2304
- "<%= config.bin %> asa ads update UUID --status PAUSED"
2270
+ "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
2271
+ "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
2305
2272
  ],
2306
2273
  "flags": {
2307
2274
  "json": {
@@ -2311,6 +2278,28 @@
2311
2278
  "allowNo": false,
2312
2279
  "type": "boolean"
2313
2280
  },
2281
+ "currency": {
2282
+ "description": "Currency code for the amounts in this call",
2283
+ "name": "currency",
2284
+ "default": "USD",
2285
+ "hasDynamicHelp": false,
2286
+ "multiple": false,
2287
+ "type": "option"
2288
+ },
2289
+ "end-time": {
2290
+ "description": "Schedule end (YYYY-MM-DD)",
2291
+ "name": "end-time",
2292
+ "hasDynamicHelp": false,
2293
+ "multiple": false,
2294
+ "type": "option"
2295
+ },
2296
+ "start-time": {
2297
+ "description": "Schedule start (YYYY-MM-DD), defaults to today",
2298
+ "name": "start-time",
2299
+ "hasDynamicHelp": false,
2300
+ "multiple": false,
2301
+ "type": "option"
2302
+ },
2314
2303
  "yes": {
2315
2304
  "char": "y",
2316
2305
  "description": "Apply without asking; required when the output is piped or --json is used",
@@ -2325,15 +2314,35 @@
2325
2314
  "multiple": false,
2326
2315
  "type": "option"
2327
2316
  },
2317
+ "automated-keywords": {
2318
+ "description": "Let Apple add keywords automatically",
2319
+ "name": "automated-keywords",
2320
+ "allowNo": true,
2321
+ "type": "boolean"
2322
+ },
2323
+ "cpa-goal": {
2324
+ "description": "CPA goal (amount, e.g. 50 or 12.50)",
2325
+ "name": "cpa-goal",
2326
+ "hasDynamicHelp": false,
2327
+ "multiple": false,
2328
+ "type": "option"
2329
+ },
2330
+ "default-bid": {
2331
+ "description": "Default bid (amount, e.g. 50 or 12.50)",
2332
+ "name": "default-bid",
2333
+ "hasDynamicHelp": false,
2334
+ "multiple": false,
2335
+ "type": "option"
2336
+ },
2328
2337
  "name": {
2329
- "description": "Ad name",
2338
+ "description": "Ad group name",
2330
2339
  "name": "name",
2331
2340
  "hasDynamicHelp": false,
2332
2341
  "multiple": false,
2333
2342
  "type": "option"
2334
2343
  },
2335
2344
  "status": {
2336
- "description": "Ad status",
2345
+ "description": "Ad group status",
2337
2346
  "name": "status",
2338
2347
  "hasDynamicHelp": false,
2339
2348
  "multiple": false,
@@ -2346,7 +2355,7 @@
2346
2355
  },
2347
2356
  "hasDynamicHelp": false,
2348
2357
  "hiddenAliases": [],
2349
- "id": "asa:ads:update",
2358
+ "id": "asa:ad-groups:update",
2350
2359
  "pluginAlias": "adapty",
2351
2360
  "pluginName": "adapty",
2352
2361
  "pluginType": "core",
@@ -2357,7 +2366,7 @@
2357
2366
  "dist",
2358
2367
  "commands",
2359
2368
  "asa",
2360
- "ads",
2369
+ "ad-groups",
2361
2370
  "update.js"
2362
2371
  ]
2363
2372
  },
@@ -2747,7 +2756,48 @@
2747
2756
  },
2748
2757
  "hasDynamicHelp": false,
2749
2758
  "hiddenAliases": [],
2750
- "id": "asa:automations:update",
2759
+ "id": "asa:automations:update",
2760
+ "pluginAlias": "adapty",
2761
+ "pluginName": "adapty",
2762
+ "pluginType": "core",
2763
+ "strict": true,
2764
+ "enableJsonFlag": true,
2765
+ "isESM": true,
2766
+ "relativePath": [
2767
+ "dist",
2768
+ "commands",
2769
+ "asa",
2770
+ "automations",
2771
+ "update.js"
2772
+ ]
2773
+ },
2774
+ "asa:competitors:summary": {
2775
+ "aliases": [],
2776
+ "args": {},
2777
+ "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2778
+ "examples": [
2779
+ "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2780
+ ],
2781
+ "flags": {
2782
+ "json": {
2783
+ "description": "Format output as json.",
2784
+ "helpGroup": "GLOBAL",
2785
+ "name": "json",
2786
+ "allowNo": false,
2787
+ "type": "boolean"
2788
+ },
2789
+ "app-ids": {
2790
+ "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2791
+ "name": "app-ids",
2792
+ "required": true,
2793
+ "hasDynamicHelp": false,
2794
+ "multiple": false,
2795
+ "type": "option"
2796
+ }
2797
+ },
2798
+ "hasDynamicHelp": false,
2799
+ "hiddenAliases": [],
2800
+ "id": "asa:competitors:summary",
2751
2801
  "pluginAlias": "adapty",
2752
2802
  "pluginName": "adapty",
2753
2803
  "pluginType": "core",
@@ -2758,16 +2808,17 @@
2758
2808
  "dist",
2759
2809
  "commands",
2760
2810
  "asa",
2761
- "automations",
2762
- "update.js"
2811
+ "competitors",
2812
+ "summary.js"
2763
2813
  ]
2764
2814
  },
2765
- "asa:competitors:summary": {
2815
+ "asa:creatives:list": {
2766
2816
  "aliases": [],
2767
2817
  "args": {},
2768
- "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
2818
+ "description": "List creatives; creative_id is what `asa ads create` needs",
2769
2819
  "examples": [
2770
- "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
2820
+ "<%= config.bin %> asa creatives list",
2821
+ "<%= config.bin %> asa creatives list --app APP_UUID"
2771
2822
  ],
2772
2823
  "flags": {
2773
2824
  "json": {
@@ -2777,18 +2828,40 @@
2777
2828
  "allowNo": false,
2778
2829
  "type": "boolean"
2779
2830
  },
2780
- "app-ids": {
2781
- "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
2782
- "name": "app-ids",
2783
- "required": true,
2831
+ "page": {
2832
+ "description": "Page number",
2833
+ "name": "page",
2834
+ "default": 1,
2835
+ "hasDynamicHelp": false,
2836
+ "multiple": false,
2837
+ "type": "option"
2838
+ },
2839
+ "page-size": {
2840
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
2841
+ "name": "page-size",
2842
+ "default": 100,
2784
2843
  "hasDynamicHelp": false,
2785
2844
  "multiple": false,
2786
2845
  "type": "option"
2846
+ },
2847
+ "app": {
2848
+ "description": "Keep only rows in this app; repeatable",
2849
+ "name": "app",
2850
+ "hasDynamicHelp": false,
2851
+ "multiple": true,
2852
+ "type": "option"
2853
+ },
2854
+ "campaign-group": {
2855
+ "description": "Keep only rows in this campaign group; repeatable",
2856
+ "name": "campaign-group",
2857
+ "hasDynamicHelp": false,
2858
+ "multiple": true,
2859
+ "type": "option"
2787
2860
  }
2788
2861
  },
2789
2862
  "hasDynamicHelp": false,
2790
2863
  "hiddenAliases": [],
2791
- "id": "asa:competitors:summary",
2864
+ "id": "asa:creatives:list",
2792
2865
  "pluginAlias": "adapty",
2793
2866
  "pluginName": "adapty",
2794
2867
  "pluginType": "core",
@@ -2799,8 +2872,8 @@
2799
2872
  "dist",
2800
2873
  "commands",
2801
2874
  "asa",
2802
- "competitors",
2803
- "summary.js"
2875
+ "creatives",
2876
+ "list.js"
2804
2877
  ]
2805
2878
  },
2806
2879
  "asa:campaigns:bulk-create": {
@@ -3046,9 +3119,11 @@
3046
3119
  "asa:campaigns:create": {
3047
3120
  "aliases": [],
3048
3121
  "args": {},
3049
- "description": "Create a campaign in Apple Search Ads",
3122
+ "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",
3050
3123
  "examples": [
3051
- "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50"
3124
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Winter push\" --adam-id 123456 --country US --daily-budget 50",
3125
+ "<%= config.bin %> asa campaigns create --org UUID --name \"Max Conv\" --adam-id 123456 --country US --daily-budget 50 --bidding-strategy MAX_CONVERSIONS",
3126
+ "<%= 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"
3052
3127
  ],
3053
3128
  "flags": {
3054
3129
  "json": {
@@ -3080,6 +3155,41 @@
3080
3155
  "multiple": false,
3081
3156
  "type": "option"
3082
3157
  },
3158
+ "invoice-advertiser": {
3159
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
3160
+ "name": "invoice-advertiser",
3161
+ "hasDynamicHelp": false,
3162
+ "multiple": false,
3163
+ "type": "option"
3164
+ },
3165
+ "invoice-billing-email": {
3166
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
3167
+ "name": "invoice-billing-email",
3168
+ "hasDynamicHelp": false,
3169
+ "multiple": false,
3170
+ "type": "option"
3171
+ },
3172
+ "invoice-contact-email": {
3173
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
3174
+ "name": "invoice-contact-email",
3175
+ "hasDynamicHelp": false,
3176
+ "multiple": false,
3177
+ "type": "option"
3178
+ },
3179
+ "invoice-contact-name": {
3180
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
3181
+ "name": "invoice-contact-name",
3182
+ "hasDynamicHelp": false,
3183
+ "multiple": false,
3184
+ "type": "option"
3185
+ },
3186
+ "invoice-order-number": {
3187
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
3188
+ "name": "invoice-order-number",
3189
+ "hasDynamicHelp": false,
3190
+ "multiple": false,
3191
+ "type": "option"
3192
+ },
3083
3193
  "ad-channel-type": {
3084
3194
  "description": "Ad channel type",
3085
3195
  "name": "ad-channel-type",
@@ -3184,7 +3294,7 @@
3184
3294
  "type": "option"
3185
3295
  },
3186
3296
  "target-cpa": {
3187
- "description": "Target CPA (amount, e.g. 50 or 12.50)",
3297
+ "description": "Target CPA; must be lower than --daily-budget (amount, e.g. 50 or 12.50)",
3188
3298
  "name": "target-cpa",
3189
3299
  "hasDynamicHelp": false,
3190
3300
  "multiple": false,
@@ -3338,10 +3448,11 @@
3338
3448
  "required": true
3339
3449
  }
3340
3450
  },
3341
- "description": "Change a campaign: budgets, countries, status or schedule",
3451
+ "description": "Change a campaign: budgets, countries, status, schedule or Invoicing Options (all five --invoice-* flags together; they replace the stored set)",
3342
3452
  "examples": [
3343
3453
  "<%= config.bin %> asa campaigns update UUID --status PAUSED",
3344
- "<%= config.bin %> asa campaigns update UUID --daily-budget 80"
3454
+ "<%= config.bin %> asa campaigns update UUID --daily-budget 80",
3455
+ "<%= 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"
3345
3456
  ],
3346
3457
  "flags": {
3347
3458
  "json": {
@@ -3373,6 +3484,41 @@
3373
3484
  "multiple": false,
3374
3485
  "type": "option"
3375
3486
  },
3487
+ "invoice-advertiser": {
3488
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): advertiser name",
3489
+ "name": "invoice-advertiser",
3490
+ "hasDynamicHelp": false,
3491
+ "multiple": false,
3492
+ "type": "option"
3493
+ },
3494
+ "invoice-billing-email": {
3495
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): billing contact email",
3496
+ "name": "invoice-billing-email",
3497
+ "hasDynamicHelp": false,
3498
+ "multiple": false,
3499
+ "type": "option"
3500
+ },
3501
+ "invoice-contact-email": {
3502
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact email",
3503
+ "name": "invoice-contact-email",
3504
+ "hasDynamicHelp": false,
3505
+ "multiple": false,
3506
+ "type": "option"
3507
+ },
3508
+ "invoice-contact-name": {
3509
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): buyer contact name",
3510
+ "name": "invoice-contact-name",
3511
+ "hasDynamicHelp": false,
3512
+ "multiple": false,
3513
+ "type": "option"
3514
+ },
3515
+ "invoice-order-number": {
3516
+ "description": "Invoicing Options (line-of-credit orgs, see payment_model in asa orgs list): order number",
3517
+ "name": "invoice-order-number",
3518
+ "hasDynamicHelp": false,
3519
+ "multiple": false,
3520
+ "type": "option"
3521
+ },
3376
3522
  "bidding-strategy": {
3377
3523
  "description": "Bidding strategy",
3378
3524
  "name": "bidding-strategy",
@@ -3448,70 +3594,6 @@
3448
3594
  "update.js"
3449
3595
  ]
3450
3596
  },
3451
- "asa:creatives:list": {
3452
- "aliases": [],
3453
- "args": {},
3454
- "description": "List creatives; creative_id is what `asa ads create` needs",
3455
- "examples": [
3456
- "<%= config.bin %> asa creatives list",
3457
- "<%= config.bin %> asa creatives list --app APP_UUID"
3458
- ],
3459
- "flags": {
3460
- "json": {
3461
- "description": "Format output as json.",
3462
- "helpGroup": "GLOBAL",
3463
- "name": "json",
3464
- "allowNo": false,
3465
- "type": "boolean"
3466
- },
3467
- "page": {
3468
- "description": "Page number",
3469
- "name": "page",
3470
- "default": 1,
3471
- "hasDynamicHelp": false,
3472
- "multiple": false,
3473
- "type": "option"
3474
- },
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,
3479
- "hasDynamicHelp": false,
3480
- "multiple": false,
3481
- "type": "option"
3482
- },
3483
- "app": {
3484
- "description": "Keep only rows in this app; repeatable",
3485
- "name": "app",
3486
- "hasDynamicHelp": false,
3487
- "multiple": true,
3488
- "type": "option"
3489
- },
3490
- "campaign-group": {
3491
- "description": "Keep only rows in this campaign group; repeatable",
3492
- "name": "campaign-group",
3493
- "hasDynamicHelp": false,
3494
- "multiple": true,
3495
- "type": "option"
3496
- }
3497
- },
3498
- "hasDynamicHelp": false,
3499
- "hiddenAliases": [],
3500
- "id": "asa:creatives:list",
3501
- "pluginAlias": "adapty",
3502
- "pluginName": "adapty",
3503
- "pluginType": "core",
3504
- "strict": true,
3505
- "enableJsonFlag": true,
3506
- "isESM": true,
3507
- "relativePath": [
3508
- "dist",
3509
- "commands",
3510
- "asa",
3511
- "creatives",
3512
- "list.js"
3513
- ]
3514
- },
3515
3597
  "asa:keywords:add": {
3516
3598
  "aliases": [],
3517
3599
  "args": {},
@@ -3818,7 +3900,7 @@
3818
3900
  "asa:metrics": {
3819
3901
  "aliases": [],
3820
3902
  "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 coarsest --group-by period: 90 days for\nday or no period grouping, 180 by week, 365 by month and coarser — widen the window by coarsening the\ngrouping, not by splitting into more calls. Budget: 5 metrics calls per minute, at most 2 per 10 seconds.",
3903
+ "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.",
3822
3904
  "examples": [
3823
3905
  "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
3824
3906
  "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5",
@@ -4247,55 +4329,6 @@
4247
4329
  "list.js"
4248
4330
  ]
4249
4331
  },
4250
- "asa:orgs:list": {
4251
- "aliases": [],
4252
- "args": {},
4253
- "description": "List the Apple Search Ads organizations this company can spend from",
4254
- "examples": [
4255
- "<%= config.bin %> asa orgs list"
4256
- ],
4257
- "flags": {
4258
- "json": {
4259
- "description": "Format output as json.",
4260
- "helpGroup": "GLOBAL",
4261
- "name": "json",
4262
- "allowNo": false,
4263
- "type": "boolean"
4264
- },
4265
- "page": {
4266
- "description": "Page number",
4267
- "name": "page",
4268
- "default": 1,
4269
- "hasDynamicHelp": false,
4270
- "multiple": false,
4271
- "type": "option"
4272
- },
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,
4277
- "hasDynamicHelp": false,
4278
- "multiple": false,
4279
- "type": "option"
4280
- }
4281
- },
4282
- "hasDynamicHelp": false,
4283
- "hiddenAliases": [],
4284
- "id": "asa:orgs:list",
4285
- "pluginAlias": "adapty",
4286
- "pluginName": "adapty",
4287
- "pluginType": "core",
4288
- "strict": true,
4289
- "enableJsonFlag": true,
4290
- "isESM": true,
4291
- "relativePath": [
4292
- "dist",
4293
- "commands",
4294
- "asa",
4295
- "orgs",
4296
- "list.js"
4297
- ]
4298
- },
4299
4332
  "asa:product-pages:list": {
4300
4333
  "aliases": [],
4301
4334
  "args": {},
@@ -4514,6 +4547,55 @@
4514
4547
  "list.js"
4515
4548
  ]
4516
4549
  },
4550
+ "asa:orgs:list": {
4551
+ "aliases": [],
4552
+ "args": {},
4553
+ "description": "List the Apple Search Ads organizations this company can spend from",
4554
+ "examples": [
4555
+ "<%= config.bin %> asa orgs list"
4556
+ ],
4557
+ "flags": {
4558
+ "json": {
4559
+ "description": "Format output as json.",
4560
+ "helpGroup": "GLOBAL",
4561
+ "name": "json",
4562
+ "allowNo": false,
4563
+ "type": "boolean"
4564
+ },
4565
+ "page": {
4566
+ "description": "Page number",
4567
+ "name": "page",
4568
+ "default": 1,
4569
+ "hasDynamicHelp": false,
4570
+ "multiple": false,
4571
+ "type": "option"
4572
+ },
4573
+ "page-size": {
4574
+ "description": "Items per page (max 1000); prefer one big page over a pagination loop",
4575
+ "name": "page-size",
4576
+ "default": 100,
4577
+ "hasDynamicHelp": false,
4578
+ "multiple": false,
4579
+ "type": "option"
4580
+ }
4581
+ },
4582
+ "hasDynamicHelp": false,
4583
+ "hiddenAliases": [],
4584
+ "id": "asa:orgs:list",
4585
+ "pluginAlias": "adapty",
4586
+ "pluginName": "adapty",
4587
+ "pluginType": "core",
4588
+ "strict": true,
4589
+ "enableJsonFlag": true,
4590
+ "isESM": true,
4591
+ "relativePath": [
4592
+ "dist",
4593
+ "commands",
4594
+ "asa",
4595
+ "orgs",
4596
+ "list.js"
4597
+ ]
4598
+ },
4517
4599
  "flows:config:get": {
4518
4600
  "aliases": [],
4519
4601
  "args": {
@@ -4818,5 +4900,5 @@
4818
4900
  ]
4819
4901
  }
4820
4902
  },
4821
- "version": "0.8.0"
4903
+ "version": "0.8.2"
4822
4904
  }