Pinterest コンバージョンコネクタ構成ガイド

API 情報

このコネクタは以下のベンダー API を使用します：

• API 名: Pinterest マーケティング API
• API バージョン: v5
• API エンドポイント: https://api.pinterest.com/
• ベンダー文書: Pinterest コンバージョンガイド

バッチ制限

このコネクタはバッチリクエストを使用して、ベンダーへの大量データ転送をサポートします。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数: 1000
• 最古のリクエストからの最大時間: 10分
• リクエストの最大サイズ: 2 MB

動作方法

Pinterest コンバージョン API は、Pinterest タグを使用せずに、広告主がコンバージョンイベントを Pinterest に送信できるようにします。コンバージョンを Pinterest キャンペーンにマッピングすることで、コンバージョンの可視性を向上させ、キャンペーンの効果やコンバージョンを促進するアクションの正確な画像を得ることができます。コンバージョン API トラッキングから得られる追加の利点には、最適化とターゲティングの向上、透明性の向上、および報告と分析のエンリッチメントが含まれます。

Pinterest コンバージョン API は、ウェブ、アプリ内、またはオフラインのコンバージョンを受け取ることができます。イベント発生から1時間以内に受け取ったイベントは、ウェブまたはアプリイベントとして報告されます。その時間枠の外で受け取ったイベントは、オフラインイベントとして分類されます。

Pinterest コンバージョンコネクタと Pinterest タグの両方を使用して、可視性を最大化し、コンバージョンを追跡することをお勧めします。Pinterest コンバージョンコネクタを単独で使用することもできますが、両方のツールを一緒に使用することで最良の結果が得られます。

追跡可能なイベントには以下が含まれます：

• カートに追加 - 商品がショッピングカートに追加されます。
• チェックアウト - トランザクションが完了します。
• カスタム - カスタムイベントを追跡します。このイベント名を使用して、コンバージョンレポートに含めたい特別なイベントを追跡します。
• リード - 製品またはサービスへの関心。
• ページ訪問 - 製品ページや記事ページなどの主要ページの閲覧。
• 検索 - あなたのウェブサイトでの検索。
• サインアップ - あなたの製品やサービスへのサインアップ。
• カテゴリー表示 - カテゴリーページの閲覧。
• ビデオ視聴 - ビデオの視聴。
• ユーザー定義イベント - オーディンスターゲティングのために定義した追加のイベント。ユニークなイベントはコンバージョンレポートで利用できません。

重複排除

冗長な実装が存在する場合（例：Pinterest コンバージョン API と Pinterest タグ）、重複排除が必要です。これにより、両方のソリューションを通じて単一のイベントが送信された場合の二重カウントを防ぎます。重複排除を使用することで、コネクタまたはタグソリューションが独立して使用される場合よりも、より多くのコンバージョンが帰属されることが期待されます。

Pinterest タグと Pinterest コンバージョン API の重複排除

Pinterest タグと Pinterest コンバージョン API は、重複排除のためにイベント ID を使用します。複数のソースを使用してコンバージョンデータを追跡する場合、この値を含めることを確認してください。イベント ID を見つけるには、次の手順を完了してください：

1. Pinterest ビジネスアカウントにログインします。
2. 広告 > レポートに移動します。
3. テーブルの上部右側にあるメニューアイコンをクリックし、パフォーマンスを選択します。

サイトに追加したイベントコードに応じて、選択した期間中に発生した回数とともにテーブル全体にリストされます。

次の命名規則を使用してイベント属性を探します：

pinterest_event_id_<Pinterest イベント>_<タグ UID>

例：pinterest_event_id_Checkout_32

各タイプのイベント ID に対して別のアクションを使用します。イベント固有のイベント ID 属性をイベント ID にマッピングし、一致するイベント名をイベント名にマッピングします。例えば：

Tealium 属性/値	Pinterest パラメータ
pinterest_event_id_Checkout_32	イベント ID
チェックアウト (ドロップダウン選択)	イベント名

詳細については、Pinterest タグ構成ガイドを参照してください。

コネクタアクション

アクション名	AudienceStream	EventStream
コンバージョンイベント送信	✓	✓

構成の構成

コネクタマーケットプレースに移動して、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについての記事を参照してください。

このコネクタを追加すると、ベンダーのデータプラットフォームポリシーを受け入れるように求められます。

コネクタを追加した後、次の構成を構成します：

• アクセストークン
  必須。 Pinterest 広告マネージャーを通じて生成されたアクセストークン。
  詳細については、Pinterest コンバージョンガイドを参照してください。
• 広告アカウント ID
  必須。 広告アカウントの一意の識別子。Pinterest アカウントにログインし、広告主アカウントを所有している Pinterest アカウントに移動して 広告 > 概要 にアクセスします。広告アカウント ID は URL パスに表示されます。例：ads.pinterest.com/advertiser/{ad_account_id}/... .

