LinkedIn Conversions API エクスポート連携

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サーバーをインストール

概要

LinkedIn Conversions API (CAPI) コネクターは、B2Bマーケティングキャンペーンのコンバージョンイベントのサーバーサイドトラッキングと測定を可能にします。LinkedInのEvents Managerと直接連携することで、このコネクターは企業がキャンペーンのパフォーマンスを測定し、9億人以上のグローバルプロフェッショナルのネットワーク全体で広告配信をより効果的に最適化するのに役立ちます。

主な機能:

• ウェブイベント: ピクセルデータを補完するサーバーサイドトラッキングにより、フォーム送信、コンテンツダウンロード、デモリクエストなどのB2Bリードジェネレーション測定を強化
• リードジェネレーションイベント: 複雑なB2B販売サイクルにおける適格リードと下流のコンバージョンイベントを追跡するための直接連携
• プロフェッショナルターゲティングデータ: 職種、企業名、業界セグメントなどのプロフェッショナル識別子と属性の追跡をサポート
• データ検証: LinkedIn CAPI仕様への自動イベント検証とフォーマット化により、プロフェッショナルコンバージョンイベントの正確な追跡を保証

このサーバーサイド連携は、クライアントサイドソリューション単独と比較して、より信頼性の高いコンバージョントラッキングと改善されたB2Bキャンペーンパフォーマンス測定を提供します。これは、プロフェッショナルオーディエンスをターゲットとし、より長い販売サイクルを測定する企業にとって特に価値があります。

前提条件

• TD Toolbeltを含むTreasure Dataの基本知識
• LinkedIn Adsの基本知識

制限事項と既知の問題

• イベント時刻の制限: 90日以上前のイベント(event_timeに基づく)は、処理中にスキップされます
• イベント時刻の検証は、エポック変換にUTCタイムゾーンを使用します

新しい接続の作成

クエリを実行する前に、TD Console上でデータ接続を作成して設定する必要があります。データ接続の一部として、連携にアクセスするための認証を提供します。以下の手順を実行してください。

1. TD Consoleを開きます。
2. Integrations Hub > Catalogに移動します。
3. LinkedIn Ads Conversions APIを検索して選択します。アイコンにカーソルを合わせてCreate Authenticationを選択します。
4. Credentialsタブが選択されていることを確認し、Click hereを選択してOAuth認証フローを開始します。認証が完了すると、新しいOAuth接続が作成され、ドロップダウンで利用可能になります。
5. Continueを選択して新しい接続を作成します。

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

TD Consoleは、データをエクスポートする複数の方法をサポートしています。Data Workbenchからデータをエクスポートするには、次の手順に従ってください。

1. Data Workbench > Queriesに移動します。
2. New Queryを選択し、クエリを定義します。
3. Export Resultsを選択してデータエクスポートを設定します。
4. 既存のLinkedIn CAPI認証を選択するか、前述の方法で新しい認証を作成します。
5. Doneを選択します。

コネクター設定パラメーター

コンバージョンルールIDを使用した設定

新しいコンバージョンルールを使用した設定

クエリ結果データ仕様の詳細ガイド

LinkedInにイベントデータをアップロードするには、LinkedInのCAPIガイドラインに準拠したデフォルトフィールドとカスタムフィールドの組み合わせを含むデータエクスポートクエリを構築する必要があります。デフォルトフィールドの場合、カラム名が「Field/Column-Level Specifications」セクションにリストされているものと一致していることを確認してください。コネクタは自動的にカラム名を正規化してLinkedInの必須フォーマットに合わせるため、大文字小文字の区別を気にする必要はありません。

例えば、デフォルトフィールド「conversionHappenedAt」の場合、エクスポートクエリのカラム名は「CONVERSIONHAPPENEDAT」、「conversionhappenedat」、「ConversionHappenedAt」など、任意の大文字小文字で記述できます。コネクタはカラム名を「conversionHappenedAt」に標準化してLinkedIn CAPIの要件に合わせます。

LinkedInのCAPIにユーザープロファイルデータを正常にアップロードまたは変更するには、特定のデータ仕様に準拠したエクスポートクエリを構築する必要があります。これらの仕様は2つのレベルに分かれています:

