LinkedIn コンバージョンコネクタ構成ガイド | サーバーサイドコネクター

LinkedIn Conversions API (CAPI) は、広告主のサーバーからのマーケティングデータとLinkedInとの間に直接接続を作成するコンバージョントラッキングツールです。この統合により、広告主はコンバージョンが発生する場所に関係なく、LinkedIn マーケティングキャンペーンのパフォーマンスを測定し、このデータを使用してキャンペーンの最適化を行うことができます。Conversions APIは、より完全な帰属、改善された信頼性、最適化された配信により、パフォーマンスをエンリッチメントし、アクションごとのコストを削減するのに役立ちます。

API 情報

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

API 名: LinkedIn API
API バージョン: 202406
API エンドポイント: https://api.linkedin.com/rest
ドキュメント: LinkedIn: Conversions API

コネクタアクション

アクション名	AudienceStream	EventStream
ストリームコンバージョンイベント	✓	✓
バッチコンバージョンイベント	✓	✓

構成の構成

コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

広告アカウント: 必須。スポンサーされたアカウントに合わせた広告アカウントIDを選択します。

重複排除

重複排除は、システムがInsight TagとCAPIの両方から送信された同じイベントを識別し、正確なカウントを保証するために1つを破棄する能力です。重複排除により、同じイベントを両方のソースから送信することができ、CAPIをLinkedIn Insight tagと連携させて、キャンペーンがもたらすコンバージョンに対する最大の可視性を提供します。

このコネクタアクションを構成して、iQ Tag ManagementアカウントのLinkedIn InsightsタグからイベントIDを受け取るには、次の命名規則を使用してイベント属性を探します：

linkedin_event_id_{CONVERSION_ID}_{TAG_UID}

Tealium iQのタグテーブルまたはタグの詳細画面でタグのUIDを見つけます：

例えば、UIDが172のタグからのイベントは、次の属性値を送信します：

linkedin_event_id_11563522_172

Conversion IDは、特定のイベントを追跡するためにLinkedIn Campaign Managerアカウントを構成する際に見つけることができます：

分析 > コンバージョントラッキングに移動します。
コンバージョンの作成 > Conversions APIまたはCSVを選択します。使用例については、LinkedIn: Conversion Trackingを参照してください。
インテグレーションを選択し、追跡したいキーコンバージョン動作を含む必要な構成値を入力します。
次のステップを選択します。
追跡するキャンペーンを選択します。
左側のメニューから分析 > Insight Tagを選択します。
タグマネージャーを使用しますをクリックし、ページに記載されているパートナーIDをコピーします。
必要なすべてのフォームが作成され、パートナーID値をコピーした後、作成をクリックします。

自動重複排除

自動重複排除値が構成されている場合、コネクタはUDOオブジェクト内の対応する変数を探します。このセクションが入力されていてTealium iQを使用している場合、イベントIDを追加する必要はありません。ただし、Tealium iQなしでEventStreamを使用している場合は、次のアプローチが必要になる場合があります。

コネクタは次の操作順序を使用します：

自動重複排除値が構成され、値がデータレイヤーで見つかった場合（例：linkedin_event_id_10501014_30）、この値はイベントIDのマッピングを上書きします。
自動重複排除値が構成されているが値が見つからない場合、構成されている場合はマップされたイベントIDが使用されます。

重複排除の制限

LinkedInは現在、Insight Tag（ピクセル）とConversions API（CAPI）の両方で追跡されるコンバージョンイベントを適切に重複排除する方法を提供していません。両方の方法が同じイベントの追跡信号を送信する場合、LinkedInは最新の信号のみを保持し、以前のものを破棄します。これは、Insight TagとConversions APIの両方を使用して同じコンバージョンイベントを追跡する場合、LinkedInのレポートでデータが欠落したり、上書きされたりする可能性があることを意味します。

また、各方法がサポートするデータフィールドにも違いがあります。Insight Tagは、コンバージョンイベントの値や通貨情報を受け入れることができません。これらのフィールドはConversions APIの実装でのみサポートされています。

広告支出のリターン（ROAS）や総収益を計算するなど、正確なレポーティングを保証するために、LinkedInは特定のコンバージョンイベントごとに1つの追跡方法（Insight TagまたはConversions APIのいずれか）のみを使用し、同時に両方を使用しないことを推奨しています。包括的なコンバージョン追跡とROASの最適化が必要な広告主に対しては、値と通貨を含むすべての関連イベントの詳細を使用してConversions APIを使用することをLinkedInは推奨しています。

変換の作成

Tealiumを使用して、キャンペーンマネージャーインターフェース内で追跡される変換イベントを作成できます。Tealium内で変換を作成することで、LinkedInキャンペーンマネージャー内で追跡用の変換イベントを構成する必要がなくなります。これらの値は変換イベントの追跡に使用され、実行中のキャンペーンと変換イベント値を関連付けるために使用されます。これらは分析 > 変換トラッキングセクションに表示されます。イベントはLinkedInキャンペーンマネージャープラットフォーム内で表示する際に、データソース値がTealiumとして表示されます。

