{ "schema": 1, "cli_version": "1.9.77", "global_flags": [ { "name": "csv", "type": "bool", "default": "false", "usage": "Output as CSV instead of tables", "required": false }, { "name": "fields", "type": "string", "default": "", "usage": "Comma-separated columns to show, in order", "required": false }, { "name": "group", "type": "string", "default": "", "usage": "Use a tag group of profiles for multi-profile commands", "required": false }, { "name": "json", "type": "bool", "default": "false", "usage": "Output pretty-printed JSON instead of tables", "required": false }, { "name": "ndjson", "type": "bool", "default": "false", "usage": "Output newline-delimited JSON (one row per line)", "required": false }, { "name": "profile", "type": "string", "default": "", "usage": "Use a named configuration profile", "required": false }, { "name": "quiet", "shorthand": "q", "type": "bool", "default": "false", "usage": "Print only ids, one per line (for scripting)", "required": false }, { "name": "raw-headers", "type": "bool", "default": "false", "usage": "Use raw API field names as table headers", "required": false }, { "name": "staged", "type": "bool", "default": "false", "usage": "Stage writes for approval instead of executing them (server records a change id; see `p202 change`)", "required": false }, { "name": "table", "type": "bool", "default": "false", "usage": "Output tables even when an AI agent would get JSON", "required": false }, { "name": "wide", "type": "bool", "default": "false", "usage": "Show all columns at full width (no truncation)", "required": false } ], "commands": [ { "path": "p202 aff-network", "use": "aff-network", "aliases": [ "category" ], "short": "Manage categories (affiliate networks)", "runnable": false, "flags": [] }, { "path": "p202 aff-network create", "use": "create", "short": "Create a new aff-network", "example": "p202 aff-network create --aff-network-name --json", "runnable": true, "flags": [ { "name": "aff-network-name", "type": "string", "default": "", "usage": "Network name (required)", "required": true }, { "name": "dni-network-id", "type": "string", "default": "", "usage": "DNI network ID", "required": false }, { "name": "idempotency-key", "type": "string", "default": "", "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate", "required": false } ] }, { "path": "p202 aff-network delete", "use": "delete ", "short": "Delete a aff-network", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Preview what the delete would remove (record + cascade counts) without deleting", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Comma-separated aff-network IDs to delete in bulk", "required": false } ] }, { "path": "p202 aff-network get", "use": "get ", "short": "Get a aff-network by ID", "runnable": true, "flags": [] }, { "path": "p202 aff-network list", "use": "list", "short": "List categories (affiliate networks)", "runnable": true, "flags": [ { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "page", "type": "string", "default": "", "usage": "Page number", "required": false }, { "name": "resolve-names", "type": "bool", "default": "false", "usage": "Resolve foreign key IDs to names", "required": false } ], "tasks": [ { "run": "p202 aff-network list", "ui_pages": [ "Setup › Categories" ], "phrases": [ "affiliate networks", "offer categories" ] } ] }, { "path": "p202 aff-network update", "use": "update ", "short": "Update a aff-network", "example": "p202 aff-network update --aff-network-name --json\n (only the flags given are sent; the rest of the aff-network is unchanged)", "runnable": true, "flags": [ { "name": "aff-network-name", "type": "string", "default": "", "usage": "Network name", "required": false }, { "name": "dni-network-id", "type": "string", "default": "", "usage": "DNI network ID", "required": false } ] }, { "path": "p202 analytics", "use": "analytics", "short": "Query performance stats grouped by campaign, traffic source, country, etc. (shorthand for report breakdown)", "long": "Stats grouped by one dimension: the shorthand for `p202 report breakdown`.\n\nWith --split-at, compare before and after a date: each value's totals on both\nsides, the change, and the daily rate on each side, so two windows of different\nlengths compare fairly.", "example": "p202 analytics --group-by country --period last30\n p202 analytics --group-by country --split-at 2026-09-04", "runnable": true, "flags": [ { "name": "aff-campaign-id", "type": "string", "default": "", "usage": "Filter by INTERNAL campaign id (from `campaign list`), not the public id in tracking URLs", "required": false }, { "name": "aff-network-id", "type": "string", "default": "", "usage": "Filter by affiliate network ID", "required": false }, { "name": "browser-id", "type": "string", "default": "", "usage": "Filter by browser ID (the id of a `--breakdown browser` row)", "required": false }, { "name": "country-id", "type": "string", "default": "", "usage": "Filter by country ID", "required": false }, { "name": "days", "type": "int", "default": "0", "usage": "Relative window: the last N×24 hours, ending now (ignored when --period is provided; --period lastN counts whole days from a midnight)", "required": false }, { "name": "device-type", "type": "string", "default": "", "usage": "Filter by device type ID: 1 Desktop, 2 Mobile, 3 Tablet, 4 Bot (the ids of `--breakdown device_type` rows)", "required": false }, { "name": "group-by", "type": "string", "default": "", "usage": "Breakdown dimension: campaign, aff_network, ppc_account, ppc_network, landing_page, keyword, country, city, region, browser, platform, device, isp, text_ad, ip, referer, referer_url, device_type, c1, c2, c3, c4, utm_source, utm_medium, utm_campaign, utm_term, utm_content, rotator, rotator_rule (aliases: geo=country, lp=landing_page, network=aff_network, offer=campaign, referrer=referer, referrer_url=referer_url, rule=rotator_rule, source=ppc_account)", "allowed_values": [ "campaign", "aff_network", "ppc_account", "ppc_network", "landing_page", "keyword", "country", "city", "region", "browser", "platform", "device", "isp", "text_ad", "ip", "referer", "referer_url", "device_type", "c1", "c2", "c3", "c4", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content", "rotator", "rotator_rule" ], "value_aliases": { "geo": "country", "lp": "landing_page", "network": "aff_network", "offer": "campaign", "referrer": "referer", "referrer_url": "referer_url", "rule": "rotator_rule", "source": "ppc_account" }, "required": false }, { "name": "ip", "type": "string", "default": "", "usage": "Only clicks from this one IP address, IPv4 or IPv6", "required": false }, { "name": "isp-id", "type": "string", "default": "", "usage": "Filter by ISP/carrier ID (the id of a `--breakdown isp` row)", "required": false }, { "name": "keyword", "type": "string", "default": "", "usage": "Only clicks whose keyword contains this text (case-insensitive)", "required": false }, { "name": "landing-page-id", "type": "string", "default": "", "usage": "Filter by landing page ID", "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "method-of-promotion", "type": "string", "default": "", "usage": "Only direct-link clicks or only landing-page clicks: directlink, landingpage", "allowed_values": [ "directlink", "landingpage" ], "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "period", "type": "string", "default": "", "usage": "Period: today, yesterday, last7, last14, last30, last90, thismonth, lastmonth, thisyear, lastyear, alltime", "allowed_values": [ "today", "yesterday", "last7", "last14", "last30", "last90", "thismonth", "lastmonth", "thisyear", "lastyear", "alltime" ], "required": false }, { "name": "platform-id", "type": "string", "default": "", "usage": "Filter by platform (OS) ID (the id of a `--breakdown platform` row)", "required": false }, { "name": "ppc-account-id", "type": "string", "default": "", "usage": "Filter by PPC account ID", "required": false }, { "name": "ppc-network-id", "type": "string", "default": "", "usage": "Filter by PPC network ID, or none for the clicks with no traffic source", "required": false }, { "name": "referer", "type": "string", "default": "", "usage": "Only clicks whose referring URL contains this text (case-insensitive)", "required": false }, { "name": "region-id", "type": "string", "default": "", "usage": "Filter by region ID (the id of a `--breakdown region` row)", "required": false }, { "name": "show", "type": "string", "default": "", "usage": "Which clicks count (default all): all, real, filtered, filtered_bot, leads; real = not filtered, filtered_bot = filtered as bots, leads = converted", "allowed_values": [ "all", "real", "filtered", "filtered_bot", "leads" ], "required": false }, { "name": "sort", "type": "string", "default": "", "usage": "Sort by: total_clicks, total_click_throughs, total_leads, total_income, total_cost, total_net, epc, avg_cpc, conv_rate, roi, cpa, clicks_per_day, conversions_per_day, revenue_per_day (aliases: clicks=total_clicks, conversions=total_leads, cost=total_cost, profit=total_net, revenue=total_income)", "allowed_values": [ "total_clicks", "total_click_throughs", "total_leads", "total_income", "total_cost", "total_net", "epc", "avg_cpc", "conv_rate", "roi", "cpa", "clicks_per_day", "conversions_per_day", "revenue_per_day" ], "value_aliases": { "clicks": "total_clicks", "conversions": "total_leads", "cost": "total_cost", "profit": "total_net", "revenue": "total_income" }, "required": false }, { "name": "sort-dir", "type": "string", "default": "", "usage": "Sort direction: ASC, DESC", "allowed_values": [ "ASC", "DESC" ], "required": false }, { "name": "split-at", "type": "string", "default": "", "usage": "Compare before/after this moment: YYYY-MM-DD (00:00 UTC) or unix seconds. Splits the window (--days N, or --time-from/--time-to in unix seconds; default --days 90) into [start, split) and [split, end] and returns one row per value: clicks/conversions/revenue before, after, change, change %, and per-day rates. --sort clicks|conversions|revenue[_per_day] ranks by absolute change (default clicks)", "required": false }, { "name": "text-ad-id", "type": "string", "default": "", "usage": "Filter by text ad ID", "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Start: unix seconds, a date (2026-10-01, from its first second in the account's timezone) or a time with its offset (2026-10-01T09:30:00Z)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "End, inclusive: unix seconds, a date (2026-10-01, through its last second in the account's timezone) or a time with its offset", "required": false } ] }, { "path": "p202 app", "use": "app", "aliases": [ "apps" ], "short": "App measurement: registered apps, SKAN encodings, postbacks and the report", "long": "Register the apps you advertise (from a store link or an app key), decode their\nSKAdNetwork and AdAttributionKit postbacks, and read the report.\n\n p202 app create --store-link https://apps.apple.com/us/app/summit-run/id990077001\n p202 goal create --registration-id 1 --name purchase --event purchase\n p202 app encoding create --registration-id 1 --fine-value 40 --goal-id 12 --revenue-override 4.99\n p202 app report --group-by registration", "runnable": false, "flags": [] }, { "path": "p202 app create", "use": "create", "short": "Register an app from a store link or an app key (claims its stored postbacks)", "long": "Registers one app. Name it with --store-link (an App Store or Google Play link, a\nmarket:// link, a numeric App Store id or a package name) or with --app-key (the App\nStore id for iOS, the package name for Android; --platform is read from the key's\nshape when left out). The server reads the link, so every client parses it the same way.", "runnable": true, "flags": [ { "name": "accept-test-signals", "type": "string", "default": "", "usage": "1 = trust test signals for this app (AdAttributionKit development-signed postbacks, Android test installs; integration testing), 0 = store them flagged (default): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "app-key", "type": "string", "default": "", "usage": "The App Store id (iOS) or the package name (Android)", "required": false }, { "name": "app-name", "type": "string", "default": "", "usage": "Display name for reports", "required": false }, { "name": "attribution-window-days", "type": "string", "default": "", "usage": "Android: days after its click an install may begin and still be attributed (1-365, default 7)", "required": false }, { "name": "ctit-max-seconds", "type": "string", "default": "", "usage": "Android: flag an install that began later than this after its click (60-31536000, default 86400)", "required": false }, { "name": "ctit-min-seconds", "type": "string", "default": "", "usage": "Android: flag an install that began sooner than this after its click (0-3600, default 10)", "required": false }, { "name": "event-cap-per-minute", "type": "string", "default": "", "usage": "Android: events one install may post a minute; past it 429 (100-60000, default 200)", "required": false }, { "name": "fast-goal-policy", "type": "string", "default": "", "usage": "Android: what a fast goal does, one of count, hold: count (pay it and flag it, default) or hold (flag it, never pay)", "allowed_values": [ "count", "hold" ], "required": false }, { "name": "fast-goal-seconds", "type": "string", "default": "", "usage": "Android: flag a goal reached sooner than this after its install (0-3600, default 5; 0 flags none)", "required": false }, { "name": "install-cap-per-minute", "type": "string", "default": "", "usage": "Android: installs the app may report a minute; past it 429 (1-60000, default 300)", "required": false }, { "name": "integrity-cloud-project-number", "type": "string", "default": "", "usage": "Android: the Google Cloud project NUMBER the SDK requests integrity tokens for (required for observe/require; can be replaced, not cleared)", "required": false }, { "name": "integrity-mode", "type": "string", "default": "", "usage": "Android: Play Integrity mode, one of off, observe, require: off (default), observe (record verdicts) or require (attribute only a passing verdict); needs `app integrity credential set` first and --integrity-cloud-project-number", "allowed_values": [ "off", "observe", "require" ], "required": false }, { "name": "notes", "type": "string", "default": "", "usage": "Free-form notes", "required": false }, { "name": "platform", "type": "string", "default": "", "usage": "Platform (default: read from --app-key or --store-link): ios, android", "allowed_values": [ "ios", "android" ], "required": false }, { "name": "store-link", "type": "string", "default": "", "usage": "App Store or Google Play link, market:// link, App Store id or package name", "required": false }, { "name": "trust-client-revenue", "type": "string", "default": "", "usage": "Android: 1 = revenue the app reports may be paid by a goal valued from it; 0 = stored, never credited (default): 0, 1", "allowed_values": [ "0", "1" ], "required": false } ] }, { "path": "p202 app delete", "use": "delete [id]", "short": "Delete an app registration (its SKAN encodings go with it; claimed postbacks keep their owner)", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Preview what the delete would remove (record + cascade counts) without deleting", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Comma-separated app registration IDs to delete in bulk", "required": false } ] }, { "path": "p202 app encoding", "use": "encoding", "aliases": [ "encodings", "skan-encoding", "skan-encodings" ], "short": "SKAN encodings: which conversion value means which goal was reached (mirror of the in-app schema)", "runnable": false, "flags": [] }, { "path": "p202 app encoding create", "use": "create", "short": "Create an encoding (one fine value 0-63 OR one coarse value) for a registration or account-wide", "runnable": true, "flags": [ { "name": "coarse-value", "type": "string", "default": "", "usage": "Coarse conversion value: low, medium, high", "allowed_values": [ "low", "medium", "high" ], "required": false }, { "name": "fine-value", "type": "string", "default": "", "usage": "Fine conversion value 0-63", "required": false }, { "name": "goal-id", "type": "string", "default": "", "usage": "The goal the value means (`p202 goal list --registration-id `; evaluated on the device, so no click window)", "required": false }, { "name": "idempotency-key", "type": "string", "default": "", "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate", "required": false }, { "name": "registration-id", "type": "string", "default": "", "usage": "iOS registration the encoding applies to (from `p202 app list`; 0 = account-wide)", "required": false }, { "name": "revenue-override", "type": "string", "default": "", "usage": "Revenue per decoded postback, instead of the goal's own value (tiered decoding)", "required": false } ] }, { "path": "p202 app encoding delete", "use": "delete [id]", "short": "Delete an encoding", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Preview what the delete would remove (record + cascade counts) without deleting", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Comma-separated SKAN encoding IDs to delete in bulk", "required": false } ] }, { "path": "p202 app encoding get", "use": "get ", "short": "Get a SKAN encoding", "runnable": true, "flags": [] }, { "path": "p202 app encoding list", "use": "list", "short": "List SKAN encodings", "runnable": true, "flags": [ { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "registration-id", "type": "string", "default": "", "usage": "Only this registration's encodings (0 = the account-wide ones)", "required": false } ] }, { "path": "p202 app encoding update", "use": "update ", "short": "Update an encoding (switch kinds with --clear-fine-value/--clear-coarse-value)", "long": "Updates fields of an encoding. An encoding always maps exactly ONE conversion\nvalue, so switching one between kinds takes the clear and the replacement in one\ncommand: `update 5 --clear-fine-value --coarse-value high` turns a fine encoding\ninto a coarse one. The clear flags send an explicit JSON null.", "runnable": true, "flags": [ { "name": "clear-coarse-value", "type": "bool", "default": "false", "usage": "Set coarse_value to null (pair with --fine-value to switch kinds)", "required": false }, { "name": "clear-fine-value", "type": "bool", "default": "false", "usage": "Set fine_value to null (pair with --coarse-value to switch kinds)", "required": false }, { "name": "clear-revenue-override", "type": "bool", "default": "false", "usage": "Go back to the goal's own value", "required": false }, { "name": "coarse-value", "type": "string", "default": "", "usage": "Coarse conversion value: low, medium, high", "allowed_values": [ "low", "medium", "high" ], "required": false }, { "name": "fine-value", "type": "string", "default": "", "usage": "Fine conversion value 0-63", "required": false }, { "name": "goal-id", "type": "string", "default": "", "usage": "The goal the value means (`p202 goal list --registration-id `; evaluated on the device, so no click window)", "required": false }, { "name": "registration-id", "type": "string", "default": "", "usage": "iOS registration the encoding applies to (from `p202 app list`; 0 = account-wide)", "required": false }, { "name": "revenue-override", "type": "string", "default": "", "usage": "Revenue per decoded postback, instead of the goal's own value (tiered decoding)", "required": false } ] }, { "path": "p202 app get", "use": "get ", "short": "Get a registered app by its registration id (from `p202 app list`)", "runnable": true, "flags": [] }, { "path": "p202 app install", "use": "install", "aliases": [ "installs" ], "short": "Android installs: list, inspect, mint a click's install token, simulate the SDK", "long": "Android installs reach the server from the SDK (POST /apps/installs); each is\nclassified into a match state (attributed, organic, bad_token, …) with its reason.\n\n p202 app install list 3 --match-state attributed\n p202 app install token 3 --click 1042\n p202 app install simulate 3 --click 1042", "runnable": false, "flags": [] }, { "path": "p202 app install get", "use": "get ", "short": "Get one install: its referrer, timestamps, match state, reason and trust", "runnable": true, "flags": [] }, { "path": "p202 app install list", "use": "list ", "short": "List an Android registration's installs, newest first, with their match state and reason", "runnable": true, "flags": [ { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "click-id", "type": "string", "default": "", "usage": "Only installs attributed or matched to this click", "required": false }, { "name": "ctit-flag", "type": "string", "default": "", "usage": "Only installs whose click-to-install time is: short, ok, long, unmeasured", "allowed_values": [ "short", "ok", "long", "unmeasured" ], "required": false }, { "name": "integrity-state", "type": "string", "default": "", "usage": "Only this Play Integrity state: not_requested, received, missing, pending, valid, invalid, error, skipped", "allowed_values": [ "not_requested", "received", "missing", "pending", "valid", "invalid", "error", "skipped" ], "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "match-state", "type": "string", "default": "", "usage": "Only this state: attributed, organic, third_party, unavailable, pending_click, bad_token, foreign_click, implausible, outside_window, duplicate_click, pending_integrity, integrity_failed, integrity_unverified", "allowed_values": [ "attributed", "organic", "third_party", "unavailable", "pending_click", "bad_token", "foreign_click", "implausible", "outside_window", "duplicate_click", "pending_integrity", "integrity_failed", "integrity_unverified" ], "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "test", "type": "string", "default": "", "usage": "Only test installs (1) or only real ones (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Received-at range start (unix timestamp)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "Received-at range end (unix timestamp)", "required": false }, { "name": "trusted", "type": "string", "default": "", "usage": "Only this trust class: trusted, refuted, unvouched", "allowed_values": [ "trusted", "refuted", "unvouched" ], "required": false } ] }, { "path": "p202 app install simulate", "use": "simulate --click ", "short": "Post an SDK-shaped install for a real click, as a device would", "long": "Reads the registration (its app token and package), mints the click's install token,\nand posts the install the Android SDK would send to POST /apps/installs — with Google's\ntimestamps placed seconds after the click — then prints the intake's answer. The install\nis real: an attributed one records the install conversion on the click.\n\nResend with the same --install-uuid to see the duplicate answer; --test marks it a test\ninstall (it counts only when the registration accepts test signals).", "runnable": true, "flags": [ { "name": "click", "type": "string", "default": "", "usage": "The click the install comes from (from `p202 click list`)", "required": false }, { "name": "delay", "type": "int", "default": "5", "usage": "Seconds from the click to the store click", "required": false }, { "name": "install-uuid", "type": "string", "default": "", "usage": "The install's id (default: a new one); reuse one to see the duplicate answer", "required": false }, { "name": "test", "type": "bool", "default": "false", "usage": "Send it as a test install (counts only under accept_test_signals)", "required": false } ] }, { "path": "p202 app install token", "use": "token --click ", "short": "Show the install token and Google Play store link for one click", "long": "Mints [[p202_install_token]] for one of your clicks, exactly as the redirect does,\nand the store link that carries it (…&referrer=p202%3D). A read: nothing is stored.", "runnable": true, "flags": [ { "name": "click", "type": "string", "default": "", "usage": "The click to sign (from `p202 click list`)", "required": false } ] }, { "path": "p202 app integrity", "use": "integrity", "short": "Play Integrity for an Android app: status, and its Google service-account credential", "long": "Play Integrity is opt-in per Android registration. Set the service account first, then\nswitch the mode:\n\n p202 app integrity credential set 3 --file service-account.json\n p202 app update 3 --integrity-mode observe --integrity-cloud-project-number 123456789012\n p202 app integrity status 3\n\nobserve records every install's verdict and changes nothing; require attributes (and pays)\nan install only once its verdict passes. `p202 app install list 3 --integrity-state invalid`\nshows the installs that failed.", "runnable": false, "flags": [] }, { "path": "p202 app integrity credential", "use": "credential", "short": "Set, rotate or clear the Google service account Play Integrity decodes with", "runnable": false, "flags": [] }, { "path": "p202 app integrity credential clear", "use": "clear ", "short": "Delete the service account (refused while the mode is observe or require, or installs still wait for a verdict)", "runnable": true, "flags": [ { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false } ] }, { "path": "p202 app integrity credential set", "use": "set --file ", "short": "Set or rotate the service account (the key is stored encrypted and never shown)", "long": "Uploads a Google service-account key file for the app. The account must be able to call\nthe Play Integrity API for the app: the Google Cloud project it belongs to is linked to the\napp in Play Console. Setting it again replaces it (rotation). The server stores the key\nencrypted and answers with the account's email and key id only.", "runnable": true, "flags": [ { "name": "file", "shorthand": "f", "type": "string", "default": "", "usage": "The service-account key file (JSON); \"-\" or omitted reads piped stdin", "required": false } ] }, { "path": "p202 app integrity status", "use": "status ", "short": "Show the mode, the credential (never its key), verdict counts and today's decodes", "runnable": true, "flags": [] }, { "path": "p202 app link", "use": "link ", "short": "The store link a campaign should send this app's clicks to, and whether a campaign does", "long": "Shows the store link for the app: for Android the Play link with [[p202_install_token]] in\nits referrer (the redirect fills it per click; the SDK reads it back), for iOS the App Store\nlink and the SKAdNetwork/AdAttributionKit Info.plist setup. With --campaign-id it says whether\nthat campaign is ready — its offer URL is the store link and, for Android, the campaign is\nlinked to the app — and with --apply it makes it so (PUT /campaigns/{id}; honours --staged).\nThen `p202 tracker create --aff-campaign-id N` gives the tracking link.", "example": "p202 app link 7\n p202 app link 7 --campaign-id 12 --apply", "runnable": true, "flags": [ { "name": "apply", "type": "bool", "default": "false", "usage": "Set the campaign's offer URL to the store link and, for Android, link it to the app (and turn URL rotation off when an alternate in rotation is not the app's link)", "required": false }, { "name": "campaign-id", "type": "string", "default": "", "usage": "Say whether this campaign sends its clicks to the store link (`p202 campaign list`)", "required": false } ] }, { "path": "p202 app list", "use": "list", "short": "List registered apps (both platforms)", "runnable": true, "flags": [ { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "platform", "type": "string", "default": "", "usage": "Only this platform: ios, android", "allowed_values": [ "ios", "android" ], "required": false } ], "tasks": [ { "run": "p202 app list", "ui_pages": [ "Setup › Mobile Apps" ], "phrases": [ "registered apps" ] } ] }, { "path": "p202 app notifications", "use": "notifications", "short": "Traffic-source postbacks the app installs' goals queued, and where each stands", "long": "Lists the notification outbox rows for app installs, newest first: the postback URL, its\nkind (reached, correction, retraction) and status — pending (waiting or backing off),\nsent, failed (attempts ran out; last_error says why), cancelled (replaced before it went\nout) or suppressed (a correction the traffic source has no correction URL for).\nmeta.summary counts every status under the same filters.", "runnable": true, "flags": [ { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "kind", "type": "string", "default": "", "usage": "Only this kind: reached, correction, retraction", "allowed_values": [ "reached", "correction", "retraction" ], "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "registration-id", "type": "string", "default": "", "usage": "Only this app's postbacks (`p202 app list`)", "required": false }, { "name": "status", "type": "string", "default": "", "usage": "Only this status: pending, sent, failed, cancelled, suppressed", "allowed_values": [ "pending", "sent", "failed", "cancelled", "suppressed" ], "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Queued at or after (unix timestamp)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "Queued at or before (unix timestamp)", "required": false } ] }, { "path": "p202 app postbacks", "use": "postbacks", "aliases": [ "postback", "pb" ], "short": "Received SKAdNetwork and AdAttributionKit postbacks (read-only)", "runnable": false, "flags": [] }, { "path": "p202 app postbacks get", "use": "get ", "short": "Get one postback, including its attribution signature", "runnable": true, "flags": [] }, { "path": "p202 app postbacks list", "use": "list", "short": "List received postbacks with filters (registration, protocol, signature state, network, window)", "runnable": true, "flags": [ { "name": "ad-interaction-type", "type": "string", "default": "", "usage": "Filter: view (view-through) or click: view, click", "allowed_values": [ "view", "click" ], "required": false }, { "name": "ad-network-id", "type": "string", "default": "", "usage": "Filter by ad network id", "required": false }, { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "app-id", "type": "string", "default": "", "usage": "Filter by the App Store id the postback itself named (forensic; prefer --registration-id)", "required": false }, { "name": "campaign-id", "type": "string", "default": "", "usage": "Filter by SKAN 2/3 campaign id", "required": false }, { "name": "coarse-conversion-value", "type": "string", "default": "", "usage": "Filter by coarse value: low, medium, high", "allowed_values": [ "low", "medium", "high" ], "required": false }, { "name": "conversion-type", "type": "string", "default": "", "usage": "Filter by conversion type: download, redownload, re-engagement", "allowed_values": [ "download", "redownload", "re-engagement" ], "required": false }, { "name": "country-code", "type": "string", "default": "", "usage": "Filter by install country code", "required": false }, { "name": "did-win", "type": "string", "default": "", "usage": "Filter: 1=winning postbacks, 0=losing: 0, 1 (aliases: false=0, true=1)", "allowed_values": [ "0", "1" ], "value_aliases": { "false": "0", "true": "1" }, "required": false }, { "name": "fidelity-type", "type": "string", "default": "", "usage": "Filter: 1=click-through, 0=view-through (both protocols; prefer --ad-interaction-type): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "postback-sequence-index", "type": "string", "default": "", "usage": "Filter by conversion window: 0, 1, 2", "allowed_values": [ "0", "1", "2" ], "required": false }, { "name": "protocol", "type": "string", "default": "", "usage": "Filter by protocol: skadnetwork, adattributionkit (aliases: aak=adattributionkit, skan=skadnetwork)", "allowed_values": [ "skadnetwork", "adattributionkit" ], "value_aliases": { "aak": "adattributionkit", "skan": "skadnetwork" }, "required": false }, { "name": "redownload", "type": "string", "default": "", "usage": "Filter: 1=redownloads, 0=first installs (both protocols; prefer --conversion-type): 0, 1 (aliases: false=0, true=1)", "allowed_values": [ "0", "1" ], "value_aliases": { "false": "0", "true": "1" }, "required": false }, { "name": "registration-id", "type": "string", "default": "", "usage": "Filter by registration (from `p202 app list`)", "required": false }, { "name": "registration-ids", "type": "string", "default": "", "usage": "Filter by several registrations, comma-separated", "required": false }, { "name": "signature", "type": "string", "default": "", "usage": "Filter by verification state: valid, invalid, unverifiable, development", "allowed_values": [ "valid", "invalid", "unverifiable", "development" ], "required": false }, { "name": "source-identifier", "type": "string", "default": "", "usage": "Filter by SKAN 4 source identifier", "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Received-at range start (unix timestamp)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "Received-at range end (unix timestamp)", "required": false }, { "name": "transaction-id", "type": "string", "default": "", "usage": "Filter by Apple transaction id", "required": false }, { "name": "version", "type": "string", "default": "", "usage": "Filter by SKAN postback version (e.g. 4.0)", "required": false } ] }, { "path": "p202 app report", "use": "report", "short": "Cross-platform app report: iOS postbacks and Android installs, with the goals they reached", "long": "Reports Apple's postbacks by default (--platform ios, what this report meant before Android),\nAndroid installs with --platform android, and both with --platform all. Any platform groups by\nday (UTC), registration or platform; iOS also by ad-network, source, country, version, protocol\nor conversion-type (Apple's postbacks, decoded through `p202 app encoding`), Android also by\ncampaign, match-state, integrity-state, ctit-flag (click-to-install time: short, ok, long,\nunmeasured) or goal (the funnel: installs that reached each goal).\n\nEvery row carries platform, installs, the trust-class counts, goals_reached, revenue and\nevents. Headline figures count trusted signals only: signature-verified postbacks, attributed\ninstalls. --signature (iOS) or --trusted (Android) recompute them over one class.\nTotals are in meta.totals: per platform, and with both platforms {ios, android, combined}.\nAndroid figures are by install: a goal counts in its install's group.", "example": "p202 app report --platform all --group-by registration\n p202 app report --platform android --group-by goal --registration-id 7\n p202 app report --platform ios --group-by ad-network --signature valid", "runnable": true, "flags": [ { "name": "ad-interaction-type", "type": "string", "default": "", "usage": "Filter: view (view-through) or click: view, click", "allowed_values": [ "view", "click" ], "required": false }, { "name": "ad-network-id", "type": "string", "default": "", "usage": "Filter by ad network id", "required": false }, { "name": "aff-campaign-id", "type": "string", "default": "", "usage": "Android: only installs on this campaign's clicks (`p202 campaign list`)", "required": false }, { "name": "app-id", "type": "string", "default": "", "usage": "Filter by the App Store id the postback itself named (forensic; prefer --registration-id)", "required": false }, { "name": "campaign-id", "type": "string", "default": "", "usage": "Filter by SKAN 2/3 campaign id", "required": false }, { "name": "coarse-conversion-value", "type": "string", "default": "", "usage": "Filter by coarse value: low, medium, high", "allowed_values": [ "low", "medium", "high" ], "required": false }, { "name": "conversion-type", "type": "string", "default": "", "usage": "Filter by conversion type: download, redownload, re-engagement", "allowed_values": [ "download", "redownload", "re-engagement" ], "required": false }, { "name": "country-code", "type": "string", "default": "", "usage": "Filter by install country code", "required": false }, { "name": "ctit-flag", "type": "string", "default": "", "usage": "Android: only installs whose click-to-install time is: short, ok, long, unmeasured", "allowed_values": [ "short", "ok", "long", "unmeasured" ], "required": false }, { "name": "did-win", "type": "string", "default": "", "usage": "Filter: 1=winning postbacks, 0=losing: 0, 1 (aliases: false=0, true=1)", "allowed_values": [ "0", "1" ], "value_aliases": { "false": "0", "true": "1" }, "required": false }, { "name": "fast-goals", "type": "string", "default": "", "usage": "Android: only installs with a goal reached implausibly fast (1), or only those without one (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "fidelity-type", "type": "string", "default": "", "usage": "Filter: 1=click-through, 0=view-through (both protocols; prefer --ad-interaction-type): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "group-by", "type": "string", "default": "day", "usage": "Group by (ad-network, source, country, version, protocol, conversion-type need --platform ios; campaign, match-state, integrity-state, ctit-flag, goal need --platform android): day, registration, platform, ad-network, source, country, version, protocol, conversion-type, campaign, match-state, integrity-state, ctit-flag, goal", "allowed_values": [ "day", "registration", "platform", "ad-network", "source", "country", "version", "protocol", "conversion-type", "campaign", "match-state", "integrity-state", "ctit-flag", "goal" ], "required": false }, { "name": "integrity-state", "type": "string", "default": "", "usage": "Android: only installs whose Play Integrity verdict is in this state: not_requested, received, missing, pending, valid, invalid, error, skipped", "allowed_values": [ "not_requested", "received", "missing", "pending", "valid", "invalid", "error", "skipped" ], "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max groups per platform (default 100)", "required": false }, { "name": "match-state", "type": "string", "default": "", "usage": "Android: only installs in this match state: attributed, organic, third_party, unavailable, pending_click, bad_token, foreign_click, implausible, outside_window, duplicate_click, pending_integrity, integrity_failed, integrity_unverified", "allowed_values": [ "attributed", "organic", "third_party", "unavailable", "pending_click", "bad_token", "foreign_click", "implausible", "outside_window", "duplicate_click", "pending_integrity", "integrity_failed", "integrity_unverified" ], "required": false }, { "name": "platform", "type": "string", "default": "", "usage": "Platform (default ios; all reports both): ios, android, all", "allowed_values": [ "ios", "android", "all" ], "required": false }, { "name": "postback-sequence-index", "type": "string", "default": "", "usage": "Filter by conversion window: 0, 1, 2", "allowed_values": [ "0", "1", "2" ], "required": false }, { "name": "protocol", "type": "string", "default": "", "usage": "Filter by protocol: skadnetwork, adattributionkit (aliases: aak=adattributionkit, skan=skadnetwork)", "allowed_values": [ "skadnetwork", "adattributionkit" ], "value_aliases": { "aak": "adattributionkit", "skan": "skadnetwork" }, "required": false }, { "name": "redownload", "type": "string", "default": "", "usage": "Filter: 1=redownloads, 0=first installs (both protocols; prefer --conversion-type): 0, 1 (aliases: false=0, true=1)", "allowed_values": [ "0", "1" ], "value_aliases": { "false": "0", "true": "1" }, "required": false }, { "name": "registration-id", "type": "string", "default": "", "usage": "Filter by registration (from `p202 app list`)", "required": false }, { "name": "registration-ids", "type": "string", "default": "", "usage": "Filter by several registrations, comma-separated", "required": false }, { "name": "signature", "type": "string", "default": "", "usage": "Filter by verification state: valid, invalid, unverifiable, development", "allowed_values": [ "valid", "invalid", "unverifiable", "development" ], "required": false }, { "name": "source-identifier", "type": "string", "default": "", "usage": "Filter by SKAN 4 source identifier", "required": false }, { "name": "test", "type": "string", "default": "", "usage": "Android: only test installs (1) or only real ones (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Received-at range start (unix timestamp)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "Received-at range end (unix timestamp)", "required": false }, { "name": "transaction-id", "type": "string", "default": "", "usage": "Filter by Apple transaction id", "required": false }, { "name": "trusted", "type": "string", "default": "", "usage": "Android: only this trust class (trusted, refuted, unvouched); goals are then counted over it", "allowed_values": [ "trusted", "refuted", "unvouched" ], "required": false }, { "name": "version", "type": "string", "default": "", "usage": "Filter by SKAN postback version (e.g. 4.0)", "required": false } ], "tasks": [ { "run": "p202 app report", "ui_pages": [ "Analyze › Mobile Apps" ], "phrases": [ "app installs report", "skadnetwork postbacks" ] } ] }, { "path": "p202 app rotate-token", "use": "rotate-token ", "short": "Replace the app token (the old token stops working immediately)", "long": "Mints a new app token for the registration and invalidates the old one — the\nremedy when builds should no longer reach the server with the token they shipped.\nThe token is an identifier, not a secret: it ships inside every copy of the app.", "runnable": true, "flags": [] }, { "path": "p202 app schema", "use": "schema ", "short": "Show the app's schema document exactly as devices fetch it", "long": "Reads the registration (for its app token), then fetches the public GET /apps/schema\nendpoint with it in the X-P202-App-Token header — the same request the SDK in the app\nmakes — so what you see is byte-for-byte what shipped builds receive.", "runnable": true, "flags": [] }, { "path": "p202 app update", "use": "update ", "short": "Update a registered app's name, notes or test-signal policy (re-runs the postback claim)", "runnable": true, "flags": [ { "name": "accept-test-signals", "type": "string", "default": "", "usage": "1 = trust test signals for this app (AdAttributionKit development-signed postbacks, Android test installs; integration testing), 0 = store them flagged (default): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "app-name", "type": "string", "default": "", "usage": "Display name for reports", "required": false }, { "name": "attribution-window-days", "type": "string", "default": "", "usage": "Android: days after its click an install may begin and still be attributed (1-365, default 7)", "required": false }, { "name": "ctit-max-seconds", "type": "string", "default": "", "usage": "Android: flag an install that began later than this after its click (60-31536000, default 86400)", "required": false }, { "name": "ctit-min-seconds", "type": "string", "default": "", "usage": "Android: flag an install that began sooner than this after its click (0-3600, default 10)", "required": false }, { "name": "event-cap-per-minute", "type": "string", "default": "", "usage": "Android: events one install may post a minute; past it 429 (100-60000, default 200)", "required": false }, { "name": "fast-goal-policy", "type": "string", "default": "", "usage": "Android: what a fast goal does, one of count, hold: count (pay it and flag it, default) or hold (flag it, never pay)", "allowed_values": [ "count", "hold" ], "required": false }, { "name": "fast-goal-seconds", "type": "string", "default": "", "usage": "Android: flag a goal reached sooner than this after its install (0-3600, default 5; 0 flags none)", "required": false }, { "name": "install-cap-per-minute", "type": "string", "default": "", "usage": "Android: installs the app may report a minute; past it 429 (1-60000, default 300)", "required": false }, { "name": "integrity-cloud-project-number", "type": "string", "default": "", "usage": "Android: the Google Cloud project NUMBER the SDK requests integrity tokens for (required for observe/require; can be replaced, not cleared)", "required": false }, { "name": "integrity-mode", "type": "string", "default": "", "usage": "Android: Play Integrity mode, one of off, observe, require: off (default), observe (record verdicts) or require (attribute only a passing verdict); needs `app integrity credential set` first and --integrity-cloud-project-number", "allowed_values": [ "off", "observe", "require" ], "required": false }, { "name": "notes", "type": "string", "default": "", "usage": "Free-form notes", "required": false }, { "name": "trust-client-revenue", "type": "string", "default": "", "usage": "Android: 1 = revenue the app reports may be paid by a goal valued from it; 0 = stored, never credited (default): 0, 1", "allowed_values": [ "0", "1" ], "required": false } ] }, { "path": "p202 app verify", "use": "verify", "short": "Verify a postback payload's Apple signature (nothing is stored)", "long": "Reads a postback JSON object from --file (or piped stdin) and asks the server to\nverify Apple's signature. A body with a jws-string is verified as AdAttributionKit\n(the response decodes the JWS header and payload and names the signing key); anything\nelse as SKAdNetwork (the response carries the exact signed message, base64, for\ndiffing against another implementation). The verdict is valid / invalid /\nunverifiable / development.", "runnable": true, "flags": [ { "name": "file", "shorthand": "f", "type": "string", "default": "", "usage": "Path to the postback JSON (default: read piped stdin)", "required": false } ] }, { "path": "p202 attribution", "use": "attribution", "short": "Multi-touch attribution: models, credit reports and journeys over your own clicks, plus platform-signed postbacks (SKAdNetwork, AdAttributionKit)", "runnable": false, "flags": [] }, { "path": "p202 attribution breakdown", "use": "breakdown", "short": "Attributed conversions, revenue, cost and ROI by a click dimension; --compare-model puts two models side by side", "long": "Attributed conversions (sum of credit) and revenue for conversions in the range, grouped by a\ndimension of the credited clicks; clicks and cost from the dimension's own clicks; and assisted\nconversions (journeys where the dimension had a touch before the converting click).\n\nWithout --model the report is \"effective\": each conversion under its campaign's model override\nwhen that model is active, otherwise the account default.\n\n--cohort click reads credits and assists by the date of the click they land on instead of the\nsale's date: each row is what its own clicks in the range earned (whenever they converted) against\ntheir cost, the population the classic reports count.", "runnable": true, "flags": [ { "name": "cohort", "type": "string", "default": "", "usage": "conversion: the sales made in the range (default); click: what the range's clicks earned, as the classic reports count. Values: conversion, click", "allowed_values": [ "conversion", "click" ], "required": false }, { "name": "compare-model", "type": "string", "default": "", "usage": "A second model id, side by side", "required": false }, { "name": "group-by", "type": "string", "default": "campaign", "usage": "Dimension: campaign, traffic_source, landing_page, keyword, c1, c2, c3, c4, country, device, day", "allowed_values": [ "campaign", "traffic_source", "landing_page", "keyword", "c1", "c2", "c3", "c4", "country", "device", "day" ], "required": false }, { "name": "keys", "type": "string", "default": "", "usage": "Only these rows: up to 1000 row keys (data[].key), comma-separated", "required": false }, { "name": "limit", "type": "string", "default": "", "usage": "Rows, 1-1000 (default 100)", "required": false }, { "name": "model", "type": "string", "default": "", "usage": "Model id (default: each campaign's override, else the account default)", "required": false }, { "name": "offset", "type": "string", "default": "", "usage": "Rows to skip, for paging past --limit (meta.groups is the total; needs a server with attribution paging)", "required": false }, { "name": "period", "type": "string", "default": "", "usage": "Range (default: the last 30 days): today, yesterday, last7, last14, last30, last90, thismonth, lastmonth, thisyear, lastyear, alltime", "allowed_values": [ "today", "yesterday", "last7", "last14", "last30", "last90", "thismonth", "lastmonth", "thisyear", "lastyear", "alltime" ], "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Range start, unix seconds", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "Range end, unix seconds", "required": false } ], "tasks": [ { "run": "p202 attribution breakdown", "ui_pages": [ "Attribution" ], "phrases": [ "multi touch attribution", "attribution report" ] } ] }, { "path": "p202 attribution export", "use": "export", "short": "Attribution exports: a breakdown written to CSV by the export runner, downloadable and optionally sent to an https webhook", "long": "An export is a job: the export runner (the minutely cron) builds the breakdown it names,\nwrites every group to a CSV file, and, when the export has a webhook, POSTs the file there,\nsigned with HMAC-SHA256 (X-P202-Signature: sha256= over \".\").\n\nWebhooks go to https URLs on public addresses only: every address the host resolves to is\nchecked, the connection is pinned to the checked address, and redirects are not followed.", "runnable": false, "flags": [] }, { "path": "p202 attribution export create", "use": "create", "short": "Queue an export of a breakdown: now, or at --run-at; optionally to a signed https webhook", "long": "Queue an export. Without --model it exports the account default model (stored as its id, so\nthe job reads a fixed model); without a range, the last 30 days. The response carries\nwebhook_secret once when the export has a webhook: keep it with the receiver.", "runnable": true, "flags": [ { "name": "compare-model", "type": "string", "default": "", "usage": "A second model id, side by side", "required": false }, { "name": "group-by", "type": "string", "default": "campaign", "usage": "Dimension: campaign, traffic_source, landing_page, keyword, c1, c2, c3, c4, country, device, day", "allowed_values": [ "campaign", "traffic_source", "landing_page", "keyword", "c1", "c2", "c3", "c4", "country", "device", "day" ], "required": false }, { "name": "idempotency-key", "type": "string", "default": "", "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate", "required": false }, { "name": "model", "type": "string", "default": "", "usage": "Model id (default: the account default model)", "required": false }, { "name": "period", "type": "string", "default": "", "usage": "Range (default: the last 30 days): today, yesterday, last7, last14, last30, last90, thismonth, lastmonth, thisyear, lastyear, alltime", "allowed_values": [ "today", "yesterday", "last7", "last14", "last30", "last90", "thismonth", "lastmonth", "thisyear", "lastyear", "alltime" ], "required": false }, { "name": "run-at", "type": "string", "default": "", "usage": "When to run it, unix seconds (default: the next export run, within a minute)", "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Range start, unix seconds", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "Range end, unix seconds", "required": false }, { "name": "webhook-secret", "type": "string", "default": "", "usage": "HMAC secret for the webhook signature, 16-255 characters (default: generated and returned once)", "required": false }, { "name": "webhook-url", "type": "string", "default": "", "usage": "Also POST the CSV here: https, public address, no redirects", "required": false } ] }, { "path": "p202 attribution export delete", "use": "delete ", "short": "Delete an export and its file (not while it is running); supports --ids for bulk", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Preview what the delete would remove (record + cascade counts) without deleting", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Comma-separated export IDs to delete in bulk", "required": false } ] }, { "path": "p202 attribution export download", "use": "download ", "short": "Download an export's CSV to --output, or to stdout", "runnable": true, "flags": [ { "name": "output", "shorthand": "O", "type": "string", "default": "", "usage": "Write the CSV to this file instead of stdout", "required": false } ] }, { "path": "p202 attribution export get", "use": "get ", "short": "One export: its status, rows, webhook answer and last error", "runnable": true, "flags": [] }, { "path": "p202 attribution export list", "use": "list", "short": "List exports, newest first", "runnable": true, "flags": [ { "name": "limit", "type": "int", "default": "50", "usage": "Rows, 1-200", "required": false }, { "name": "status", "type": "string", "default": "", "usage": "Only this status: pending, running, completed, failed", "allowed_values": [ "pending", "running", "completed", "failed" ], "required": false } ] }, { "path": "p202 attribution export retry", "use": "retry ", "short": "Queue a failed export again, with its attempts reset", "runnable": true, "flags": [] }, { "path": "p202 attribution journey", "use": "journey ", "short": "One conversion's journey: its touches, the identity signals that linked them, and every model's credit", "runnable": true, "flags": [] }, { "path": "p202 attribution journeys", "use": "journeys", "short": "Journey metrics: length distribution, time to convert, one-touch share by browser", "runnable": true, "flags": [ { "name": "period", "type": "string", "default": "", "usage": "Range (default: the last 30 days): today, yesterday, last7, last14, last30, last90, thismonth, lastmonth, thisyear, lastyear, alltime", "allowed_values": [ "today", "yesterday", "last7", "last14", "last30", "last90", "thismonth", "lastmonth", "thisyear", "lastyear", "alltime" ], "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Range start, unix seconds", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "Range end, unix seconds", "required": false } ] }, { "path": "p202 attribution model", "use": "model", "short": "Manage attribution models (every account has one default; credits are computed for every active model)", "runnable": false, "flags": [] }, { "path": "p202 attribution model create", "use": "create", "short": "Create an attribution model; its credits are computed for existing conversions by the next worker run", "runnable": true, "flags": [ { "name": "default", "type": "bool", "default": "false", "usage": "Make this the account default model", "required": false }, { "name": "idempotency-key", "type": "string", "default": "", "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate", "required": false }, { "name": "lookback-days", "type": "int", "default": "30", "usage": "Days before a conversion whose clicks can earn credit, 1-365", "required": false }, { "name": "model-name", "type": "string", "default": "", "usage": "Model name (required)", "required": true }, { "name": "model-type", "type": "string", "default": "", "usage": "Type (required): last_touch, first_touch, linear, time_decay, position_based", "allowed_values": [ "last_touch", "first_touch", "linear", "time_decay", "position_based" ], "required": true }, { "name": "status", "type": "string", "default": "", "usage": "Status: active, inactive", "allowed_values": [ "active", "inactive" ], "required": false }, { "name": "weighting-config", "type": "string", "default": "", "usage": "Weighting config JSON object: time_decay {\"half_life_hours\":48}, position_based {\"first_weight\":0.4,\"last_weight\":0.4}", "required": false } ] }, { "path": "p202 attribution model delete", "use": "delete ", "short": "Delete an attribution model and its credits (not the default); supports --ids for bulk", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Preview what the delete would remove (record + cascade counts) without deleting", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Comma-separated model IDs to delete in bulk", "required": false } ] }, { "path": "p202 attribution model get", "use": "get ", "short": "Get an attribution model", "runnable": true, "flags": [] }, { "path": "p202 attribution model list", "use": "list", "short": "List attribution models", "runnable": true, "flags": [ { "name": "type", "shorthand": "t", "type": "string", "default": "", "usage": "Filter by type: last_touch, first_touch, linear, time_decay, position_based", "allowed_values": [ "last_touch", "first_touch", "linear", "time_decay", "position_based" ], "required": false } ] }, { "path": "p202 attribution model update", "use": "update ", "short": "Update an attribution model (changing its type resets its weighting config to that type's defaults)", "runnable": true, "flags": [ { "name": "default", "type": "bool", "default": "false", "usage": "Make this the account default model", "required": false }, { "name": "lookback-days", "type": "int", "default": "30", "usage": "Days before a conversion whose clicks can earn credit, 1-365", "required": false }, { "name": "model-name", "type": "string", "default": "", "usage": "Model name", "required": false }, { "name": "model-type", "type": "string", "default": "", "usage": "Type: last_touch, first_touch, linear, time_decay, position_based", "allowed_values": [ "last_touch", "first_touch", "linear", "time_decay", "position_based" ], "required": false }, { "name": "status", "type": "string", "default": "", "usage": "Status: active, inactive", "allowed_values": [ "active", "inactive" ], "required": false }, { "name": "weighting-config", "type": "string", "default": "", "usage": "Weighting config JSON object: time_decay {\"half_life_hours\":48}, position_based {\"first_weight\":0.4,\"last_weight\":0.4}", "required": false } ] }, { "path": "p202 attribution queue", "use": "queue", "short": "The attribution worker's backlog: conversions waiting, failing (with the error), and why each was queued", "runnable": true, "flags": [ { "name": "limit", "type": "int", "default": "50", "usage": "Rows of the backlog to list, 1-500", "required": false } ] }, { "path": "p202 campaign", "use": "campaign", "short": "Manage campaigns (affiliate offers with URLs, payouts, and postback settings)", "runnable": false, "flags": [] }, { "path": "p202 campaign check-urls", "use": "check-urls", "short": "Find offer URLs whose host is dead, without sending clicks", "long": "Checks campaign offer URL slots (aff_campaign_url, _2 to _5) and reports which\npoint at a host that no longer works. Opening an affiliate link registers a\nclick, so by default no HTTP request is sent: each unique host is resolved\n(DNS), connected to (TCP) and, for https, put through a TLS handshake with\nnormal certificate verification, then the connection is closed.\n\nstatus per URL: ok, invalid_url, dns_failed, connect_failed, timeout,\ntls_failed (and http_failed with --http); detail says why.\n\n--http also sends one HEAD request per unique URL (GET only if HEAD answers\n405), follows no redirect, and reports http_status and location. Affiliate\nnetworks may count these as clicks, so it asks first (--force skips).\nTokens such as [[subid]] are sent as \"p202check\".\n\nLike `p202 rotator check`, it exits 5 (partial_failure) when any URL's\nstatus is not ok; every row is still printed on stdout.", "example": "p202 campaign check-urls\n p202 campaign check-urls --url-contains g2afse.com --slot 1 --timeout 10s\n p202 campaign check-urls --ids 279,281 --json", "runnable": true, "flags": [ { "name": "aff-network-id", "type": "string", "default": "", "usage": "Only campaigns in this affiliate network (ids from p202 aff-network list)", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip the --http confirmation prompt", "required": false }, { "name": "http", "type": "bool", "default": "false", "usage": "Also send a HEAD request per URL and report its status; affiliate networks may count it as a click", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Only these campaign IDs (comma-separated)", "required": false }, { "name": "slot", "type": "string", "default": "all", "usage": "URL slots to check: 1-5, comma-separated, or all", "required": false }, { "name": "timeout", "type": "duration", "default": "5s", "usage": "Time allowed per host for DNS, connect and TLS together (and per --http request)", "required": false }, { "name": "url-contains", "type": "string", "default": "", "usage": "Only offer URLs containing this text (case-insensitive)", "required": false } ] }, { "path": "p202 campaign clone", "use": "clone ", "short": "Clone a campaign", "runnable": true, "flags": [ { "name": "idempotency-key", "type": "string", "default": "", "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate", "required": false }, { "name": "name", "type": "string", "default": "", "usage": "Optional name override for the cloned campaign", "required": false } ] }, { "path": "p202 campaign create", "use": "create", "short": "Create a new campaign", "example": "p202 campaign create --aff-campaign-name --aff-campaign-url --aff-campaign-payout --aff-network-id --json", "runnable": true, "flags": [ { "name": "aff-campaign-cloaking", "type": "string", "default": "", "usage": "Enable cloaking (1) or not (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "aff-campaign-currency", "type": "string", "default": "", "usage": "Currency code (e.g. USD)", "required": false }, { "name": "aff-campaign-foreign-payout", "type": "string", "default": "", "usage": "Foreign currency payout", "required": false }, { "name": "aff-campaign-name", "type": "string", "default": "", "usage": "Campaign name (required)", "required": true }, { "name": "aff-campaign-payout", "type": "string", "default": "", "usage": "Default payout (required)", "required": true }, { "name": "aff-campaign-rotate", "type": "string", "default": "", "usage": "Enable rotation (1) or not (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "aff-campaign-url", "type": "string", "default": "", "usage": "Primary offer URL (required)", "required": true }, { "name": "aff-campaign-url-2", "type": "string", "default": "", "usage": "Offer URL 2 (used with --aff-campaign-rotate 1)", "required": false }, { "name": "aff-campaign-url-3", "type": "string", "default": "", "usage": "Offer URL 3", "required": false }, { "name": "aff-campaign-url-4", "type": "string", "default": "", "usage": "Offer URL 4", "required": false }, { "name": "aff-campaign-url-5", "type": "string", "default": "", "usage": "Offer URL 5", "required": false }, { "name": "aff-network-id", "type": "string", "default": "", "usage": "Category (affiliate network) id, from `p202 aff-network list` (required)", "required": true }, { "name": "app-registration-id", "type": "string", "default": "", "usage": "The Android app registration this campaign's store links install (`p202 app list --platform android`; 0 unlinks). An install of another app on its click is foreign_click", "required": false }, { "name": "attribution-model-id", "type": "string", "default": "", "usage": "The attribution model this campaign's conversions are credited with, overriding the account default (`p202 attribution model list`; 0 returns it to the default)", "required": false }, { "name": "idempotency-key", "type": "string", "default": "", "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate", "required": false }, { "name": "identity-signals", "type": "string", "default": "", "usage": "Link this campaign's clicks into multi-touch journeys (1, default) or not (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "payout-mode", "type": "string", "default": "", "usage": "How conversions set a click's value, replace (latest payout, default) or accumulate (sum): replace, accumulate", "allowed_values": [ "replace", "accumulate" ], "required": false } ] }, { "path": "p202 campaign delete", "use": "delete ", "short": "Delete a campaign", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Preview what the delete would remove (record + cascade counts) without deleting", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Comma-separated campaign IDs to delete in bulk", "required": false } ] }, { "path": "p202 campaign get", "use": "get ", "short": "Get a campaign by ID", "long": "Get a campaign by id. Accepts the internal aff_campaign_id (from `campaign list`). If you pass the\npublic aff_campaign_id_public (the value in tracking links / the UI), it is resolved automatically;\nuse --public to force the public lookup.", "runnable": true, "flags": [ { "name": "public", "type": "bool", "default": "false", "usage": "Treat the id as the public aff_campaign_id_public", "required": false } ] }, { "path": "p202 campaign list", "use": "list", "short": "List campaigns (affiliate offers with URLs, payouts, and postback settings)", "runnable": true, "flags": [ { "name": "aff-network-id", "type": "string", "default": "", "usage": "Filter by affiliate network ID (from `p202 aff-network list`)", "required": false }, { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "days", "type": "int", "default": "0", "usage": "Stats window for --with-stats in days, ending now (ignored when --period is given)", "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "min-clicks", "type": "int", "default": "0", "usage": "With --with-stats: only campaigns with at least N clicks in the window (searches every page)", "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "page", "type": "string", "default": "", "usage": "Page number", "required": false }, { "name": "period", "type": "string", "default": "", "usage": "Stats window for --with-stats (default last30): today, yesterday, last7, last14, last30, last90, thismonth, lastmonth, thisyear, lastyear, alltime", "allowed_values": [ "today", "yesterday", "last7", "last14", "last30", "last90", "thismonth", "lastmonth", "thisyear", "lastyear", "alltime" ], "required": false }, { "name": "resolve-names", "type": "bool", "default": "false", "usage": "Resolve foreign key IDs to names", "required": false }, { "name": "url-contains", "type": "string", "default": "", "usage": "Only campaigns with a URL containing this text (case-insensitive; searches every page; fields: aff_campaign_url, aff_campaign_url_2, aff_campaign_url_3, aff_campaign_url_4, aff_campaign_url_5)", "required": false }, { "name": "with-stats", "type": "bool", "default": "false", "usage": "Add each campaign's traffic in the window: total_clicks, total_leads, total_income, total_cost, total_net (0 when none; needs the reports:read scope)", "required": false } ], "tasks": [ { "run": "p202 campaign list", "ui_pages": [ "Setup › Campaigns" ], "phrases": [ "affiliate offers", "my offers" ] } ] }, { "path": "p202 campaign optimize", "use": "optimize ", "short": "Diagnose a campaign and recommend a salvage offer for its traffic", "long": "Summarizes the campaign's break-even/ROI status and ranks other offers by EPC,\nso you can route losing traffic to the offer that monetizes it best.", "runnable": true, "flags": [ { "name": "aff-campaign-id", "type": "string", "default": "", "usage": "Filter by INTERNAL campaign id (from `campaign list`), not the public id in tracking URLs", "required": false }, { "name": "aff-network-id", "type": "string", "default": "", "usage": "Filter by affiliate network ID", "required": false }, { "name": "browser-id", "type": "string", "default": "", "usage": "Filter by browser ID (the id of a `--breakdown browser` row)", "required": false }, { "name": "country-id", "type": "string", "default": "", "usage": "Filter by country ID", "required": false }, { "name": "device-type", "type": "string", "default": "", "usage": "Filter by device type ID: 1 Desktop, 2 Mobile, 3 Tablet, 4 Bot (the ids of `--breakdown device_type` rows)", "required": false }, { "name": "ip", "type": "string", "default": "", "usage": "Only clicks from this one IP address, IPv4 or IPv6", "required": false }, { "name": "isp-id", "type": "string", "default": "", "usage": "Filter by ISP/carrier ID (the id of a `--breakdown isp` row)", "required": false }, { "name": "keyword", "type": "string", "default": "", "usage": "Only clicks whose keyword contains this text (case-insensitive)", "required": false }, { "name": "landing-page-id", "type": "string", "default": "", "usage": "Filter by landing page ID", "required": false }, { "name": "method-of-promotion", "type": "string", "default": "", "usage": "Only direct-link clicks or only landing-page clicks: directlink, landingpage", "allowed_values": [ "directlink", "landingpage" ], "required": false }, { "name": "period", "shorthand": "p", "type": "string", "default": "", "usage": "Period: today, yesterday, last7, last14, last30, last90, thismonth, lastmonth, thisyear, lastyear, alltime", "allowed_values": [ "today", "yesterday", "last7", "last14", "last30", "last90", "thismonth", "lastmonth", "thisyear", "lastyear", "alltime" ], "required": false }, { "name": "platform-id", "type": "string", "default": "", "usage": "Filter by platform (OS) ID (the id of a `--breakdown platform` row)", "required": false }, { "name": "ppc-account-id", "type": "string", "default": "", "usage": "Filter by PPC account ID", "required": false }, { "name": "ppc-network-id", "type": "string", "default": "", "usage": "Filter by PPC network ID, or none for the clicks with no traffic source", "required": false }, { "name": "referer", "type": "string", "default": "", "usage": "Only clicks whose referring URL contains this text (case-insensitive)", "required": false }, { "name": "region-id", "type": "string", "default": "", "usage": "Filter by region ID (the id of a `--breakdown region` row)", "required": false }, { "name": "show", "type": "string", "default": "", "usage": "Which clicks count (default all): all, real, filtered, filtered_bot, leads; real = not filtered, filtered_bot = filtered as bots, leads = converted", "allowed_values": [ "all", "real", "filtered", "filtered_bot", "leads" ], "required": false }, { "name": "text-ad-id", "type": "string", "default": "", "usage": "Filter by text ad ID", "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Start: unix seconds, a date (2026-10-01, from its first second in the account's timezone) or a time with its offset (2026-10-01T09:30:00Z)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "End, inclusive: unix seconds, a date (2026-10-01, through its last second in the account's timezone) or a time with its offset", "required": false } ] }, { "path": "p202 campaign replace-url", "use": "replace-url", "short": "Find campaigns whose offer URLs contain a string and rewrite those URLs in bulk", "long": "Finds every campaign whose offer URL slots (aff_campaign_url, _2 to _5)\ncontain --match (case-insensitive), and rewrites the matching slots:\n\n --with replaces the matched text inside the URL\n --set replaces the whole URL; {id} and {slug} (the campaign\n name, lowercased and hyphenated) are filled per campaign\n\nRun with --dry-run first: it lists every campaign, slot, old and new URL\nand writes nothing. Without --dry-run the same list is shown and you are\nasked to confirm (--force skips the prompt; --staged records one proposal\nper campaign instead of writing). Matching runs in the CLI over every page\nof campaigns, so it works against any server version.\n\nRe-running is safe with --set (updated URLs no longer contain --match),\nbut with --with it rewrites again if the replacement still contains --match.\n\nUndo: every run that applies a change saves the applied slots (old and new\nURL, profile, base URL) to ~/.p202/undo/replace-url-.json and\nprints `Undo with: p202 campaign replace-url --undo ` (under --json\nalso meta.undo_manifest). --undo puts old_url back only where the slot\nstill holds that run's new_url; slots changed since, and deleted campaigns,\nare left alone and listed with status skipped. It refuses a manifest\nwritten against another base URL, cannot be combined with --match, --with,\n--set, --slot, --ids or --aff-network-id, and otherwise behaves like a\nnormal run (--dry-run, the prompt, --force, --staged, exit 5 on a failed\nPUT). An undo that applies changes saves its own manifest, so it can be\nundone too. If a manifest cannot be saved after the writes, the command\nprints it on stderr and exits 5.", "example": "p202 campaign replace-url --match g2afse.com --set 'https://example.com/?utm_source={slug}' --dry-run\n p202 campaign replace-url --match http://promo.example.com --with https://promo.example.com --force\n p202 campaign replace-url --undo ~/.p202/undo/replace-url-20260930T101500Z.json --dry-run", "runnable": true, "flags": [ { "name": "aff-network-id", "type": "string", "default": "", "usage": "Only campaigns in this affiliate network (`p202 aff-network list`)", "required": false }, { "name": "dry-run", "type": "bool", "default": "false", "usage": "List the changes without writing anything", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip the confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Only these campaign IDs (comma-separated)", "required": false }, { "name": "match", "type": "string", "default": "", "usage": "Text the offer URLs to change contain (case-insensitive; required unless --undo)", "required": false }, { "name": "set", "type": "string", "default": "", "usage": "Replace the whole URL with this; {id} and {slug} are filled per campaign", "required": false }, { "name": "slot", "type": "string", "default": "all", "usage": "URL slots to consider: 1-5, comma-separated, or all", "required": false }, { "name": "undo", "type": "string", "default": "", "usage": "Revert a run from its undo manifest `file` (printed after \"Undo with:\"): restores old URLs where the slot is unchanged since", "required": false }, { "name": "with", "type": "string", "default": "", "usage": "Replace the matched text with this", "required": false } ] }, { "path": "p202 campaign update", "use": "update ", "short": "Update a campaign", "example": "p202 campaign update --aff-campaign-name --json\n (only the flags given are sent; the rest of the campaign is unchanged)", "runnable": true, "flags": [ { "name": "aff-campaign-cloaking", "type": "string", "default": "", "usage": "Enable cloaking (1) or not (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "aff-campaign-currency", "type": "string", "default": "", "usage": "Currency code (e.g. USD)", "required": false }, { "name": "aff-campaign-foreign-payout", "type": "string", "default": "", "usage": "Foreign currency payout", "required": false }, { "name": "aff-campaign-name", "type": "string", "default": "", "usage": "Campaign name", "required": false }, { "name": "aff-campaign-payout", "type": "string", "default": "", "usage": "Default payout", "required": false }, { "name": "aff-campaign-rotate", "type": "string", "default": "", "usage": "Enable rotation (1) or not (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "aff-campaign-url", "type": "string", "default": "", "usage": "Primary offer URL", "required": false }, { "name": "aff-campaign-url-2", "type": "string", "default": "", "usage": "Offer URL 2 (used with --aff-campaign-rotate 1) (\"\" clears it)", "required": false }, { "name": "aff-campaign-url-3", "type": "string", "default": "", "usage": "Offer URL 3 (\"\" clears it)", "required": false }, { "name": "aff-campaign-url-4", "type": "string", "default": "", "usage": "Offer URL 4 (\"\" clears it)", "required": false }, { "name": "aff-campaign-url-5", "type": "string", "default": "", "usage": "Offer URL 5 (\"\" clears it)", "required": false }, { "name": "aff-network-id", "type": "string", "default": "", "usage": "Category (affiliate network) id, from `p202 aff-network list`", "required": false }, { "name": "app-registration-id", "type": "string", "default": "", "usage": "The Android app registration this campaign's store links install (`p202 app list --platform android`; 0 unlinks). An install of another app on its click is foreign_click", "required": false }, { "name": "attribution-model-id", "type": "string", "default": "", "usage": "The attribution model this campaign's conversions are credited with, overriding the account default (`p202 attribution model list`; 0 returns it to the default)", "required": false }, { "name": "identity-signals", "type": "string", "default": "", "usage": "Link this campaign's clicks into multi-touch journeys (1, default) or not (0): 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "payout-mode", "type": "string", "default": "", "usage": "How conversions set a click's value, replace (latest payout, default) or accumulate (sum): replace, accumulate", "allowed_values": [ "replace", "accumulate" ], "required": false } ] }, { "path": "p202 change", "use": "change", "short": "Review and resolve staged writes (proposals recorded by --staged)", "runnable": false, "flags": [] }, { "path": "p202 change apply", "use": "apply ", "short": "Apply a staged change (performs the recorded write)", "long": "Apply a staged change. This performs the recorded write, re-validated on the\nserver against current state and this key's authorization — a propose-only\n(`stage`-scoped) key cannot apply; the applier needs the write scope for the\narea the change touches. Running apply IS the approval, so it confirms\ninteractively unless --force is passed.", "runnable": true, "flags": [ { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false } ] }, { "path": "p202 change discard", "use": "discard ", "short": "Discard a staged change without performing it", "runnable": true, "flags": [] }, { "path": "p202 change list", "use": "list", "short": "List staged changes (yours; --all for every user's, admin only)", "runnable": true, "flags": [ { "name": "all", "type": "bool", "default": "false", "usage": "Every user's changes, not just yours (admin only)", "required": false }, { "name": "status", "type": "string", "default": "", "usage": "Filter by status: staged, applying, applied, discarded, apply_interrupted", "allowed_values": [ "staged", "applying", "applied", "discarded", "apply_interrupted" ], "required": false } ] }, { "path": "p202 change show", "use": "show ", "short": "Show one staged change, including its payload and preview", "runnable": true, "flags": [] }, { "path": "p202 click", "use": "click", "short": "View tracked clicks (inbound visitor events from traffic sources), and set what past clicks cost", "runnable": false, "flags": [] }, { "path": "p202 click conversions", "use": "conversions ", "short": "Explain a click's value: every conversion on it, whether it counts, and why not", "long": "Lists every conversion recorded on the click — counted, unpaid, superseded,\ndeleted and reversals alike — with its amount, what produced it (source), what\nthat is (a goal and version, an upload, the conversion a reversal nets, the API\nkey that wrote it), its transaction id, and whether it counts toward the\nclick's value, with the reason when it does not.\n\nThe table shows one line per conversion and ends with the click's value; --json\nand --ndjson return the API's rows unchanged, and --json adds the \"click\"\nsummary (value, payout mode, whether the rows add up to what the reports show).", "runnable": true, "flags": [] }, { "path": "p202 click get", "use": "get ", "short": "Get a click by ID", "runnable": true, "flags": [] }, { "path": "p202 click list", "use": "list", "short": "List tracked clicks with optional filters by campaign, time range, or bot status", "long": "Lists clicks newest first, with what the Visitors page shows for each: campaign,\ntraffic source, keyword, IP, location, device, referrer and landing URLs. It takes\nthe Visitors page's filters, as `p202 report` does: --keyword and --referer\n(contains), --ip, --device-type, --show real|filtered|filtered_bot|leads, location,\nbrowser and platform ids, and --period.\n\n--follow is the Spy page: it prints the newest --limit clicks (default 10), then\neach new click as it arrives, polling every --interval, until interrupted or\n--stop-after elapses. Under --json or --ndjson it writes one JSON object per\nclick per line.\n\n p202 click list --aff-campaign-id 12 --time-from 2026-10-01 --all --csv\n p202 click list --keyword shoes --show real --period last7\n p202 click list --follow --ndjson --stop-after 10m", "runnable": true, "flags": [ { "name": "aff-campaign-id", "type": "string", "default": "", "usage": "Filter by INTERNAL campaign id (from `campaign list`), not the public id in tracking URLs", "required": false }, { "name": "aff-network-id", "type": "string", "default": "", "usage": "Filter by affiliate network ID", "required": false }, { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "browser-id", "type": "string", "default": "", "usage": "Filter by browser ID (the id of a `--breakdown browser` row)", "required": false }, { "name": "click-bot", "type": "string", "default": "", "usage": "Filter: 0=human, 1=bot: 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "click-lead", "type": "string", "default": "", "usage": "Filter: 0=clicks only, 1=conversions only: 0, 1", "allowed_values": [ "0", "1" ], "required": false }, { "name": "country-id", "type": "string", "default": "", "usage": "Filter by country ID", "required": false }, { "name": "device-type", "type": "string", "default": "", "usage": "Filter by device type ID: 1 Desktop, 2 Mobile, 3 Tablet, 4 Bot (the ids of `--breakdown device_type` rows)", "required": false }, { "name": "follow", "type": "bool", "default": "false", "usage": "Keep printing new clicks as they arrive (the Spy page)", "required": false }, { "name": "interval", "type": "duration", "default": "5s", "usage": "With --follow: how often to poll (at least 1s)", "required": false }, { "name": "ip", "type": "string", "default": "", "usage": "Only clicks from this one IP address, IPv4 or IPv6", "required": false }, { "name": "isp-id", "type": "string", "default": "", "usage": "Filter by ISP/carrier ID (the id of a `--breakdown isp` row)", "required": false }, { "name": "keyword", "type": "string", "default": "", "usage": "Only clicks whose keyword contains this text (case-insensitive)", "required": false }, { "name": "landing-page-id", "type": "string", "default": "", "usage": "Filter by landing page ID", "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "method-of-promotion", "type": "string", "default": "", "usage": "Only direct-link clicks or only landing-page clicks: directlink, landingpage", "allowed_values": [ "directlink", "landingpage" ], "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "page", "type": "string", "default": "", "usage": "Page number (maps to offset)", "required": false }, { "name": "period", "shorthand": "p", "type": "string", "default": "", "usage": "Period: today, yesterday, last7, last14, last30, last90, thismonth, lastmonth, thisyear, lastyear, alltime", "allowed_values": [ "today", "yesterday", "last7", "last14", "last30", "last90", "thismonth", "lastmonth", "thisyear", "lastyear", "alltime" ], "required": false }, { "name": "platform-id", "type": "string", "default": "", "usage": "Filter by platform (OS) ID (the id of a `--breakdown platform` row)", "required": false }, { "name": "ppc-account-id", "type": "string", "default": "", "usage": "Filter by PPC account ID", "required": false }, { "name": "ppc-network-id", "type": "string", "default": "", "usage": "Filter by PPC network ID, or none for the clicks with no traffic source", "required": false }, { "name": "referer", "type": "string", "default": "", "usage": "Only clicks whose referring URL contains this text (case-insensitive)", "required": false }, { "name": "region-id", "type": "string", "default": "", "usage": "Filter by region ID (the id of a `--breakdown region` row)", "required": false }, { "name": "show", "type": "string", "default": "", "usage": "Which clicks count (default all): all, real, filtered, filtered_bot, leads; real = not filtered, filtered_bot = filtered as bots, leads = converted", "allowed_values": [ "all", "real", "filtered", "filtered_bot", "leads" ], "required": false }, { "name": "stop-after", "type": "duration", "default": "0s", "usage": "With --follow: stop after this long, e.g. 10m (0 follows until interrupted)", "required": false }, { "name": "text-ad-id", "type": "string", "default": "", "usage": "Filter by text ad ID", "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Start: unix seconds, a date (2026-10-01, from its first second in the account's timezone) or a time with its offset (2026-10-01T09:30:00Z)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "End, inclusive: unix seconds, a date (2026-10-01, through its last second in the account's timezone) or a time with its offset", "required": false } ], "tasks": [ { "run": "p202 click list --follow", "ui_pages": [ "Spy" ], "phrases": [ "realtime traffic", "realtime clicks", "live traffic", "live clicks", "watch clicks", "watch traffic", "tail clicks", "stream clicks", "monitor traffic", "clicks as they arrive", "clicks as they come in", "incoming clicks" ] }, { "run": "p202 click list", "ui_pages": [ "Visitors" ], "phrases": [ "visitor log", "recent clicks", "click history", "individual clicks" ] } ] }, { "path": "p202 click update-cpc", "use": "update-cpc", "short": "Set what a set of past clicks cost (the UI's Update CPC), after counting them", "long": "Sets the cost (CPC) of the account's clicks between --from 00:00:00 and --to 23:59:59 in\nthe account's time zone, narrowed by any of the id filters and --method-of-promotion.\n\nIt counts the clicks first (POST /clicks/cpc?dry_run=1) and says how many, then asks\n(--force skips the question; --dry-run stops after the count). The update carries the\ncount and the highest click id it saw, and the server writes only if those clicks still\nnumber the same — so a click recorded after the count is never changed, and when the\nselection moved nothing is written (exit 1; run the command again).\n\nNeeds a role with access_to_update_section and a key with clicks:write. Cannot be staged.\nReports show the new cost once the data engine rebuilds the hours (its cron job).", "example": "p202 click update-cpc --from 2026-10-01 --to 2026-10-07 --cpc 0.25 --aff-campaign-id 12 --dry-run\n p202 click update-cpc --from 2026-10-07 --to 2026-10-07 --cpc 0.00125 --ppc-account-id 3\n p202 click update-cpc --from 2026-10-01 --to 2026-10-31 --cpc 1.10 --method-of-promotion directlink --force", "runnable": true, "flags": [ { "name": "aff-campaign-id", "type": "string", "default": "", "usage": "Only this campaign's clicks (id from `p202 campaign list`; 0 = every campaign)", "required": false }, { "name": "aff-network-id", "type": "string", "default": "", "usage": "Only this category's clicks (id from `p202 aff-network list`; 0 = every category)", "required": false }, { "name": "cpc", "type": "string", "default": "", "usage": "What each click cost, in dollars, up to 99.99999 with five decimals (required)", "required": true }, { "name": "dry-run", "type": "bool", "default": "false", "usage": "Count the clicks and write nothing", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Update without asking (the count is still checked)", "required": false }, { "name": "from", "type": "string", "default": "", "usage": "First day, YYYY-MM-DD, in the account's time zone (required)", "required": true }, { "name": "landing-page-id", "type": "string", "default": "", "usage": "Only this landing page's clicks (id from `p202 landing-page list`; 0 = every landing page)", "required": false }, { "name": "method-of-promotion", "type": "string", "default": "", "usage": "Only direct-link or only landing-page clicks (default: both): directlink, landingpage", "allowed_values": [ "directlink", "landingpage" ], "required": false }, { "name": "ppc-account-id", "type": "string", "default": "", "usage": "Only this traffic source account's clicks (id from `p202 ppc-account list`; 0 = every traffic source account)", "required": false }, { "name": "ppc-network-id", "type": "string", "default": "", "usage": "Only this traffic source's clicks (id from `p202 ppc-network list`; 0 = every traffic source)", "required": false }, { "name": "text-ad-id", "type": "string", "default": "", "usage": "Only this text ad's clicks (id from `p202 text-ad list`; 0 = every text ad)", "required": false }, { "name": "to", "type": "string", "default": "", "usage": "Last day, YYYY-MM-DD, in the account's time zone (required)", "required": true } ], "tasks": [ { "run": "p202 click update-cpc", "ui_pages": [ "Update › Update CPC" ], "phrases": [ "set what clicks cost", "record click cost" ] } ] }, { "path": "p202 commands", "use": "commands [command...]", "short": "List every command and flag (with allowed values) in one call; --json for agents", "long": "Dumps the command tree: for each command its path, aliases, description, examples\nand flags (name, shorthand, type, default, usage, allowed values, required). Global\nflags are listed once under global_flags. Name a command to list only its subtree.\n\n--brief is the catalog an agent reads to choose a command: every command on one\nline (its path, summary and the web UI page it does, with that page's command line),\nand the pages no command does; about 6,000 tokens. It prints as text even where an\nagent would get JSON by default; --json gives it as JSON. Then `p202 --help`\nfor the flags. To rank commands by your words instead, use `p202 search `.", "example": "p202 commands --brief\n p202 commands --json\n p202 commands report\n p202 commands --quiet", "runnable": true, "flags": [ { "name": "brief", "type": "bool", "default": "false", "usage": "One line per command (path, summary, the UI page it does): the catalog an agent reads to choose a command", "required": false } ] }, { "path": "p202 completion", "use": "completion", "short": "Generate the autocompletion script for the specified shell", "long": "Generate the autocompletion script for p202 for the specified shell.\nSee each sub-command's help for details on how to use the generated script.", "runnable": false, "flags": [] }, { "path": "p202 completion bash", "use": "bash", "short": "Generate the autocompletion script for bash", "long": "Generate the autocompletion script for the bash shell.\n\nThis script depends on the 'bash-completion' package.\nIf it is not installed already, you can install it via your OS's package manager.\n\nTo load completions in your current shell session:\n\n\tsource <(p202 completion bash)\n\nTo load completions for every new session, execute once:\n\n#### Linux:\n\n\tp202 completion bash > /etc/bash_completion.d/p202\n\n#### macOS:\n\n\tp202 completion bash > $(brew --prefix)/etc/bash_completion.d/p202\n\nYou will need to start a new shell for this setup to take effect.", "runnable": true, "flags": [ { "name": "no-descriptions", "type": "bool", "default": "false", "usage": "disable completion descriptions", "required": false } ] }, { "path": "p202 completion fish", "use": "fish", "short": "Generate the autocompletion script for fish", "long": "Generate the autocompletion script for the fish shell.\n\nTo load completions in your current shell session:\n\n\tp202 completion fish | source\n\nTo load completions for every new session, execute once:\n\n\tp202 completion fish > ~/.config/fish/completions/p202.fish\n\nYou will need to start a new shell for this setup to take effect.", "runnable": true, "flags": [ { "name": "no-descriptions", "type": "bool", "default": "false", "usage": "disable completion descriptions", "required": false } ] }, { "path": "p202 completion powershell", "use": "powershell", "short": "Generate the autocompletion script for powershell", "long": "Generate the autocompletion script for powershell.\n\nTo load completions in your current shell session:\n\n\tp202 completion powershell | Out-String | Invoke-Expression\n\nTo load completions for every new session, add the output of the above command\nto your powershell profile.", "runnable": true, "flags": [ { "name": "no-descriptions", "type": "bool", "default": "false", "usage": "disable completion descriptions", "required": false } ] }, { "path": "p202 completion zsh", "use": "zsh", "short": "Generate the autocompletion script for zsh", "long": "Generate the autocompletion script for the zsh shell.\n\nIf shell completion is not already enabled in your environment you will need\nto enable it. You can execute the following once:\n\n\techo \"autoload -U compinit; compinit\" >> ~/.zshrc\n\nTo load completions in your current shell session:\n\n\tsource <(p202 completion zsh)\n\nTo load completions for every new session, execute once:\n\n#### Linux:\n\n\tp202 completion zsh > \"${fpath[1]}/_p202\"\n\n#### macOS:\n\n\tp202 completion zsh > $(brew --prefix)/share/zsh/site-functions/_p202\n\nYou will need to start a new shell for this setup to take effect.", "runnable": true, "flags": [ { "name": "no-descriptions", "type": "bool", "default": "false", "usage": "disable completion descriptions", "required": false } ] }, { "path": "p202 config", "use": "config", "short": "Manage CLI configuration", "runnable": false, "flags": [] }, { "path": "p202 config add-profile", "use": "add-profile ", "short": "Create a named profile", "runnable": true, "flags": [ { "name": "key", "type": "string", "default": "", "usage": "Profile API key (required)", "required": true }, { "name": "url", "type": "string", "default": "", "usage": "Profile base URL (required)", "required": true } ] }, { "path": "p202 config get-default", "use": "get-default [key]", "short": "Get one default value or list all defaults", "runnable": true, "flags": [] }, { "path": "p202 config list-profiles", "use": "list-profiles", "short": "List all configured profiles", "runnable": true, "flags": [ { "name": "tag", "type": "string", "default": "", "usage": "Filter profiles by tag", "required": false } ] }, { "path": "p202 config remove-profile", "use": "remove-profile ", "short": "Remove a named profile", "runnable": true, "flags": [ { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false } ] }, { "path": "p202 config rename-profile", "use": "rename-profile ", "short": "Rename a profile", "runnable": true, "flags": [] }, { "path": "p202 config set-default", "use": "set-default ", "short": "Set a default value for supported command flags", "runnable": true, "flags": [] }, { "path": "p202 config set-key", "use": "set-key [api-key]", "short": "Set the API key (omit the argument to be prompted without echoing)", "runnable": true, "flags": [] }, { "path": "p202 config set-url", "use": "set-url ", "short": "Set the Prosper202 instance URL the API is reached at (the install's address)", "runnable": true, "flags": [] }, { "path": "p202 config show", "use": "show", "short": "Show current configuration", "runnable": true, "flags": [] }, { "path": "p202 config tag-profile", "use": "tag-profile [...]", "short": "Add tags to a profile", "runnable": true, "flags": [] }, { "path": "p202 config test", "use": "test", "short": "Test the connection to the Prosper202 instance and that the API key works", "long": "Checks that the instance answers (GET /system/health) and then that it accepts the\nconfigured key, and says which user the key acts as (`p202 whoami` shows more).\nThe health check alone is answered before authentication, so it passed with any key.", "runnable": true, "flags": [] }, { "path": "p202 config unset-default", "use": "unset-default ", "short": "Remove a configured default value", "runnable": true, "flags": [] }, { "path": "p202 config untag-profile", "use": "untag-profile [...]", "short": "Remove tags from a profile", "runnable": true, "flags": [] }, { "path": "p202 config use", "use": "use ", "short": "Set the active profile", "runnable": true, "flags": [] }, { "path": "p202 conversion", "use": "conversion", "short": "Manage conversions (revenue events recorded via postback or pixel)", "runnable": false, "flags": [] }, { "path": "p202 conversion create", "use": "create", "short": "Create a conversion", "long": "Records a conversion on a click. --status reversed records a reversal of the click's earlier\nconversion with the same --transaction-id instead (--reversal-id is the network's id for it).\n--customer-id or --customer-ref (+ --customer-ref-type, --customer-crm) links it to an LTV\ncustomer; --item / --items-file add product line items to that customer's revenue event, so\nthey need a customer: one named here, one already linked to the click, or the account's\ncustomer c-param. The server refuses items that find none, and records nothing.\n\n p202 conversion create --click-id 123 --payout 49 --transaction-id ORD-1 --customer-ref CUST-77 \\\n --item '{\"sku\":\"PRO-1\",\"quantity\":1,\"unit_price\":49}'\n p202 conversion create --click-id 123 --status reversed --transaction-id ORD-1", "runnable": true, "flags": [ { "name": "click-id", "type": "string", "default": "", "usage": "Click ID (required)", "required": true }, { "name": "click-id-public", "type": "string", "default": "", "usage": "Legacy alias for --click-id", "required": false }, { "name": "conv-time", "type": "string", "default": "", "usage": "When it converted, unix seconds (default now)", "required": false }, { "name": "conversion-payout", "type": "string", "default": "", "usage": "Legacy alias for --payout", "required": false }, { "name": "customer-crm", "type": "string", "default": "", "usage": "CRM fields as a JSON object, applied only when this call creates the customer, e.g. '{\"email\":\"a@b.co\",\"first_name\":\"Ada\"}'", "required": false }, { "name": "customer-id", "type": "string", "default": "", "usage": "The customer's internal id (`p202 ltv customers`)", "required": false }, { "name": "customer-ref", "type": "string", "default": "", "usage": "Your system's id for the customer; the server finds it, or creates a customer for it", "required": false }, { "name": "customer-ref-type", "type": "string", "default": "", "usage": "What kind of reference --customer-ref is (default custom): email_md5, email_sha256, esp_id, merchant_id, subid, custom", "allowed_values": [ "email_md5", "email_sha256", "esp_id", "merchant_id", "subid", "custom" ], "required": false }, { "name": "idempotency-key", "type": "string", "default": "", "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate", "required": false }, { "name": "item", "type": "stringArray", "default": "[]", "usage": "A line item as a JSON object (repeatable), e.g. '{\"sku\":\"PRO-1\",\"name\":\"Pro plan\",\"quantity\":1,\"unit_price\":49}'", "required": false }, { "name": "items-file", "type": "string", "default": "", "usage": "Line items as a JSON array in a file (- for stdin), instead of --item", "required": false }, { "name": "payout", "type": "string", "default": "", "usage": "Payout amount", "required": false }, { "name": "reversal-id", "type": "string", "default": "", "usage": "The network's id for the reversal (with --status reversed)", "required": false }, { "name": "status", "type": "string", "default": "", "usage": "Record a reversal of the click's conversion with this --transaction-id: reversed", "allowed_values": [ "reversed" ], "required": false }, { "name": "transaction-id", "type": "string", "default": "", "usage": "Transaction ID for deduplication", "required": false } ] }, { "path": "p202 conversion delete", "use": "delete ", "short": "Delete a conversion", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Preview what the delete would remove (record + cascade counts) without deleting", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip confirmation prompt", "required": false }, { "name": "ids", "type": "string", "default": "", "usage": "Comma-separated conversion IDs to delete in bulk", "required": false } ] }, { "path": "p202 conversion delete-subids", "use": "delete-subids ", "short": "Delete the conversions of a list of subids, one per line (the UI's Delete Subids)", "long": "The reverse of mark-subids: every live conversion of each subid's click is cleared through\nthe ledger (soft-deleted, its revenue voided, the click's value recomputed), so the click\nis no longer a lead; the click itself stays. A subid of another account is left alone.\n\nIt reads the list first (--dry-run stops there), says how many conversions it would clear,\nand asks (--force skips). Lines are answered cleared (would_clear), not_found, not_a_subid\nor duplicate_in_list, with the file's line numbers. Running it twice is safe.\n\nNeeds a role with access_to_update_section AND delete_individual_subids, and a key with\nconversions:write. Cannot be staged. To clear a whole campaign, use reset-subids.", "example": "p202 conversion delete-subids wrong-subids.txt --dry-run\n p202 conversion delete-subids wrong-subids.txt --force --json", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Say what each line would clear and write nothing", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Delete without asking", "required": false } ], "tasks": [ { "run": "p202 conversion delete-subids", "ui_pages": [ "Update › Delete Subids" ] } ] }, { "path": "p202 conversion get", "use": "get ", "short": "Get a conversion by ID", "runnable": true, "flags": [] }, { "path": "p202 conversion import", "use": "import ", "short": "Record a network's conversion export (CSV or JSON) against its clicks, safely re-runnable", "long": "Reads a network's conversion export — a CSV file with a header row, or a JSON array of\nobjects — and records each line as a conversion on the click its subid names.\n\nColumns (auto-detected from the header, case and punctuation ignored; the flags override):\n subid required: subid, sub_id, aff_sub, sub1, click_id, clickid, s2 (--subid-column)\n payout optional: payout, commission, amount, revenue (--payout-column); $ and\n thousands separators (1,234.50) are dropped, a decimal comma (12,50) is\n refused; absent = the campaign's default payout\n transaction id optional: transaction_id, order_id, txid (--txid-column)\n time optional: date, time, conversion_date, created_at (--time-column); unix\n seconds or ms, or 2026-02-03[ 14:05[:00]] in --timezone (default UTC),\n RFC 3339, or any Go layout given with --time-format; absent = now\nMore than one candidate header for a column is refused: name the one to use.\n\nThe subid is read as the postback (gpb.php) reads it: the click id, digits only, no\nleading zero. Rows are marked invalid (with the reason) or duplicate_in_file (the same\nclick and transaction id as an earlier row; without a transaction id a click converts\nonce, as the postback does). A negative payout with a transaction id reverses that sale;\nnegative rows are sent after the sales, so a newest-first report reverses the right one.\n\n--dry-run shows that plan without contacting the server; add --check-clicks to also read\neach click's conversions (GET /clicks/{id}/conversions, read-only, once per click).\nWithout --dry-run the clicks are always read first, then you confirm (--force skips;\n--staged records proposals instead), then each ready row is sent as POST /conversions\nwith an Idempotency-Key derived from its click, transaction id, payout and time.\n\nStatuses: created, duplicate (the click already has it: same transaction id, or any\nconversion for an id-less row, or the key was replayed, or the server answered it as a\nduplicate or as a deleted conversion's transaction id), conflict (the click has the\ntransaction id with another payout or time; not sent), click_not_found, failed (with\nthe server's message), staged, invalid, duplicate_in_file (ready in a dry run). Re-running\nthe same file is safe: recorded rows come back as duplicate. Exit 5 if any row failed or\nconflicts; re-running the same command then sends only the rows not yet recorded.", "example": "p202 conversion import a2hosting-feb.csv --dry-run\n p202 conversion import a2hosting-feb.csv --dry-run --check-clicks\n p202 conversion import export.csv --subid-column 'Sub ID 2' --time-column 'Sale Date' --timezone America/New_York\n p202 conversion import conversions.json --force --json", "runnable": true, "flags": [ { "name": "check-clicks", "type": "bool", "default": "false", "usage": "With --dry-run, also read each click's conversions to show click_not_found and duplicate rows", "required": false }, { "name": "dry-run", "type": "bool", "default": "false", "usage": "Show the plan and write nothing (no request unless --check-clicks)", "required": false }, { "name": "force", "shorthand": "f", "type": "bool", "default": "false", "usage": "Skip the confirmation prompt", "required": false }, { "name": "payout-column", "type": "string", "default": "", "usage": "Header of the payout column (default: auto-detect; with no payout column the campaign's default payout applies)", "required": false }, { "name": "subid-column", "type": "string", "default": "", "usage": "Header of the column holding the Prosper202 subid (default: auto-detect)", "required": false }, { "name": "time-column", "type": "string", "default": "", "usage": "Header of the conversion time column (default: auto-detect; with no time column the server records now)", "required": false }, { "name": "time-format", "type": "string", "default": "", "usage": "Go time layout of the time column, e.g. '01/02/2006 15:04' (default: unix or ISO dates)", "required": false }, { "name": "timezone", "type": "string", "default": "UTC", "usage": "Zone of times written without one: UTC, an IANA name, or an offset like -05:00", "required": false }, { "name": "txid-column", "type": "string", "default": "", "usage": "Header of the transaction id column (default: auto-detect)", "required": false } ] }, { "path": "p202 conversion list", "use": "list", "short": "List conversions", "runnable": true, "flags": [ { "name": "aff-campaign-id", "type": "string", "default": "", "usage": "Filter by campaign ID", "required": false }, { "name": "all", "type": "bool", "default": "false", "usage": "Fetch all rows across pages", "required": false }, { "name": "click-id", "type": "string", "default": "", "usage": "Only this click's conversions (see also `p202 click conversions `)", "required": false }, { "name": "goal", "type": "string", "default": "", "usage": "Only this goal's outcomes, every version (goal id from `p202 goal list`)", "required": false }, { "name": "limit", "shorthand": "l", "type": "string", "default": "", "usage": "Max results", "required": false }, { "name": "offset", "shorthand": "o", "type": "string", "default": "", "usage": "Pagination offset", "required": false }, { "name": "source", "type": "string", "default": "", "usage": "Only conversions from this source: pixel, postback, universal_pixel, api, subid_upload, revenue_upload, legacy_pixel, clickbank, app_install, goal, legacy_baseline", "allowed_values": [ "pixel", "postback", "universal_pixel", "api", "subid_upload", "revenue_upload", "legacy_pixel", "clickbank", "app_install", "goal", "legacy_baseline" ], "required": false }, { "name": "time-from", "type": "string", "default": "", "usage": "Start: unix seconds, a date (2026-10-01, from its first second in the account's timezone) or a time with its offset (2026-10-01T09:30:00Z)", "required": false }, { "name": "time-to", "type": "string", "default": "", "usage": "End, inclusive: unix seconds, a date (2026-10-01, through its last second in the account's timezone) or a time with its offset", "required": false } ] }, { "path": "p202 conversion mark-subids", "use": "mark-subids ", "short": "Mark clicks converted from a list of subids, one per line (the UI's Update Subids)", "long": "Records each subid's click as converted, at its campaign's payout, through the conversion\nledger (source subid_upload) — once per click: a click that is already a lead is answered\nalready_converted and nothing is added, so running the same list twice is safe.\n\nThe file holds one subid (a click id) per line; - reads the list from piped stdin. Every\nline is answered with its file line number: marked (would_mark with --dry-run),\nalready_converted, not_found (no click of this account), not_a_subid, or duplicate_in_list.\nA long list is sent 1,000 lines a request; when one fails, the lines before it stand and\nrunning the command again marks the rest.\n\nNeeds a role with access_to_update_section and a key with conversions:write. Cannot be staged.", "example": "p202 conversion mark-subids subids.txt --dry-run\n p202 conversion mark-subids subids.txt\n cut -d, -f2 network-report.csv | p202 conversion mark-subids - --json", "runnable": true, "flags": [ { "name": "dry-run", "type": "bool", "default": "false", "usage": "Say what each line would do and write nothing", "required": false } ], "tasks": [ { "run": "p202 conversion mark-subids", "ui_pages": [ "Update › Update Subids" ] } ] }, { "path": "p202 conversion pixel", "use": "pixel", "short": "Print the conversion pixel for your thank-you page (Setup > Postback / Pixel)", "long": "Prints the pixel Setup > Postback / Pixel shows, to put on the conversion or\nthank-you page:\n\n --type simple an image pixel (gpx.php): one click tracked at a time (default)\n --type advanced the same with cid (--campaign): several clicks at once\n --type universal the universal smart pixel (upx.php), which also fires your\n traffic sources' pixels: a JavaScript tag with a fallback for\n browsers without JavaScript, or a plain iframe with --iframe\n\nStdout is the pixel alone, under --quiet too: the image or iframe tag on one line,\nor the universal JavaScript tag as the page writes it (a