Pinterest イベント転送拡張機能

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Tags

作成対象：

Developer

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 前提条件 prerequisites

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

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

必要な設定の詳細の収集 configuration-details

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

資格情報

説明

例

広告アカウント ID

お使いの Pinterest Ads アカウント ID。詳しくは、Pinterest ドキュメントを参照してください。

123456789012

コンバージョンアクセストークン

お使いの Pinterest コンバージョンアクセストークン。詳しくは、 Pinterest コンバージョン API ガイダンス用のドキュメント。
このトークンは期限切れにならないので、この操作は 1 回のみ実行する必要があります。

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

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

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

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

Pinterest 拡張機能の設定

IMPORTANT

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

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

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

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

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

イベント転送ルールの設定 config-rule

すべてのデータ要素を設定したら、イベントの送信先と送信方法を決定するイベント転送ルールの作成を開始できます。 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 を提供するか、シンプル化されたキーと値の入力セットを使用するかを選択します。

{ "event_source_url": "http://site.com" }

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 を提供するか、シンプル化されたキーと値の入力セットを使用するかを選択します。

{ "ph": "122333445" }

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

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

フィールド名

説明

Phone

ユーザーの連絡先番号。数字のみを使用でき、国コード、市外局番、および数値を使用して入力する必要があります。

性別

性別は、「f」（女性の場合）、「m」（男性の場合）、または「n」（バイナリ以外の場合）のどちらかとして入力できます。

生年月日

生年月日（年、月、日として入力）

姓

ユーザーの姓。

名

ユーザーの名。

市区町村

ユーザーの居住都市。これは主に請求目的で使用されます。

都道府県

ユーザーの状態。2 文字のコードで小文字で指定されます。

郵便番号

ユーザーの郵便番号。主に請求目的で使用されます。

国

ユーザーの国を示す 2 文字の ISO-3166 国コード。

外部 ID

スペース内のユーザーを識別する広告主の一意の ID。例えば、ユーザー ID、ロイヤリティー ID などです。

クリック ID

ドメインの_epik cookie または URL の&epik=クエリパラメーターに保存される一意の識別子。

IMPORTANT

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