设置 Pinterest

Pinterest 是一家已与 Adjust 集成的广告渠道。我们的集成允许 Pinterest 通过自动回传接收归因和应用内事件数据。

在本文中了解如何为您的应用设置 Pinterest 监测，这包括激活集成、创建推广活动链接、以及选择 Adjust 可以与 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 控制面板中：​

点击和展示 URL 应添加到广告跟踪 URL 部分。

在 Campaign Lab 中选择 Pinterest 和应用

  1. 找到 Campaign Lab​ ，选择 合作伙伴​ 。
  2. 选择 新合作伙伴​ > Pinterest​ 。选择 下一步​ 进入下一界面。
  3. 在 应用选择​ 界面选择要创建链接的应用，启用集成来与 Pinterest 分享数据。
  4. 选择 下一步​ 。

启用数据分享

启用数据分享以激活与 Pinterest 的集成。要启用数据分享：

  1. 输入您的 TAG ID (required for events)、Pinterest Account ID 和 Pinterest Authentication Token。

启用与 Pinterest 的数据分享后，Adjust 会默认自动向 Pinterest 发送以下数据：

  • 事件

设置数据分享

如果您的多平台应用启用了多个平台的数据分享，那么可以：

  1. 通过选择 使用平台特定设置​ 来在平台层级区分数据共享设置。
  2. 您可以通过选择 使用全局设置​ 来为多个平台应用相同的数据共享设置。

在 哪些数据会默认分享？​ 部分, 查看 Adjust 默认与 Pinterest 分享的活动。

  • 事件

发送额外数据

选择您想通过回传与 Pinterest 分享的数据量和数据类型。Pinterest 可能会使用此信息来优化表现。

  1. 在__您想分享哪些数据来源？__​部分，选择与 Pinterest 分享数据的归因来源：
  • 来自所有归因渠道的数据
  • 仅限归因至 Pinterest 的数据

应用内收入 (来自应用内购买)

通过应用内收入分享，Pinterest 可以接收收入金额以及您的收入事件数据。您需要映射能产生收入的事件，才能分享该数据。

映射事件

将您想分享的事件映射到 Pinterest 可以接收的值。未映射事件的数据不会被发送至 Pinterest。

映射单个事件

如果您的应用为多平台应用，则可以选择按平台与 Pinterest 分享不同事件。这有助于您：

  • 通过设定单个事件来管理不同平台的推广活动策略。
  • 按平台自定义数据分享。

在 映射事件​ 中，按照以下步骤选择要直接发送至 Pinterest 的应用内事件。

  1. 选择 映射事件​ 。

  2. 在 Adjust 事件​ 列表中，选择要与 Pinterest 分享的 Adjust 事件。

  3. 在 合作伙伴事件​ 下，您需要选择与 Adjust 事件对应的 Pinterest 事件。

    1. 对于单平台应用和仅针对一个平台启用了数据共享的多平台应用，您只能针对一个平台映射事件。对于针对多个平台启用了数据共享的多平台应用，您可以：

      • 选择 使用平台特定映射​ 来在平台层级映射单独事件或不针对某些平台映射事件。
      • 选择 使用全局映射​ 来为所有平台映射相同的事件。

    2. 打开 合作伙伴​ 列表，选择要映射到 Adjust 事件的渠道事件，或输入自定义事件名称。

  4. 选择 确认​ 。

现在 Pinterest 将接收每个关联事件的应用内事件数据。

映射全部事件

如果 Pinterest 支持自动映射所有事件，则在 映射事件​ 下选择 映射全部事件​ ，这能够省去映射单个事件的时间。

现在 Pinterest 将接收所有关联事件的应用内事件数据。

映射参数

要与 Pinterest分享自定义数据，您通常需要映射参数。

合作伙伴参数 (在 Adjust SDK 4.0+ 版本中提供) 允许 Adjust 从您的应用中收集自定义数据点，并将其发送至 Pinterest。借此，Pinterest 可以接收每个已关联事件的自定义事件详情。

在向 Adjust SDK 添加新的合作伙伴参数之前，请确保现有的合作伙伴参数均不符合您的要求。

如需与 Pinterest 分享合作伙伴参数，请遵循以下步骤。

  1. 在 Adjust SDK 中设置合作伙伴参数。

  2. 在 设置数据分享​ 下，选择 参数​ 。

  3. 打开 映射参数​ ，选择如何向渠道发送 SDK 中指定的合作伙伴参数。

    1. 选择 映射参数​ 。
    2. 在 SDK 参数​ 字段中输入要与渠道分享的 SDK 参数名称。
    3. 在 合作伙伴参数​ 字段中输入 SDK 参数对应的渠道参数。
请注意:

如果您在 Adjust SDK 中设置了合作伙伴参数而没有在控制面板中设置参数分享，那么 Adjust 会按照 Adjust SDK 中的名称发送参数。

配置链接和设置

您可以进行以下设置：

创建链接并与 Pinterest 分享

在 设置概览​ 界面，您可以检查自己的选择，也可以返回并更改以下内容：

  • 所选应用
  • 数据分享选项
  • 链接结构参数
  • 用户目的位置
  • 归因设置

选择 创建链接​ 来创建点击 URL、展示 URL、二维码和链接识别码。创建链接还会启用数据共享及与 Pinterest 的集成。

创建链接后，请与 Pinterest 分享链接，以便在推广活动中放置。

合作伙伴特定设置说明

Overview

To send in-app events to Pinterest, required credentials depend on the API version you’re using:

API v5 (Recommended):​

  • Ad Account ID
  • Access Token

Legacy API:​

  • Tag ID

You can retrieve your Access Token​ in Pinterest Ads Manager​: Ad Account Overview > Conversions > Set Up API​

More information available here

Best practice

Pinterest supports both iOS​ and Android​“deep linking” conversions campaigns. Before enabling the integration, contact Pinterest​ so they can assist with campaign setup.

Predefined parameters

You can send predefined parameters​ with your events using the Adjust SDK. When attached correctly, these parameters are forwarded to Pinterest.

Refer to the SDK documentation for the correct way to attach partner parameters​ to your events.

ParameterDescriptionSupported in API v5Format / Notes
external_idExternal user ID✅Comma- or semicolon-separated string list
event_source_urlURL of the webpage where the event occurred✅String (URL format)
emEmail address hashes✅SHA256 hash of the lowercase email address
phPhone number hashes✅SHA256 hash of phone number with digits only, incl. country and area code
event_idUnique event identifier✅String
content_idsProduct or content identifiers✅Comma- or semicolon-separated string list
order_idOrder identifier✅String
valueValue of purchase or add to cart✅Numeric (Supported also in the old API)
currencyCurrency for the value field✅ISO 4217 code (e.g., USD, EUR) — supported also in the old API

For more details on formatting external_id, em and ph, refer to the Pinterest API documentation.

The values of value and currency parameters are used as fallback values​ and are only forwarded to Pinterest if Adjust does not receive any revenue data​ for the in-app event directly from the SDK.

For more information, refer to the Adjust documentation on event revenue recording.

Grouped item-level parameters

The following parameters describe item-level metadata​ and should be aligned in order​ across the event payload.

ParameterDescriptionFormat / Notes
idUnique identifiers for itemsOrdered string list (comma- or semicolon-separated)
quantityQuantity of each itemOrdered string list
item_nameName of each itemOrdered string list
item_pricePrice of each itemOrdered string list
item_categoryCategory of each itemOrdered string list
item_brandBrand of each itemOrdered string list
重要提示:

The order of values​ must match across these fields.

(e.g., the first value in item_price should match the first in item_name, id, etc.)

转发给 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