Pinterest Ads Field Mappings

Media Delivery

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

API Source Field Name Displayed Field Type
AD_GROUP_ID Media Buy Id Text
AD_GROUP_NAME Media Buy Name Text
AdGroupEntityStatus Media Buy Status Text
APPTYPE Targeted Segment Device Text
Name Campaign Advertiser Text
AdAccountId Campaign Advertiser ID Text
CAMPAIGN_ID Campaign Id Text
CAMPAIGN_NAME Campaign Name Text
CAMPAIGN_STATUS Campaign Status Text
Currency Currency Currency
Date Date Time DateTime
GENDER Targeted Segmen Gender Text
INTEREST Not Mapped Text
LOCATION Targeted Segmen Location Text
MEDIA_BUY_TARGETING_TYPE Targeted Segmen Type Text
PIN_PROMOTION_ID Ad Id Text
PIN_PROMOTION_NAME Ad Name Text
PIN_PROMOTION_STATUS Ad Creative Status Text
CreativeType Ad Format Text
budget_in_micro_currency_Daily Media Buy Daily Budget Number
budget_in_micro_currency_lifetime Media Buy Budget Number
objective_type Campaign Method Text
daily_spend_cap Not Mapped Text
destination_url Ad Creative Click Url Text
end_time Media Buy End Date Date
media.media_type.image.List.400x300 Ad Creative Image Text
lifetime_spend_cap Campaign Budget Number
optimization_goal_metadata.conversion_event Media buy Type Te_

Media Conversion

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

API Source Field Name Displayed Field Type
AD_GROUP_ID Media Buy Id Text
AD_GROUP_NAME Media Buy Name Text
AdGroupEntityStatus Media Buy Status Text
APPTYPE Targeted Segment Device Text
Name Advertiser Name Text
AdAccountId Advertiser ID Text
CAMPAIGN_ID Campaign Id Text
CAMPAIGN_NAME Campaign Name Text
CAMPAIGN_STATUS Campaign Status Text
Currency Currency Currency
Date Date Time DateTime
GENDER Targeted Segmen Gender Text
INTEREST Not Mapped Text
LOCATION Targeted Segmen Location Text
MEDIA_BUY_TARGETING_TYPE Targeted Segmen Type Text
PIN_PROMOTION_ID Ad Id Text
PIN_PROMOTION_NAME Ad Name Text
PIN_PROMOTION_STATUS Ad Creative Status Text
CreativeType Ad Format Text
budget_in_micro_currency_Daily Media Buy Daily Budget Number
budget_in_micro_currency_lifetime Media Buy Budget Number
objective_type Campaign Method Text
daily_spend_cap Not Mapped Text
destination_url Ad Creative Click Url Text
end_time Media Buy End Date Date
media.media_type.image.List.400x300 Ad Creative Image Text
lifetime_spend_cap Campaign Budget Number
optimization_goal_metadata.conversion_event Media buy Type Text
pin_id Primary Ad Creative Id Text
start_time Media Buy Start Date Date
StartTime Campaign Start Date DateTime
EndTime Campaign End Date DateTime
TagName Conversion Tag Name Text
Category Conversion Tag Category Text
ConversionPostClickConversions Post Click Conversions Number
ConversionPostClickRevenue Post Click Revenue Number
ConversionPostImpressionConversions Post Impression Conversions Number
ConversionPostImpressionRevenue Post Impression Revenue Number
ConversionRevenue Revenue Number
ConversionTotalConversions Conversions Number
ConversionTotalEngagementConversions _Not Mapped _ Number
Engagement order value (Checkout) _Not Mapped _