Pinterest 事件转发扩展

Pinterest 是一个可视化发现引擎，用于查找脚本、家庭装饰、风格灵感等想法。 有数十亿个针脚在 Pinterest，也可以与他人共享 Pinterest. 您可以整理用户交互事件并利用 Pinterest Analytics 以了解用户行为并运行定向广告。

此 Pinterest 转化 API 事件转发 通过扩展，您可以利用在Adobe Experience Platform Edge Network中捕获的数据并将其发送至 Pinterest. 本文档介绍了扩展的用例，如何安装扩展，以及如何将其功能集成到事件转发中 规则.

转化访问令牌是使用的身份验证方法 Pinterest 与交互时 Pinterest API。

用例

如果您要在以下位置使用来自Edge Network的数据，则应该使用此扩展： Pinterest 以利用其客户分析功能。

例如，以组织中的营销团队为例。 团队从其网站捕获用户交互事件数据并将其加载到 Pinterest 使用此事件转发扩展。

然后，营销和分析团队可以利用 Pinterest 分析功能，以了解关键用户交互和行为，从而让您更好地了解用户并将他们定位到有针对性的广告促销活动中。

有关特定用例的更多信息 Pinterest，请参阅 Pinterest 用例 文档。

Pinterest 先决条件

您必须拥有有效的 Pinterest 商业帐户 才能使用此扩展。 转到 Pinterest 注册页面 以注册并创建帐户（如果尚未注册）。

您还需要 Pinterest 开发人员帐户，需要将其与您的 Pinterest 商业帐户。 要将开发人员帐户与业务帐户相关联，请参阅 Pinterest ​ 开发人员帐户.

收集所需的配置详细信息

为了将Experience Platform连接到 Pinterest时，需要以下输入值：

凭据 描述 示例
广告帐户ID 您的 Pinterest 广告帐户ID。 请参阅 Pinterest 文档 作为指导。 123456789012
转化访问令牌 您的 Pinterest 转换访问令牌。 请参阅 Pinterest 转化API 指导文件。
您只需执行此操作一次，因为此令牌不会过期。

安装和配置 Pinterest 扩展

要安装扩展， 创建事件转发属性 或者选择现有的属性进行编辑。

在左侧导航中，选择 扩展. 选择 安装 在的卡片上 Pinterest 中的扩展 目录 选项卡。

目录显示 Pinterest 扩展 安装 突出显示。

配置 Pinterest 扩展

重要

根据您的实施需求，您可能需要在配置扩展之前创建架构、数据元素和数据集。 请在开始之前查看所有配置步骤，以确定需要为用例设置哪些实体。

在左侧导航中，选择 扩展. 选择 配置 在的卡片上 Pinterest 中的扩展 已安装选**选项卡。

Pinterest 扩展如中所示 安装 制表符 配置 突出显示。

在下一个屏幕上，输入 广告帐户ID 和 转化访问令牌 您之前在 配置详细信息 部分。 完成后，选择​保存。

此 Pinterest 配置 屏幕高亮显示 广告帐户ID 和 转化访问令牌 输入字段。

配置事件转发规则

设置完所有数据元素后，您可以开始创建事件转发规则，以确定将事件发送到的时间和方式 Pinterest.

新建 规则 在事件转发属性中。 下 操作，添加新操作并将扩展设置为 pinterest. 要将Edge Network事件发送到 Pinterest，设置 操作类型 到 发送事件.

此 Pinterest 发送事件 规则创建。

选择后，会显示其他控件以进一步配置事件。 您需要映射 Pinterest 事件属性到您之前创建的数据元素。

事件数据

创建新规则需要以下事件数据：

字段名称 描述 示例
活动名称 用户事件的类型。 但是，这可以是要利用的任何事件类型 Pinterest Analytics 建议使用 Pinterest 事件代码 *结账
* add_to_cart
* page_visit
*注册
* [用户定义的事件]
操作源 指示转化事件发生的位置的源。 * app_android
* app_ios
* web
*脱机
事件时间 这是指事件时间。 使用的默认时间格式为UNIX，格式为 <seconds>.<miliseconds> 这取决于您当地的时区。 欲了解更多信息，请参见 Pinterest API. 1433188255.500表示新纪元后的1433188255秒和500毫秒，或2015年6月1日星期一的7秒:50:晚上55时格林威治标准时间
事件ID 一个唯一的ID字符串，可标识此事件，并可用于在通过转化API和Pinterest跟踪摄取的事件之间删除重复项。 否则，事件的数据可能会被重复计数，并将报告量度虚增。 ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
事件属性 包含事件的自定义属性的JSON对象。 从提供原始JSON或使用一组简化的键值输入中进行选择。

