Pinterest Conversion Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

Pinterestは、画像や動画を通じてアイデアを発見・共有するために設計された人気のソーシャルメディアプラットフォームで、一般的にPinと呼ばれます。様々なマーケティング目標のため、企業はPinterest Adsに料金を支払い、ユーザーが最も目にしやすい目立つ位置にプロモートされたPinを配置できます。

Pinterest Conversions APIを使用することで、この連携により広告主はコンバージョンイベントをPinterestに直接送信し、キャンペーンの最適化、ターゲティング、コンバージョンレポート作成を行い、コンバージョンの可視性を向上させることができます。この連携は以下のコンバージョンタイプをサポートしています:

• Web
• In-App
• Offline conversions

ユーザー属性はマッチング目的で一緒にエクスポートされ、エクスポートにはカスタム属性(製品属性など)も含まれます。

前提条件

• Treasure Dataの基本知識
• Pinterest Ads Managerの基本知識
• Pinterestビジネスアカウント
• Pinterest Conversion API用のアクセストークン。Generate an access token for Pinterest Conversion APIを参照してください。

制限事項

• Conversion APIには、広告アカウントあたり1分間に5000回の呼び出しというレート制限があります。Pinterest API Rate Limitsを参照してください。
• イベントの重複排除は、使用する場合、48時間のウィンドウ内でのみ有効です。
• この連携はPinterestへのテストイベントの送信をサポートしていますが、アップロードされるイベント数を制限しません。Treasure Dataでは、大量のテストイベントを送信しないことを推奨します。

TD Consoleを使用した接続の作成

Treasure Dataでは、クエリを実行する前にデータ接続を作成および設定する必要があります。データ接続の一部として、連携へのアクセスに必要な認証情報を提供します。

新しい接続の作成

1. TD Consoleを開きます。

2. Integrations Hub > Catalogに移動します。

3. Pinterest Conversionを検索します。

4. Create Authenticationを選択します。

   

5. Pinterest Conversion Ads Manager用のアクセストークンを入力します。

6. Continueを選択します。

7. Authenticationの名前を入力し、Doneを選択します。

エクスポート用のクエリ結果の設定

TD Consoleは、データをエクスポートする複数の方法をサポートしています。以下は、Data Workbenchからデータをエクスポートする手順です。

1. Data Workbench > Queriesに移動します。
2. New Queryを選択し、クエリを定義します。
3. Export Resultsを選択します。
4. 既存のPinterest Conversion認証を選択するか、新しく作成します(Create a New Connectionを参照)。
5. エクスポートパラメータを設定し、Doneを選択します。

• Export Resultsパラメータ

コンバージョンイベントをアップロードするためのクエリの定義

• ハッシュ化—以下のHashing列でYesとマークされているフィールドは、小文字にしてSha256でハッシュ化する必要があります。平文で提供された場合、連携がハッシュ化します。

• 文字列の配列—Array of string型のフィールドは、フラット化された列名で複数の値を受け入れます。例えば、em、em_1、em_2は、ユーザーのメール文字列の配列を形成できます。

• アイテムオブジェクトの配列—Pinterestでは、ID、名前、数量、価格などの多くの属性を持つ複数の注文アイテムをアップロードできます。以下はアイテムオブジェクトの例です:

  • item_id, item_price,item_quantity
  • item_id_1, item_price_1, item_name_1
  • item_id_2, item_brand_2, item_category_2

サンプルクエリ

最低限必要なフィールド

SELECT
  'add_to_cart' AS event_name
  ,'app_android' AS action_source
  ,now() AS event_time
  ,'801470028' AS event_id
  ,'some_one@mail.com' AS em
FROM
  your_table

文字列の配列

SELECT 'add_to_cart' AS event_name  ,'app_android' AS action_source  ,now() AS event_time  ,'59930360' AS event_id    ,'some_one@mail.com' AS em  ,'another_one@gmail.com' AS em_1    ,'or123' AS order_id  ,'cook' AS search_string    ,'item 1' AS item_id_1  ,'10.4' AS item_price_1  ,20 AS item_quantity_1    ,'basket' AS item_name_2  ,'cat ' AS item_category_2  ,'tiny' AS item_brand_2 FROM your_table

Audience Studioでセグメントをアクティブ化

Audience Studioでアクティベーションを作成することにより、セグメントデータをターゲットプラットフォームに送信することもできます。

1. Audience Studioに移動します。
2. 親セグメントを選択します。
3. ターゲットセグメントを開き、右クリックしてCreate Activationを選択します。
4. Detailsパネルで、アクティベーション名を入力し、前のセクションの設定パラメータに従ってアクティベーションを設定します。
5. Output Mappingパネルでアクティベーション出力をカスタマイズします。