フィールド / パラメータ	説明	例および/またはタイプ
アカウント (`account`)	この変換が属するスポンサー広告アカウントURN。URLクエリパラメータまたはリクエストJSON本文で指定できます。	`urn:li:sponsoredAccount:1234567` URN
名前 (`name`)	このルールの短い名前で、UIやレポートに表示されます。	`Summer_Sale CRM Conversions` / 文字列
有効 (`enabled`)	このルールが変換に一致するかどうかを有効または無効に構成します。初期状態はどちらでもよいが、有効に構成されたルールのみが変換イベントをトリガーします。デフォルト値は`true`です。	`true`
クリック後の帰属ウィンドウサイズ (`postClickAttributionWindowSize`)	LinkedIn広告をクリックしたメンバーの変換ウィンドウ時間枠（日数）。この期間内に発生した変換はLinkedIn広告に帰属されます。許可される値は`1`、`7`、`30`、または`90`です。デフォルト値は`30`です。	`90` (整数)
視認通過帰属ウィンドウサイズ (`viewThroughAttributionWindowSize`)	LinkedIn広告を見たメンバーの変換ウィンドウ時間枠（日数）。この期間内に発生した変換はLinkedIn広告に帰属されます。許可される値は`1`、`7`、`30`、または`90`です。デフォルト値は`7`です。	7 (整数)
帰属タイプ (`attributionType`) パラメータ値: `LAST_TOUCH_BY_CAMPAIGN` `LAST_TOUCH_BY_CONVERSION`	変換アクションがどのようにカウントされるかを説明するモデル: 各キャンペーン: 変換アクションは、それに帰属できる各キャンペーンに対して一度カウントされます（デフォルト）最後のキャンペーン: (単一キャンペーン) 変換アクションは、少なくとも1つの関連キャンペーンがある各変換に対して一度カウントされます。	左セクションの値をサポートするドロップダウン: 各キャンペーン: 複数のキャンペーンに関連する変換アクションの場合、変換ウィンドウ内でインタラクションがあったすべてのキャンペーンが変換でクレジットされます。最後のキャンペーン: キャンペーンに関連する変換アクションの場合、変換ウィンドウ内で広告インタラクションがあった最も最近のキャンペーンが変換でクレジットされます。
タイプ (`type`)	この変換ルールで追跡する変換のタイプ: `ADD_TO_CART`: ユーザーがショッピングカートに1つ以上の商品を追加しました。 `DOWNLOAD`: ユーザーがファイルをダウンロードしました。 `INSTALL`: ユーザーがプラグインまたはアプリをインストールしました。 `KEY_PAGE_VIEW`: ユーザーが重要なウェブページ/アプリ画面を閲覧しました。 `LEAD`: ユーザーがリード生成フォームを記入しました。 `PURCHASE`: ユーザーが購入しました。 `SIGN_UP`: ユーザーがウェブサイト/アプリサービスにサインアップしました。 `OTHER`: 上記にリストされていない何かです。 `TALENT_LEAD`: ユーザーがLinkedIn Talent MediaのPipeline Builderページにリード情報を提出しました。 `JOB_APPLY`: ユーザーがLinkedInで求人に応募しました。 `SAVE`: フォームまたはフローの状態を保存しました。 `START_CHECKOUT`: チェックアウトプロセスを開始しました。 `SCHEDULE`: サービスまたは予約をスケジュールしました。 `VIEW_CONTENT`: ユーザーがページまたはアプリ画面のセクションを閲覧しました（webview）。 `VIEW_VIDEO`: ユーザーがビデオを再生しました。 `ADD_BILLING_INFO`: ユーザーがクレジットカードまたは購入詳細を追加しました。 `BOOK_APPOINTMENT`: ユーザーが予約をしました。 `REQUEST_QUOTE`: ユーザーが見積もりを依頼しました。 `SEARCH`: ユーザーがアプリ内で検索しました。 `SUBSCRIBE`: ユーザーがサービスに登録しました。 `AD_CLICK`: ユーザーが第三者の広告をクリックしました。 `AD_VIEW`: ユーザーが広告を閲覧しました。 `COMPLETE_SIGNUP`: ユーザーが登録プロセスを完了しました。 `SUBMIT_APPLICATION`: ユーザーが申請を提出しました（complete_signupと同じ）。 `PHONE_CALL`: ユーザーが通話を開始したり、電話に特化したイベントや提出を行いました。 `INVITE`: ユーザーが招待を送信/共有しました。 `LOGIN`: ユーザーが広告主のサービスアカウントにログインしました。 `SHARE`: ユーザーがコンテンツを共有しました。 `DONATE`: ユーザーが寄付を行いました。 `ADD_TO_LIST`: ユーザーが商品をウィッシュリストに追加しました。 `RATE`: ユーザーがサービスまたは商品を評価しました。 `START_TRIAL`: ユーザーが試用サブスクリプションを開始しました。 `OUTBOUND_CLICK`: ユーザーがリンクをクリックしてアプリまたはページを離れました。 `CONTACT`: ユーザーがフォームを記入することによって連絡を試みました。

