Pinterest イベント転送拡張機能

Last update: Mon Apr 06 2026 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とやり取りする際に使用する認証方法です。

ユースケース

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

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

マーケティング部門と分析部門は、Pinterestの分析機能を活用して、主要な利用者のインタラクションと行動を把握できます。これにより、利用者をより深く理解し、ターゲットを絞った広告施策を展開できるようになります。

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

Pinterest 前提条件 prerequisites

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

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

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

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

資格情報

説明

例

広告アカウント Id

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

123456789012

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

Pinterest コンバージョンアクセストークン。ガイダンスについては、Pinterest コンバージョン API ドキュメントを参照してください。
このトークンは期限切れではないため、この操作は1回のみ行う必要があります。

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

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

左側のナビゲーションで、Extensionsを選択します。 Install タブのPinterest拡張機能のカードで Catalog を選択します。

がハイライト表示されたPinterest拡張機能を表示するInstall カタログ。

Pinterest 拡張機能の設定

IMPORTANT

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

左側のナビゲーションで、Extensionsを選択します。 Configure** タブのPinterest拡張機能のカードでInstalledを選択します。

Pinterestがハイライト表示されたInstall タブに表示されているConfigure拡張機能。

次の画面で、以前にAds Account Id設定の詳細Conversion Access Token セクションで収集したとを入力します。完了したら、Saveを選択します。

入力フィールド PinterestとConfigureを強調表示するAds Account Id Conversion Access Token画面。

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

すべてのデータ要素を設定したら、イベントをいつ、どのようにPinterestに送信するかを決定するイベント転送ルールの作成を開始できます。

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

Pinterest Send Event ルールの作成。

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

Event Data

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

フィールド名

説明

例

Event Name

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

* チェックアウト
* add_to_cart
* page_visit
&ast；登録
* [ ユーザー定義イベント ]

Action Source

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

* app_android
* app_ios
* web
* オフライン

Event Time

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

1433188255.500は、1433188255秒後500 ミリ秒後、または2015年6月1日月曜日の午後7:50:55 GMTを示します。

Event ID

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

ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

Event Properties

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

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

ルールアクションでPinterest Event Dataが強調表示されました。

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

フィールド名

説明

イベント Source URL

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

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

アプリストアのアプリ ID。

アプリケーション名

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

Application Version

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

デバイスブランド

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

デバイスキャリア

ユーザーのデバイス用モバイルキャリア。

デバイスモデル

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

Device Type

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

OS バージョン

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

ユーザー言語

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

User Data

次のユーザーデータはによって入力できます。必須フィールドではありません。

フィールド名

説明

例

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

ebd543592…f2b7e1

Mobile Adverstising IDs

ユーザーの「Google Advertising ID」（GAID）または「Appleの広告主向けID」（IDFA）のSha256 ハッシュ

ebd543592…f2b7e1

Client IP Address

ユーザーのIP アドレス（IPv4形式またはIPv6形式）。マッチングに使用されます。

192.168.0.1

Client User Agent

ユーザーのweb ブラウザーのユーザーエージェント文字列。

Mozilla/5.0 （platform; rv:geckoversion） Gecko/geckotrail Firefox/firefoxversion

Customer information data

他の顧客情報を含むJSON オブジェクト。生のJSONを提供するか、簡素化されたキー値入力セットを使用するかを選択します。

{ "ph": "122333445" }

ルールアクションでPinterest User Dataが強調表示されました。

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

フィールド名

説明

Phone

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

性別

性別は、女性の場合は「f」、男性の場合は「m」、非バイナリの場合は「n」として入力できます。

生年月日

年、月、日として入力された生年月日。

姓

ユーザーの姓。

名

ユーザーの名前。

市区町村

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

都道府県

小文字の2文字コードとして提供されるユーザーの状態。

郵便番号

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

国

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

外部 ID

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

クリック ID

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

IMPORTANT

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