Create ad groups
Create multiple new ad groups. All ads in a given ad group will have the same budget, bid, run dates, targeting, and placement (search, browse, other).
For more information, click here.
Notes:
- bid_in_micro_currency and budget_in_micro_currency should be expressed in microcurrency amounts based on the currency field set in the advertiser's profile.
Microcurrency is used to track very small transactions, based on the currency set in the advertiser's profile. A microcurrency unit is 10^(-6) of the standard unit of currency selected in the advertiser's profile.
Equivalency equations, using dollars as an example currency:
- $1 = 1,000,000 microdollars
- 1 microdollar = $0.000001
To convert between currency and microcurrency, using dollars as an example currency:
-
To convert dollars to microdollars, multiply dollars by 1,000,000
-
To convert microdollars to dollars, divide microdollars by 1,000,000
-
Ad groups belong to ad campaigns. Some types of campaigns (e.g. budget optimization) have limits on the number of ad groups they can hold. If you exceed those limits, you will get an error message.
-
Certain organizations with closed beta access can set start_time and end_time at the ad group level for campaigns with Campaign Budget Optimization (CBO) objectives: TRAFFIC, AWARENESS, WEB_CONVERSIONS, and CATALOG_SALES. All other organizations can set these scheduling parameters for non-CBO campaigns only.
-
If the parent ad campaign has start and end times set, ad group start and end times must occur within the parent campaign schedule.
Path parameters
Unique identifier of an ad account.
Request body
Example request
[
{
"billable_event": "CLICKTHROUGH",
"budget_type": "DAILY",
"pacing_delivery_type": "STANDARD",
"placement_group": "ALL",
"status": "ACTIVE",
"targeting_spec": {
"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.
Example response
{
"items": [
{
"data": {
"billable_event": "CLICKTHROUGH",
"placement_group": "ALL",
"status": "ACTIVE",
"targeting_spec": {
"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"
]
}
},
"exceptions": [
{
"code": 2,
"message": "Advertiser not found."
}
]
}
]
}