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

API 情報

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

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

バッチ制限

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

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

動作方法

Pinterest API for Conversions は、Pinterest タグを使用せずに広告主がコンバージョンイベントを Pinterest に送信できるようにします。コンバージョンを Pinterest キャンペーンにマッピングすることで、コンバージョンの可視性が向上し、キャンペーンの効果とコンバージョンを促進するアクションのより正確なビューが提供されます。このアプローチは、ターゲティングの最適化、透明性の向上、およびレポーティングと分析の改善を促進します。

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

Pinterest コンバージョンコネクタと Pinterest タグの両方を使用して、可視性を最大化し、コンバージョンを追跡することをお勧めします。Pinterest コンバージョンコネクタはスタンドアロンソリューションとして利用可能ですが、Pinterest コンバージョンコネクタと Pinterest タグを併用することで最良の結果が得られます。

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

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

重複排除

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

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

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

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

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

pinterest_event_id_{PINTEREST_EVENT}_{TAG_UID}

例：pinterest_event_id_Checkout_32

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

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

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

アクション

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

構成

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

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

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

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

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

オフラインコンバージョン

オフラインイベントを通じて広告の影響を測定することができます。これには、ウェブサイトやアプリの外で発生する購入、インタラクション、コンバージョン（例えば、物理的な小売ロケーションで）が含まれます。Pinterest コンバージョンコネクタを使用してオフラインイベントとコンバージョンを処理するには、必要なパラメータを含めるようにコネクタを構成します。

前提条件

• すべてのオフラインイベントについて、コネクタ構成でイベントアクションソースを Offline に構成する必要があります。
• オフラインイベントには、すべての必要なイベントパラメータを含める必要があります。詳細については、Pinterest: サーバーイベントパラメータの形式を参照してください。

構成手順

Pinterest コンバージョンコネクタを使用してオフラインイベントを送信するための構成手順は次のとおりです：

1. アクションタブで新しいコンバージョンイベント送信アクションを追加します。
2. イベントアクションソースパラメータをOfflineにマッピングします。
3. 必要なパラメータをマッピングし、イベントタイプに必要に応じてオプションのパラメータを含めます。
   • Pinterest は、オフラインイベントの必須イベント ID パラメータにトランザクション ID、注文 ID、または Tealium Random をマッピングすることを推奨します。
4. Pinterest Ads Manager で確認します。

アクション

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

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

コンバージョンイベントの送信

パラメータ	説明
イベント名	(必須) 記録するユーザーイベントのタイプ。 注意: カスタムイベントタイプのイベントはレポートで使用できません。 カートに追加 - アイテムがショッピングカートに追加されます。 ウィッシュリストに追加 - アイテムがウィッシュリストに追加されます。 チェックアウト - 取引の完了。 カスタム - コンバージョンレポートに含めたい特別なイベントを追跡するためにこのイベント名を使用します。 チェックアウトの開始 - チェックアウトプロセスが始まります。例えば、ユーザーがチェックアウトボタンをクリックします。 リード - 製品またはサービスへの興味。 ページ訪問 - 製品ページや記事ページなどの主要ページの閲覧。 検索 - あなたのウェブサイトでの検索。 サインアップ - 製品やサービスへのサインアップ。 サブスクライブ - コンテンツストリーミングや月間メールなどのサービス、または月間配送などの製品オファリングへのユーザーのサブスクリプション。 カテゴリー表示 - カテゴリーページの閲覧。 コンテンツ表示 - 製品やランディングページなど、あなたのビジネスに関連するウェブページへのユーザー訪問。 ビデオ視聴 - ビデオ視聴。
イベントアクションソース	(必須) コンバージョンイベントが発生したソースを示します。 アプリAndroid - Androidデバイスからのモバイルインアプリイベントを介して。 アプリiOS - iOSデバイスからのモバイルインアプリイベントを介して。 オフライン - イベントはオフラインから。 ウェブ - デスクトップウェブブラウザおよびモバイルウェブブラウザを介して。

ユーザーデータ

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

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

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

パラメータ	説明
メール (SHA256ハッシュ済み)	すでに空白トリム、小文字化、SHA256ハッシュ処理されたメールアドレスを提供します。
メール (SHA256ハッシュを適用)	プレーンテキストのメールアドレスを提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ処理します。
Appleの広告識別子 (SHA256ハッシュ済み)	すでに空白トリムおよびSHA256ハッシュ処理されたAppleの広告識別子を提供します。
Appleの広告識別子 (SHA256ハッシュを適用)	プレーンテキストのAppleの広告識別子を提供し、コネクタがこの値を空白トリムし、SHA256ハッシュを使用してハッシュ処理します。
Google広告ID (SHA256ハッシュ済み)	すでに空白トリムおよびSHA256ハッシュ処理されたGoogle広告IDを提供します。
Google広告ID (SHA256ハッシュを適用)	プレーンテキストのGoogle広告IDを提供し、コネクタがこの値を空白トリムし、SHA256ハッシュを使用してハッシュ処理します。
クライアントIPアドレス	IPv4またはIPv6形式のいずれかであるユーザーのIPアドレス。
クライアントユーザーエージェント	ユーザーのウェブブラウザのユーザーエージェント文字列。
電話番号 (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 for ConversionsおよびPinterest Tagから取り込まれたイベントの重複排除に使用されます。
広告アカウントIDオーバーライド	この構成は、コネクタ構成セクションで使用されるPinterest 広告アカウントIDをオーバーライドします。広告アカウントIDオーバーライドまたはコネクタ構成セクションの広告アカウントIDのいずれかが提供される必要があります。
イベント時間	ユーザーのコンバージョンイベントが発生したときのUnixタイムスタンプ（UTC、秒単位）。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。イベント時間は、Pinterestがリクエストを受け取った時間よりも遅れることはできません。
イベントソースURL	ウェブコンバージョンイベントのURL。
オプトアウト	イベントアクションソースがウェブまたはオフラインの場合、このパラメータはユーザーがウェブコンバージョンイベントの追跡をオプトアウトしたかどうかを定義します。イベントアクションソースがアプリAndroidまたはアプリ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は同じレスポンスメッセージを返します。リクエストが機能しており、イベントが正しく構築されていることを確認するためにこのモードを使用します。

自動マッピング無効化

パラメータ	説明
自動マッピング無効化	コネクタの自動マッピングを無効にします。

構成

パラメータ	説明
アクセストークン	Pinterest広告マネージャーを通じて生成されたアクセストークン。詳細については、Pinterest: コンバージョンガイドを参照してください。