コネクタの構成が完了したら、完了 をクリックします。

アクション構成 — パラメータとオプション

コネクタアクションの構成を続けるには、続行 をクリックします。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション — コンバージョンイベント送信

イベント構成

次のパラメータが必要です：

パラメータ	説明
イベント名	記録するユーザーイベントのタイプ。 注意: カスタムイベントタイプのイベントはレポートで使用できません。 カートに追加 - 商品がショッピングカートに追加されます。 チェックアウト - トランザクションが完了します。 カスタム - このイベント名を使用して、コンバージョンレポートに含めたい特別なイベントを追跡します。 リード - 製品またはサービスへの関心。 ページ訪問 - 製品ページや記事ページなどの主要ページの閲覧。 検索 - あなたのウェブサイトでの検索。 サインアップ - あなたの製品やサービスへのサインアップ。 カテゴリー表示 - カテゴリーページの閲覧。 ビデオ視聴 - ビデオの視聴。
イベントアクションソース	コンバージョンイベントが発生した場所を示すソース。 アプリ Android - Android デバイスからのモバイルアプリ内イベント。 アプリ iOS - iOS デバイスからのモバイルアプリ内イベント。 オフライン - イベントはオフラインから。 ウェブ - デスクトップウェブブラウザおよびモバイルウェブブラウザから。

ユーザーデータ

データマッピングは次の要件を満たす必要があります：

• 複数の値を追加するために配列タイプの属性をマッピングします。
• 単一の値を追加するために単一値属性をマッピングします。クライアント IP アドレス および クライアント ユーザーエージェント フィールドには単一値属性のみをマッピングする必要があります。

次のパラメータが必要です：

パラメータ	説明
Email (既に SHA256 ハッシュ化されている)	すでに空白トリム、小文字化、SHA256 ハッシュ化されたメールアドレスを提供します。
Email (SHA256 ハッシュを適用)	プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256 ハッシュを使用してハッシュ化します。
Apple の広告主識別子 (既に SHA256 ハッシュ化されている)	すでに空白トリムおよび SHA256 ハッシュ化された Apple の広告主識別子を提供します。
Apple の広告主識別子 (SHA256 ハッシュを適用)	プレーンテキストの Apple の広告主識別子を提供し、コネクタはこの値を空白トリムして SHA256 ハッシュを使用してハッシュ化します。
Google広告ID（SHA256ハッシュを適用）	プレーンテキストのGoogle広告IDを提供し、コネクタが空白を削除し、この値をSHA256ハッシュでハッシュ化します。
クライアントIPアドレス	ユーザーのIPアドレスで、IPv4またはIPv6形式のいずれかです。
クライアントユーザーエージェント	ユーザーのWebブラウザのユーザーエージェント文字列です。
電話番号（既にSHA256ハッシュ化済み）	数字のみを含む電話番号で、すでに空白を削除し、SHA256でハッシュ化されています。ハッシュ化する前に先頭のゼロを削除してください。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタがすべての非数値文字と先頭のゼロを削除し、空白を削除して、この値をSHA256ハッシュでハッシュ化します。
性別（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された性別を提供してください。
性別（SHA256ハッシュを適用）	プレーンテキストの性別を提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
生年月日（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された生年月日を提供してください。
生年月日（SHA256ハッシュを適用）	プレーンテキストの生年月日を提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
名（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された名前を提供してください。
名（SHA256ハッシュを適用）	プレーンテキストの名前を提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
姓（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された姓を提供してください。
姓（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
市区町村（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された市区町村を提供してください。ハッシュ化する前にスペースと句読点を削除してください。
市区町村（SHA256ハッシュを適用）	プレーンテキストの市区町村を提供し、コネクタがスペースと句読点を削除し、空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
州（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された州を提供してください。
州（SHA256ハッシュを適用）	プレーンテキストの州を提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
郵便番号（既にSHA256ハッシュ化済み）	数字のみを含む郵便番号で、すでに空白を削除し、SHA256でハッシュ化されています。
郵便番号（SHA256ハッシュを適用）	プレーンテキストの郵便番号を提供し、コネクタがすべての非数値文字を削除し、空白を削除して、この値をSHA256ハッシュでハッシュ化します。
国コード（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された国コードを提供してください。
国コード（SHA256ハッシュを適用）	プレーンテキストの国コードを提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
外部ID（既にSHA256ハッシュ化済み）	すでに空白を削除し、SHA256でハッシュ化された1つ以上の外部IDを提供してください。複数の外部IDがある場合は、配列としてフォーマットしてください。詳細については、Pinterest: 外部IDとは何ですか？を参照してください。
外部ID（SHA256ハッシュを適用）	1つ以上のプレーンテキストの外部IDを提供し、コネクタが空白を削除し、これらの値をSHA256ハッシュでハッシュ化します。複数の外部IDを提供する場合は、配列としてフォーマットしてください。
クリックID	ドメインの _epik クッキーまたはURLの &epik= query パラメータに格納されている一意の識別子です。ROAS/CPAなどのレポートパフォーマンスが向上する可能性があります。

