Live read: Get one ad group

Available on:

Asks the provider for one ad group now, and gives its payload with the field names of the provider.

The keys are the provider’s, and so is the shape. A Meta ad set answers id, name, campaign_id, status, its two budget fields, its bid as bid_strategy, bid_amount and bid_constraints, and its schedule as start_time and end_time; a TikTok ad group answers adgroup_id, budget_mode, optimization_goal, billing_event and placement_type; a Google Ads ad group answers id, name, status and campaignId.

The payload holds the fields AdCrunch asks the provider for, and no more. Targeting is outside that set at every provider, so no payload here carries it.

Money

AdCrunch changes one thing in the payload: the money of Meta, bid_amount, daily_budget and lifetime_budget. Meta writes each amount in a unit that depends on the currency. This read gives each one as a number in whole units of the currency of the advertiser. It is the unit of budget on a row: 250 is 250.00. When AdCrunch does not know the currency of the advertiser, each of these fields is null.

A TikTok amount is in whole units already, so it does not change. A Google Ads field whose name ends in Micros states its unit, so it stays in micros: 12340000 is 12.34.

When there is nothing to give

404 — the provider holds no such ad group on this ad account, the provider has no ad group at all, or your organization does not own the advertiser in the path. They are deliberately not told apart: distinguishing them would confirm that a ad group exists to somebody who cannot read it.