tracee ads

accounts

Ad platforms and accounts. Which ad platforms are connected, their accounts, how far synced data reaches and the last sync.

tracee ads accounts

campaigns

Campaign performance. Spend, clicks, CTR, CPC, platform-reported leads, CRM contacts and MQLs and cost per lead for every campaign, on any set of platforms, with totals per platform and an optional comparison with the previous period.

tracee ads campaigns [--platforms <platforms>] [--days <days>] [--from <from>] [--to <to>] [--campaign-ids <campaign_ids>] [--query <query>] [--status <status>] [--sort <sort>] [--compare] [--include-idle] [--limit <limit>]

• --platformsstring[]

  The platforms Repeat the flag or separate values with commas.

  up to 6 items

  Available options:googlemetalinkedintiktokredditpinterest

• --daysinteger

  Window ending today; 30 by default

  1–731

• --fromstring

  Start date, YYYY-MM-DD (with to, instead of days)

  pattern ^\d{4}-\d{2}-\d{2}$

• --tostring

  End date, YYYY-MM-DD

  pattern ^\d{4}-\d{2}-\d{2}$

• --campaign-idsstring[]

  Only these. From GET /api/v1/ads/campaigns Repeat the flag or separate values with commas.

  up to 100 itemseach uuid

• --querystring

  Part of the campaign's name

  up to 4,000 characters

• --statusstring

  The status

  Available options:ActivePaused

• --sortstring

  The sort

  Available options:spendcrm_contactscrm_mqlscost_per_mqlcost_per_contactclicks

• --compare / --no-compareboolean

  Add the previous period

• --include-idle / --no-include-idleboolean

  Also those with no spend or leads

• --limitinteger

  The limit

  1–200

daily

Day by day. One campaign, or platforms summed, day by day.

tracee ads daily [--campaign-id <campaign_id>] [--platforms <platforms>] [--days <days>] [--from <from>] [--to <to>]

• --campaign-idstring

  One campaign, from GET /api/v1/ads/campaigns

  uuid

• --platformsstring[]

  The platforms Repeat the flag or separate values with commas.

  up to 6 items

  Available options:googlemetalinkedintiktokredditpinterest

• --daysinteger

  Window ending today; 30 by default

  1–731

• --fromstring

  Start date, YYYY-MM-DD (with to, instead of days)

  pattern ^\d{4}-\d{2}-\d{2}$

• --tostring

  End date, YYYY-MM-DD

  pattern ^\d{4}-\d{2}-\d{2}$

sync

Sync ad platforms. Pulls fresh numbers from each connected platform (or the ones named) and reruns attribution.

tracee ads sync [--platforms <platforms>] [--days <days>] [--connection-id <connection_id>]

• --platformsstring[]

  The platforms Repeat the flag or separate values with commas.

  up to 6 items

  Available options:googlemetalinkedintiktokredditpinterest

• --daysinteger

  Window ending today; 30 by default

  1–731

• --connection-idstring

  One account, from GET /api/v1/ads/accounts

  uuid

--data <json|@file|-> sends the whole body instead of flags.

tracee ads sync --platforms google

conversions

Conversion actions. The conversion actions each platform defines, read live.

tracee ads conversions [--platforms <platforms>]

• --platformsstring[]

  The platforms Repeat the flag or separate values with commas.

  up to 6 items

  Available options:googlemetalinkedintiktokredditpinterest

google-query

Run a Google Ads query. Read-only GAQL (SELECT … FROM … [WHERE …]) on the connected Google Ads accounts; at most 200 rows each.

tracee ads google-query --query <query> [--customer-id <customer_id>]

• --querystringrequired

  The GAQL statement

  up to 4,000 characters

• --customer-idstring

  One Google Ads account id. From GET /api/v1/ads/accounts

  up to 20 characters

--data <json|@file|-> sends the whole body instead of flags.

tracee ads google-query --query pricing