Pinterestコンバージョンコネクタ構成ガイド
この記事では、Pinterestコンバージョンコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Pinterest Marketing API
- APIバージョン:v5
- APIエンドポイント:
https://api.pinterest.com/
- ベンダーのドキュメンテーション:Pinterest Conversions Guide
バッチ制限
このコネクタは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます:
- リクエストの最大数:1000
- 最古のリクエストからの最大時間:10分
- リクエストの最大サイズ:2 MB
仕組み
Pinterest Conversions APIは、広告主がPinterestタグを使用せずにPinterestにコンバージョンイベントを送信することを可能にします。コンバージョンをPinterestのキャンペーンにマッピングすることで、コンバージョンの可視性を向上させ、キャンペーンやコンバージョンを促進するアクションの効果をより正確に把握することができます。Conversion APIトラッキングから得られる追加の利点には、最適化とターゲティングのエンリッチメント、透明性の向上、レポートと分析のエンリッチメントが含まれます。
Pinterest Conversions APIは、ウェブ、アプリ内、オフラインのコンバージョンを受け取ることができます。イベントが発生してから1時間以内に受け取ったイベントは、ウェブまたはアプリのイベントとして報告されます。そのウィンドウの外で受け取ったイベントは、オフラインのイベントとしてカテゴライズされます。
Pinterest ConversionコネクタとPinterestタグを併用して、可視性を最大化し、コンバージョンを追跡することをお勧めします。Pinterest Conversionコネクタを単独のソリューションとして使用することも可能ですが、両方のツールを一緒に使用することで最良の結果が得られます。
追跡できるイベントには以下のものがあります:
- カートに追加 - 商品がショッピングカートに追加されます。
- チェックアウト - トランザクションが完了します。
- カスタム - カスタムイベントを追跡します。このイベント名を使用して、コンバージョンレポートに含めたい特別なイベントを追跡します。
- リード - 製品やサービスへの関心。
- ページ訪問 - 製品ページや記事ページなどの主要なページの閲覧。
- 検索 - あなたのウェブサイトでの検索。
- サインアップ - あなたの製品やサービスへのサインアップ。
- カテゴリー表示 - カテゴリーページの閲覧。
- ビデオ視聴 - ビデオの視聴。
- ユーザー定義イベント - オーディエンスターゲティングの目的で定義した追加のイベントを追加します。ユニークなイベントはコンバージョンレポートには利用できません。
重複排除
冗長な実装が行われる場合(例えば、Pinterest Conversion APIとPinterest Tag)、重複排除が必要となります。これは、同一のイベントが両方のソリューションを通じて送信された場合の二重カウントを避けるためです。重複排除を使用することで、広告主はコネクタやタグソリューションを独立して使用する場合よりも多くのコンバージョンが帰属することを期待できます。
PinterestタグとPinterest Conversions APIの重複排除
Pinterest TagとPinterest Conversion APIは、重複排除のためにEvent IDを使用します。複数のソースがコンバージョンデータの追跡に使用される場合、この値が含まれていることを確認してください。Event IDを見つけるための手順は以下の通りです:
- Pinterestビジネスアカウントにログインします。
- Ads > Reportingに移動します。
- テーブルの右上にあるメニューアイコンをクリックし、Performanceを選択します。
あなたのサイトに追加したイベントコードによって、それらは選択した時間枠で何回発生したかとともに、テーブル全体にリストされます。
以下の命名規則を使用してイベント属性を探します:
pinterest_event_id_<Pinterest Event>_<Tag UID>
例えば:pinterest_event_id_Checkout_32
イベントIDごとに別のアクションを使用します。イベント固有のイベントID属性をEvent IDにマッピングし、一致するイベント名をEvent Nameにマッピングします。例えば:
Tealium属性/値 | Pinterestパラメータ |
---|---|
pinterest_event_id_Checkout_32 |
Event ID |
Checkout (ドロップダウン選択) | Event Name |
詳細については、Pinterest Tag Setup Guideを参照してください。
コネクタアクション
アクション名 | AudienceStream | EventStream |
---|---|---|
Send Conversion Event | ✓ | ✓ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、About Connectorsの記事を参照してください。
このコネクタを追加すると、ベンダーのデータプラットフォームポリシーを受け入れるように求められます。
コネクタを追加した後、以下の構成を構成します:
- Access Token
必須。 Pinterest Ads Managerを通じて生成されたAccess Token。
詳細については、PinterestのConversions Guideを参照してください。 - Ad Account ID
必須。 広告アカウントの一意の識別子。PinterestでAd Account IDを見つけるには、広告主アカウントを所有するPinterestアカウントにログインし、Ads > Overviewに移動します。Ad Account IDはURLパスに表示されます。例えば、ads.pinterest.com/advertiser/{ad_account_id}/...
。
コネクタの構成が完了したら、Doneをクリックします。
アクション構成 - パラメータとオプション
Continueをクリックしてコネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
以下のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - Send Conversion Event
パラメータ
パラメータ | 説明 |
---|---|
Event Name | 記録するユーザーイベントのタイプ。 注:カスタムイベントタイプのイベントはレポーティングで使用できません。 カートに追加 - 商品がショッピングカートに追加されます。 チェックアウト - トランザクションが完了します。 カスタム - このイベント名を使用して、コンバージョンレポートに含めたい特別なイベントを追跡します。 リード - 製品やサービスへの関心。 ページ訪問 - 製品ページや記事ページなどの主要なページの閲覧。 検索 - あなたのウェブサイトでの検索。 サインアップ - あなたの製品やサービスへのサインアップ。 カテゴリー表示 - カテゴリーページの閲覧。 ビデオ視聴 - ビデオの視聴。 |
Event Action Source | コンバージョンイベントが発生した場所を示すソース。 App Android - Androidデバイスからのモバイルアプリ内イベント。 App iOS - iOSデバイスからのモバイルアプリ内イベント。 Offline - イベントはオフラインから。 Web - デスクトップウェブブラウザおよびモバイルウェブブラウザから。 |
Event ID | (必須) このイベントを識別し、Pinterest API for ConversionsとPinterest Tagの両方を介して取り込まれたイベント間で重複排除を行うための一意のID文字列。 |
Ad Account ID Override | この構成は、コネクタ構成セクションで使用されるPinterestのAd Account IDを上書きします。Ad Account ID Overrideまたはコネクタ構成セクションのAd Account IDのいずれかを提供する必要があります。 |
Event Time | ユーザーのコンバージョンイベントが発生したときを示すUnixタイムスタンプ(UTC)(秒単位)。イベント時間は、Pinterestがリクエストを受け取る未来にはなりません。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。 |
Event Source URL | ウェブコンバージョンイベントのURL。 |
Opt Out | Event Action SourceがWebまたはOfflineの場合、ウェブコンバージョンイベントの追跡をユーザーがオプトアウトしたかどうかを定義します。一方、Event Action SourceがApp AndroidまたはApp iOSの場合、ユーザーがiOSデバイスで広告追跡を制限したか、Androidデバイスで広告のパーソナライズをオプトアウトしたかどうかを定義します。 |
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= クエリパラメータ。これにより、ROAS/CPAなどのレポート性能が向上する可能性があります。 |
通貨 | ISO-4217の通貨コード。提供されない場合、Pinterestはアカウント作成時に構成された広告主の通貨をデフォルトとします。 |
値 | イベントの総価値。リクエストで文字列として受け入れられ、ダブルに解析されます。例えば、チェックアウトイベントに2つのアイテムがある場合、値は総価格であるべきです。 |
コンテンツID | 製品IDのリスト。 |
アイテム数 | イベントの製品の総数。例えば、チェックアウトイベントで購入されたアイテムの総数。 |
注文ID | 注文ID。 |
検索文字列 | ユーザーのコンバージョンイベントに関連する検索文字列。 |
オプトアウトタイプ | 個人情報の共有をユーザーがオプトアウトするための異なるプライバシー権利法のフラグ。値はカンマで区切られるべきです。配列タイプの属性はマッピング可能で、カンマで区切られた文字列に変換されます。 |
アイテム価格 | 製品の価格。リクエストで文字列として受け入れられ、ダブルに解析されます。例えば、チェックアウトイベントに2つの製品がある場合、値は総価格であるべきです。 |
数量 | 製品の量。 |
アプリID | アプリストアのアプリID。 |
アプリ名 | アプリの名前。 |
アプリバージョン | アプリのバージョン。 |
デバイスブランド | ユーザーデバイスのブランド。 |
デバイスキャリア | ユーザーデバイスのモバイルキャリア。 |
デバイスモデル | ユーザーデバイスのモデル。 |
デバイスタイプ | ユーザーデバイスのタイプ。 |
OSバージョン | デバイスのオペレーティングシステムのバージョン。 |
WiFi | イベントがユーザーデバイスがWiFiに接続されているときに発生したかどうか。 |
言語 | ユーザーの言語を示すISO-639-1の2文字の言語コード。 |
Tealium iQタグID | Tealium iQタグIDが提供されると、Tealium iQから送信されたイベントID値が自動的に識別され、Pinterestに送信されます。イベントIDを識別するために使用されるUDO値はpinterest_event_id_EVENTNAME_TAGID です。 |
テストモード | リクエストをテストリクエストとしてマークするために選択します。イベントは記録されませんが、APIは依然として同じレスポンスメッセージを返します。このモードを使用して、リクエストが機能していることと、イベントが正しく構築されていることを確認します。 |
最終更新日 :: 2024年July月10日