Pinterest イベント転送拡張機能

最終更新日: 2023-10-31
  • トピック:
  • Tags
    このトピックの詳細を表示
  • 作成対象:
  • Developer
    User
    Admin
    Leader

Pinterest は、レシピ、ホームデコール、スタイルのインスピレーションなどのアイデアを見つけるための視覚的発見エンジンです。 何十億ものピンが Pinterest(で他のユーザーと共有することもできます) Pinterest. ユーザーインタラクションイベントを照合し、 Pinterest Analytics ユーザーの行動を把握し、ターゲット広告を実行する。

The Pinterest コンバージョン API イベント転送 拡張機能を使用すると、 Adobe Experience Platform Edge Network で取得したデータを活用し、に送信できます。 Pinterest. このドキュメントでは、拡張機能の使用例、拡張機能のインストール方法、イベント転送に拡張機能を統合する方法について説明します ルール.

コンバージョンアクセストークンは、 Pinterest 操作中に Pinterest API.

ユースケース

この拡張機能は、 Pinterest を使用して、顧客分析機能を活用します。

例えば、組織内のマーケティングチームについて考えてみましょう。 チームは、Web サイトからユーザーインタラクションイベントデータをキャプチャし、 Pinterest このイベント転送拡張機能を使用する。

マーケティングチームと分析チームは、 Pinterest Analytics の主なユーザーインタラクションおよび動作を把握し、ユーザーをより深く理解し、ターゲット化された広告キャンペーンのターゲットに設定する機能。

特有の使用例について詳しくは、 Pinterest(を参照) Pinterest 使用例 ドキュメント。

Pinterest 前提条件

有効な Pinterest ビジネスアカウント この拡張機能を使用するには、を参照してください。 次に移動: Pinterest 登録ページ をクリックして、アカウントを作成します(まだ持っていない場合)。