• Export Query Specifications(またはデータセットレベルのデータ仕様): このセクションでは、必須フィールドの存在や複数のフィールドにまたがるデータ検証ルールなど、クエリ結果データセット全体に適用される要件とルールについて説明します。
• Field/Column-Level Specifications: このセクションでは、各フィールドのデータ型や形式など、データセット内の個々のフィールド/カラムの要件とルールについて詳しく説明します。

Export Query Specifications

Field or Column-Level Specifications

Standard Event Parameters

User Identification Parameters

User Information Parameters

Conversion Value Parameters

Special Field Handling

Handling Date-Time

統合では、日時カスタムフィールドカラムについて、タイムスタンプとしてキャストされた値またはISO-8601日時文字列形式の値を処理できます。ISO-8601日時文字列を使用する場合は、値の末尾に文字「Z」を含めることで、コネクタが日時値を検出し、LinkedIn Ads CAPIのAPIコントラクトで必要とされるUnix時間値に変換できるようにしてください。

Handling Date-Time Custom Field Columnsの例

1. Timestampとしてキャスト

• ソースデータテーブルにstring型のカラムを作成します:

ALTER TABLE source_data_table ADD COLUMN date_time_field VARCHAR;

• そのカラムに日時値の文字列を挿入します:

INSERT INTO source_data_table (id, date_time_field)VALUES(1, '2024-08-28'),(2, '2024-08-28 15:30:00'),(3, '2024-08-28T15:30:00');

• カラム値をtimestamp型としてキャストします:

SELECT id, CAST(date_time_field AS timestamp) AS date_time_field FROM source_data_table;

2. ISO-8601日時文字列を使用する

• ソースデータテーブルにstring型のカラムを作成します:

ALTER TABLE source_data_table ADD COLUMN date_time_field VARCHAR;

• そのカラムに日時値の文字列を挿入します。"T"区切り文字と末尾の"Z"を含むISO-8601形式でフォーマットされていることを確認してください:

INSERT INTO source_data_table (id, date_time_field)VALUES(1, '2024-08-28T00:00:00Z'),(2, '2024-05-28T15:30:00.123Z'),(3, '2024-02-28T15:30:00Z');

• クエリで直接カラムを使用します:

SELECT id, date_time_field FROM source_data_table;

Audience Studio で Segment をアクティベートする

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

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

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

6. Schedule を設定します。

• スケジュールを定義する値を選択し、オプションでメール通知を含めます。

7. Create を選択します。

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

CLI(Toolbelt)を使用してLinkedIn Conversion CAPIに結果をエクスポートすることもできます。

td queryコマンドの--resultオプションを使用して、LinkedInサーバーへのエクスポート情報を指定する必要があります。*td query*コマンドの詳細については、こちらの記事を参照してください。

オプションのフォーマットはJSONで、一般的な構造は以下の通りです。

out:
  type: linkedin_ads_conversion_api
  client_id: your client id
  client_secret: your client secret
  refresh_token: your refresh token
  ad_account_id: your ad account id
  conversion_rule_id: your conversion rule id
  use_conversion_rule_id: true
  skip_invalid_records: true

パラメータ

使用例

OAuth認証

td query --result '{"type":"linkedin_ads_conversion_api","client_id":"client_id","client_secret":"client_secret","refresh_token":"refresh_token,"ad_account_id":"ad_account_id", "conversion_rule_id":conversion_rule_id,"use_conversion_rule_id":true,"skip_invalid_records":true}' -d sample_database "select conversion,conversionhappenedat,currencycode,amount,sha256_email,linkedin_first_party_ads_tracking_uuid,acxiom_id,oracle_moat_id,firstName,title,lastName,companyname,countrycode,externalids as externalIds,lead,eventid from conversion" -T presto

関連記事

その他の設定

• Result Exportは、定期的にターゲット宛先にデータをアップロードするためにスケジュール設定できます。
• すべてのインポートおよびエクスポート統合はTD Workflowに追加できます。tdデータオペレータは、クエリ結果を指定された統合にエクスポートできます。詳細については、Treasure Dataオペレータのリファレンスを参照してください。
• APIドキュメント: Microsoft Conversion API
• Authorization Code Flow: Microsoft Authorization Code Flow (3-legged OAuth)