Pinterest Conversionsコネクタ構成ガイド

要件

• コンバージョンイベントを送信する権限を持つPinterest広告アカウント。

• user_dataで、次のいずれかの有効なユーザーIDを送信できること。

  • メールアドレス（SHA256でハッシュ化済み）（em）。
  • Appleの広告主向け識別子（SHA256でハッシュ化済み）またはGoogle広告ID（SHA256でハッシュ化済み）（hashed_maids）。
  • クライアントIPアドレスおよびクライアントユーザーエージェント（client_ip_addressおよびclient_user_agent）。
  • アプリID（該当する場合）。

    Pinterestでは、照合のために少なくとも1つの有効なユーザーIDが必要です。PIIに関する制限がある組織では、この統合を構成する前に承認を得る必要があります。

• すべてのオフラインイベントについて：

  • コネクタ構成で、Event Action SourceをOfflineに構成する必要があります。
  • オフラインイベントには、必須のイベントパラメータをすべて含める必要があります。詳細については、Pinterest：サーバーイベントパラメータの形式を参照してください。

API情報

このコネクタでは、次のベンダーAPIを使用します。

• API名：Pinterest API
• APIバージョン：v5
• APIエンドポイント：https://api.pinterest.com/
• ベンダーのドキュメント：Pinterest：コンバージョンガイド

バッチ制限

このコネクタでは、ベンダーへの大量データ転送をサポートするために、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに保持されます。

• リクエストの最大数：1000
• 最も古いリクエストからの最大経過時間：10分
• リクエストの最大サイズ：2 MB

仕組み

Pinterest API for Conversionsを使用すると、広告主はPinterestタグを使用せずにコンバージョンイベントをPinterestへ送信できます。コンバージョンをPinterestキャンペーンにマッピングすることで、コンバージョンの可視性が向上し、キャンペーンの効果とコンバージョンにつながるアクションをより正確に把握できます。この方法により、ターゲティングが最適化され、透明性が高まり、レポートと分析が改善されます。

Pinterest API for Conversionsは、Web、アプリ内、またはオフラインのコンバージョンを受信できます。イベント発生から1時間以内に受信したイベントは、Webイベントまたはアプリイベントとしてレポートされます。この時間枠を過ぎて受信したイベントは、オフラインイベントとして分類されます。

可視性を最大限に高めてコンバージョンを追跡するために、Pinterest ConversionsコネクタとPinterestタグを併用することをお勧めします。Pinterest Conversionsコネクタは単独のソリューションとして利用できますが、Pinterest ConversionsコネクタとPinterestタグを併用することで最良の結果が得られます。

追跡できるイベントは次のとおりです。

• カートに追加：商品がショッピングカートに追加された。
• チェックアウト：取引が完了した。
• カスタム：カスタムイベントを追跡します。コンバージョンレポートに含める特別なイベントを追跡するには、このイベント名を使用します。
• リード：製品またはサービスへの関心。
• ページ訪問：製品ページや記事ページなど、主要ページの閲覧。
• 検索：Webサイト上での検索。
• サインアップ：製品またはサービスへのサインアップ。
• カテゴリ表示：カテゴリページの閲覧。
• 動画視聴：動画の視聴。
• ユーザー定義イベント：オーディエンスターゲティングを目的として定義した追加イベントを登録します。固有のイベントはコンバージョンレポートには使用できません。

重複排除

重複する実装が存在する場合（たとえば、Pinterest API for ConversionsとPinterestタグ）、1つのイベントが両方のソリューションから送信された際に二重にカウントされるのを防ぐため、重複排除が必要です。重複排除を使用すると、コネクタまたはタグのソリューションを単独で使用する場合よりも多くのコンバージョンがアトリビューションされることが期待できます。

PinterestタグとPinterest API for Conversionsでは、重複排除にイベントIDを使用します。複数のソースを使用してコンバージョンデータを追跡する場合は、この値が含まれていることを確認してください。イベントIDを確認するには、次の手順を実行します。

1. Pinterestビジネスアカウントにログインします。
2. Ads > Reportingに移動します。
3. テーブル上部の右上にあるメニューアイコンをクリックし、Performanceを選択します。

サイトに追加したイベントコードに応じて、選択した期間内の発生回数とともにテーブル全体に表示されます。

次の命名規則に従うイベント属性を探します。