また、 Pinterest 開発者アカウント ( Pinterest ビジネスアカウント。 開発者アカウントをビジネスアカウントに関連付けるには、 Pinterest ​ 開発者アカウント.

必要な設定の詳細の収集

Experience Platformを Pinterestの場合、次の入力が必要です。

資格情報 説明
広告アカウント ID お使いの Pinterest Ads アカウント ID。 詳しくは、Pinterest ドキュメントを参照してください。 123456789012
コンバージョンアクセストークン お使いの Pinterest コンバージョンアクセストークン。 詳しくは、 Pinterest コンバージョン API ガイダンス用のドキュメント。
このトークンは期限切れにならないので、この操作は 1 回のみ実行する必要があります。

のインストールと設定 Pinterest 拡張

拡張機能をインストールするには、以下を実行します。 イベント転送プロパティの作成 または、代わりに編集する既存のプロパティを選択します。

左側のナビゲーションで、「 拡張機能. 選択 インストール ~のためのカードで Pinterest の拡張 カタログ タブをクリックします。

を表示するカタログ Pinterest 拡張 インストール ハイライト表示されました。

Pinterest 拡張機能の設定

重要

実装のニーズに応じて、拡張機能を設定する前に、スキーマ、データ要素、データセットの作成が必要になる場合があります。 ユースケースに合わせて設定する必要のあるエンティティを判断するには、開始する前にすべての設定手順を確認してください。

左側のナビゲーションで、「 拡張機能. 選択 設定 ~のためのカードで Pinterest の拡張 インストール済み**タブをクリックします。

Pinterest 拡張機能 インストール タブ 設定 ハイライト表示されました。

次の画面で、 広告アカウント ID および コンバージョンアクセストークン 以前に 設定の詳細 」セクションに入力します。 完了したら「保存」を選択します。

The Pinterest 設定 画面のハイライト 広告アカウント ID および コンバージョンアクセストークン 入力フィールド。

イベント転送ルールの設定

すべてのデータ要素を設定したら、イベントの送信先と送信方法を決定するイベント転送ルールの作成を開始できます。 Pinterest.

新規作成 ルール を設定します。 の下 アクション、新しいアクションを追加し、拡張機能をに設定します。 Pinterest. Edge ネットワークイベントをに送信するには、以下を実行します。 Pinterestを設定し、 アクションタイプ から イベントの送信.

The Pinterest イベントの送信 ルールの作成。

選択後、イベントをさらに設定するための追加のコントロールが表示されます。 次をマッピングする必要があります。 Pinterest イベントのプロパティを、以前に作成したデータ要素に追加します。

イベントデータ

新しいルールを作成するには、次のイベントデータが必要です。

フィールド名 説明
イベント名 ユーザーイベントのタイプ。 ただし、これは、 Pinterest Analytics 使用をお勧めします。 Pinterest イベントコード * checkout
* add_to_cart
* page_visit
*サインアップ
* [ユーザー定義イベント]
アクションソース コンバージョンイベントが発生した場所を示すソース。 * app_android
* app_ios
* web
*オフライン
イベント時刻 これはイベント時刻を参照します。 デフォルトの時刻形式は UNIX で、形式は <seconds>.<miliseconds> ローカルタイムゾーンに応じて異なります。 詳しくは、 Pinterest API. 1433188255.500 は、エポックの1433188255秒後、または 2015 年 6 月 1 日(月)の 7 時点を示します。:50:午後 55 時 (GMT)。
イベント ID このイベントを識別し、コンバージョン API とPinterestの両方のトラッキングを通じて取り込まれたイベント間の重複排除に使用できる一意の ID 文字列。 これがないと、イベントのデータは二重にカウントされる可能性が高く、指標の水増しがレポートされます。 ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
イベントのプロパティ イベントのカスタムプロパティを含む JSON オブジェクト。 生の JSON を提供するか、シンプル化されたキーと値の入力セットを使用するかを選択します。

The Pinterest イベントデータ ルールアクション内でハイライト表示されています。

次のイベントプロパティを設定できます。

フィールド名 説明
イベントソース URL Web コンバージョンイベントの URL。
アプリケーションストア ID アプリストアのアプリ ID。
アプリ名 アプリケーションの名前
Application Version アプリケーションのバージョン。
デバイスのブランド ユーザーが使用しているデバイスのブランド。
デバイスキャリア デバイスのユーザーの携帯電話会社。
デバイスモデル ユーザーのデバイスのモデル。
Device Type ユーザーが使用しているデバイスのタイプ。
OS バージョン デバイスのオペレーティングシステムのバージョン。
ユーザーの言語 ユーザーの言語を示す 2 文字の ISO-639-1 言語コード。

ユーザーデータ

次のユーザーデータは、必須フィールドではありません:

フィールド名 説明
メール ユーザー電子メールアドレス、またはユーザーアドレス電子メールの SHA256 ハッシュ。 ebd543592…f2b7e1
モバイル広告 ID ユーザーの「Google Advertising ID」(GAID) または「Apple for Advertisers」(IDFA) の Sha256 ハッシュ ebd543592…f2b7e1
クライアント IP アドレス ユーザーの IP アドレス。IPv4 形式または IPv6 形式を使用できます。 照合に使用されます。 192.168.0.1
クライアントユーザーエージェント ユーザーの Web ブラウザーのユーザーエージェント文字列。 Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
顧客情報データ 他の顧客情報を含む JSON オブジェクト。 生の JSON を提供するか、シンプル化されたキーと値の入力セットを使用するかを選択します。

The Pinterest ユーザーデータ ルールアクション内でハイライト表示されています。

設定できる顧客情報プロパティは次のとおりです。

フィールド名 説明
Phone ユーザーの連絡先番号。 数字のみを使用でき、国コード、市外局番、および数値を使用して入力する必要があります。
性別 性別は、「f」(女性の場合)、「m」(男性の場合)、または「n」(バイナリ以外の場合)のどちらかとして入力できます。
生年月日 生年月日(年、月、日として入力)
ユーザーの姓。
ユーザーの名。
市区町村 ユーザーの居住都市。 これは主に請求目的で使用されます。
都道府県 ユーザーの状態。2 文字のコードで小文字で指定されます。
郵便番号 ユーザーの郵便番号。主に請求目的で使用されます。
ユーザーの国を示す 2 文字の ISO-3166 国コード。
外部 ID スペース内のユーザーを識別する広告主の一意の ID。 例えば、ユーザー ID、ロイヤリティー ID などです。
クリック ID ドメインの_epik cookie または URL の&epik=クエリパラメーターに保存される一意の識別子。
重要

データをに送信する前に Pinterest API エンドポイントです。拡張機能は、電子メール、電話番号、名、姓、性別、生年月日、市区町村、都道府県、郵便番号、国、外部 ID の各フィールドの値をハッシュ化して標準化します。 SHA256 文字列が既に存在する場合、拡張機能はこれらのフィールドの値をハッシュ化しません。

カスタムデータ

ルールには、次のカスタムデータを入力できます。

フィールド名 説明
通貨 ISO-4217 通貨コード。 これを指定しない場合、 Pinterest は、デフォルトで、アカウント作成時に設定された広告主の通貨に設定されます。
イベントの合計値。 リクエスト内の文字列として受け入れられます。 これは 2 桁の数字に解析されます。
検索文字列 ユーザーコンバージョンイベントに関連する検索文字列。
注文 ID 注文 ID。 送信中 order_id 役に立つ情報 Pinterest 必要に応じて、イベントの重複を排除します。
製品数 イベントの製品の合計数。 例えば、チェックアウトイベントで購入された品目の合計数などです。
コンテンツ ID 製品 ID のリスト(配列)。
内容 価格や数量など、製品に関する情報を含むオブジェクトのリスト(配列)。

The Pinterest カスタムデータ ルールアクション内でハイライト表示されています。

内のデータの検証 Pinterest

イベント転送ルールを作成して実行したら、に送信されたイベントかどうかを検証します。 Pinterest API は、 Pinterest UI

イベント収集および Experience Platform 統合に成功した場合は、 Pinterest UI

The Pinterest イベントマネージャー

さらにドリルスルーして、 Pinterest イベントデータ配分。

The Pinterest データ配分

次の手順

このガイドでは、 Pinterest UI のイベント転送拡張機能。 詳しくは、次の公式ドキュメントを参照してください。

このページ