Pinterestの設定

PinterestはAdjustと連携されたアドネットワークです。Adjustとの連携により、Pinterestは自動コールバックを通してアトリビューションとアプリ内イベントデータを受信できます。

ここでは、Pinterestとのアプリ計測を設定する方法を説明します。 連携の有効化、キャンペーンリンクの作成、Adjustが Pinterestと共有できるデータを選択する方法をご確認ください。

事前準備

要件​

• Adjustアカウントの管理者、編集者またはカスタム編集者のアクセス権限。
• Adjust SDK v4.0.0以降を実装することで、SDKパラメーターをPinterestパラメーターにマッピングできます。この機能を使用するには、以下のリンク先のガイドに従ってください。

iOS | Android | 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を「Ad Tracking URL」セクションに追加する必要があります。

Campaign LabでPinterestとアプリを選択

1. Campaign Lab​ にて、 パートナー（Partner）​ を選択します。
2. 新規パートナー（New partner） > Pinterest​ を選択します。 次へ（Next）​ を選択して、次の画面に移動します。
3. アプリの選択（App selection）​ 画面で、リンクを作成したいアプリを選択し、 Pinterestのデータ共有をするため連携を有効化します。
4. 次（NEXT）​ を選択します。

データ共有を有効化

データ共有を有効化すると、Pinterestとの連携が有効化されます。データ共有を有効化する方法：

1. TAG ID (required for events)、Pinterest Account ID、およびPinterest Authentication Tokenを入力します。

Pinterestとのデータ共有を有効化すると、デフォルトでは、Pinterestに以下のデータが自動送信されます：

• イベント

データ共有オプションの設定

マルチプラットフォームアプリで複数のプラットフォームを対象にデータ共有を有効にしている場合は、以下のことが可能です：

1. プラットフォーム固有の設定を使用（Use platform-specific settings）​ を選択すると、プラットフォームレベルでデータ共有オプションを個別に設定できます。
2. グローバル設定を使用（Use global settings）​ を選択して、複数のプラットフォームに同じデータ共有設定を行います。

デフォルトで共有するデータ（What will be shared by default?）​ にて、Adjustがデフォルトで Pinterestと共有するアクティビティを確認してください。

• イベント

追加データの送信

コールバックによりPinterestと共有するデータ量とタイプを選択します。 Pinterestはこの情報を使用して、パフォーマンスを最適化することができます。

1. 共有するデータソース（What sources of data do you want to share?）​にて、Pinterestと共有するデータのアトリビューションソースを選択します：

• 全てのアトリビューションソースのデータ
• Pinterestにアトリビュートされたデータのみ

アプリ内収益（アプリ内購入由来）

アプリ内収益を共有すると、 Pinterestは収益イベントデータと収益額を受信することができます。このデータを共有するには、収益が発生するイベントをマッピングしてください。

イベントのマッピング

共有するイベントを、Pinterestが受信できる値にマッピングします。マッピングされていないイベントのデータは、Pinterestと共有されません。

各イベントをマッピング

マルチプラットフォームアプリの場合、プラットフォームごとに異なるイベントをPinterestと共有することができます。これにより、次のことが可能になります。

• 各イベントを設定し、それぞれのプラットフォームのキャンペーン戦略を管理できます。
• プラットフォームごとにデータ共有をカスタマイズします。

イベントのマッピング（Map events）​ にて、以下の手順に従って、Pinterestに直接送信するアプリ内イベントを選択します。

1. イベントのマッピング（Map event）​ を選択します。

2. Adjustイベント​ リストで、 Pinterestと共有するAdjustイベントを選択します。

3. パートナーイベント（Partner event）​ で、Adjustイベントに対応するPinterestイベントを選択します。

   1. シングルプラットフォームアプリおよびマルチプラットフォームアプリで、単一のプラットフォームでのみデータ共有が有効になっている場合は、そのプラットフォームでのみデータ共有オプションを設定します。マルチプラットフォームアプリの場合、複数のプラットフォームでデータ共有が有効化されている場合は、以下のことが可能です。

      • プラットフォーム固有のマッピングを使用する（Use platform-specific mapping）​ を選択して、プラットフォームレベルで各イベントをマッピングするか、特定のプラットフォームのイベントをマッピングしないようにします。
      • グローバルマッピングを使用​ して、全てのプラットフォームに同じイベントをマッピングします。

   2. パートナーイベント（Partner event）​ リストで、Adjustイベントをマッピングするカスタムイベント名を選択するか、入力します。

