Pinterest Ads Field Mappings

Note: Unmapped fields aren’t currently supported. Check the Release Notes for updates.

API Source Field NameDisplayed FieldType
AD_GROUP_IDMedia Buy IdText
AD_GROUP_NAMEMedia Buy NameText
AdGroupEntityStatusMedia Buy StatusText
APPTYPETargeted Segment DeviceText
NameCampaign AdvertiserText
AdAccountIdCampaign Advertiser IDText
CAMPAIGN_IDCampaign IdText
CAMPAIGN_NAMECampaign NameText
CAMPAIGN_STATUSCampaign StatusText
CurrencyCurrencyCurrency
DateDate TimeDateTime
GENDERTargeted Segmen GenderText
INTERESTNot MappedText
LOCATIONTargeted Segmen LocationText
MEDIA_BUY_TARGETING_TYPETargeted Segmen TypeText
PIN_PROMOTION_IDAd IdText
PIN_PROMOTION_NAMEAd NameText
PIN_PROMOTION_STATUSAd Creative StatusText
CreativeTypeAd FormatText
budget_in_micro_currency_DailyMedia Buy Daily BudgetNumber
budget_in_micro_currency_lifetimeMedia Buy BudgetNumber
objective_typeCampaign MethodText
daily_spend_capNot MappedText
destination_urlAd Creative Click UrlText
end_timeMedia Buy End DateDate
media.media_type.image.List.400x300Ad Creative ImageText
lifetime_spend_capCampaign BudgetNumber
optimization_goal_metadata.conversion_eventMedia buy TypeTe_

Note: Unmapped fields aren’t currently supported. Check the Release Notes for updates.

API Source Field NameDisplayed FieldType
AD_GROUP_IDMedia Buy IdText
AD_GROUP_NAMEMedia Buy NameText
AdGroupEntityStatusMedia Buy StatusText
APPTYPETargeted Segment DeviceText
NameAdvertiser NameText
AdAccountIdAdvertiser IDText
CAMPAIGN_IDCampaign IdText
CAMPAIGN_NAMECampaign NameText
CAMPAIGN_STATUSCampaign StatusText
CurrencyCurrencyCurrency
DateDate TimeDateTime
GENDERTargeted Segmen GenderText
INTERESTNot MappedText
LOCATIONTargeted Segmen LocationText
MEDIA_BUY_TARGETING_TYPETargeted Segmen TypeText
PIN_PROMOTION_IDAd IdText
PIN_PROMOTION_NAMEAd NameText
PIN_PROMOTION_STATUSAd Creative StatusText
CreativeTypeAd FormatText
budget_in_micro_currency_DailyMedia Buy Daily BudgetNumber
budget_in_micro_currency_lifetimeMedia Buy BudgetNumber
objective_typeCampaign MethodText
daily_spend_capNot MappedText
destination_urlAd Creative Click UrlText
end_timeMedia Buy End DateDate
media.media_type.image.List.400x300Ad Creative ImageText
lifetime_spend_capCampaign BudgetNumber
optimization_goal_metadata.conversion_eventMedia buy TypeText
pin_idPrimary Ad Creative IdText
start_timeMedia Buy Start DateDate
StartTimeCampaign Start DateDateTime
EndTimeCampaign End DateDateTime
TagNameConversion Tag NameText
CategoryConversion Tag CategoryText
ConversionPostClickConversionsPost Click ConversionsNumber
ConversionPostClickRevenuePost Click RevenueNumber
ConversionPostImpressionConversionsPost Impression ConversionsNumber
ConversionPostImpressionRevenuePost Impression RevenueNumber
ConversionRevenueRevenueNumber
ConversionTotalConversionsConversionsNumber
ConversionTotalEngagementConversions_Not Mapped _Number
Engagement order value (Checkout)_Not Mapped _