v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

targeting_template

Create targeting templates

Targeting templates allow advertisers to save a set of targeting details including audience lists, keywords & interest, demographics, and placements to use more than once during the campaign creation process.

Templates can be used to build out basic targeting criteria that you plan to use across campaigns and to reuse performance targeting from prior campaigns for new campaigns.

post/ad_accounts/{ad_account_id}/targeting_templates

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

auto_targeting_enabledboolean

Enable auto-targeting for ad group. Also known as "expanded targeting".

namestring required

targeting template name

placement_group'ALL' | 'SEARCH' | 'BROWSE' | 'OTHER'

Campaign placement group type

Example request

{
  "keywords": [
    {
      "match_type": "BROAD",
      "value": "couples halloween costumes"
    }
  ],
  "placement_group": "ALL",
  "targeting_attributes": {
    "SHOPPING_RETARGETING": [
      {
        "lookback_window": 30,
        "exclusion_window": 14,
        "tag_types": [
          0,
          6
        ]
      }
    ]
  },
  "tracking_urls": {
    "impression": [
      "URL1",
      "URL2"
    ],
    "click": [
      "URL1",
      "URL2"
    ],
    "engagement": [
      "URL1",
      "URL2"
    ],
    "buyable_button": [
      "URL1",
      "URL2"
    ],
    "audience_verification": [
      "URL1",
      "URL2"
    ]
  }
}

Response

The request has succeeded.

ad_account_idstring

The ID of the advertiser that this targeting template belongs to.

auto_targeting_enabledboolean

Enable auto-targeting for ad group. Also known as "expanded targeting".

created_timeinteger

Targeting template created time. Unix timestamp in seconds.

idstring

Targeting template ID.

namestring required

targeting template name

placement_group'ALL' | 'SEARCH' | 'BROWSE' | 'OTHER'

Campaign placement group type

status'ACTIVE' | 'DELETED'

Indicate targeting template is active or Deleted

updated_timeinteger

Targeting template updated time.Unix timestamp in seconds.

validboolean nullable

Inform if the targeting template is valid (ex. would be false if has revoked audience)

Example response

{
  "keywords": [
    {
      "match_type": "BROAD",
      "value": "couples halloween costumes"
    }
  ],
  "placement_group": "ALL",
  "sizing": {
    "reach_estimate": {
      "estimate": 63492000,
      "lower_bound": 47619000,
      "upper_bound": 79365000
    }
  },
  "targeting_attributes": {
    "SHOPPING_RETARGETING": [
      {
        "lookback_window": 30,
        "exclusion_window": 14,
        "tag_types": [
          0,
          6
        ]
      }
    ]
  },
  "tracking_urls": {
    "impression": [
      "URL1",
      "URL2"
    ],
    "click": [
      "URL1",
      "URL2"
    ],
    "engagement": [
      "URL1",
      "URL2"
    ],
    "buyable_button": [
      "URL1",
      "URL2"
    ],
    "audience_verification": [
      "URL1",
      "URL2"
    ]
  }
}