name |
str |
Ad group name. |
[optional] |
status |
str |
Ad group/entity status. |
[optional] |
budget_in_micro_currency |
int, none_type |
Budget in micro currency. This field is REQUIRED for non-CBO (campaign budget optimization) campaigns. A CBO campaign automatically generates ad group budgets from its campaign budget to maximize campaign outcome. A CBO campaign is limited to 70 or less ad groups. |
[optional] |
bid_in_micro_currency |
int, none_type |
Bid price in micro currency. This field is REQUIRED for the following campaign objective_type/billable_event combinations: AWARENESS/IMPRESSION, CONSIDERATION/CLICKTHROUGH, CATALOG_SALES/CLICKTHROUGH, VIDEO_VIEW/VIDEO_V_50_MRC. |
[optional] |
optimization_goal_metadata |
{str: (bool, date, datetime, dict, float, int, list, str, none_type)}, none_type |
Optimization goals for objective-based performance campaigns. REQUIRED when campaign's `objective_type` is set to `"WEB_CONVERSION"`. |
[optional] |
budget_type |
str |
|
[optional] |
start_time |
int, none_type |
Ad group start time. Unix timestamp in seconds. Defaults to current time. |
[optional] |
end_time |
int, none_type |
Ad group end time. Unix timestamp in seconds. |
[optional] |
targeting_spec |
TargetingSpec |
|
[optional] |
lifetime_frequency_cap |
int |
Set a limit to the number of times a promoted pin from this campaign can be impressed by a pinner within the past rolling 30 days. Only available for CPM (cost per mille (1000 impressions)) ad groups. A CPM ad group has an IMPRESSION <a href="/docs/redoc/#section/Billable-event">billable_event</a> value. This field REQUIRES the `end_time` field. |
[optional] |
tracking_urls |
{str: (bool, date, datetime, dict, float, int, list, str, none_type)}, none_type |
Third-party tracking URLs.<br> JSON object with the format: {"<a href="/docs/redoc/#section/Tracking-URL-event">Tracking event enum</a>":[URL string array],...}<br> For example: {"impression": ["URL1", "URL2"], "click": ["URL1", "URL2", "URL3"]}.<br>Up to three tracking URLs are supported for each event type. Tracking URLs set at the ad group or ad level can override those set at the campaign level. May be null. Pass in an empty object - {} - to remove tracking URLs.<br><br> For more information, see <a href="https://help.pinterest.com/en/business/article/third-party-and-dynamic-tracking\" target="_blank">Third-party and dynamic tracking</a>. |
[optional] |
auto_targeting_enabled |
bool, none_type |
Enable auto-targeting for ad group. Also known as <a href="https://help.pinterest.com/en/business/article/expanded-targeting\" target="_blank">"expanded targeting"</a>. |
[optional] |
placement_group |
str |
<a href="/docs/redoc/#section/Placement-group">Placement group</a>. |
[optional] |
pacing_delivery_type |
str |
|
[optional] |
campaign_id |
str |
Campaign ID of the ad group. |
[optional] |
billable_event |
ActionType |
|
[optional] |
bid_strategy_type |
str, none_type |
Bid strategy type. For Campaigns with Video Completion objectives, the only supported bid strategy type is AUTOMATIC_BID. |
[optional] |
targeting_template_ids |
[str], none_type |
Targeting template IDs applied to the ad group. We currently only support 1 targeting template per ad group. To use targeting templates, do not set any other targeting fields: targeting_spec, tracking_urls, auto_targeting_enabled, placement_group. To clear all targeting template IDs, set this field to ['0']. |
[optional] |
id |
str |
Ad group ID. |
[optional] |
ad_account_id |
str |
Advertiser ID. |
[optional] |
created_time |
int |
Ad group creation time. Unix timestamp in seconds. |
[optional] |
updated_time |
int |
Ad group last update time. Unix timestamp in seconds. |
[optional] |
type |
str |
Always "adgroup". |
[optional] if omitted the server will use the default value of "adgroup" |
conversion_learning_mode_type |
str, none_type |
oCPM learn mode |
[optional] |
summary_status |
str |
Ad group summary status. |
[optional] |
feed_profile_id |
str |
Feed Profile ID associated to the adgroup. |
[optional] |
dca_assets |
bool, date, datetime, dict, float, int, list, str, none_type |
[DCA] The Dynamic creative assets to use for DCA. Dynamic Creative Assembly (DCA) accepts basic creative assets of an ad (image, video, title, call to action, logo etc). Then it automatically generates optimized ad combinations based on these assets. |
[optional] |
any string name |
bool, date, datetime, dict, float, int, list, str, none_type |
any string name can be used but the value must be the correct type |
[optional] |