• Attribute Columns
  • Export All Columnsを選択すると、変更を加えずにすべての列をエクスポートします。
  • + Add Columnsを選択して、エクスポート用の特定の列を追加します。Output Column Nameには、ソース列名と同じ名前が事前入力されます。Output Column Nameを更新できます。+ Add Columnsを選択し続けて、アクティベーション出力用の新しい列を追加します。
• String Builder
  • + Add stringを選択して、エクスポート用の文字列を作成します。次の値から選択します：
    • String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    • Timestamp: エクスポートの日時。
    • Segment Id: セグメントID番号。
    • Segment Name: セグメント名。
    • Audience Id: 親セグメント番号。

1. Scheduleを設定します。

• スケジュールを定義する値を選択し、必要に応じてメール通知を含めます。

1. Createを選択します。

(オプション) CLI を使用したエクスポート連携

TD Toolbelt を使用すると、CLI からクエリ結果のエクスポートをトリガーできます。エクスポートジョブのパラメータは、td query コマンドの --result オプションで指定する必要があります。詳細については、コマンドラインから Treasure Data へのクエリとデータのインポートを参照してください。

以下は、オプションの一般的な構造と JSON 形式の例です:

{    "type": "pinterest_conversion",    "access_token": "pina_AIA2RFAxxx",    "ad_account_id": 549764609761,    "test_event": false,    "skip_invalid_record": true}

CLI パラメータ

実際のイベントとテストイベントの送信例

1. テストコンバージョンイベントを送信

td --database test_db \
--wait "SELECT event_name, action_source, event_time, event_id, event_source_url, opt_out, partner_name, app_id, app_name, app_version, device_brand, device_carrier, device_type, os_version, wifi, language, em, hashed_maids, client_ip_address, client_user_agent, ph, ge, db, ln, fn, ct, st, zp, country, external_id, click_id, partner_id, currency, value, content_ids, content_name, content_category, content_brand, item_id, item_id_1, item_id_2, item_price, item_price_1, item_price_2, item_name, item_name_1, item_name_2, item_category, item_category_1, item_category_2, item_brand, item_brand_1, item_brand_2, item_quantity, item_quantity_1, item_quantity_2, num_items, order_id, search_string, opt_out_type from test_table" \
--type presto \
--result '{"type":"pinterest_conversion","td_authentication_id": 12345, "access_token":"pina_AIA2RFAWACYNMAQA...", "ad_account_id": 5497xxx, "test_event": true, "skip_invalid_record":true}'

2. 実際のイベントを送信

td --database test_db \
--wait "SELECT event_name, action_source, event_time, event_id, event_source_url, opt_out, partner_name, app_id, app_name, app_version, device_brand, device_carrier, device_type, os_version, wifi, language, em, hashed_maids, client_ip_address, client_user_agent, ph, ge, db, ln, fn, ct, st, zp, country, external_id, click_id, partner_id, currency, value, content_ids, content_name, content_category, content_brand, item_id, item_id_1, item_id_2, item_price, item_price_1, item_price_2, item_name, item_name_1, item_name_2, item_category, item_category_1, item_category_2, item_brand, item_brand_1, item_brand_2, item_quantity, item_quantity_1, item_quantity_2, num_items, order_id, search_string, opt_out_type from test_table" \
--type presto \
--result '{"type":"pinterest_conversion","td_authentication_id": 12345, "access_token":"pina_AIA2RFAWACYNMAQA...", "ad_account_id": 5497xxx, "test_event": false, "skip_invalid_record":true}'

その他の設定

• 結果エクスポートはスケジュール設定により、ターゲット宛先へのデータアップロードを定期的に実行できます。
• すべてのインポートおよびエクスポート連携は、TD Workflow に追加できます。td>: データオペレータを使用して、クエリ結果を指定されたコネクタにエクスポートできます。詳細については、Treasure Data オペレータリファレンスを参照してください。

(リファレンス) Conversion API のアクセストークンを生成する

このセクションでは、Conversion API のアクセストークンを生成する方法の概要を説明します。Pinterest は事前の通知なく詳細な手順を変更する場合がありますのでご注意ください。

1. Pinterest Ad Manager から、メインメニューに移動し、Conversions を選択します。

2. Conversions ページで、Set up API を選択し、Generate new token を選択します。

   有効期限のないアクセストークン ``` pina_xxxxxxx が生成されます

関連項目

• Pinterest Send Conversion API