概览

Pinterest 转化 API 让广告主可以通过服务器到服务器的连接，直接向 Pinterest 发送转化。通过 Pinterest API 捕获的转化事件随后可用于推广计划中的重新定位，并可在转化报告中进行审核，从而更好地了解转化。

通过 Pinterest 转化 API，广告主可以发送以下转化事件：

网页转化

应用程序内转化

离线转化

事件可以实时接收，或在发生和被捕获后一小时内接收。如果事件在此时间范围之外接收，或者属于延迟批量事件的一部分，则会被记为离线转化。

将 Pinterest 转化 API 与 Pinterest 标签搭配使用，有助于最大限度地了解捕获到的转化事件。我们的最佳实践是同时使用这两种转化捕获解决方案，以确保您能全面了解转化推广计划的表现。

Pinterest API

Pinterest 转化 API 是我们 Pinterest API 生态系统中的几种产品之一。拥有 Pinterest Business 帐户的任何人都可以使用 Pinterest 转化 API，但他们并不会自动获得更广泛的 Pinterest API 访问权限。

Pinterest 开发者平台提供有关 Pinterest 所有 API 产品的信息。

开始使用

拥有 Pinterest Business 帐户的任何人都可以访问 Pinterest 转化 API。

首先，您需要生成访问令牌。访问令牌是一串字符，可验证所提出并发回至正确用户帐户的请求。

请按以下步骤生成访问令牌：

登录 Pinterest 企业帐户

点击顶部菜单中的广告，然后选择转化

在左侧导航栏中选择转化访问令牌页面

点击生成新令牌按钮

复制新生成的访问令牌并返回到设置流程。

如果您要访问不归自己所有的帐户，则需要先设置企业访问权限。

实施

转化事件：所有可在 Pinterest 标签上捕获的事件类型也可通过 Pinterest 转化 API 获取。您可以在我们的 Pinterest API 开发者文档中找到事件的完整列表，以及有关事件重要性的进一步信息。

设置服务器到服务器 API 集成需要具备两个条件：开发者以及网站所有者提供的工程资源。技术开发者的工作量将因以下因素而异：

开发者对 API 集成的熟悉程度。如果他们以前从未进行过 API 集成，可能工作量就会相对较多。如果你已实施其他转化 API，你的开发者仅需进行一些增加性的更改。

所跟踪事件的数量，以及数据将在转化过程哪个阶段发送给我们。

广告主是否想要或需要使用第三方进行集成（例如 Shopify、GTM、Tellium）。

如果您已经在使用 Pinterest 标签

我们强烈建议您将 Pinterest 转化 API 与 Pinterest 标签搭配使用，以最大限度实现转化。

如果您先前已经设置 Pinterest 标签，则需要确保转化不会被计算两次（一次是通过 Pinterest 标签，一次是通过 API）。

为此，您需要确保参数 event_id 是与通过 Pinterest 标签和 Pinterest 转化 API 捕获的转化一起传回。

然后，我们的系统会将相应 event_id 识别为重复值，并且仅保留捕获的第一个转化。为确保去重成功，event_id 必须满足以下条件：

同一转化的 event_id 必须相同：当一位用户访问网页时，Pinterest 标签和 Pinterest API 都会触发页面访问转化。这两个转化传回的 event_id 必须一致，以便我们的系统将其识别为同一转化。

不同转化的 event_id 必须是独一无二的：当一位用户访问网页时，Pinterest 标签和 Pinterest API 都会触发页面访问转化。随后，该用户将一件 T 恤添加到购物车中，从而在 Pinterest 标签和 Pinterest API 中均触发 AddToCart 事件。虽然针对同一事件触发的 event_id 必须一致，但页面访问事件和 AddToCart 事件发送的 event_id 必须是独一无二的。如此一来，我们的系统便会将它们识别为不同的事件。

根据事件 ID 和 event_name，Pinterest 会从记录中移除所有重复事件，但前提是： (a) 事件并非离线发生（action_source 非离线），以及 (b) Pinterest 收到转化事件后，在 48 小时内收到其重复事件。

验证设置

API 设置完成后，您可以通过检查以下内容来验证是否收到了转化事件：

回复代码：设置 API 集成的开发者可以查看转化触发后传回的各个请求所返回的回复代码。

广告管理工具中的去重页面：去重后的转化会显示在广告管理工具的去重页面上。如要访问去重页面，请执行以下操作：

• 登录 Pinterest 企业帐户
• 点击顶部菜单中的“广告”，然后选择“转化”
• 在左侧导航栏中选择“去重”。

质量和灵活性

灵活性是转化 API 设置的状态，通过该设置可进行最高级别的信号匹配和归因。 随着广告行业政策的变化和演变，这些附加数据将有助于我们提供更准确的报告。

灵活性状态

灵活性状态分为“良好”和“差”两种。你可以在广告管理工具的“转化运行状况”部分查看灵活性状态。

灵活性良好

选项 1：特定标识符覆盖率

标识符覆盖率

• 90% 或以上的事件应有 IP/UA；
• 10% 或以上的底部漏斗事件有经过哈希处理的电子邮件地址或 MAID；
• 10% 或以上的事件有外部 ID。

与标签数据重叠（如适用）

• 90%* 或以上的标签事件应通过 CAPI 接收

或者：

选项 2：达到基本匹配率

CAPI 用户匹配率为 60% 或以上

与标签数据重叠（如适用）

90%* 或以上的标签事件应通过 CAPI 接收

灵活性差

灵活性状态为“差”的任何设置。

灵活性 ID 和信号

发送以下信号以达到灵活的广告主状态。

API ID /信号	权重/排名
client_ip_address + client_user_agent	高
Em	高
external_id	高
hashed_maid	高
click_id	高
fn + ln	低
Ph	低
ge, bd, ct, st, zp, country	低

*基于匹配率增加概率的权重/排名

第三方实施

Pinterest 拥有多项第三方集成，帮助支持您的 API 采用流程。

Google Tag Manager - 服务器端

将 Google Tag Manager 帐户与 Pinterest 转化 API 关联，了解 Pinterest 对商店流量和产品销售产生的影响。

此集成功能要求利用首选的云提供商和服务器端标记知识来部署服务器容器。如需了解更多关于前提条件的信息，请访问开发者网站。

Shopify

这项转化 API 集成功能与 Pinterest 标签相辅相成，可确保较高的数据覆盖面和质量。安装 Shopify 应用程序后，无需执行任何操作即可利用此增强功能。更改会自动应用到商家的商店。

Tealium

如果广告主对 Tealium 感兴趣，可以直接在第三方平台上设置转化 API。Tealium 构建模板并有助于促进与广告主的集成。

Tealium 的学习中心内概述了实施过程。如有任何关于实施支持的问题，请将其发送至 support [at] tealium.com (support[at]tealium[dot]com)。

如果您对任何其他第三方集成感兴趣，请联系您的销售代表了解详情。

了解有限数据处理

自 2023 年 1 月 1 日起，广告主可以使用有限数据处理标志来帮助遵守《加州消费者隐私法案》（经《加州隐私权法案》修订，以下统称为“CCPA”）。借助此标志，Pinterest 将限制我们如何使用特定数据，以帮助广告主遵守用户隐私设置。例如，对于根据 CCPA 选择不销售或共享其数据的加州用户，广告主可能会使用有限数据处理标志。使用有限数据处理标志后，根据 CCPA，Pinterest 将充当加州用户带有标志的数据的服务提供商。

广告主负责遵守用户选择退出的规定，以及在实施有限数据处理标志时识别用户所居住的州。