変換イベントパラメータ

パラメータ	説明
イベントID	必須。イベントの一意のIDを含む文字列値です。このIDは、Pinterest APIから取り込まれたイベントの重複排除に使用されます。
広告アカウントIDオーバーライド	この構成は、コネクタ構成セクションで使用されるPinterest 広告アカウントID を上書きします。広告アカウントIDオーバーライド またはコネクタ構成セクションの 広告アカウントID のいずれかを提供する必要があります。
イベント時間	ユーザーの変換イベントが発生したときのUnixタイムスタンプ（UTC）を秒単位で示します。このイベント時間は、Pinterestがリクエストを受け取った時間よりも遅れることはできません。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。
イベントソースURL	Web変換イベントのURLです。
オプトアウト	イベントアクションソースがWebまたはOfflineの場合、このパラメータはユーザーがWeb変換イベントの追跡をオプトアウトしたかどうかを定義します。イベントアクションソースがApp AndroidまたはApp iOSの場合、iOSデバイスで広告追跡を制限する機能が有効になっているか、Androidデバイスで広告のパーソナライズをオプトアウトしているかを定義します。
イベント名オーバーライド	イベント名がカスタムに構成されている場合、このフィールドにカスタムイベントの名前を指定します。

カスタムデータ

パラメータ	説明
通貨	ISO 4217通貨コードです。提供されない場合、Pinterestはアカウント作成時に構成された広告主の通貨をデフォルトとします。
価値	イベントの総価値です。コネクタは文字列値を受け取り、それを倍精度数に解析します。複数のアイテムが含まれるチェックアウトイベントの場合は、すべてのアイテムの合計価格を使用します。
コンテンツID	製品IDのリストです。
アイテム数	イベントの製品の総数です。たとえば、チェックアウトイベントで購入されたアイテムの総数です。
注文ID	注文IDです。
検索文字列	ユーザーの変換イベントに関連する検索文字列です。
オプトアウトタイプ	個人情報の共有をオプトアウトするためのさまざまなプライバシー権法のフラグです。値はコンマで区切られる必要があります。配列タイプの属性はマッピングされ、コンマ区切りの文字列に変換されます。

コンテンツデータ

• 変換に複数のアイテムを追加するために、配列タイプの属性を提供します。配列タイプの属性は同じ長さでなければなりません。
• 単一値属性をパラメータにマッピングする場合、その値は変換の配列内のすべてのアイテムに適用されます。

パラメータ	説明
アイテム価格	イベントの総価値です。コネクタは文字列値を受け取り、それを倍精度数に解析します。複数のアイテムが含まれるチェックアウトイベントの場合は、すべてのアイテムの合計価格を使用します。
数量	製品の数量です。
ID	製品のIDです。AddToCartおよびCheckoutイベントに推奨されます。
アイテム名	製品の名前です。
アイテムカテゴリ	製品のカテゴリです。
アイテムブランド	製品のブランドです。

アプリ情報

パラメータ	説明
アプリID	アプリストアのアプリIDです。
アプリ名	アプリの名前です。
アプリバージョン	アプリのバージョンです。
デバイスブランド	ユーザーデバイスのブランドです。
デバイスキャリア	ユーザーデバイスのモバイルキャリアです。
デバイスモデル	ユーザーデバイスのモデルです。
デバイスタイプ	ユーザーデバイスのタイプです。
OSバージョン	デバイスのオペレーティングシステムのバージョンです。
WiFi	イベントがユーザーデバイスがWiFiに接続されているときに発生したかどうか。
言語	ユーザーの言語を示す2文字のISO 639-1言語コードです。

自動重複排除

パラメータ	説明
Tealium iQタグID	Tealium iQタグIDが提供されると、Tealium iQから送信されたイベントID値が自動的に識別され、Pinterestに送信されます。イベントIDを識別するために使用されるUDO値は pinterest_event_id_EVENTNAME_TAGID です。

テストモード

パラメータ	説明
テストモード	リクエストをテストリクエストとしてマークするためにチェックボックスを選択します。イベントは記録されませんが、APIは同じレスポンスメッセージを返します。このモードを使用して、リクエストが正しく機能しており、イベントが正確に構築されていることを確認します。