Pinterest コンバージョンコネクタ構成ガイド

必要条件

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

• user_data で以下の有効なユーザーIDのいずれかを送信する能力:

  • Email（既に SHA256 ハッシュ化済み）(em)。
  • Appleの広告識別子（既に SHA256 ハッシュ化済み）または Google 広告ID（既に SHA256 ハッシュ化済み）(hashed_maids)。
  • クライアントIPアドレスとクライアントユーザーエージェント（client_ip_address と client_user_agent）。
  • アプリID（該当する場合）。

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

• オフラインイベントの場合:

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

API情報

このコネクタは以下のベンダーAPIを使用します:

• API名: Pinterest API
• APIバージョン: v5
• APIエンドポイント: https://api.pinterest.com/
• ベンダー文書: Pinterest: コンバージョンガイド

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:

• 最大リクエスト数: 1000
• 最古のリクエストからの最大時間: 10分
• リクエストの最大サイズ: 2 MB

動作方法

Pinterest API for Conversionsを使用すると、広告主はPinterestタグを使用せずにPinterestにコンバージョンイベントを送信できます。コンバージョンをPinterestキャンペーンにマッピングすることで、キャンペーンの効果とコンバージョンを推進するアクションの正確なビューが得られます。このアプローチは、ターゲティングの最適化、透明性の向上、およびレポートと分析の改善を促進します。

Pinterest API for Conversionsは、ウェブ、アプリ内、またはオフラインのコンバージョンを受け取ることができます。イベント発生から1時間以内に受信したイベントは、ウェブまたはアプリイベントとして報告されます。その時間枠の外で受信したイベントは、オフラインイベントとして分類されます。

Pinterest ConversionsコネクタとPinterestタグを併用することで、可視性を最大化し、コンバージョンを追跡することをお勧めします。Pinterest Conversionsコネクタは単独で利用可能ですが、両方を併用することで最良の結果が得られます。

追跡可能なイベントには以下が含まれます:

• カートに追加: アイテムがショッピングカートに追加されます。
• チェックアウト: トランザクションが完了します。
• カスタム: カスタムイベントを追跡します。このイベント名を使用して、コンバージョンレポートに含めたい特別なイベントを追跡します。
• リード: 製品またはサービスへの関心。
• ページ訪問: 製品ページや記事ページなどの主要ページの閲覧。
• 検索: あなたのウェブサイトでの検索。
• サインアップ: あなたの製品やサービスへのサインアップ。
• カテゴリ表示: カテゴリページの閲覧。
• ビデオ視聴: ビデオの視聴。
• ユーザー定義イベント: オーディエンスターゲティングのために定義した追加のイベント。変換レポートで利用可能なユニークなイベントはありません。

重複排除

冗長な実装が存在する場合（例: Pinterest API for ConversionsとPinterest tag）、重複排除が必要です。重複排除を使用することで、コネクタまたはタグソリューションを独立して使用する場合よりも多くのコンバージョンが帰属されることが期待されます。

Pinterest tagとPinterest API for Conversionsは、重複排除のためにイベントIDを使用します。複数のソースを使用してコンバージョンデータを追跡する場合、この値を含めることを確認してください。イベントIDを見つけるには、次の手順を完了してください:

1. Pinterestビジネスアカウントにログインします。
2. 広告 > レポートに移動します。
3. テーブルの右上にあるメニューアイコンをクリックし、パフォーマンスを選択します。

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

次の命名規則を使用してイベント属性を探します:

pinterest_event_id_{PINTEREST_EVENT}_{TAG_UID}

例: pinterest_event_id_Checkout_32

各タイプのイベントIDに対して別のアクションを使用します。イベント固有のイベントID属性をイベントIDにマッピングし、一致するイベント名をイベント名にマッピングします。例:

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

重複排除の確認

Pinterestは重複排除されたコンバージョン指標を表示しません。代わりに、以下の項目を検証することで重複排除を確認します:

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

Pinterest広告マネージャーでevent_idを表示するには、次の手順を使用します:

1. 広告マネージャー > コンバージョン > イベントに移動します。
2. 広告アカウントを選択します。
3. イベント（例: チェックアウト）を選択します。
4. イベント診断を開きます。
5. イベントペイロードを展開するためにクリックします。
6. 次のことを確認します:
   • event_source = web または api
   • event_idが一致します
   • ユーザーデータステータス = accepted

検証

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

1. Send Conversion Event アクションで Testing Mode を選択します。
2. テストイベントを送信します。
3. Pinterestで次の手順を使用します:
   • Conversions > Events > Test Eventsに移動します。
   • 受領とペイロードの整合性を確認します。

構成

コネクタマーケットプレースに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、About Connectorsの記事を参照してください。

このコネクタを追加すると、ベンダーのデータプラットフォームポリシーを受け入れるように求められます。

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

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

構成が完了したら Done をクリックします。

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

オフラインイベントを通じて、ウェブサイトやアプリの外で発生する広告の影響を測定できます。これには、物理的な小売店での購入、相互作用、およびコンバージョンが含まれます。オフラインイベントとコンバージョンを処理するために、必要なパラメータを含めるようにPinterest Conversionsコネクタを構成します。

構成手順

Pinterest Conversionsコネクターを使用してオフラインイベントを送信するには：

1. アクションタブで、新しい送信コンバージョンイベントアクションを追加します。
2. イベントアクションソースパラメータをOfflineにマッピングします。
3. 必要なパラメータをマッピングし、イベントタイプに必要に応じてオプションのパラメータを含めます。
   • Pinterestは、オフラインイベントの必須イベントIDパラメータにトランザクションID、注文ID、またはTealium Randomをマッピングすることを推奨しています。
4. Pinterest広告マネージャーで確認します。

アクション

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

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

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

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

ユーザーデータ

データマッピングは以下の要件を満たす必要があります：

• 配列型属性をマップして複数の値を追加します。
• 単一値属性をマップして単一の値を追加します。単一値属性はクライアントIPアドレスおよびクライアントユーザーエージェントフィールドにのみマップする必要があります。

以下のパラメータが必要です：

カスタムデータ

コンテンツデータ

• コンバージョンに複数のアイテムを追加するために配列型属性を提供します。配列型属性は同じ長さでなければなりません。
• 単一値属性をパラメータにマップする場合、その値はコンバージョンの配列内のすべてのアイテムに適用されます。

アプリ情報

自動重複排除

テストモード

自動マッピング無効化

構成

コネクタのインサイト

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