Pinterest イベント転送拡張機能

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

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

Pinterest コンバージョン 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

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

左側のナビゲーションで、「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
* signup
* [ ユーザー定義イベント ]

Action Source

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

* app_android
* app_ios
* web
* offline

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

App Store アプリ ID。

アプリケーション名

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

Application Version

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

デバイスブランド

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

デバイスキャリア

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

デバイスモデル

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

Device Type

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

OS バージョン

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

ユーザーの言語

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

User Data

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

フィールド名

説明

例

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

ebd543592…f2b7e1

Mobile Adverstising IDs

ユーザーの「Google Advertising ID」（GAID）または「Appleの広告主識別子」（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 文字列が既に存在する場合、拡張機能はこれらのフィールドの値をハッシュ化しません。