文件Experience Platform來源連接器指南

[Beta]{class="badge informative"}

Pinterest Ads

最後更新： 2026年10月2日

建立對象：

  • 開發人員
NOTE
Pinterest Ads來源是測試版。 閱讀條款與條件的來源概觀。
IMPORTANT
Pinterest Ads來源是Customer Journey Analytics SKU的一部分。

使用Pinterest Ads來源連線您的廣告帳戶，並擷取付費媒體中繼資料和效能度量。 Adobe Experience Platform已將此資料發佈到付費媒體資料集。 在Adobe Customer Journey Analytics中使用這些資料集來分析您的行銷活動。

若要連線您的帳戶，請登入Pinterest並授權Experience Platform存取您的廣告資料。 您不需要手動產生或輸入API認證。

內嵌的運作方式 how-it-works

在您建立資料流並選取您的廣告帳戶後，Experience Platform會自動布建資料集並排程內嵌。

處理
行為
資料集布建
重複使用貴組織中的現有付費媒體資料集，並在資料集不存在時建立資料集。
初始回填
會在資料流建立後30分鐘執行，並擷取過去30天的中繼資料和量度。
每日內嵌
從資料流建立後的那天開始每天執行一次，並擷取前一天的中繼資料和量度。
重述
每個每日擷取回合執行三次：在執行後的一天、兩天和三天。

重述會擷取更新的歷史資料，以解決先前報告的量度變更。 您沒有自行設定回填、每日擷取或重新陳述排程。

帳戶必要條件 prerequisites

在連線帳戶之前，請確定您擁有下列專案：

  • 現有的Pinterest廣告帳戶。
  • 已在該廣告帳戶中設定行銷活動和廣告。
  • 存取以登入Pinterest並授權Experience Platform存取您選取的廣告帳戶。

自動資料集設定 schema-and-dataset-provisioning

聯結器會自動指派資料集、結構描述和欄位對應。 您沒有在建立資料流期間建立目標結構描述、選取目標資料集或對應欄位。

對應的實體型別包括帳戶、行銷活動、廣告群組、廣告、資產、體驗和摘要量度。 Assets代表Pinterest個釘選。 體驗記錄結合來自釘選和廣告的資訊，而不是單獨的體驗API。

XDM欄位對應 pinterest-fields

請使用下表瞭解對應至Experience Data Model (XDM)結構描述的核心欄位。 聯結器將paidMedia.adNetwork對應至pinterest。

帳戶欄位 account-fields

帳戶結構描述會儲存您的廣告帳戶身分和帳戶詳細資料。

Pinterest欄位
XDM欄位
說明
id
paidMedia.accountID
廣告帳戶識別碼。
name
paidMedia.accountDetails.accountName
廣告帳戶名稱。
country
paidMedia.accountDetails.country
國家/地區代碼。
currency
paidMedia.accountDetails.currency
貨幣代碼。
permissions
paidMedia.accountDetails.permissions
一系列帳戶許可權。
time_zone
paidMedia.accountDetails.timezone
廣告帳戶時區。
created_time
paidMedia.metadata.createdTime
建立時間戳記，轉換為ISO 8601。
updated_time
paidMedia.metadata.updatedTime
修改時間戳記，轉換為ISO 8601。

行銷活動欄位 campaign-fields

行銷活動結構描述會儲存行銷活動身分識別、狀態以及與廣告帳戶的關係。

Pinterest欄位
XDM欄位
說明
id
paidMedia.campaignID
行銷活動識別碼。
ad_account_id
paidMedia.accountID
上層廣告帳戶識別碼。
name
paidMedia.metadata.name
行銷活動名稱。
status
paidMedia.metadata.status
標準化的行銷活動狀態。
summary_status
paidMedia.metadata.servingStatus
標準化傳遞狀態。
created_time
paidMedia.metadata.createdTime
建立時間戳記，轉換為ISO 8601。
updated_time
paidMedia.metadata.updatedTime
修改時間戳記，轉換為ISO 8601。

對於行銷活動、廣告群組和廣告，聯結器會將ACTIVE、PAUSED、ARCHIVED和DRAFT標準化為小寫狀態值。 它將DELETED_DRAFT對應至deleted。

廣告群組欄位 ad-group-fields

廣告群組結構描述會儲存廣告群組身分以及與行銷活動和帳戶的關係。

Pinterest欄位
XDM欄位
說明
id
paidMedia.adGroupID
廣告群組識別碼。
ad_account_id
paidMedia.accountID
上層廣告帳戶識別碼。
campaign_id
paidMedia.campaignID
上層促銷活動識別碼。
name
paidMedia.metadata.name
廣告群組名稱。
status
paidMedia.metadata.status
標準化的廣告群組狀態。
summary_status
paidMedia.metadata.servingStatus
標準化傳遞狀態。

