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タグと連携させて、キャンペーンがもたらすコンバージョンに対する最大の可視性を提供することができます。

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

linkedin_event_id_<CONVERSION_ID>_<TAG_UID>

タグのUIDは、Tealium iQのタグテーブルまたはタグの詳細画面で見つけることができます：

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

linkedin_event_id_11563522_172

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

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

自動重複排除

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

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

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

変換を作成する

Tealiumを使用して、Campaign Managerインターフェース内で追跡される変換イベントを作成できます。Tealium内で変換を作成することで、LinkedIn Campaign Manager内で追跡用の変換イベントを構成する必要がなくなります。これらの値は変換イベントの追跡に使用され、実行中のキャンペーンと変換イベント値を関連付けるために使用されます。これらは分析 > 変換追跡セクションに表示されます。イベントはLinkedIn Campaign Managerプラットフォーム内で表示する際にデータソース値が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`: ユーザーがページまたはアプリ画面のセクションを閲覧しました（ウェブビュー）。 `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。広告主はCampaign Managerから拡張変換トラッキングを有効にする必要があります。これにより、クリックURLにClick IDパラメータ`li_fat_id`が追加されます。
Acxiom ID	LiveRampアイデンティティグラフとのマッチング用のユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとのマッチング用のユーザー識別子。
名	変換にマッチする連絡先の名。会社、役職、または国コード属性が入力されている場合は必須です。
姓	変換にマッチする連絡先の姓。会社、役職、または国コード属性が入力されている場合は必須です。
会社	変換にマッチする連絡先の会社を表します。
役職	変換にマッチする連絡先の役職名。
国コード	連絡先の国を表す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