Pinterest Conversions Connectorのセットアップガイド | サーバーサイドコネクタ

API情報

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

API名：PinterestマーケティングAPI
APIバージョン：v5
APIエンドポイント：https://api.pinterest.com/
ベンダーのドキュメント：Pinterest Conversionsガイド

バッチ制限

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

最大リクエスト数：1000
最も古いリクエストからの経過時間の最大値：10分
リクエストの最大サイズ：2 MB

動作原理

Pinterest Conversions APIを使用すると、Pinterestタグを使用せずに広告主がPinterestにコンバージョンイベントを送信することができます。コンバージョンをPinterestキャンペーンにマッピングすることで、コンバージョンの可視性を向上させ、キャンペーンやコンバージョンを促進するアクションの効果をより正確に把握することができます。コンバージョンAPIトラッキングの追加の利点には、最適化とターゲティングの向上、より透明性のあるレポートと分析のエンリッチメントがあります。

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

Pinterest ConversionコネクタとPinterestタグの両方を使用することをお勧めします。Pinterest Conversionコネクタを単独で使用することもできますが、両方のツールを併用することで最良の結果が得られます。

トラッキングできるイベントには次のものがあります：

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

重複排除

冗長な実装が行われた場合（たとえば、Pinterest Conversion APIとPinterestタグの両方）、重複排除が必要です。重複排除を使用することで、コネクタまたはタグソリューションを単独で使用する場合よりも、より多くのコンバージョンが帰属されることが期待できます。

PinterestタグとPinterest Conversions APIの重複排除

PinterestタグとPinterest Conversions APIは、重複排除のためにイベントIDを使用します。複数のソースを使用してコンバージョンデータをトラッキングする場合、この値を含める必要があります。イベントIDを見つけるには、次の手順を実行します：

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

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

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

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 Ads Managerで生成されたアクセストークン。
詳細については、PinterestのConversionsガイドを参照してください。
広告アカウントID
必須項目。 広告アカウントの一意の識別子。Pinterestで広告主アカウントを所有するPinterestアカウントにログインし、広告 > 概要に移動します。 広告アカウントIDはURLパスに表示されます。例：ads.pinterest.com/advertiser/{ad_account_id}/... 。

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

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

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

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

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

パラメータ

パラメータ	説明
イベント名	記録するユーザーイベントのタイプ。注意：カスタムイベントタイプのイベントはレポートで使用できません。カートに追加 - 商品がカートに追加されます。チェックアウト - 完了した取引。カスタム - コンバージョンレポートに含めたい特別なイベントをトラッキングするためのイベント名。リード - 商品やサービスへの関心。ページビュー - 商品ページや記事ページなどの主要なページの表示。検索 - ウェブサイト上での検索。サインアップ - 製品やサービスへのサインアップ。カテゴリの表示 - カテゴリページの表示。動画の視聴 - 動画の視聴。
イベントアクションソース	コンバージョンイベントが発生した場所を示すソース。 App Android - Androidデバイスからのモバイルアプリ内イベントを介して。 App iOS - iOSデバイスからのモバイルアプリ内イベントを介して。オフライン - オフラインからのイベント。 Web - デスクトップWebブラウザおよびモバイルWebブラウザを介して。
イベントID	（必須）このイベントを識別するための一意のID文字列。Pinterest API for ConversionsとPinterestタグの両方を介して取り込まれたイベント間の重複排除に使用できます。
広告アカウントIDの上書き	この構成は、コネクタ構成セクションで使用されるPinterest 広告アカウントIDを上書きします。コネクタ構成セクションの広告アカウントIDの上書きまたは広告アカウントIDのいずれかを指定する必要があります。
イベント時刻	ユーザーのコンバージョンイベントが発生したUnixタイムスタンプ（UTC）（秒単位）。イベント時刻は、Pinterestがリクエストを受け取った時点の未来になることはできません。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。
イベントソースURL	ウェブコンバージョンイベントのURL。
オプトアウト	イベントアクションソースがWebまたはオフラインの場合、ウェブコンバージョンイベントのトラッキングをオプトアウトしたユーザーかどうかを定義します。イベントアクションソースがApp AndroidまたはApp iOSの場合、iOSデバイスでの広告追跡の制限を有効にしたか、Androidデバイスでの広告パーソナライゼーションをオプトアウトしたかを定義します。
メールアドレス（すでにSHA256ハッシュ化済み）	スペースをトリムし、小文字に変換し、SHA256ハッシュ化済みのメールアドレスを指定します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを指定し、コネクタはこの値をスペースをトリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
Appleの広告主識別子（すでにSHA256ハッシュ化済み）	スペースをトリムし、SHA256ハッシュ化済みのAppleの広告主識別子を指定します。
Appleの広告主識別子（SHA256ハッシュを適用）	プレーンテキストのAppleの広告主識別子を指定し、コネクタはこの値をスペースをトリムしてハッシュ化します。
Google広告ID（すでにSHA256ハッシュ化済み）	スペースをトリムし、SHA256ハッシュ化済みのGoogle広告IDを指定します。
Google広告ID（SHA256ハッシュを適用）	プレーンテキストのGoogle広告IDを指定し、コネクタはこの値をスペースをトリムしてハッシュ化します。
クライアント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ハッシュ化済みの外部IDを指定します。
外部ID（SHA256ハッシュを適用）	プレーンテキストの外部IDを指定し、コネクタはこの値をスペースをトリムし、SHA256ハッシュを使用してハッシュ化します。
通貨	ISO-4217通貨コード。指定しない場合、Pinterestはアカウント作成時に広告主の通貨をデフォルトとします。
値	イベントの合計値。リクエストで文字列として受け入れられ、doubleにパースされます。たとえば、チェックアウトイベントで2つのアイテムがある場合、値は合計価格になります。
コンテンツID	製品IDのリスト。
アイテム数	イベントの製品の総数。たとえば、チェックアウトイベントで購入されたアイテムの総数です。
注文ID	注文ID。
検索文字列	ユーザーのコンバージョンイベントに関連する検索文字列。
オプトアウトタイプ	ユーザーの個人情報の共有をオプトアウトするためのさまざまなプライバシー権利法のフラグ。値はカンマ区切りで指定する必要があります。配列タイプの属性はマッピングでき、カンマ区切りの文字列に変換されます。
アイテム価格	製品の価格。リクエストで文字列として受け入れられ、doubleにパースされます。たとえば、チェックアウトイベントで2つの製品がある場合、値は合計価格になります。
数量	製品の数量。
アプリID	アプリストアのアプリID。
アプリ名	アプリの名前。
アプリバージョン	アプリのバージョン。
デバイスブランド	ユーザーデバイスのブランド。
デバイスキャリア	ユーザーデバイスのモバイルキャリア。
デバイスモデル	ユーザーデバイスのモデル。
デバイスタイプ	ユーザーデバイスのタイプ。
OSバージョン	デバイスのオペレーティングシステムのバージョン。
WiFi	イベントがユーザーデバイスがWiFiに接続されているときに発生したかどうか。
言語	ユーザーの言語を示す2文字のISO-639-1言語コード。
テストモード	リクエストをテストリクエストとしてマークする場合にチェックします。イベントは記録されませんが、APIは同じ応答メッセージを返します。リクエストが正常に機能し、イベントが正しく構築されているかを確認するためにこのモードを使用します。