Pinterest イベント転送拡張機能

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

Pinterest は、レシピ、家の装飾、スタイルのインスピレーションなどのアイデアを見つけるための視覚的な発見エンジンです。 Pinterest には数十億のピンがあり、Pinterest 上の他のユーザーと共有することもできます。ユーザーインタラクションイベントを照合し、Pinterest Analytics れを活用してユーザーの行動を把握し、ターゲット広告を実行できます。

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

コンバージョンアクセストークンは、Pinterest が Pinterest API を操作する際に使用する認証方法です。

ユースケース

この拡張機能は、Edge Networkのデータを使用して customer analytics の機能 Pinterest 活用する場合に使用します。

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

その後、マーケティングチームと分析チームは、Pinterest Analytics 機能を活用して主要なユーザーのインタラクションと行動を理解することで、ユーザーをより深く理解し、ターゲット広告キャンペーンのターゲットに設定できます。

Pinterest 固有のユースケースについて詳しくは、Pinterest ユースケースドキュメントを参照してください。

Pinterest 前提条件 prerequisites

この拡張機能を使用するには、有効な Pinterest ビジネスアカウントが必要です。アカウントをまだお持ちでない場合は、Pinterest 登録ページに移動し、アカウントを登録して作成してください。

また、Pinterest 開発者アカウントも必要です。このアカウントは、Pinterest ビジネスアカウントに関連付ける必要があります。開発者アカウントをビジネスアカウントに関連付けるには、Pinterest 開発者アカウントを参照してください。

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

Experience Platformを Pinterest に接続するには、次の入力が必要です。

資格情報

説明

例

広告アカウント Id

Pinterest 広告アカウント Id。詳しくは、Pinterest ドキュメントを参照してください。

123456789012

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

Pinterest コンバージョンアクセストークン。詳しくは、Pinterest Conversions API ドキュメントを参照してください。
このトークンは期限切れではないので、これは 1 回だけ実行する必要があります。

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

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

左側のナビゲーションで、「拡張機能」を選択します。「カタログ」タブの Pinterest 拡張機能のカードにある「インストール」を選択します。

インストールがハイライト表示された Pinterest 拡張機能を表示するカタログ

Pinterest 拡張機能の設定

IMPORTANT

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

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

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

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

広告アカウント ID およびコンバージョンアクセストークン入力フィールドがハイライト表示された Pinterest 設定画面

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

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

イベント転送プロパティに新しいルールを作成します。「アクション」で、新しいアクションを追加し、拡張機能を「Pinterest」に設定します。 Edge Networkイベントを Pinterest に送信するには、アクションタイプ を イベントを送信 . に設定します。

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

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

イベントデータ

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

フィールド名

説明

例

イベント名

ユーザーイベントのタイプ。任意のイベントタイプを使用できますが、Pinterest Analytics れを活用するには、Pinterest イベントコードを使用することをお勧めします。

* チェックアウト
* add_to_cart
* page_visit
* サインアップ
* [ ユーザー定義イベント ]

アクションSource

コンバージョンイベントが発生した場所を示すソース。

* app_android
* app_ios
* web
* offline

イベント時間

これはイベント時間を指します。使用されるデフォルトの時間形式は UNIX で、形式はローカルタイムゾーンに応じて <seconds>.<miliseconds> なります。詳しくは、Pinterest API を参照してください。

1433188255.500 は、エポックから 1433188255 秒と 500 ミリ秒後、すなわち 2015 年 6 月 1 日（月）の午後 7:50:55 （GMT）を示します。

イベント ID

このイベントを識別する一意の ID 文字列。コンバージョン API とPinterest トラッキングの両方を介して取り込まれたイベント間の重複排除に使用できます。そうしないと、イベントのデータが二重にカウントされ、指標の膨張を報告する可能性があります。

ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

イベントのプロパティ

イベントのカスタムプロパティを含む JSON オブジェクト。生の JSON を提供するか、キー値の入力のシンプルなセットを使用するかを選択します。

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

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

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

フィールド名

説明

イベントSourceの URL

Web コンバージョンイベントの URL。

アプリケーションストア ID

App Store アプリ ID。

アプリケーション名

アプリケーションの名前。

Application Version

アプリケーションのバージョン。

デバイスブランド

ユーザーが使用しているデバイスのブランド。

デバイスキャリア

自分のデバイスでのユーザーの携帯電話会社。

デバイスモデル

ユーザーのデバイスのモデル。

Device Type

ユーザーが使用しているデバイスのタイプ。

OS バージョン

デバイスのオペレーティングシステムのバージョン。

ユーザーの言語

ユーザーの言語を示す 2 文字の ISO-639-1 言語コード。

ユーザーデータ

必須フィールドではないユーザーが次のユーザーデータを入力できます。

フィールド名

説明

例

メール

ユーザーの電子メールアドレス、またはユーザーのアドレスの電子メールの SHA256 ハッシュ。

ebd543592…f2b7e1

モバイル広告 ID

ユーザーの「Google Advertising ID」（GAID）または「Appleの広告主識別子」（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" }

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

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

フィールド名

説明

Phone

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

性別

性別は、女性の場合は「f」、男性の場合は「m」、バイナリ以外の場合は「n」のいずれかを入力できます。

生年月日

生年月日。年、月、日と入力します。

姓

ユーザーの姓。

名

ユーザーの名。

市区町村

ユーザーの居住都市。主に課金目的で使用されます。

都道府県

ユーザーの状態（小文字の 2 文字コードで提供）。

郵便番号

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

国

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

外部 ID

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

クリック ID

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

IMPORTANT

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