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

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

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

重複排除

冗長な実装が存在する場合（例：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 アカウントにログインし、広告主アカウントを所有する 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形式のいずれかです。
クライアントユーザーエージェント	ユーザーのウェブブラウザのユーザーエージェント文字列です。
電話番号（既に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に接続されているときに発生したかどうか。
言語	ユーザーの言語を示す二文字のISO 639-1言語コード。

自動重複排除

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

テストモード

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

自動マッピング無効化

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