Get campaign

Campaign's Advertiser ID.

Campaign creation time. Unix timestamp in seconds.

Note: The default for this field is null, which is treated the same as 0. For campaign budget optimization, a daily or lifetime spend cap must be set, but not both. For ad group level budgets, this field must be 0 or unset.

When transitioning from campaign budget optimization to non-campaign budget optimization, the default_ad_group_budget_in_micro_currency will propagate to each child ad groups daily budget. Unit is micro currency of the associated advertiser account.

Note: To clear this field on update, set the end time to -1. Timestamp in Unix format for scheduling when ads in the campaign stop appearing. Must occur after any end times for child ad groups. If end_time is not specified for the campaign, ads run indefinitely unless you update the campaign, changing their status to paused. Learn about scheduling campaigns. Different end times can be set for the campaign's child ad groups, but they cannot occur after an end_time specified for the campaign.

• If your campaign has a child ad group with an end time specified, and if you update that campaign with an end_time that is earlier than that of the ad group, the campaign end_time will supersede the ad group end_time, and the request will not return an error.
• In this scenario, if you call List campaigns or List ad groups, the returned campaigns or ad groups are listed with the start and end times that you assigned them, regardless of supersedence.

Campaign ID, must be associated with the ad account ID provided in the path.

Specifies the intended promotion type for the campaign.

Note: This field is immutable unless the campaign is in draft status.

STANDARD_AD

• For ads derived from Pins.
• Supported for all objective types except for current CATALOG_SALES and WEB_CONVERSION, which are being deprecated.
• For simplified objective types.

CATALOG

• For creating product group promotions.
• Supported for CONSIDERATION and SALES objective types.
• For simplified objective types.

LEGACY

• Intended only for maintaining backward compatibility.
• Must be used for CATALOG_SALES and WEB_CONVERSION.
• Supported for CATALOG_SALES and WEB_CONVERSION objective types.

If you do not provide this parameter, the default is:

• LEGACY for CATALOG_SALES and WEB_CONVERSION
• STANDARD_AD for other objective types

Note: This field is immutable unless the campaign is in draft status. Specifies whether the campaign was created in the automated campaign flow. When using Automated Campaigns, a daily spend cap must be set, and Pinterest Performance+ may not be used. The following objective types are supported:

• CONSIDERATION
• WEB_CONVERSION
• SALES
• LEADS
• CATALOG_SALES

Note: This field is immutable unless the campaign is in draft status. Determines if a campaign automatically generates ad-group level budgets given a campaign budget to maximize campaign outcome. When using campaign budgets with a lifetime spend cap, the end time must be provided.

Whether the campaign contains a carting(where-to-buy link) ad.

Determine if a campaign has setup for flexible daily budgets, also known as "Pinterest Performance+ budgets". Flexible daily budgets are only supported for campaign budget optimization with a daily spend cap, and not a lifetime spend cap.

Specifies whether the campaign is optimized for Lifetime Value (LTV). Only available for eligible advertisers.

Note: This field is immutable unless the campaign is in draft status. You can only use this feature with the following objectives:

• CONSIDERATION
• WEB_CONVERSION
• SALES
• LEADS
• CATALOG_SALES
• APP_INSTALL Enable Pinterest Performance+ for your campaign. To learn more, see Pinterest Performance+ Setup

Note: This field is immutable unless the campaign is in draft status. Restricted Have your ads and content appear at the top of search result lists in Pinterest. You can only use this feature with the following objectives:

• CONSIDERATION
• WEB_CONVERSION
• SALES
• LEADS
• CATALOG_SALES You cannot use this feature with Pinterest Performance+ or Premiere Spotlight enabled.

Note: The default for this field is null, which is treated the same as 0. For campaign budget optimization, a daily or lifetime spend cap must be set, but not both. For ad group level budgets, this field must be 0 or unset.

Campaign name - 255 chars max.

Campaign objective type. If set as one of ["AWARENESS", "CONSIDERATION", "WEB_CONVERSION", "CATALOG_SALES", "VIDEO_COMPLETION", "CTV_CONSIDERATION"] the campaign is considered as a Campaign Budget Optimization (CBO) campaign, meaning budget needs to be set at the campaign level rather than at the ad group level. ["WEB_SESSIONS"] is DEPRECATED. VIDEO_VIEW is deprecated; use VIDEO_COMPLETION instead. CTV_CONSIDERATION is in BETA. For update, only draft campaigns may update objective type.

Note: To clear this field on update, set the order line ID to 0. Order line ID that appears on the invoice. The order line must not be expired.

Timestamp in Unix format for scheduling when ads in the campaign start to appear. Must precede any start times set for child ad groups. Defaults to current time if no time is specified. Learn about scheduling campaigns. Different start times can be set for the campaign's child ad groups, but they cannot occur before a start_time specified for the campaign.

• If your campaign has a child ad group with a start time specified, and if you update that campaign with a start_time that is later than that of the ad group, the campaign start_time will supersede the ad group start_time, and the request will not return an error.
• In this scenario, if you call List campaigns or List ad groups, the returned campaigns or ad groups are listed with the start and end times that you assigned them, regardless of supersedence.

Entity status

Summary status for campaign

Always "campaign".

UTC timestamp. Last update time.