LinkedIn Conversions Connector セットアップガイド | サーバーサイドコネクタ

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

API情報

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

API名：LinkedIn API
APIバージョン：202302
APIエンドポイント：https://api.linkedin.com/rest
ドキュメント：コンバージョントラッキング

コネクタのアクション

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

構成の構成

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

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

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

重複排除

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

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

linkedin_event_id_<Conversion ID>_<TAG UID>

たとえば、linkedin_event_id_11563522_123です。

Conversion IDは、LinkedInのキャンペーンマネージャーアカウントで、特定のイベントを追跡するためにLinkedIn Insightsタグを構成する際に見つけることができます：

分析 > コンバージョントラッキングに移動します。
コンバージョンの作成 > オンラインコンバージョンまたはオフラインコンバージョンを選択します（使用目的に応じて）。詳細については、コンバージョンの作成を参照してください。
必要な構成値を入力します。これには、追跡するキーコンバージョン動作も含まれます。
次のステップを選択します。
追跡するキャンペーンを選択します。
コンバージョントラッキング方法の定義の下で、イベント固有を選択するか、イメージピクセルコードを使用してコンバージョンIDを表示します。
- 表示された場合、conversion_idパラメータの値を選択します。
必要なフォームがすべて作成され、Conversion IDの値をコピーした後、作成をクリックします。

自動重複排除

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

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

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

コンバージョンの作成

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

フィールド/パラメータ	説明	例および/またはタイプ
アカウント（`account`）	このコンバージョンが所属するスポンサー広告アカウントのURN。URLクエリパラメータまたはリクエストJSON本文で指定できます。	`urn:li:sponsoredAccount:1234567` URN
名前（`name`）	UIおよびレポートに表示されるこのルールの短い名前。	`Summer_Sale CRM Conversions` / 文字列
有効（`enabled`）	このルールを一致させるために`true`または`false`を構成して有効化または無効化します。初期状態はどちらでもかまいませんが、有効になっているルールのみがコンバージョンイベントをトリガーします。デフォルトは`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回カウントされます（デフォルト）最後のキャンペーン：（単一キャンペーン）コンバージョンアクションは、少なくとも1つの関連キャンペーンを持つ各コンバージョンに対して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`：ページまたはアプリ画面のセクションを表示しました（Webビュー）。 `VIEW_VIDEO`：ユーザーがビデオを再生しました。 `ADD_BILLING_INFO`：ユーザーがクレジットカードまたは購入詳細を追加しました。 `BOOK_APPOINTMENT`：ユーザーが予約を確保しました。 `REQUEST_QUOTE`：ユーザーが見積もりをリクエストしました。 `SEARCH`：ユーザーがアプリ内で検索しました。 `SUBSCRIBE`：ユーザーがサービスに登録しました。 `AD_CLICK`：ユーザーが第三者広告をクリックしました。 `AD_VIEW`：ユーザーが広告を表示しました。 `COMPLETE_SIGNUP`：ユーザーが登録プロセスを完了しました。 `SUBMIT_APPLICATION`：ユーザーが申請を提出しました（complete_singupと同じ）。 `PHONE_CALL`：ユーザーが通話を開始したか、電話に関連する特定のイベントまたは送信を行いました。 `INVITE`：ユーザーが招待を送信/共有しました。 `LOGIN`：ユーザーが広告主のサービスアカウントにログインしました。 `SHARE`：ユーザーがコンテンツを共有しました。 `DONATE`：ユーザーが寄付を行いました。 `ADD_TO_LIST`：ユーザーが製品をウィッシュリストに追加しました。 `RATE`：ユーザーがサービスまたは製品に評価を付けました。 `START_TRIAL`：ユーザーがトライアルサブスクリプションを開始しました。 `OUTBOUND_CLICK`：ユーザーがリンクをクリックしてアプリまたはページを離れました。 `CONTACT`：ユーザーがフォームを記入して連絡しようとしました。

キャンペーンをコンバージョンに関連付ける

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

パラメータ	説明
コンバージョン	必須。コンバージョンを選択するか、カスタムテキストとしてコンバージョンIDを指定します。
キャンペーン	必須。キャンペーンを選択するか、カスタムテキストとしてキャンペーンIDを指定します。

アクション

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

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

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

ストリームコンバージョンイベント

パラメータ

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

パラメータ	説明
コンバージョン	APIを介して作成されたコンバージョンルールを選択します。コンバージョンIDはカスタムテキストとして指定できます。
メールアドレス（すでにSHA256ハッシュ化されている）	クリアテキストでSHA256ハッシュ化されたメールアドレスを指定します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを指定し、コネクタがこの値をトリムして小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
LinkedInファーストパーティ広告のトラッキングUUID	ファーストパーティCookie ID。広告主は、キャンペーンマネージャーから拡張コンバージョントラッキングを有効にして、クリックURLにli_fat_idパラメータを追加するファーストパーティCookieを有効にする必要があります。
Axciom ID	LiveRamp Identity Graphとの一致に使用されるユーザー識別子
Oracle Moat ID	Oracle Moat Identityとの一致に使用されるユーザー識別子
名前	コンバージョンに一致させる連絡先の名前
姓	コンバージョンに一致させる連絡先の姓
会社	一致させる連絡先の会社を表します
役職	一致させる連絡先の役職名
国コード	連絡先の国を表すISO標準の2文字の国コード
コンバージョン時刻	コンバージョンイベントが発生したエポックタイムスタンプ（ミリ秒単位）。マッピングされていない場合、現在のタイムスタンプで初期化されます。
コンバージョン金額	このコンバージョンの金銭的価値。conversionValueオブジェクトを送信するために必要です。
通貨コード	ISO形式の通貨コード。conversionValueオブジェクトを送信するために必要です。
イベントID	広告主が各イベントを示すために生成した一意のID。このフィールドは重複排除に使用されます。

バッチコンバージョンイベント

バッチ制限

このアクションは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。リクエストは、次のいずれかの閾値が満たされるまでキューに入れられます：

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

パラメータ

パラメータ	説明
コンバージョン	APIを介して作成されたコンバージョンルールを選択します。コンバージョンIDはカスタムテキストとして指定できます。
メールアドレス（すでにSHA256ハッシュ化されている）	クリアテキストでSHA256ハッシュ化されたメールアドレスを指定します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを指定し、コネクタがこの値をトリムして小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
LinkedInファーストパーティ広告のトラッキングUUID	ファーストパーティCookie ID。広告主は、キャンペーンマネージャーから拡張コンバージョントラッキングを有効にして、クリックURLにli_fat_idパラメータを追加するファーストパーティCookieを有効にする必要があります。
Axciom ID	LiveRamp Identity Graphとの一致に使用されるユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとの一致に使用されるユーザー識別子。
名前	コンバージョンに一致させる連絡先の名前。
姓	コンバージョンに一致させる連絡先の姓。
会社	連絡先の会社を表します。
役職	連絡先の役職名。
国コード	連絡先の国を表すISO標準の2文字の国コード。
コンバージョン時刻	コンバージョンイベントが発生したエポックタイムスタンプ（ミリ秒単位）。マッピングされていない場合、現在のタイムスタンプで初期化されます。
コンバージョン金額	このコンバージョンの金銭的価値。conversionValueオブジェクトを送信するために必要です。
通貨コード	ISO形式の通貨コード。conversionValueオブジェクトを送信するために必要です。
イベントID	広告主が各イベントを示すために生成した一意のID。このフィールドは重複排除に使用されます。