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

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

API 情報

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

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

構成

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

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

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

認証

LinkedIn でサインインしてコネクタを使用します。

1. 接続を確立をクリックします。
2. LinkedIn アカウントにサインインします。
3. 許可をクリックして接続を承認します。

重複排除

重複排除は、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アカウントを構成する際に見つけることができます：

1. 分析 > コンバージョントラッキングに進みます。
2. コンバージョンの作成 > Conversions APIまたはCSVを選択します。詳細については、LinkedIn: Conversion Trackingを参照してください。
3. インテグレーションを選択し、追跡したいキーコンバージョン動作を含む必要な構成値を入力します。
4. 次のステップを選択します。
5. 追跡するキャンペーンを選択します。
6. 左側のメニューから分析 > Insight Tagを選択します。
7. タグマネージャーを使用する場合は、タグマネージャーを使用しますをクリックし、ページに記載されているパートナーIDをコピーします。パートナーID値はInsights Tagの構成に必要ですが、CAPIのマッピングには必要ありません。
8. 必要なすべてのフォームが作成された後、作成をクリックします。

自動重複排除

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

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

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

重複排除の制限

LinkedInは、Insight Tag（ピクセル）とConversions API（CAPI）の両方から同じConversion IDとEvent IDが送信された場合、コンバージョンイベントを重複排除します。重複排除の結果は、提供された識別子の組み合わせに依存します。測定目標と報告の優先順位を確認し、要件に合った構成を選択してください：

• 同じConversion IDとEvent ID

  • LinkedInはイベントを同じイベントとして扱い、重複排除し、報告のためにInsight Tagイベントのみを保持します。CAPIイベントは破棄されます。
  • ピクセルを主要な帰属源として残したい場合や、CAPIをバックアップ信号としてのみ必要とする場合は、この構成を使用します。

• 同じConversion IDと異なるEvent ID

  • LinkedInはイベントを別のコンバージョンとして扱い、両方をカウントします。これにより二重カウントが発生しますが、テストまたは移行期間中にピクセルとCAPIのデータを比較することができます。
  • ピクセルベースのトラッキングからCAPIへの移行を検証するための短期間の検証にこの構成を使用します。

• 異なるConversions ID（Event IDに関係なく）

  • LinkedInはイベントをInsight TagとCAPIを通じて追跡される別々のコンバージョンとして考えます。この構成は重複排除を完全に回避し、CAPIイベントの完全なサーバーサイド帰属を保証します。
  • CAPIを主要な真実の源として使用し、サーバーサイドのコンバージョンに独立した帰属を維持したい場合は、この構成を使用します。

各アプローチには精度、可視性、および報告の整合性におけるトレードオフがあります。CAPIのみのトラッキングは最も完全な実装を提供します。並行トラッキングは移行中の制御されたテストと検証を可能にします。重複排除モードは二重カウントを最小限に抑えますが、サーバーサイドデータの可視性を制限します。Tealiumはこれらの3つの方法すべてをサポートし、広告主がLinkedInによるコンバージョンの測定と帰属をどのように反映させたいかを決定することを奨励します。

LinkedIn Click IDの保持

このコネクタでLinkedIn Insight Tagを使用している場合、LinkedIn Click IDをファーストパーティクッキーとして保持します。

デフォルトでは、コネクタはクエリ文字列パラメータから自動的に li_fat_id を読み取ります。自動マッピングを無効にした場合や li_fat_id をファーストパーティクッキーとして保持する必要がある場合のみ、これらの手順に従ってください。

1. Persist Data Value extensionを作成します。
2. データレイヤーにクエリ文字列パラメータ li_fat_id を追加します。
3. li_fat_id の値を li_fat_id クッキーに構成します。

   

4. EventStreamで、li_fat_id_cookie という名前のファーストパーティクッキー属性を作成します。
5. コネクタで li_fat_id_cookie をLinkedIn First Party Ads Tracking UUIDにマップします。

   

変換の作成

Tealiumで変換を作成する場合、LinkedInキャンペーンマネージャーで変換イベントを構成する必要はありません。Tealiumを使用して、キャンペーンマネージャーインターフェースで追跡される変換イベントを作成します。これらの値は変換イベントを追跡し、キャンペーンに関連付けます。変換イベントはLinkedInキャンペーンマネージャープラットフォームのTealiumというデータソース値を持つ分析 > 変換トラッキングセクションに表示されます。

