设置 Pinterest
Pinterest 是一家已与 Adjust 集成的广告渠道。我们的集成允许 Pinterest 通过自动回传接收归因和应用内事件数据。
在本文中了解如何为您的应用设置 Pinterest 监测,这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 Pinterest 分享的数据。
操作前须知
要求
- Adjust 中的管理员、编辑员或自定义编辑员权限。
- Adjust SDK v4.0.0 或更新版本,以便将 SDK 参数映射至Pinterest 参数。按照以下指南使用此功能。
iOS | 安卓 | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
凭证
TAG ID (required for events)、Pinterest Account ID 和 Pinterest Authentication Token
- 如需帮助查找凭证,请联系您的 Pinterest 代表。
在您的 Pinterest 控制面板中:
Adjust S2S 点击链接应在 Pinterest 中设置为 并行点击跟踪链接 。点击此处了解更多信息。
在 Campaign Lab 中选择 Pinterest 和应用
- 找到 Campaign Lab ,选择 合作伙伴 。
- 选择 新合作伙伴 > Pinterest 。选择 下一步 进入下一界面。
- 在 应用选择 界面选择要创建链接的应用,启用集成来与 Pinterest 分享数据。
- 选择 下一步 。
启用数据分享
启用数据分享以激活与 Pinterest 的集成。要启用数据分享:
- 输入您的 TAG ID (required for events)、Pinterest Account ID 和 Pinterest Authentication Token。
启用与 Pinterest 的数据分享后,Adjust 会默认自动向 Pinterest 发送以下数据:
- 事件
设置数据分享
如果您的多平台应用启用了多个平台的数据分享,那么可以:
- 通过选择 使用平台特定设置 来在平台层级区分数据共享设置。
- 您可以通过选择 使用全局设置 来为多个平台应用相同的数据共享设置。
在 哪些数据会默认分享? 部分, 查看 Adjust 默认与 Pinterest 分享的活动。
- 事件
发送额外数据
选择您想通过回传与 Pinterest 分享的数据量和数据类型。Pinterest 可能会使用此信息来优化表现。
- 在__您想分享哪些数据来源?__部分,选择与 Pinterest 分享数据的归因来源:
- 来自所有归因渠道的数据
- 仅限归因至 Pinterest 的数据
应用内收入 (来自应用内购买)
通过应用内收入分享,Pinterest 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件,才能分享该数据。
映射事件
将您想分享的事件映射到 Pinterest 可以接收的值。未映射事件的数据不会被发送至 Pinterest。
映射单个事件
如果您的应用为多平台应用,则可以选择按平台与 Pinterest 分享不同事件。这有助于您:
- 通过设定单个事件来管理不同平台的推广活动策略。
- 按平台自定义数据分享。
在 映射事件 中,按照以下步骤选择要直接发送至 Pinterest 的应用内事件。
选择 映射事件 。
在 Adjust 事件 列表中,选择要与 Pinterest 分享的 Adjust 事件。
在 合作伙伴事件 下,您需要选择与 Adjust 事件对应的 Pinterest 事件。
对于单平台应用和仅针对一个平台启用了数据共享的多平台应用,您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用,您可以:
- 选择 使用平台特定映射 来在平台层级映射单独事件或不针对某些平台映射事件。
- 选择 使用全局映射 来为所有平台映射相同的事件。
打开 合作伙伴 列表,选择要映射到 Adjust 事件的渠道事件,或输入自定义事件名称。
选择 确认 。
现在 Pinterest 将接收每个关联事件的应用内事件数据。
映射全部事件
如果 Pinterest 支持自动映射所有事件,则在 映射事件 下选择 映射全部事件 ,这能够省去映射单个事件的时间。
现在 Pinterest 将接收所有关联事件的应用内事件数据。
映射参数
要与 Pinterest分享自定义数据,您通常需要映射参数。
合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点,并将其发送至 Pinterest。借此,Pinterest 可以接收每个已关联事件的自定义事件详情。
在向 Adjust SDK 添加新的合作伙伴参数之前,请确保现有的合作伙伴参数均不符合您的要求。
如需与 Pinterest 分享合作伙伴参数,请遵循以下步骤。
在 Adjust SDK 中设置合作伙伴参数。
- 在操作前须知部分查看所有 SDK 开发平台链接。
在 设置数据分享 下,选择 参数 。
打开 映射参数 ,选择如何向渠道发送 SDK 中指定的合作伙伴参数。
- 选择 映射参数 。
- 在 SDK 参数 字段中输入要与渠道分享的 SDK 参数名称。
- 在 合作伙伴参数 字段中输入 SDK 参数对应的渠道参数。
如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享,那么 Adjust 会按照 Adjust SDK 中的名称发送参数。
配置链接和设置
您可以进行以下设置:
创建链接并与 Pinterest 分享
在 设置概览 界面,您可以检查自己的选择,也可以返回并更改以下内容:
- 所选应用
- 数据分享选项
- 链接结构参数
- 用户目的位置
- 归因设置
选择 创建链接 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 Pinterest 的集成。
创建链接后,请与 Pinterest 分享链接,以便在推广活动中放置。
合作伙伴特定设置说明
概览
向 Pinterest 发送应用内事件必要的凭证取决于您所使用的 API 版本:
API v5 (推荐):
- Ad Account ID
- Access Token (访问识别码)
旧版 API:
- Tag ID
您可以在 Pinterest 广告管理工具 中获取 Access Token 。具体导航方法: Ad Account Overview > Conversions > Set Up API
从旧版 API 过渡到 API v5
Pinterest 将停用 旧版 API ,使用 API v5 。在本文档中,我们将为您详细说明设置过程,其中包括验证、事件映射以及如何删除旧版的配置。
1. 输入凭证
在 Campaign Lab 中选择 Pinterest 和应用,然后提供以下详细信息:
- Account ID
- Access Token (访问识别码)
要使用 API v5,这两个字段均为必填。请参阅此处,了解如何查找对应账户 ID 的 Access Token
2. 事件映射
了解事件映射字段
- Name (Legacy) – 仅用于旧版 API。
- New name (API v5) – API v5 所需的事件值。
打开 Adjust 事件字段,选择要映射的 Adjust 应用内事件,然后从 New name 下拉菜单中将事件映射到值
查看下文,了解 Legacy API (Name) 到 API v5 (New name) 的事件名称映射建议。您也可以将 Legacy API (Name) 事件映射到其他 Pinterest 可用的 API v5 (New name) 事件。
Name (Legacy) | New Name (API v5) |
Add to cart | Add to cart |
Purchase | Checkout |
Registration | Signup |
Search | Search |
Lead | Lead |
Page visit | Page visit |
3. 移除j旧版 Tag ID (可选)
API v5 不再需要 Tag ID。您可以从配置中安全移除 Tag ID。如果您仍提供 Tag ID、 账户 ID 和 Access Token ,以及 New name 字段值,那么系统将优先使用 API v5 ,忽略旧版 API 的 Tag ID。
最佳做法
Pinterest 支持 iOS 和 Android “深度链接”转化推广活动。在启用集成前,请 联系 Pinterest ,获得推广活动设置帮助。
预定义参数
您可以使用 Adjust SDK,随事件一起发送 预定义参数 。正确附加后,这些参数将被转发至 Pinterest。
请参阅 SDK 文档,了解向事件附加 合作伙伴参数 的正确方法。
参数 | 描述 | API v5 支持 | 格式 / 注释 |
external_id | 外部用户 ID | ✅ | 用逗号或分号分隔的字符串列表 |
event_source_url | 事件发生所在网页的 URL | ✅ | 字符串 (URL 格式) |
em | 电子邮件地址哈希 | ✅ | 小写电子邮件地址的 SHA256 哈希 |
ph | 电话号码哈希 | ✅ | 电话号码的 SHA256 哈希 (仅限数字),包括国家和地区代码 |
event_id | 唯一设备标识符 | ✅ | 字符串 |
content_ids | 产品或内容标识符 | ✅ | 用逗号或分号分隔的字符串列表 |
order_id | 订单标识符 | ✅ | 字符串 |
value | 购买价值或添加至购物车的价值 | ✅ | 数字 (旧版 API 也支持) |
currency | 值字段的币种 | ✅ | ISO 4217 代码 (如 USD、EUR) — 旧版 API 也支持 |
要了解格式化 external_id
、 em
和 ph
的更多详情,请参阅 Pinterest API 文档。
金额和币种参数的值会被用作 后备 。仅在 Adjust 未能直接从 SDK 收到任何应用内事件的收入数据时 ,这些值才会被转发至 Pinterest 。
要了解更多信息请,参阅 Adjust 关于事件收入记录的文档。
商品层级分组参数
以下参数描述了 商品级别的元数据 ,请在事件负载中 按顺序排列 。
参数 | 描述 | 格式 / 注释 |
id | 商品唯一标识符 | 有序字符串列表 (以逗号或分号分隔) |
quantity | 每个商品的数量 | 有序字符串列表 |
item_name | 每个商品的名称 | 有序字符串列表 |
item_price | 每个商品的价格 | 有序字符串列表 |
item_category | 每个商品的类别 | 有序字符串列表 |
item_brand | 每个商品的品牌 | 有序字符串列表 |
这些字段中 值的顺序 必须匹配。
(例如,item_price
中的第一个值应与item_name
、id
等的第一个值相同。)
转发给 Pinterest 的所有参数列表
Pinterest 要求 Adjust 在回传中发送以下参数 (数据点):
占位符 | 信息 |
{city} | 设备所在城市 |
{country} | 两字符设备国家/地区代码 |
{currency} | 从 Adjust SDK 发送的原始 ISO 4217 货币代码 |
{device_name} | 设备型号 |
{gps_adid} | Google Play 应用商店广告 ID |
{idfa} | 广告主 ID(仅限 iOS 设备) |
{ip_address} | 设备 IP 地址 |
{isp} | 设备互联网服务供应商 |
{language} | 设备两字符语言代码 |
{os_name} | 设备操作系统 |
{os_version} | 操作系统版本号 |
{partner_parameters} | Adjust SDK 或 S2S 请求收集并且通过回调传输给第三方提供商的自定义合作伙伴参数 |
{revenue_usd} | 以美元计算的收入 |
{revenue} | 从 Adjust SDK 发送的收入(以分计) |
{sdk_version} | Adjust SDK 版本(按应用) |
{tracking_limited} | 若跟踪受限,则为 1;若跟踪未受限,则为 0 |
{user_agent} | 传入的原始用户代理 |
{app_id} | 商店的应用 ID 或 Google Play 商店 |
{app_name} | 应用名称 |
{app_version_short} | 应用版本号 (安卓),Bundle release 版本号 (iOS) |
{created_at} | 活动时间戳 |
{impression_based} | 如基于展示,则参数为 1,否则为 0 |