pinterest_event_id_{PINTEREST_EVENT}_{TAG_UID}

例：pinterest_event_id_Checkout_32

イベントIDのタイプごとに個別のアクションを使用します。イベント固有のイベントID属性をEvent IDにマッピングし、それに対応するイベント名をEvent Nameにマッピングします。例：

詳細については、Pinterestタグ構成ガイドを参照してください。

重複排除の確認

Pinterestには、重複排除済みコンバージョンの指標は表示されません。代わりに、次の項目を検証して重複排除を確認します。

• event_idがWebとAPIの両方のペイロードに存在する。
• 両方のバージョンをトリガーした後、レポートにコンバージョンが1回だけ表示される。

Pinterest Ads Managerでevent_idを表示するには、次の手順を実行します。

1. Ads Manager > Conversions > Eventsに移動します。
2. 広告アカウントを選択します。
3. イベント（たとえば、Checkout）を選択します。
4. Event Diagnosticsを開きます。
5. イベントペイロードをクリックして展開します。
6. 次の項目を確認します。
   • event_source = webまたはapi
   • event_idが一致している
   • User data status = accepted

検証

コネクタアクションを検証するには、次のようにテストイベントコードを使用します。

1. Send Conversion Eventアクションで、Testing Modeを選択します。
2. テストイベントを送信します。
3. Pinterestで、次の手順を実行します。
   • Conversions > Events > Test Eventsに移動します。
   • イベントが受信され、ペイロードが完全であることを確認します。

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

このコネクタを追加すると、ベンダーのデータプラットフォームポリシーへの同意を求められます。

コネクタを追加した後、次の構成を構成します。

• EULA Agreement：（必須）チェックボックスをオンにして、Pinterestのデータプラットフォームポリシーに同意します。
• Access Token：（必須）Pinterest Ads Managerを通じて生成されたアクセストークン。詳細については、Pinterest：コンバージョンガイドを参照してください。
• Ad Account ID：（必須）広告アカウントの一意の識別子。PinterestでAd Account IDを確認するには、広告主アカウントを所有するPinterestアカウントにログインし、Ads > Overviewに移動します。Ad Account IDはURLパスに表示されます。例：ads.pinterest.com/advertiser/{ad_account_id}/...

コネクタの構成が完了したら、Doneをクリックします。

オフラインコンバージョン

オフラインイベントを使用すると、実店舗など、Webサイトやアプリの外部で発生した購入、インタラクション、コンバージョンに広告が与えた影響を測定できます。Pinterest Conversionsコネクタを通じてオフラインイベントとコンバージョンを処理するには、必須パラメータを含めるようにコネクタを構成します。

構成手順

オフラインイベントを送信するように Pinterest Conversions コネクタを構成するには、次の手順を実行します。

1. Actions タブで、新しい Send Conversion Event アクションを追加します。
2. Event Action Source パラメータを Offline にマッピングします。
3. 必須パラメータをマッピングし、イベントタイプに応じて必要なオプションパラメータを含めます。
   • Pinterest では、オフラインイベントの必須の Event ID パラメータに、トランザクション ID、注文 ID、または Tealium Random をマッピングすることを推奨しています。
4. Pinterest Ads Manager で確認します。

アクション

Continue をクリックして、コネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

以下のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。

コンバージョンイベントを送信

コンバージョンイベントのパラメータ

ユーザーデータ

データマッピングは、次の要件を満たす必要があります。

• 複数の値を追加するには、配列型属性をマッピングします。
• 単一の値を追加するには、単一値属性をマッピングします。クライアントIPアドレスおよびクライアントユーザーエージェントフィールドには、単一値属性のみをマッピングしてください。

次のパラメータが必要です。

カスタムデータ

コンテンツデータ

• コンバージョンに複数の商品を追加するには、配列型属性を指定します。配列型属性の長さはすべて同じである必要があります。
• 単一値属性をパラメータにマッピングした場合、その値はコンバージョンの配列内にあるすべての商品に適用されます。

アプリ情報

自動重複排除

テストモード

自動マッピングの無効化

構成

API Insights

Pinterest ConversionsコネクタはAPI Insightsをサポートしており、Pinterestのコンバージョンイベント品質スコア（EQS）データをTealiumに直接表示できます。詳細については、Connector Insights：Pinterest Conversionsを参照してください。