フィールド / パラメータ	説明	タイプ
アカウント (account)	この変換が属するスポンサー広告アカウントURN。この値をURLクエリパラメータまたはリクエストJSON本文で指定します。例：urn:li:sponsoredAccount:1234567。	URN
名前 (name)	このルールの短い名前で、UIやレポートで表示されます。例：Summer_Sale CRM Conversions。	文字列
有効 (enabled)	このルールが変換にマッチするかどうかを有効または無効に構成します。初期状態はどちらでもよいが、有効なルールのみが変換イベントをトリガーします。デフォルト値はtrueです。	ブール
クリック後帰属ウィンドウサイズ (postClickAttributionWindowSize)	LinkedIn広告をクリックしたメンバーの変換ウィンドウ時間枠（日数）。変換はLinkedIn広告に帰属されます。許可される値は1、7、30、または90です。デフォルト値は30です。	整数
視認後帰属ウィンドウサイズ (viewThroughAttributionWindowSize)	LinkedIn広告を視認したメンバーの変換ウィンドウ時間枠（日数）。変換はLinkedIn広告に帰属されます。許可される値は1、7、30、90、または365です。365は次のタイプにのみ有効です：Submit Application、Purchase、Add to Cart、Qualified Lead and Lead。デフォルト値は7です。	整数

帰属タイプ

attributionTypeパラメータは、変換アクションがどのようにカウントされるかを決定します：

値	説明
LAST_TOUCH_BY_CAMPAIGN	各キャンペーン：変換アクションは、それに帰属できる各キャンペーンに対して一度カウントされます。複数のキャンペーンに関連する変換の場合、変換ウィンドウ内でインタラクションがあった各キャンペーンがクレジットされます。（デフォルト）
LAST_TOUCH_BY_CONVERSION	最後のキャンペーン：変換アクションは、少なくとも1つの関連キャンペーンを持つ各変換に対して一度カウントされます。キャンペーンに関連する変換の場合、変換ウィンドウ内で広告インタラクションがあった最も最近のキャンペーンがクレジットされます。

変換タイプ

typeパラメータは、この変換ルールに対して追跡する変換のタイプを指定します：

値	説明
Ad Click	ユーザーが第三者の広告をクリックしました。
Ad View	ユーザーが広告を視認しました。
Add Billing Info	ユーザーがクレジットカードまたは購入詳細を追加しました。
Add to Cart	ユーザーがショッピングカートに1つ以上の商品を追加しました。
Add to List	ユーザーが商品をウィッシュリストに追加しました。
Book Appointment	ユーザーが予約をしました。
Complete Signup	ユーザーが登録プロセスを完了しました。
Contact	ユーザーがフォームを記入して連絡を試みました。
Donate	ユーザーが寄付を行いました。
Download	ユーザーがファイルをダウンロードしました。
Install	ユーザーがプラグインまたはアプリをインストールしました。
Invite	ユーザーが招待を送信または共有しました。
Job Apply	ユーザーがLinkedInで求人に応募しました。
Key Page View	ユーザーが重要なウェブページまたはアプリ画面を閲覧しました。
Lead	ユーザーがリード生成フォームを記入しました。
Login	ユーザーが広告主のサービスアカウントにログインしました。
Other	上記に該当しないもの。
Outbound Click	ユーザーがリンクをクリックしてアプリまたはページを離れました。
Phone Call	ユーザーが通話を開始または電話固有のイベントまたは提出を行いました。
Purchase	ユーザーが購入を行いました。
Qualified Lead	リードを有資格リードとして特定しました。
Rate	ユーザーがサービスまたは製品を評価しました。
Request Quote	ユーザーが見積もりを依頼しました。
Save	フォームまたはフローの状態を保存しました。
Schedule	サービスまたは予約をスケジュールしました。
Search	ユーザーがアプリ内で検索しました。
Share	ユーザーがコンテンツを共有しました。
Signup	ユーザーがウェブサイトまたはアプリサービスにサインアップしました。
Start Checkout	チェックアウトプロセスを開始しました。
Start Trial	ユーザーが試用サブスクリプションを開始しました。
Submit Application	ユーザーがアプリケーションを提出しました（Complete Signupと同じ）。
Subscribe	ユーザーがサービスに登録しました。
Talent Lead	ユーザーがLinkedIn Talent MediaのPipeline Builderページでリードとして情報を提出しました。
View Content	ユーザーがページまたはアプリ画面のセクションを閲覧しました（webview）。
View Video	ユーザーがビデオを再生しました。

キャンペーンを変換に関連付ける

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

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