4. 適用（Apply）​ を選択します。

Pinterestは連携されているイベントごとにアプリ内イベントのデータを受信するようになります。

全てのイベントをマッピング

Pinterestが全てのイベントの自動マッピングをサポートしている場合、 イベントのマッピング（Map events）​ で、 全てのイベントをマッピング（Map all events）​ を選択します。これにより、個々のイベントをマッピングする時間を節約できます。

Pinterestは連携されているイベントごとにアプリ内イベントのデータを受信するようになります。

パラメーターのマッピング

通常、カスタムデータをPinterestと共有するには、パラメーターをマッピングする必要があります。

パートナーパラメーター（Adjust SDKバージョン4.0以降で使用可能）によって、Adjustはアプリからカスタムデータポイントを収集し、Pinterestに送信することができます。 これにより、Pinterestは連携しているイベントごとにカスタムイベントの詳細を受信するようになります。

Adjust SDKに新しいパートナーパラメーターを追加する前に、要件に合うパートナーパラメーターが存在していないことを確認してください。

パートナーパラメーターをPinterestに共有するには、以下の手順に従って設定してください。

1. AdjustのSDKでパートナーパラメーターを実装します。

   • 全てのSDK開発プラットフォームのリンクについては、事前準備をご確認ください

2. データ共有オプションの設定（Set your data sharing option）​ で、 パラメーター​ を選択します。

3. パラメーターのマッピング（Map parameters）​ では、SDKで定義したパートナーパラメーターをネットワークに送信する方法を指定できます。

   1. パラメーターのマッピング（Map parameters）​ を選択します。
   2. SDKパラメーター（SDK parameter）​ フィールドで、ネットワークと共有するSDKパラメーターの名前を入力します。
   3. パートナーパラメーター（Partner parameter）​ フィールドで、SDKパラメーターに対応するネットワークパラメーターを入力します。

リンクと設定の管理

以下を設定することができます：

• リンク構造
• ユーザーの遷移先
• アトリビューション設定

リンクを作成しPinterestと共有

設定のレビュー（Setup review）​ 画面にて 、選択内容を確認できます。設定前に戻って、以下の変更も行えます：

• 選択したアプリ
• データ共有オプション
• リンク構造パラメーター
• ユーザーの遷移先
• アトリビューション設定

リンクの作成（Create link）​ を選択し、クリックURL、インプレッションURL、QRコード、リンクトークンを作成します。リンクを作成することで、データの共有や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

Transitioning from Legacy API to API v5

Pinterest will deprecate its Legacy API​ in favor of the API v5​. This documentation walks you through the setup process, including authentication, event mapping, and removing legacy configurations.

1. Enter Credentials

After you selected Pinterest and your app in Campaign Lab, provide the following details:

• Account ID
• Access token

2. Event mapping

• Understand event mapping fields
  • Name (Legacy)​– used only with the Legacy API.
  • New name (API v5)​ – event values required for API v5.
• Select the Adjust in-app event you want to map from the Adjust event field and map it to a value from the New name​ dropdown

The event name mapping recommendations from Legacy API (Name) to API v5 (New name) are shared below. You are also free to map your Legacy API (Name) events to other available API v5 (New Name) events for Pinterest.

3. Remove legacy Tag ID (optional)

The Tag ID is no longer required with API v5. You can safely remove the Tag ID from your configuration. If you still provide a Tag ID along with an Account ID​ and Access Token​, and a value for the New Name​ field, the system will prioritize API v5​ and ignore the Tag ID for Legacy API.

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.

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.

Pinterestに転送されるパラメーター一覧

Adjustは、Pinterestに以下のパラメーター（データポイント）をコールバック送信するよう要求されています。