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 は、Web、アプリ内、またはオフラインのコンバージョンを受け取ることができます。イベントが発生してから1時間以内に受け取られたイベントは、Webまたはアプリイベントとして報告されます。その時間枠の外で受け取られたイベントは、オフラインイベントとして分類されます。

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

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

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

重複排除

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

Pinterest タグと Pinterest API for Conversions のための重複排除

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
チェックアウト (ドロップダウン選択)	イベント名

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

コネクタアクション

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

構成の構成

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

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

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

• アクセストークン
  必須。 Pinterest 広告マネージャーを通じて生成されたアクセストークン。
  詳細については、Pinterest コンバージョンガイドを参照してください。
• 広告アカウント ID
  必須。 広告アカウントの一意の識別子。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ハッシュ化済み）	空白をトリムし、SHA256でハッシュ化されたGoogle広告IDを提供してください。
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 for ConversionsおよびPinterest Tagから取り込まれたイベントの重複排除に使用されます。
広告アカウント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に接続されているときに発生したかどうか。
言語	ユーザーの言語を示す二文字のISO 639-1言語コード。

自動重複排除

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

テストモード

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