廣告欄位 ad-fields

廣告方案會儲存廣告身分、評論狀態，以及與其他付費媒體實體的關係。

Pinterest欄位
XDM欄位
說明
id
paidMedia.adID
廣告識別碼。
ad_group_id
paidMedia.adGroupID
上層廣告群組識別碼。
campaign_id
paidMedia.campaignID
上層促銷活動識別碼。
ad_account_id
paidMedia.accountID
上層廣告帳戶識別碼。
pin_id
paidMedia.assetID
相關的PIN識別碼。
name
paidMedia.metadata.name
廣告名稱。
status
paidMedia.metadata.status
標準化的廣告狀態。
review_status
adDetails.reviewStatus
檢閱狀態，例如pending、rejected、approved或not_reviewed。

Creative標題和說明來自相關的Pin，而非廣告物件。

資產欄位 asset-fields

資產結構描述會儲存Pin內容和媒體屬性。 下列對應說明含有單一影像或視訊的圖釘。

Pinterest欄位
XDM欄位
說明
id
paidMedia.assetID
Pin識別碼。
title
assetDetails.title
圖釘標題。
description
assetDetails.description
釘選說明。
media.media_type
assetDetails.assetType
資產型別，例如image或video。
media.images["1200x"].url
assetDetails.mediaProperties.url
最大的可用影像URL。
media.images["150x150"].url
assetDetails.mediaProperties.thumbnailURL
影像縮圖URL。
media.video_url
assetDetails.mediaProperties.url
視訊Pin的視訊URL。
media.cover_image_url
assetDetails.mediaProperties.thumbnailURL
視訊Pin的封面影像URL。
media.duration
assetDetails.videoProperties.duration
由Pinterest提供的視訊持續時間（毫秒）。

對於具有多個影像、影片或混合媒體的Pin，每個專案都會變成個別的資產記錄。 聯結器使用{pin_id}_{index}產生資產識別碼，其中index是從零開始的專案位置。 這些資產使用carousel_card資產型別。

體驗欄位 experience-fields

體驗記錄說明從Pin和廣告衍生的創意體驗。 體驗識別碼使用Pin識別碼。

Pinterest創意型別
XDM體驗型別
REGULAR
single_image
VIDEO, MAX_VIDEO, CTV_VIDEO
single_video
CAROUSEL
carousel
COLLECTION, MAX_WIDTH_REGULAR_COLLECTION, MAX_WIDTH_VIDEO_COLLECTION
collection
IDEA, SHOWCASE
instant_experience
QUIZ, SHOPPING, COLLAGE, APP
other

對於具有多個媒體專案的圖釘，聯結器會為每個專案填入experienceDetails.carouselProperties.cards[]一個專案。 每張卡片都會參考其產生的資產識別碼。

摘要量度欄位 summary-metrics-fields

摘要量度會儲存廣告績效資料。 聯結器會使用PIN_ID做為資產分組索引鍵，從廣告分析對應廣告量度和資產量度。

Pinterest欄位
XDM欄位
說明
SPEND_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR
metrics.spend
Advertising支出。
PAID_IMPRESSION, TOTAL_IMPRESSION
metrics.impressions
曝光計數。
TOTAL_CLICKTHROUGH, CLICKTHROUGH_1, CLICKTHROUGH_2
metrics.clicks
按一下計數。
CTR, ECTR, CTR_2
metrics.ctr
點按率。
TOTAL_ENGAGEMENT, ENGAGEMENT_1, ENGAGEMENT_2
metrics.engagements
參與計數。
TOTAL_CONVERSIONS
metrics.conversions
轉換計數。
CHECKOUT_ROAS
metrics.roas
結帳轉換的廣告支出回報率。
TOTAL_VIDEO_MRC_VIEWS, VIDEO_MRC_VIEWS_1, VIDEO_MRC_VIEWS_2
metrics.videoViews
視訊檢視次數。
TOTAL_VIDEO_P100_COMPLETE, VIDEO_P100_COMPLETE_2
metrics.videoCompletions
已完成的視訊檢視計數。

其他對應包括成本、轉換、影片、歸因和參與量度。

體驗摘要量度包含廣告目標定位分析的裝置和位置劃分。 聯結器要求APPTYPE裝置劃分和PLACEMENT位置劃分。 系統不會要求其他目標劃分。

連線您的帳戶 connect-to-platform

若要建立資料流，請依照Pinterest Ads UI教學課程操作。

使用Pinterest API檔案取得基礎廣告API的相關資訊。

recommendation-more-help
experience-platform-help-sources