アクション

アクション名	AudienceStream	EventStream
バッチ変換イベント	✓	✓

コネクタアクションを使用して変換からLinkedInに連絡先情報を送信します。

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

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

バッチ変換イベント

バッチ制限

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

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

パラメータ

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

パラメータ	説明
コンバージョン	APIを通じて作成されたコンバージョンルールを選択するか、カスタムテキストとしてコンバージョンIDを入力します。
メールアドレス（既にSHA256ハッシュ化済み）	既にSHA256でハッシュ化されたメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
LinkedInファーストパーティ広告トラッキングUUID	ファーストパーティクッキーID。広告主はキャンペーンマネージャーから拡張コンバージョントラッキングを有効にし、クリックURLにli_fat_idパラメータを追加するファーストパーティクッキーをアクティブにする必要があります。
Acxiom ID	LiveRampアイデンティティグラフとのマッチング用ユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとのマッチング用ユーザー識別子。
名	コンバージョンにマッチする連絡先の名。会社、役職、または国コード属性が入力されている場合は必須です。
姓	コンバージョンにマッチする連絡先の姓。会社、役職、または国コード属性が入力されている場合は必須です。
会社	コンバージョンにマッチする連絡先の会社を表します。
役職	コンバージョンにマッチする連絡先の役職名。
国コード	連絡先の国を表すISO 3166標準の二文字国コード。
外部ID	externalIdsのリスト。externalIdには、コンバージョンイベントをトリガーしたユーザーを表す広告主提供の識別子が含まれます。詳細については、LinkedIn: カスタムマッチング識別子を参照してください。
クライアントIPアドレス（IPv4）	LinkedInに未ハッシュで送信されるクライアントIPv4アドレス。有効なIPv4値のみが送信され、IPv6および無効な値は無視されます。
Google広告ID（GAID）	明示的な属性マッピングから取得されたGoogle広告ID。専用の属性（例：google_advertising_idまたはgaid）をマッピングし、その属性をアプリまたはモバイルバックエンドがデバイスのGAIDで入力するようにします。値はUUID形式の文字列（例：38400000-8cf0-11bd-b23e-10b96e40000d）である必要があります。マッピングされた値がこの形式に一致しない場合、コネクタはGAIDを省略し、イベントをそのまま送信します。エラーは発生せず、他の識別子には影響しません。

GAIDの取得

GAIDは明示的な属性マッピングからのみ取得されます。コネクタはイベント内の他のデータからGAIDを推測しません。

GAIDを送信するには、データレイヤーに専用の属性（例：google_advertising_idまたはgaid）を作成し、モバイルアプリまたはバックエンドを使用してデバイスのGoogle広告IDでそれを入力します。その属性をコネクタアクションの**Google広告ID（GAID）**フィールドにマッピングします。

値はUUID形式（36文字、ハイフンで区切られた16進数）に一致する必要があります。マッピングされた値がこの形式に一致しない場合、コネクタはGAIDをドロップし、イベントをそのまま送信します。エラーは発生せず、他の識別子には影響しません。

このフィールドに_ga、_gid、または他のGoogleアナリティクスクッキー値をマッピングしないでください。これらの値はGoogleアナリティクスクライアントID形式（GA1.1.*.*）を使用し、有効なGAIDではありません。

コンバージョンイベント属性

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

自動重複排除

LinkedInはタグとCAPIのために別々のコンバージョンIDを使用することを推奨しているため、重複排除はイベントIDを使用します。Tealium iQタグIDを提供すると、コネクタはTealium iQから送信されたイベントID値を検索します。タグのコンバージョンIDがコネクタのコンバージョンIDと異なる場合、そのID値をLinkedIn Insight TagコンバージョンIDにマッピングします。

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

識別子の自動マッピング無効化

デフォルトでは、コネクタはデータレイヤーからクライアントIPv4およびLinkedInファーストパーティ広告トラッキングUUIDを自動マッピングします。LinkedInファーストパーティ広告トラッキングUUIDについては、コネクタがli_fat_idクエリストリングパラメータを読み取ります。このパラメータをアクションでマッピングする場合、そのマッピングが自動マッピングされた値に優先します。識別子の自動マッピング無効化オプションを使用して、これらの識別子の自動マッピングをオフにします。

パラメータ	説明
識別子の自動マッピング無効化	有効にすると、クライアントIPv4およびLinkedInファーストパーティ広告トラッキングUUIDはデータレイヤーから自動マッピングされません。