@superwall/cli 2.6.0-beta.2 → 2.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +47 -16
- package/dist/{apple-Dc5pOPms.js → apple-D-rfsuDA.js} +17 -19
- package/dist/{approve-BSbdmOez.js → approve-aPc5RoXB.js} +9 -11
- package/dist/{assets-C_RjojkK.js → assets-PyuXe45Y.js} +3 -3
- package/dist/auth.d.ts +11 -4
- package/dist/auth.js +4 -5
- package/dist/base-CAU0hWoI.js +82 -0
- package/dist/{billing-B6HK-F_a.js → billing-Dt6L_l9R.js} +3 -3
- package/dist/{build-DK88pTMW.js → build-CY5FnMNY.js} +35 -16
- package/dist/{client-x08fpvay.js → config-DOp5oChe.js} +162 -15
- package/dist/{create-B6-Dr3GZ.js → create-BZL5VH4L.js} +41 -41
- package/dist/{create-kpqEhqkk.js → create-D6w3UL0m.js} +9 -9
- package/dist/create-DM5Y1Pyk.js +18 -0
- package/dist/{doctor-DYbm8IKQ.js → doctor-C9FR0qw3.js} +50 -10
- package/dist/entry.js +45 -40
- package/dist/{environment-BFNzLLPN.js → environment-sE2wZYdg.js} +1 -1
- package/dist/{drivers-Dyi-y9Jn.js → existing--peXpOZj.js} +305 -8
- package/dist/framework-DW5fqjh4.js +65 -0
- package/dist/{source-BccdO4aL.js → git-Hf9Wc7Hp.js} +34 -92
- package/dist/{held-sKq3xrsT.js → held-CUBCOCGP.js} +8 -8
- package/dist/held-DVxvPMSG.js +15 -0
- package/dist/{install-DsIsif39.js → install-C5d82gZF.js} +15 -17
- package/dist/{integrate-B8eA676b.js → integrate-D8J_X1bj.js} +33 -38
- package/dist/{login-Blhxi20A.js → login-C6X7JrhM.js} +8 -9
- package/dist/{login-BlpfYapG.js → login-DXhm9L0F.js} +3 -3
- package/dist/login-et319ESO.js +13 -0
- package/dist/{lookup-Dg55W9S7.js → lookup-DqmIbUkv.js} +28 -4
- package/dist/{migrate-DoRb9jmA.js → migrate-BYF6hKZ2.js} +66 -45
- package/dist/{notification-url-D82msWF5.js → notification-url-Bo54nkXv.js} +4 -4
- package/dist/{open-BAqLpTSI.js → open-xdgXUzaF.js} +2 -2
- package/dist/{org-C4G7WjTV.js → org-BD8U3D1_.js} +4 -4
- package/dist/{organization-CmuQwcKN.js → organization-D-ZlB3qU.js} +4 -4
- package/dist/{orgs-1OzwUtpT.js → orgs-DQQJ3sw_.js} +1 -2
- package/dist/{paths-gBbqgkS7.js → paths-CIlyzF2I.js} +1 -1
- package/dist/{playbook-BKqlv77S.js → playbook-ecggWGFi.js} +10 -14
- package/dist/{products-Cqq59DBQ.js → products-CJq_iXv5.js} +1 -1
- package/dist/{promote-D0i8A0CO.js → promote-QVMLGYlU.js} +27 -28
- package/dist/{pull-DgQ_UmGv.js → pull-CCXhb2a7.js} +72 -26
- package/dist/{pull-CiIrJ5ik.js → pull-CrdsfsAl.js} +33 -39
- package/dist/pull-h71pL3r_.js +30 -0
- package/dist/push-BIq6R8Ro.js +29 -0
- package/dist/push-D6pJM_vv.js +21 -0
- package/dist/{push-7N4XIVtg.js → push-DJMGG7zW.js} +23 -12
- package/dist/{push-BWsXO7FN.js → push-DiMDwGfe.js} +8 -7
- package/dist/{registry-aAR_8VOw.js → registry-BSnQXft4.js} +1286 -901
- package/dist/registry-YwzTfCNc.js +22 -0
- package/dist/{resolve-CcOpO_5s.js → resolve-DO7bPota.js} +4 -4
- package/dist/{resources-DNwvf8rg.js → resources-XwvXA20E.js} +15 -2
- package/dist/{run-tVYJ3V5j.js → run-B-YvxfRc.js} +15 -17
- package/dist/scan-B36wkZmI.js +4 -0
- package/dist/{scan-dv0rrY4C.js → scan-ViBhmrB7.js} +1 -1
- package/dist/{scope-BXoQo30_.js → scope-BLLUxbrA.js} +24 -18
- package/dist/{scope-ehZ7L1nj.js → scope-Cg1AdAfO.js} +33 -3
- package/dist/screenshot-file-Dix2Qynm.js +127 -0
- package/dist/{sdk-DEfQttek.js → sdk-BFunw4Hc.js} +1 -1
- package/dist/{framework-JFLjmD5Y.js → selection-C07e_GGY.js} +4 -54
- package/dist/{series-D2ZpZ8cx.js → series-B8NJK4yS.js} +1 -1
- package/dist/{server-CcZGdYjE.js → server-CBtHzl9y.js} +40 -18
- package/dist/server-CZwSfzKe.js +33 -0
- package/dist/{base-83ZTv6up.js → session-BfVx50iA.js} +8 -83
- package/dist/{session-dHBtgSN0.js → session-BlrwAdGN.js} +1 -1
- package/dist/session-Cip4j99n.js +5 -0
- package/dist/{migration-BUedsREQ.js → setup-a4B72xJ8.js} +290 -28
- package/dist/skills/superwall/SKILL.md +37 -10
- package/dist/skills/superwall/references/api.md +66 -21
- package/dist/skills/superwall/references/asa.md +109 -64
- package/dist/skills/superwall/references/dashboard-links.md +65 -28
- package/dist/skills/superwall/references/data-analytics.md +1 -1
- package/dist/skills/superwall/workflows/dashboard/setup.md +15 -5
- package/dist/skills/superwall/workflows/integrate/flutter.md +9 -7
- package/dist/skills/superwall-framework/SKILL.md +197 -14
- package/dist/skills/superwall-framework/references/cli.md +98 -7
- package/dist/skills/superwall-framework/references/examples.md +2 -2
- package/dist/skills/superwall-framework/references/migrate-from-editor.md +5 -0
- package/dist/skills/superwall-framework/references/migrate-from-native.md +5 -0
- package/dist/{skills-Q7xB784d.js → skills-BB1uIt8t.js} +139 -9
- package/dist/{skills-Bqz2l_bx.js → skills-SnxFa2in.js} +8 -12
- package/dist/source-DQs6iLtC.js +82 -0
- package/dist/{source-push-CG948HrX.js → source-push-w7miTr6m.js} +38 -14
- package/dist/{spinner-IA6hV8nI.js → spinner-BQp7fQvK.js} +7 -5
- package/dist/{starter-BtUUQWhd.js → starter-BlJ_InZJ.js} +2 -2
- package/dist/{status-CB_MrFu5.js → status-DxsIw9zq.js} +9 -11
- package/dist/{output-Ggzq5_-t.js → storage-BR6imSqm.js} +40 -1
- package/dist/storekit-BqyujKQ_.js +203 -0
- package/dist/storekit-ELVCMF0X.js +15 -0
- package/dist/{bind-DcWIIPgk.js → theme-Ed0gz6hr.js} +29 -6
- package/dist/token-CWQ6tdva.js +100 -0
- package/dist/tools-skills/animate-onboarding/SKILL.md +1 -1
- package/dist/tools-skills/mobile-design/SKILL.md +1 -1
- package/dist/tools-skills/onboarding-questions/SKILL.md +1 -1
- package/dist/tools-skills/superwall/SKILL.md +43 -17
- package/dist/tools-skills/superwall/references/api.md +74 -24
- package/dist/tools-skills/superwall/references/asa.md +109 -64
- package/dist/tools-skills/superwall/references/dashboard-links.md +65 -28
- package/dist/tools-skills/superwall/references/data-analytics.md +1 -1
- package/dist/tools-skills/superwall/workflows/dashboard/playbook.md +4 -3
- package/dist/tools-skills/superwall/workflows/dashboard/setup.md +21 -8
- package/dist/tools-skills/superwall/workflows/integrate/flutter.md +9 -7
- package/dist/tools-skills/superwall/workflows/migrate/adapty.md +4 -3
- package/dist/tools-skills/superwall/workflows/migrate/playbook.md +2 -2
- package/dist/tools-skills/superwall/workflows/migrate/qonversion.md +4 -3
- package/dist/tools-skills/superwall/workflows/migrate/revenuecat.md +4 -3
- package/dist/tools-skills/superwall-editor/SKILL.md +2 -3
- package/dist/tools.d.ts +1 -1
- package/dist/tools.js +1230 -745
- package/dist/{try-CS3jLyoP.js → try-C3HW3hPZ.js} +17 -19
- package/dist/{lock-DgSx-p8Y.js → types-Dc9U_4kp.js} +86 -80
- package/dist/upgrade-Cw9jVt-r.js +348 -0
- package/dist/upgrade-DVsonzDF.js +27 -0
- package/package.json +11 -3
- package/dist/config-CGcG7GOt.js +0 -113
- package/dist/create-Du8Fx7W5.js +0 -20
- package/dist/existing-WQ3pz94o.js +0 -97
- package/dist/held-DmOhszHR.js +0 -17
- package/dist/log-C0MDCfA2.js +0 -62
- package/dist/login-D9jfRO8w.js +0 -17
- package/dist/pull-CO5HlqBe.js +0 -36
- package/dist/push-BIhGDNpL.js +0 -30
- package/dist/push-BgqTddLA.js +0 -22
- package/dist/run-B-YoyB-a.js +0 -100
- package/dist/scan-BU41gcQY.js +0 -4
- package/dist/screenshot-file-XAS0Xy0e.js +0 -16
- package/dist/server-BemmM1FV.js +0 -29
- package/dist/session-4aITGsF1.js +0 -6
- package/dist/setup-m94dpT3t.js +0 -217
- package/dist/spawn-DmmmHIP-.js +0 -71
- package/dist/storage-pR0Wb0d9.js +0 -41
- package/dist/storekit-BMxyYAHj.js +0 -17
- package/dist/storekit-CQnwlpKV.js +0 -47
- package/dist/telemetry-DU56L7Cy.js +0 -56
- package/dist/theme-DUsCh-Vd.js +0 -25
- package/dist/token-BbUeExGJ.js +0 -70
- package/dist/upgrade-CKn88PZD.js +0 -206
- package/dist/upgrade-DfD3-ClG.js +0 -7
- /package/dist/{browser-Bp3yRKlU.js → browser-BVjaf98V.js} +0 -0
- /package/dist/{client-BJQXl62Q.js → client-BwYhzITp.js} +0 -0
- /package/dist/{design-lint-CiFc78aM.js → design-lint-mgO-2SGS.js} +0 -0
- /package/dist/{devtools-ByZ6XYnn.js → devtools-B6Vp6HMy.js} +0 -0
- /package/dist/{input-MDd67UIp.js → input-DOT_2Zvb.js} +0 -0
- /package/dist/{project-NoMtbMyl.js → project-BomArwSj.js} +0 -0
- /package/dist/{reports-HYVp169R.js → reports-hbxsd3Zo.js} +0 -0
- /package/dist/{storage-Bdz5AmqS.d.ts → storage-Bh3wT1Rn.d.ts} +0 -0
- /package/dist/{timing-Ca0TXY-A.js → timing-BKEEIBij.js} +0 -0
- /package/dist/{ui-D_qf3Gvw.js → ui-hFgji1e8.js} +0 -0
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
# CLI Reference
|
|
2
2
|
|
|
3
3
|
CLI commands use the installed `superwall` binary. The user installs it once
|
|
4
|
-
with `npm install --global superwall`; agents must not
|
|
5
|
-
|
|
4
|
+
with `npm install --global superwall`; agents must not install or upgrade it on
|
|
5
|
+
their own. The one exception is the upgrade prompt the CLI prints on stderr
|
|
6
|
+
(`Update available X → Y · run <command>`, or a `Major update available`
|
|
7
|
+
block): see SKILL.md › When the CLI prints an upgrade prompt. Use `superwall login` once for device-flow OAuth. The saved session
|
|
6
8
|
lives in `~/.superwall`.
|
|
7
9
|
|
|
8
10
|
```bash
|
|
@@ -98,8 +100,19 @@ superwall apps update <app> --bundle-id com.acme.app --json # warns when repor
|
|
|
98
100
|
superwall apps update <app> --revenue-provider open_revenue --json # a person's decision; needs --yes outside a terminal
|
|
99
101
|
superwall campaigns placements create <campaignId> --event-name paywall_trigger --json
|
|
100
102
|
superwall campaigns audiences readout <campaignId> <audienceId> --json
|
|
103
|
+
superwall campaigns audiences reorder <campaignId> -d 'audience_ids:=[<audienceId>,<audienceId>]' --json # match order; existing users may switch audience
|
|
104
|
+
superwall campaigns variants weights <campaignId> <audienceId> -d 'weights:=[{"variant_id":"<variantId>","percentage":100}]' --json
|
|
101
105
|
```
|
|
102
106
|
|
|
107
|
+
`campaigns variants weights` replaces all of an audience's treatment-variant
|
|
108
|
+
weights in one call. Every treatment must be in `weights`, each `percentage` a
|
|
109
|
+
whole number; the holdout, if any, is auto-balanced to 100 minus their sum. It
|
|
110
|
+
changes live traffic. To move a treatment to 100%, send this one call instead
|
|
111
|
+
of patching each variant's percentage in turn, which takes several calls in the
|
|
112
|
+
right order (holdout to 0 first) and leaves the split half-changed in between.
|
|
113
|
+
`campaigns audiences reorder` sets the order audiences are matched in; pass
|
|
114
|
+
every audience id, first match first.
|
|
115
|
+
|
|
103
116
|
There is no `projects` command: `apps list` nests apps under their projects,
|
|
104
117
|
and `--project <id>` only narrows `--app`.
|
|
105
118
|
|
|
@@ -147,6 +160,17 @@ superwall products create --identifier com.acme.pro.monthly \
|
|
|
147
160
|
# id from `superwall entitlements list --json`; run `superwall upgrade` once a
|
|
148
161
|
# newer CLI is out.
|
|
149
162
|
|
|
163
|
+
# --price is in the currency's main unit (9.99 USD, 1200 JPY); the CLI sends the
|
|
164
|
+
# API whole minor units (999, 1200). A raw `superwall post /v2/products` takes
|
|
165
|
+
# `price[amount]` in minor units already: 'price[amount]:=999', never 9.99.
|
|
166
|
+
|
|
167
|
+
# Custom store products: --app takes the custom store's id or name, or
|
|
168
|
+
# --store custom uses the project's default custom store. CLI 2.5.2 and older
|
|
169
|
+
# can't find a custom store by --app; there, post /v2/products with
|
|
170
|
+
# -d store=custom -d application_id=<store id>.
|
|
171
|
+
superwall products create --identifier pro_monthly --app <custom store id> \
|
|
172
|
+
--price 9.99 --period month --json
|
|
173
|
+
|
|
150
174
|
# Campaigns: a description and the placement that triggers it
|
|
151
175
|
superwall campaigns create --description "Onboarding paywall" --placement onboarding_complete --project <id> --app <id> --json
|
|
152
176
|
|
|
@@ -164,6 +188,13 @@ for you.
|
|
|
164
188
|
superwall products storekit --project <id> [--out Superwall.storekit] --json
|
|
165
189
|
```
|
|
166
190
|
|
|
191
|
+
`--json` answers `{ path, products, skipped: [{ id, identifier, reason }] }`:
|
|
192
|
+
`products` is how many were written, `id` is the Superwall product id, and
|
|
193
|
+
`reason` is `other_store`, `no_price` or `no_identifier`. Price a `no_price`
|
|
194
|
+
product with
|
|
195
|
+
`superwall products update <id> --price '{"amount":<minor units>,"currency":"USD"}'`
|
|
196
|
+
(the warning prints that command for each one), then export again.
|
|
197
|
+
|
|
167
198
|
## App Store Connect
|
|
168
199
|
|
|
169
200
|
Superwall proxies the App Store Connect API with a signed request - no `.p8`
|
|
@@ -237,29 +268,36 @@ and releases (versions, builds, metadata, release), see the
|
|
|
237
268
|
|
|
238
269
|
## Apple Search Ads
|
|
239
270
|
|
|
240
|
-
Superwall proxies the Apple Ads
|
|
241
|
-
connected in the dashboard (app → Integrations → Apple Search
|
|
242
|
-
Nothing is stored locally; the CLI picks the connected iOS app
|
|
243
|
-
`--app <id>`:
|
|
271
|
+
Superwall proxies the Apple Ads Platform API v1 (`api.ads.apple.com/v1`) with
|
|
272
|
+
the credentials connected in the dashboard (app → Integrations → Apple Search
|
|
273
|
+
Ads → Advanced). Nothing is stored locally; the CLI picks the connected iOS app
|
|
274
|
+
itself, or takes `--app <id>`:
|
|
244
275
|
|
|
245
276
|
```bash
|
|
246
|
-
superwall asa keys --json
|
|
277
|
+
superwall asa keys list --json # which apps are connected
|
|
247
278
|
|
|
248
|
-
# Resources: asa <resource> <action> [id]
|
|
279
|
+
# Resources: asa <resource> <action> [id]. Resources are top level; on lists,
|
|
280
|
+
# --campaign / --adgroup / --adam-id are filters.
|
|
249
281
|
superwall asa campaigns list --json
|
|
250
282
|
superwall asa campaigns get <id> --json
|
|
251
|
-
superwall asa campaigns
|
|
283
|
+
superwall asa campaigns list --field status --op EQUALS --values ENABLED --order-by name:asc --all --json
|
|
252
284
|
superwall asa adgroups list --campaign <id> --json
|
|
253
|
-
superwall asa keywords list --
|
|
285
|
+
superwall asa keywords list --adgroup <id> --all --json
|
|
286
|
+
superwall asa keywords update <id>,<id> --status PAUSED --json # ids only, no --campaign/--adgroup
|
|
254
287
|
superwall asa reports campaigns --start 2025-01-01 --end 2025-01-31 --json
|
|
255
288
|
|
|
256
|
-
#
|
|
257
|
-
superwall asa
|
|
258
|
-
|
|
259
|
-
|
|
289
|
+
# Full QueryRequest: filters, sorting, pagination {offset, pageSize}
|
|
290
|
+
superwall asa campaigns list --query '{"filters":[{"field":"status","operator":"EQUALS","value":"ENABLED"}],"pagination":{"offset":0,"pageSize":100}}' --json
|
|
291
|
+
|
|
292
|
+
# Raw API - a verb + path, or just a path (defaults to GET). /v1 is added;
|
|
293
|
+
# a path starting with /v1 or /api/ passes through as written.
|
|
294
|
+
superwall asa get /campaigns/<id> --json
|
|
295
|
+
superwall asa /me --json
|
|
296
|
+
superwall asa post /campaigns/query --body '{"filters":[]}' --json
|
|
260
297
|
|
|
261
|
-
# Several
|
|
262
|
-
|
|
298
|
+
# Several ad accounts behind one API user (sends X-AP-Context: adAccountId=).
|
|
299
|
+
# Without it the only account the key reaches is used; with several, it asks.
|
|
300
|
+
superwall asa campaigns list --ad-account-id <adAccountId> --json
|
|
263
301
|
```
|
|
264
302
|
|
|
265
303
|
### Request schema & docs — do this before every write
|
|
@@ -271,14 +309,15 @@ superwall asa docs campaigns create # Apple's own page: fields, enums, e
|
|
|
271
309
|
```
|
|
272
310
|
|
|
273
311
|
Writes take typed flags (money flags resolve the account's currency from
|
|
274
|
-
`/acls`, or pass `--currency`), `-d key=value` / `key:=json` for any other
|
|
312
|
+
the ad account in `/v1/acls`, or pass `--currency`), `-d key=value` / `key:=json` for any other
|
|
275
313
|
field, or `--body <json|@file|@->` for the whole payload:
|
|
276
314
|
|
|
277
315
|
```bash
|
|
278
316
|
superwall asa campaigns create --name "Launch" --adam-id <adamId> --countries US,CA \
|
|
279
|
-
--daily-budget 50 --supply-sources
|
|
280
|
-
|
|
281
|
-
superwall asa keywords
|
|
317
|
+
--daily-budget 50 --supply-sources APPSTORE --supply-placements APPSTORE_SEARCH_RESULTS \
|
|
318
|
+
--billing-event TAPS --bid-strategy MANUAL_CPT --bid-goal TAP --json
|
|
319
|
+
superwall asa keywords update <id> --bid 2 --json
|
|
320
|
+
superwall asa keywords delete <id,id,id> --json
|
|
282
321
|
```
|
|
283
322
|
|
|
284
323
|
Apple's validation errors come back as `Apple Search Ads rejected …` with each
|
|
@@ -316,12 +355,17 @@ superwall get /v2/products -d project_id=25607 --json
|
|
|
316
355
|
superwall get /v2/campaigns -d project_id=25607 -d limit=10 --json
|
|
317
356
|
superwall post /v2/entitlements -d project_id=25607 -d identifier=pro --json
|
|
318
357
|
superwall patch /v2/projects/25607 -d name=Renamed --json
|
|
358
|
+
superwall put /v2/campaigns/<id>/audiences/<audience_id>/weights -d 'weights:=[{"variant_id":"<variant_id>","percentage":100}]' --json # put needs a CLI newer than 2.5.2
|
|
319
359
|
superwall delete /v2/... --json # careful
|
|
320
360
|
|
|
321
361
|
# -d key=value sends a string; key:=value sends typed JSON; nesting via key[sub]
|
|
322
362
|
superwall post /v2/products -d 'price[amount]:=4999' -d 'price[currency]=USD' --json
|
|
323
363
|
```
|
|
324
364
|
|
|
365
|
+
The `put` above is the raw form of `campaigns variants weights`, which works on
|
|
366
|
+
CLI 2.5.2 too; the raw `put` verb needs a CLI newer than 2.5.2 (older ones
|
|
367
|
+
answer `Unknown command`). Prefer the resource command.
|
|
368
|
+
|
|
325
369
|
Raw paths need explicit scope params (`project_id`, ...) - the nicely-named
|
|
326
370
|
resource commands above resolve scope for you; the verbs do not.
|
|
327
371
|
|
|
@@ -376,7 +420,8 @@ tables, query patterns, and performance guardrails.
|
|
|
376
420
|
```bash
|
|
377
421
|
superwall doctor --json # health-check the integration
|
|
378
422
|
superwall skills # install the Superwall agent skills into your agent
|
|
379
|
-
superwall upgrade # update the CLI to the latest version
|
|
423
|
+
superwall upgrade # update the CLI to the latest version (betas: the newest `next`)
|
|
424
|
+
# run it when the upgrade prompt says so; ask the user first for a major
|
|
380
425
|
superwall feedback "..." --title "..." --kind bug --use-case "..." --file log.txt --json
|
|
381
426
|
# report a bug, wrong doc or missing capability to the Superwall team,
|
|
382
427
|
# without asking; duplicates are merged (see SKILL.md › Feedback)
|
|
@@ -1,11 +1,12 @@
|
|
|
1
|
-
# Apple Search Ads — the
|
|
1
|
+
# Apple Search Ads — the Apple Ads Platform API via Superwall's proxy
|
|
2
2
|
|
|
3
|
-
`superwall asa` proxies the **
|
|
4
|
-
(`api.
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
reports
|
|
3
|
+
`superwall asa` proxies the **Apple Ads Platform API v1**
|
|
4
|
+
(`api.ads.apple.com/v1`), which replaced the Campaign Management API v5 (Apple
|
|
5
|
+
shuts v5 off on 2027-01-26). Superwall holds the credentials connected in the
|
|
6
|
+
dashboard, mints the client secret, exchanges it for an access token, and adds
|
|
7
|
+
the `X-AP-Context` header — nothing to manage locally. This lets an agent read
|
|
8
|
+
and manage campaigns, ad groups, keywords, ads, creatives, budgets and reports
|
|
9
|
+
directly.
|
|
9
10
|
|
|
10
11
|
## Which app
|
|
11
12
|
|
|
@@ -21,9 +22,13 @@ Search Ads → Advanced, paste Superwall's public key into Apple's Account
|
|
|
21
22
|
Settings → API, then enter the Client ID, Team ID and Key ID. `asa keys set`
|
|
22
23
|
is deliberately not a CLI command (Superwall generates the key pair).
|
|
23
24
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
25
|
+
## Which ad account
|
|
26
|
+
|
|
27
|
+
Every request is scoped to one Apple Ads ad account. Pass
|
|
28
|
+
`--ad-account-id <id>` to choose it (sent as `X-AP-Context: adAccountId=<id>`;
|
|
29
|
+
`superwall asa acls --json` lists the accounts the key reaches). Without it,
|
|
30
|
+
the only ad account the key reaches is used; when it reaches several, the
|
|
31
|
+
command fails and asks for `--ad-account-id`.
|
|
27
32
|
|
|
28
33
|
## Docs access — do this before every write
|
|
29
34
|
|
|
@@ -41,89 +46,115 @@ superwall asa docs "impression" # search by keyword
|
|
|
41
46
|
## Command shape
|
|
42
47
|
|
|
43
48
|
```
|
|
44
|
-
superwall asa <resource> <action> [id]
|
|
49
|
+
superwall asa <resource> <action> [id] --json
|
|
45
50
|
```
|
|
46
51
|
|
|
52
|
+
Resources are top level, as in v1: a keyword, ad or ad group is addressed by
|
|
53
|
+
its own id, never through its campaign. On lists, `--campaign`, `--adgroup` and
|
|
54
|
+
`--adam-id` are filters, not path parts.
|
|
55
|
+
|
|
47
56
|
| Resource | Actions |
|
|
48
57
|
|---|---|
|
|
49
|
-
| `campaigns` | `list`, `get <id>`, `
|
|
50
|
-
| `adgroups` |
|
|
51
|
-
| `keywords` | `list`, `get
|
|
52
|
-
| `negative-keywords` | same;
|
|
53
|
-
| `ads` | `list`, `get
|
|
54
|
-
| `creatives` | `list`, `get
|
|
55
|
-
| `
|
|
56
|
-
| `
|
|
57
|
-
| `
|
|
58
|
-
| `
|
|
59
|
-
| `
|
|
60
|
-
| `
|
|
61
|
-
| `
|
|
62
|
-
| `
|
|
58
|
+
| `campaigns` | `list`, `get <id>`, `create`, `update <id>`, `delete <id>`, `limited-reasons <id>` |
|
|
59
|
+
| `adgroups` | `list [--campaign]`, `get <id>`, `create --campaign`, `update <id>`, `delete <id>` |
|
|
60
|
+
| `keywords` | `list [--campaign] [--adgroup]`, `get <id>`, `create --adgroup`, `update <id[,id…]>`, `delete <id[,id…]>` |
|
|
61
|
+
| `negative-keywords` | same; `create --campaign` for campaign level, add `--adgroup` for ad group level |
|
|
62
|
+
| `ads` | `list [--campaign] [--adgroup]`, `get <id>`, `create --adgroup`, `update <id>`, `delete <id>` |
|
|
63
|
+
| `creatives` | `list`, `get <id>`, `create`, `update <id>`, `delete <id>` |
|
|
64
|
+
| `assets` | `list [--adam-id]`, `get <id>`, `delete <id>` |
|
|
65
|
+
| `product-pages` | `list --adam-id`, `get <id>`, `locales <id>` |
|
|
66
|
+
| `ad-rejections` | `list [--adam-id]`, `get <id>` |
|
|
67
|
+
| `reports` | `campaigns`, `adgroups`, `keywords`, `searchterms`, `ads` (`--start --end`; all but `campaigns` need `--campaign`) |
|
|
68
|
+
| `brand-reports` | the same five, for Apple Maps (business brand) campaigns |
|
|
69
|
+
| `insights` | `impression-share`, `search-term-popularity` |
|
|
70
|
+
| `apps` | `search <query>`, `eligibility <adam-id>`, `get <adam-id>`, `localized <adam-id>`, `languages` |
|
|
71
|
+
| `geo` | `search <query>`, `get <id[,id…]> --entity <Country\|AdminArea\|Locality>` |
|
|
72
|
+
| `budget-orders` | `list`, `get <id>`, `create`, `update <id>`, `delete <id>` |
|
|
73
|
+
| `recommendations` | `target-cpas`, `daily-budgets`, and `apply-…` / `dismiss-…` for each |
|
|
74
|
+
| `suggestions` | `keywords`, `phrases`, `categories`, `target-cpa` |
|
|
75
|
+
| `change-history` | `list`, `get <id>` |
|
|
76
|
+
| `brands` | `list`, `get <id>`, `categories`, `category <id>`, `rejections` |
|
|
77
|
+
| `ad-accounts` | `get <id>`, `create`, `update <id>`, `resources` |
|
|
78
|
+
| `orgs`, `acls`, `me` | the organization, the ad accounts the key reaches, the API user |
|
|
63
79
|
|
|
64
80
|
Raw escape hatch for anything else: `superwall asa get|post|put|delete /path
|
|
65
|
-
[-d k=v] [--body json]`, or `superwall asa /path` (GET). `/
|
|
81
|
+
[-d k=v] [--body json]`, or `superwall asa /path` (GET). `/v1` is added to the
|
|
82
|
+
path; a path that already starts with `/v1` or `/api/` is sent as written.
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
superwall asa /me --json
|
|
86
|
+
superwall asa post /campaigns/query --body '{"filters":[]}' --json
|
|
87
|
+
```
|
|
66
88
|
|
|
67
89
|
## Reading
|
|
68
90
|
|
|
91
|
+
Every list is a `POST …/query` with Apple's QueryRequest (`filters`,
|
|
92
|
+
`sorting`, `pagination { offset, pageSize }`). Build it with the one-filter
|
|
93
|
+
shorthand `--field/--op/--values`, sort with `--order-by field[:asc|desc]`,
|
|
94
|
+
page with `--limit`/`--offset`, or pass the whole request with
|
|
95
|
+
`--query <json|@file|@->`. Shorthand, scope flags and `--query` filters are
|
|
96
|
+
combined. `--all` walks every page until Apple's `totalCount`; the output is
|
|
97
|
+
`{ result: [...], pagination }` like a single page.
|
|
98
|
+
|
|
69
99
|
```bash
|
|
70
100
|
superwall asa campaigns list --limit 50 --json
|
|
71
101
|
superwall asa campaigns list --all --json # walks every page
|
|
72
|
-
superwall asa campaigns
|
|
73
|
-
superwall asa campaigns
|
|
74
|
-
superwall asa campaigns get <id> --
|
|
75
|
-
superwall asa
|
|
102
|
+
superwall asa campaigns list --field status --op EQUALS --values ENABLED --order-by name:desc --json
|
|
103
|
+
superwall asa campaigns list --query '{"filters":[{"field":"name","operator":"STARTS_WITH","value":"US"}],"sorting":[{"field":"name","order":"ASC"}]}' --all --json
|
|
104
|
+
superwall asa campaigns get <id> --json
|
|
105
|
+
superwall asa adgroups list --campaign <id> --json
|
|
106
|
+
superwall asa keywords list --adgroup <id> --field matchType --op EQUALS --values EXACT --all --json
|
|
76
107
|
```
|
|
77
108
|
|
|
78
|
-
`
|
|
79
|
-
|
|
80
|
-
`--order-by field[:asc|desc]`, `--fields`, `--limit`, `--offset`. `--all` pages
|
|
81
|
-
until Apple's `totalResults` is reached; the output is `{ data: [...],
|
|
82
|
-
pagination }` like a single page.
|
|
109
|
+
`asa docs <resource> list` links Apple's page, which lists the fields each
|
|
110
|
+
query can filter and sort on, with their operators.
|
|
83
111
|
|
|
84
112
|
## Writing
|
|
85
113
|
|
|
86
|
-
Before writes, confirm the exact account, campaign and ad group. Changes to
|
|
114
|
+
Before writes, confirm the exact ad account, campaign and ad group. Changes to
|
|
87
115
|
budgets, bids, billing or enabled campaigns can spend money: show the proposed
|
|
88
116
|
change, currency and spending limit and obtain specific user approval. Ask for
|
|
89
117
|
specific approval before deletions or access changes. Examples below are not
|
|
90
118
|
permission to execute those actions.
|
|
91
119
|
|
|
92
120
|
Typed flags map to Apple's field names (`asa docs <resource>` shows the
|
|
93
|
-
mapping
|
|
94
|
-
`--
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
`--body`.
|
|
121
|
+
mapping, including nested ones such as `--daily-budget` → `dailyBudget.value`).
|
|
122
|
+
Money flags (`--daily-budget`, `--bid`, `--amount`) become
|
|
123
|
+
`{ amount, currency }`; the currency comes from `--currency` or the ad
|
|
124
|
+
account's `/acls` entry. Anything else goes through `-d key=value`
|
|
125
|
+
(`key:=value` for numbers/booleans/JSON, `key[sub]` nesting) or `--body`.
|
|
126
|
+
Campaign and budget order creates take the ad account id from
|
|
127
|
+
`--ad-account-id`, or the only account the key reaches.
|
|
98
128
|
|
|
99
129
|
```bash
|
|
100
|
-
# Campaign
|
|
130
|
+
# Campaign
|
|
101
131
|
superwall asa campaigns create --name "Launch" --adam-id <adamId> --countries US,CA \
|
|
102
|
-
--daily-budget 50 --supply-sources
|
|
103
|
-
--billing-event TAPS --json
|
|
132
|
+
--daily-budget 50 --supply-sources APPSTORE --supply-placements APPSTORE_SEARCH_RESULTS \
|
|
133
|
+
--billing-event TAPS --bid-strategy MANUAL_CPT --bid-goal TAP --json
|
|
104
134
|
|
|
105
135
|
# Pause it
|
|
106
136
|
superwall asa campaigns update <id> --status PAUSED --json
|
|
107
137
|
|
|
108
|
-
# Ad group
|
|
109
|
-
superwall asa adgroups create --campaign <id> --name "Exact match" --
|
|
138
|
+
# Ad group (--bid is the default bid)
|
|
139
|
+
superwall asa adgroups create --campaign <id> --name "Exact match" --pricing-model CPT --bid 1.50 \
|
|
110
140
|
--start 2025-06-01T00:00:00.000 --search-match=false --json
|
|
111
141
|
|
|
112
|
-
# Keywords
|
|
113
|
-
superwall asa keywords create --
|
|
114
|
-
superwall asa keywords create
|
|
115
|
-
--body '[{"text":"grammar","matchType":"BROAD",
|
|
116
|
-
superwall asa keywords update <id> --
|
|
117
|
-
superwall asa keywords
|
|
118
|
-
superwall asa keywords delete <id
|
|
142
|
+
# Keywords: one from flags, or many from --body (sent to bulk-create as items)
|
|
143
|
+
superwall asa keywords create --adgroup <id> --text "grammar checker" --match-type EXACT --bid 1.25 --json
|
|
144
|
+
superwall asa keywords create \
|
|
145
|
+
--body '[{"adGroupId":<id>,"text":"grammar","matchType":"BROAD"},{"adGroupId":<id>,"text":"spell check","matchType":"EXACT"}]' --json
|
|
146
|
+
superwall asa keywords update <id> --bid 2 --json # one → PUT /keywords/{id}
|
|
147
|
+
superwall asa keywords update <id,id> --status PAUSED --json # several → bulk-update
|
|
148
|
+
superwall asa keywords delete <id> --json # one → DELETE
|
|
149
|
+
superwall asa keywords delete <id,id,id> --json # several → bulk-delete
|
|
119
150
|
|
|
120
151
|
# Negative keywords: campaign level, or ad group level with --adgroup
|
|
121
152
|
superwall asa negative-keywords create --campaign <id> --text free --match-type BROAD --json
|
|
122
|
-
superwall asa negative-keywords create --campaign <id> --adgroup <id> --text free --json
|
|
153
|
+
superwall asa negative-keywords create --campaign <id> --adgroup <id> --text free --match-type BROAD --json
|
|
123
154
|
|
|
124
155
|
# Creative + ad (custom product page)
|
|
125
156
|
superwall asa creatives create --adam-id <adamId> --type CUSTOM_PRODUCT_PAGE --product-page-id <ppId> --name "Holiday" --json
|
|
126
|
-
superwall asa ads create --
|
|
157
|
+
superwall asa ads create --adgroup <id> --creative-id <creativeId> --name "Holiday ad" --json
|
|
127
158
|
```
|
|
128
159
|
|
|
129
160
|
Apple's validation failures come back as
|
|
@@ -136,20 +167,21 @@ Read the field, fix the flag, retry.
|
|
|
136
167
|
superwall asa reports campaigns --start 2025-01-01 --end 2025-01-31 --json
|
|
137
168
|
superwall asa reports campaigns --start 2025-01-01 --end 2025-01-31 --granularity WEEKLY --group-by countryOrRegion --json
|
|
138
169
|
superwall asa reports adgroups --campaign <id> --start 2025-01-01 --end 2025-01-31 --json
|
|
139
|
-
superwall asa reports keywords --campaign <id>
|
|
170
|
+
superwall asa reports keywords --campaign <id> --adgroup <id> --start 2025-01-01 --end 2025-01-31 --json
|
|
140
171
|
superwall asa reports searchterms --campaign <id> --start 2025-01-01 --end 2025-01-31 --json
|
|
141
172
|
superwall asa reports ads --campaign <id> --start 2025-01-01 --end 2025-01-31 --json
|
|
173
|
+
superwall asa brand-reports campaigns --start 2025-01-01 --end 2025-01-31 --json # Apple Maps
|
|
142
174
|
```
|
|
143
175
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
176
|
+
Reports send a `timeRange` (`start`, `end`, `granularity`, `timeZone`):
|
|
177
|
+
granularity defaults to `DAILY` and the time zone to `UTC` (`--time-zone ORTZ`
|
|
178
|
+
uses the account's). Filters, `--order-by` and `--query` work as on lists.
|
|
179
|
+
|
|
180
|
+
Insights are queries too, answered right away:
|
|
148
181
|
|
|
149
182
|
```bash
|
|
150
|
-
superwall asa impression-share
|
|
151
|
-
|
|
152
|
-
superwall asa impression-share get <id> --json # downloadUri once state is COMPLETED
|
|
183
|
+
superwall asa insights impression-share --adam-id <adamId> --start 2025-01-01 --end 2025-01-07 --json
|
|
184
|
+
superwall asa insights search-term-popularity --start 2025-01-01 --end 2025-01-07 --json
|
|
153
185
|
```
|
|
154
186
|
|
|
155
187
|
## Discovery
|
|
@@ -160,7 +192,20 @@ superwall asa apps eligibility <adamId> --json
|
|
|
160
192
|
superwall asa product-pages list --adam-id <adamId> --json
|
|
161
193
|
superwall asa geo search "New York" --entity Locality --json
|
|
162
194
|
superwall asa geo get "US|CA|Cupertino" --entity Locality --json
|
|
163
|
-
superwall asa
|
|
195
|
+
superwall asa suggestions keywords --adam-id <adamId> --json
|
|
196
|
+
superwall asa recommendations daily-budgets --json
|
|
197
|
+
superwall asa change-history list --json
|
|
164
198
|
superwall asa acls --json
|
|
165
199
|
superwall asa me --json
|
|
166
200
|
```
|
|
201
|
+
|
|
202
|
+
## Not on v1
|
|
203
|
+
|
|
204
|
+
These v5 commands have no Platform API equivalent and are gone:
|
|
205
|
+
ad-group-level negative keyword search, `product-pages countries` and
|
|
206
|
+
`device-sizes`. There is no `find` action: every `list` takes the filters, a
|
|
207
|
+
full query goes in `--query`, and the ad account is `--ad-account-id`.
|
|
208
|
+
`impression-share` moved to
|
|
209
|
+
`insights impression-share` (synchronous now) and `ad-rejections assets` to
|
|
210
|
+
`assets list`. Asset upload (`POST /v1/assets/upload`) takes form data, which
|
|
211
|
+
the proxy doesn't pass, so it isn't available.
|
|
@@ -1,57 +1,94 @@
|
|
|
1
1
|
# Dashboard Links
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
When you don't know the applicationId, use the `select-application` redirect - the user picks their app, then lands on the target page:
|
|
3
|
+
The dashboard lives at `https://app.superwall.com`. Every page of an app is
|
|
4
|
+
under its organization and application:
|
|
6
5
|
|
|
7
6
|
```
|
|
8
|
-
https://superwall.com/
|
|
7
|
+
https://app.superwall.com/{orgId}/{applicationId}/{page}
|
|
9
8
|
```
|
|
10
9
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
| API Keys | `https://superwall.com/select-application?pathname=/applications/:app/settings/api-keys` |
|
|
15
|
-
| Integrations | `https://superwall.com/select-application?pathname=/applications/:app/integrations` |
|
|
16
|
-
| Users | `https://superwall.com/select-application?pathname=/applications/:app/users/v2` |
|
|
17
|
-
| Surveys | `https://superwall.com/select-application?pathname=/applications/:app/surveys` |
|
|
18
|
-
| Products | `https://superwall.com/select-application?pathname=/applications/:app/products/v2` |
|
|
19
|
-
| Demand Score | `https://superwall.com/select-application?pathname=/applications/:app/demand-score` |
|
|
20
|
-
| Charts | `https://superwall.com/select-application?pathname=/applications/:app/charts/v2` |
|
|
21
|
-
| Campaigns | `https://superwall.com/select-application?pathname=/applications/:app/rules` |
|
|
22
|
-
| Paywalls | `https://superwall.com/select-application?pathname=/applications/:app/paywalls` |
|
|
23
|
-
| Templates | `https://superwall.com/select-application?pathname=/applications/:app/templates` |
|
|
10
|
+
The old `superwall.com` dashboard pages (`/applications/{applicationId}/…`
|
|
11
|
+
and the `/select-application?pathname=…` redirect) are the legacy
|
|
12
|
+
dashboard. Do not give them.
|
|
24
13
|
|
|
25
|
-
##
|
|
14
|
+
## Finding the ids
|
|
26
15
|
|
|
27
|
-
|
|
16
|
+
- **applicationId**: `superwall.lock` (`apps.<platform>`) in a framework
|
|
17
|
+
project, or `applications[].id` in `GET /v2/projects`.
|
|
18
|
+
- **orgId**: `organization_id` of the project that holds the app, in
|
|
19
|
+
`GET /v2/projects`. A dashboard link the user pasted carries both:
|
|
20
|
+
`https://app.superwall.com/{orgId}/{applicationId}/…`.
|
|
21
|
+
- **paywallId**: `superwall.lock` (`paywalls.<name>.<platform>.paywallId`) in
|
|
22
|
+
a framework project, or `id` in `GET /v2/paywalls`.
|
|
23
|
+
|
|
24
|
+
When you can't find the ids, link the organization picker; the user picks
|
|
25
|
+
their organization and app, then opens the page from the sidebar:
|
|
28
26
|
|
|
29
27
|
```
|
|
30
|
-
https://superwall.com/
|
|
28
|
+
https://app.superwall.com/select-organization
|
|
31
29
|
```
|
|
32
30
|
|
|
33
|
-
|
|
31
|
+
## Pages
|
|
32
|
+
|
|
33
|
+
| Page | Path after `/{orgId}/{applicationId}` |
|
|
34
|
+
|------|-----|
|
|
35
|
+
| Paywalls | `/paywalls` |
|
|
36
|
+
| Design system | `/paywalls/design-system` |
|
|
37
|
+
| Templates (where a new paywall starts) | `/templates` |
|
|
38
|
+
| Campaigns | `/campaigns` |
|
|
39
|
+
| One campaign | `/campaigns/{campaignId}` |
|
|
40
|
+
| Products | `/products` |
|
|
41
|
+
| Charts | `/charts` |
|
|
42
|
+
| Users | `/users` |
|
|
43
|
+
| Surveys | `/surveys` |
|
|
44
|
+
| Demand Score | `/demand-score` |
|
|
45
|
+
| Integrations | `/integrations` |
|
|
46
|
+
| Settings | `/settings` |
|
|
47
|
+
| API Keys | `/settings/api-keys` |
|
|
48
|
+
|
|
49
|
+
Example: `https://app.superwall.com/1203/40581/settings/api-keys`.
|
|
34
50
|
|
|
35
51
|
## Deep-linking to a specific paywall
|
|
36
52
|
|
|
37
|
-
|
|
53
|
+
The link depends on how the paywall was built. A paywall row from
|
|
54
|
+
`GET /v2/paywalls` says so in `headless`.
|
|
55
|
+
|
|
56
|
+
**Built with the framework (code-first, `headless: true`)**: its studio.
|
|
38
57
|
|
|
39
58
|
```
|
|
40
|
-
https://superwall.com/
|
|
59
|
+
https://app.superwall.com/{orgId}/{applicationId}/paywalls/{paywallId}/studio
|
|
41
60
|
```
|
|
42
61
|
|
|
43
|
-
|
|
62
|
+
Give this link whenever you push, promote or publish a framework paywall,
|
|
63
|
+
and whenever the user asks where to see one.
|
|
64
|
+
|
|
65
|
+
**A new code-first paywall** (the builder, before any push):
|
|
44
66
|
|
|
45
67
|
```
|
|
46
|
-
https://superwall.com/
|
|
68
|
+
https://app.superwall.com/{orgId}/{applicationId}/paywalls/new/studio
|
|
47
69
|
```
|
|
48
70
|
|
|
49
|
-
|
|
71
|
+
**Built in the visual editor (`headless: false`)**: the legacy editor, the
|
|
72
|
+
only place those paywalls open.
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
https://superwall.com/editor/#/applications/{applicationId}/paywalls/{paywallId}/latest
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Never give a code-first paywall the editor link; it cannot edit one. When
|
|
79
|
+
you can't tell the kind, link the paywalls page,
|
|
80
|
+
`https://app.superwall.com/{orgId}/{applicationId}/paywalls`, which opens
|
|
81
|
+
each paywall the right way.
|
|
50
82
|
|
|
51
83
|
## Deep-linking to a specific user
|
|
52
84
|
|
|
53
85
|
```
|
|
54
|
-
https://superwall.com/
|
|
86
|
+
https://app.superwall.com/{orgId}/{applicationId}/users/{userId}
|
|
55
87
|
```
|
|
56
88
|
|
|
57
|
-
`{userId}` can be a Superwall alias (e.g. `$SuperwallAlias:31FC167B-55CF-4197-9DF2-E5200C6A2E67`) or any user identifier.
|
|
89
|
+
`{userId}` can be a Superwall alias (e.g. `$SuperwallAlias:31FC167B-55CF-4197-9DF2-E5200C6A2E67`) or any user identifier; URL-encode it.
|
|
90
|
+
|
|
91
|
+
## Staging
|
|
92
|
+
|
|
93
|
+
Superwall's own staging dashboard is `https://app.superwall.dev`, same paths.
|
|
94
|
+
Use it only when the CLI or API points at staging.
|
|
@@ -896,7 +896,7 @@ sw.applications_rep (applicationId)
|
|
|
896
896
|
|
|
897
897
|
1. Search `sw.applications_rep` by name
|
|
898
898
|
2. If multiple results, check `sw.events_hr_agg` for recent event counts
|
|
899
|
-
3. Show `applicationId` + link: `superwall.com/
|
|
899
|
+
3. Show `applicationId` + link: `https://app.superwall.com/{orgId}/{applicationId}/charts`, with `orgId` from `organization_id` in `GET /v2/projects` ([dashboard-links.md](dashboard-links.md))
|
|
900
900
|
|
|
901
901
|
```sql
|
|
902
902
|
SELECT applicationId, name, platform
|
|
@@ -52,12 +52,16 @@ superwall asc iaps list com.app.bundle --json # one-time / non-renew
|
|
|
52
52
|
superwall asc products com.app.bundle --json # everything
|
|
53
53
|
superwall asc apps --json # list ASC apps if unsure of the id
|
|
54
54
|
|
|
55
|
-
# create each returned productId, granting your entitlement
|
|
56
|
-
superwall products create --identifier com.app.pro.yearly --
|
|
55
|
+
# create each returned productId with its price, period and trial, granting your entitlement
|
|
56
|
+
superwall products create --identifier com.app.pro.yearly --price 24.99 --period year \
|
|
57
|
+
--trial-days 7 --entitlement pro --app <id> --json
|
|
57
58
|
```
|
|
58
59
|
|
|
59
|
-
|
|
60
|
-
|
|
60
|
+
Take the price, period and trial from the ASC listing. `--price` is in major units (24.99),
|
|
61
|
+
`--currency` defaults to USD, `--period` is `day`, `week`, `month` or `year`, and
|
|
62
|
+
`--period-count` defaults to 1; leave out `--period` and `--trial-days` for a one-time product.
|
|
63
|
+
A product created without `--price` is left out of the `.storekit` export below, which writes
|
|
64
|
+
what Superwall holds.
|
|
61
65
|
|
|
62
66
|
### Generate a local `.storekit` file (for Xcode testing without sandbox)
|
|
63
67
|
|
|
@@ -65,7 +69,13 @@ the stores remain the source of truth for pricing.
|
|
|
65
69
|
superwall products storekit --project <id> --out Superwall.storekit --json
|
|
66
70
|
```
|
|
67
71
|
|
|
68
|
-
|
|
72
|
+
Writes each App Store product with its Superwall price, read in its currency's minor units
|
|
73
|
+
(399 USD is 3.99). Auto-renewable subscriptions go in one `Subscriptions` group with their
|
|
74
|
+
period, and their free or paid trial as the introductory offer; one-time products are written
|
|
75
|
+
as NonConsumable. Products of another store (Play, Stripe, custom), with no price, or with no
|
|
76
|
+
identifier are left out and named in a warning. Price one with
|
|
77
|
+
`superwall products update <id> --price '{"amount":<minor units>,"currency":"USD"}'`, where
|
|
78
|
+
`<id>` is its Superwall product id, then export again.
|
|
69
79
|
|
|
70
80
|
## Entitlements
|
|
71
81
|
|
|
@@ -104,15 +104,17 @@ plugins { id 'com.android.application' version '8.4.1' apply false }
|
|
|
104
104
|
distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
> **Important:**
|
|
108
|
-
> `
|
|
107
|
+
> **Important:** Do not declare `SuperwallPaywallActivity` in the app's
|
|
108
|
+
> `AndroidManifest.xml`. The `superwallkit_flutter` plugin's manifest already
|
|
109
|
+
> declares it, and a second declaration with a different theme fails the
|
|
110
|
+
> manifest merge (`Attribute activity#...SuperwallPaywallActivity@theme ... is
|
|
111
|
+
> also present at [:superwallkit_flutter]`). If the app already has one, remove
|
|
112
|
+
> it, or keep it only with `tools:replace="android:theme"`.
|
|
113
|
+
|
|
114
|
+
Optionally, add the debug activities inside the `<application>` tag of
|
|
115
|
+
`android/app/src/main/AndroidManifest.xml`:
|
|
109
116
|
|
|
110
117
|
```xml
|
|
111
|
-
<activity
|
|
112
|
-
android:name="com.superwall.sdk.paywall.view.SuperwallPaywallActivity"
|
|
113
|
-
android:theme="@style/Theme.MaterialComponents.DayNight.NoActionBar"
|
|
114
|
-
android:configChanges="orientation|screenSize|keyboardHidden">
|
|
115
|
-
</activity>
|
|
116
118
|
<activity android:name="com.superwall.sdk.debug.DebugViewActivity" />
|
|
117
119
|
<activity android:name="com.superwall.sdk.debug.localizations.SWLocalizationActivity" />
|
|
118
120
|
<activity android:name="com.superwall.sdk.debug.SWConsoleActivity" />
|