キャンペーンと変換の関連付け

生成された変換イベントを必要なキャンペーン値に関連付けることが重要です。これらの変換イベントはLinkedInキャンペーンと一対多の関係を持つことがあります。Tealiumはまた、マッピングされるアクションに変換イベントを取得します。キャンペーンと変換の関連付けオーバーレイを使用して、変換をキャンペーンにマッピングします。変換とキャンペーン値を選択した後、関連付けの作成を選択し、成功メッセージが表示されるのを待ちます。

パラメータ	説明
変換	必須。変換を選択するか、カスタムテキストとして変換IDを提供します。
キャンペーン	必須。キャンペーンを選択するか、カスタムテキストとしてキャンペーンIDを提供します。

アクション

コネクタのアクションは、変換からLinkedInに連絡先情報を送信するために使用されます。

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

変換イベントのストリーミング

パラメータ

次のパラメータのうち少なくとも1つを送信する必要があります: メールアドレス、LinkedInファーストパーティ広告トラッキングUUID、Acxiom ID、Oracle Moat ID、または名と姓。ユーザー情報（例: 会社、役職、または国コード）を送信する場合は、他の識別パラメータを提供しているかどうかに関わらず、名と姓のパラメータを含める必要があります。

パラメータ	説明
変換	APIを通じて作成された変換ルールを選択します。変換IDはカスタムテキストとして提供できます。
メールアドレス（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化されたメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュを使用してハッシュ化します。
LinkedInファーストパーティ広告トラッキングUUID	ファーストパーティクッキーID。広告主はキャンペーンマネージャーからエンリッチメントされた変換トラッキングを有効にする必要があります。これにより、クリックURLにClick IDパラメータ`li_fat_id`が追加されます。
Acxiom ID	LiveRampアイデンティティグラフとのマッチング用のユーザー識別子。
Oracle Moat ID	Oracle Moatアイデンティティとのマッチング用のユーザー識別子。
名	変換にマッチする連絡先の名。会社、役職、または国コード属性が入力されている場合は必須です。
姓	変換にマッチする連絡先の姓。会社、役職、または国コード属性が入力されている場合は必須です。
会社	変換にマッチする連絡先の会社を表します。
役職	変換にマッチする連絡先の役職名。
国コード	連絡先の国を表すISO 3166標準の2文字国コード。

変換イベント属性

パラメータ	説明
変換時間	変換イベントが発生した時のエポックタイムスタンプ（ミリ秒）。マッピングされていない場合、現在のタイムスタンプで初期化されます。
変換金額	この変換の金銭的価値。conversionValue オブジェクトの送信が必要です。
通貨コード	ISO 4217形式の通貨コード。conversionValue オブジェクトの送信が必要です。
イベントID	広告主によって生成された各イベントを示すユニークID。このフィールドは重複排除に使用されます。

自動重複排除

LinkedInはタグとCAPI用に別の変換IDを使用することを推奨しているため、重複排除は変換IDに関係なくイベントIDに基づいて行われます。Tealium iQ Tag IDが提供された場合、コネクタはTealium iQから送信されたイベントID値を自動的に検索します。タグの変換IDがコネクタの変換IDと異なる場合、そのID値をLinkedIn Insight Tag Conversion IDにマッピングします。

パラメータ	説明
Tealium iQ Tag ID	イベントID値を提供するTealium iQタグ。
LinkedIn Insight Tag Conversion ID	タグの変換IDをマッピングするLinkedIn Insight Tag Conversion ID。

バッチ変換イベント

バッチ制限

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

最大リクエスト数：1000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：1 MB

パラメータ

次のいずれかのパラメータを少なくとも一つ送信する必要があります：メールアドレス、LinkedIn First Party Ads Tracking UUID、Acxiom ID、Oracle Moat ID、または名と姓。ユーザー情報（例：会社、役職、または国コード）を送信する場合は、他の識別パラメータを提供しているかどうかに関わらず、名と姓のパラメータを含める必要があります。

パラメータ	説明
変換	APIを通じて作成された変換ルールを選択します。変換IDはカスタムテキストとして提供できます。
メールアドレス（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化されたメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
LinkedIn First Party Ads Tracking UUID	First Party Cookie ID。広告主はキャンペーンマネージャーからエンリッチメントされた変換トラッキングを有効にする必要があります。これにより、クリックURLにClick IDパラメータ `li_fat_id` が追加されます。
Acxiom ID	LiveRampのアイデンティティグラフとのマッチング用のユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとのマッチング用のユーザー識別子。
名	変換にマッチする連絡先の名。会社、役職、または国コード属性が入力されている場合は必須です。
姓	変換にマッチする連絡先の姓。会社、役職、または国コード属性が入力されている場合は必須です。
会社	変換にマッチする連絡先の会社を表します。
役職	変換にマッチする連絡先の役職名。
国コード	連絡先の国を表すISO 3166標準の二文字国コード。

ベンダー文書

LinkedIn: Conversions API