此 Pinterest 事件数据 在“规则”操作中突出显示。

可以配置以下事件属性：

字段名称 描述
事件源URL Web转换事件的URL。
应用程序商店ID 应用商店应用程序ID。
应用程序名称 应用程序的名称。
Application Version 应用程序的版本。
设备品牌 用户正在使用的设备的品牌。
设备托架 用户的设备的移动设备运营商。
设备型号 用户设备的型号。
Device Type 用户正在使用的设备类型。
操作系统版本 设备的操作系统版本。
用户语言 用于指示用户语言的双字符ISO-639-1语言代码。

用户数据

可以输入的以下用户数据不是必填字段：

字段名称 描述 示例
电子邮件 用户电子邮件地址或用户地址电子邮件的SHA256哈希。 ebd543592…f2b7e1
移动设备广告ID 用户的“Google广告ID”(GAID)或“Apple的广告商标识符”(IDFA)的Sha256哈希 ebd543592…f2b7e1
客户端IP地址 用户的IP地址，可以是IPv4或IPv6格式。 用于匹配。 192.168.0.1
客户端用户代理 用户Web浏览器的用户代理字符串。 Mozilla/5.0 （平台；rv：geckoversion）Gecko/geckotrail Firefox/firefoxversion
客户信息数据 包含其他客户信息的JSON对象。 从提供原始JSON或使用一组简化的键值输入中进行选择。

此 Pinterest 用户数据 在“规则”操作中突出显示。

可以配置的客户信息属性包括：

字段名称 描述
Phone 用户联系电话。 仅接受数字，并且应输入国家/地区代码、区号和号码。
性别 性别可以输入为“f”（女性）、“m”（男性）或“n”（非二进制）。
出生日期 出生日期，按年、月、日输入。
姓氏 用户的姓氏。
名字 用户的名字。
城市 用户的居住城市。 这主要用于计费目的。
State 用户的状态，以小写形式提供为两个字母的代码。
邮政编码 用户的邮政编码，主要用于计费目的。
国家/地区 双字符ISO-3166国家/地区代码，指示用户的国家/地区。
外部ID 广告商的唯一ID，用于标识其空间中的用户。 例如，用户ID、忠诚度ID等。
点击ID 域上存储在_epik Cookie中的唯一标识符或URL中的&epik=查询参数。
重要

将数据发送到之前 Pinterest API端点，扩展将散列并标准化以下字段的值：电子邮件、电话号码、名字、姓氏、性别、出生日期、城市、州、邮政编码、国家/地区和外部ID。 如果已经存在SHA256字符串，扩展将不会对这些字段的值进行哈希处理。

自定义数据

可以为规则输入以下自定义数据：

字段名称 描述
货币 ISO-4217货币代码。 如果未提供， Pinterest 将默认使用在创建帐户期间设置的广告商货币。
值 事件的总值。 被接受为请求中的字符串。 这将被解析为两位数。
搜索字符串 与用户转化事件相关的搜索字符串。
订单ID 订单ID。 正在发送 order_id 会有所帮助 Pinterest 在必要时删除重复事件。
产品数量 事件的产品总数。 例如，在结账事件中购买的项目总数。
内容Id 产品ID列表（数组）。
内容 包含产品信息（如价格和数量）的对象列表（数组）。

此 Pinterest 自定义数据 在“规则”操作中突出显示。

验证中的数据 Pinterest

创建并执行事件转发规则后，验证是否已将事件发送到 Pinterest API按预期显示在中 Pinterest UI。

如果事件集合和 Experience Platform 集成成功，您将会在 Pinterest UI。

此 Pinterest 事件管理器

您可以进一步穿透钻取并查看 Pinterest 事件数据分发。

此 Pinterest 数据分发

后续步骤

本指南介绍如何安装和配置 Pinterest ui中的事件转发扩展。 有关更多信息，请参阅官方文档：

在此页面上