文档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天的元数据和量度。
每日摄取
每天运行一次，从数据流创建后的第二天开始，并检索前一天的元数据和量度。
重述
每次每日摄取运行三次：即该运行后的一天、两天和三天。

Restatement会检索更新的历史数据，以便考虑先前报告的量度的更改。 您自己不配置回填、每日摄取或重新声明计划。

帐户先决条件 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
Pin标题。
description
assetDetails.description
Pin描述。
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 creative type
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

对于具有多个媒体项目的Pin，连接器会为每个项目填充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广告UI教程操作。

有关基础广告API的信息，请使用Pinterest API文档。

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