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
Stream Conversion Event	✗	✓
Batch Conversion Events	✗	✓

構成の構成

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

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

Ad Account：必須。スポンサードアカウントと一致する広告アカウントIDを選択します。

重複排除

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

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

linkedin_event_id_<Conversion ID>_<TAG UID>

例えば linkedin_event_id_11563522_123。

Conversion IDは、特定のイベントの追跡にLinkedIn Insightsタグを構成している間、LinkedInのCampaign Managerアカウントで見つけることができます：

Analyze > Conversion Trackingに移動します。
Create Conversion > Conversions API or CSVを選択します。使用ケースに応じて選択します。詳細については、LinkedIn: Conversion Trackingを参照してください。
インテグレーションを選択し、追跡したいKey Conversion Behaviorを含む必要なSettings値を入力します。
Next Stepを選択します。
追跡するキャンペーンを選択します。
左側のメニューからAnalyze > Insight Tagを選択します。
I will use a tag managerをクリックし、ページに記載されているパートナーIDをコピーします。
必要なすべてのフォームが作成され、Partner ID値をコピーしたら、Createをクリックします。

自動重複排除

Automatic Deduplication値が構成されている場合、コネクタはUDOオブジェクト内の対応する変数を探します。このセクションが入力されていてTealium iQを使用している場合、Event IDを追加する必要はもうありません。ただし、Tealium iQを使用せずにEventStreamを使用する場合は、以下のアプローチがまだ必要になる場合があります。

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

Automatic Deduplicationが構成されており、その値がデータレイヤーで見つかった場合（例えば、linkedin_event_id_10501014_30）、この値はEvent IDのマッピングを上書きします。
Automatic Deduplicationが構成されているが、値が見つからない場合、構成されている場合は、マッピングされたEvent IDが使用されます。

コンバージョンの作成

Tealiumを使用して、Campaign Managerインターフェース内で追跡されるConversion Eventを作成することができます。Tealium内でコンバージョンを作成することで、LinkedIn Campaign Manager内で追跡のためのコンバージョンイベントを構成する必要がなくなります。これらの値は、コンバージョンイベントの追跡と、実行中のキャンペーンとの関連付けに使用されます。これらはAnalyze > Conversion Trackingセクションに表示されます。イベントは、LinkedIn Campaign Managerプラットフォーム内で表示するときにTealiumというデータソース値で表示されます。

フィールド / パラメータ	説明	例またはタイプ
Account (`account`)	このコンバージョンが属するスポンサード広告アカウントURN。これはURLクエリパラメータまたはリクエストJSONボディで指定できます。	`urn:li:sponsoredAccount:1234567` URN
Name (`name`)	このルールの短い名前で、UIやレポートに表示されます。	`Summer_Sale CRM Conversions` / string
Enabled (`enabled`)	このルールがコンバージョンにマッチするのを有効または無効にします。初期状態はどちらでもよいが、有効になっているルールのみがコンバージョンイベントをトリガーします。デフォルトは`true`。	`true`
Post Click attribution window size (`postClickAttributionWindowSize`)	LinkedIn広告をクリックしたメンバーのコンバージョンウィンドウ時間枠（日数）。コンバージョンはLinkedIn広告に帰属します。許可される値は`1`、`7`、`30`、または`90`。デフォルトは`30`	`90` (integer)
Attribution Type (`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_singupと同じ）。 `PHONE_CALL`: ユーザーが電話をかけた、または電話に関連するイベントや提出を行いました。 `INVITE`: ユーザーが招待を送った/共有しました。 `LOGIN`: ユーザーが広告主のサービスアカウントにログインしました。 `SHARE`: ユーザーがコンテンツを共有しました。 `DONATE`: ユーザーが寄付を行いました。 `ADD_TO_LIST`: ユーザーが商品をウィッシュリストに追加しました。 `RATE`: ユーザーがサービスや商品を評価しました。 `START_TRIAL`: ユーザーが試用期間を開始しました。 `OUTBOUND_CLICK`: ユーザーがリンクをクリックしてアプリやページを離れました。 `CONTACT`: ユーザーがフォームを記入してコンタクトを試みました。

キャンペーンとコンバージョンの関連付け

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

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

アクション

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

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

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

ストリーム変換イベント

パラメータ

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

パラメータ	説明
Conversion	APIを通じて作成された変換ルールを選択します。変換IDはカスタムテキストとして提供することができます。
Email Address (already SHA256 hashed)	すでにSHA256でハッシュ化されたプレーンテキストのメールアドレスを提供します。
Email Address (apply SHA256 hash)	プレーンテキストのメールアドレスを提供し、コネクタは空白をトリムし、小文字にし、この値をSHA256ハッシュでハッシュ化します。
LinkedIn First Party Ads Tracking UUID	First Party Cookie ID。広告主はキャンペーンマネージャーからエンリッチメントされたコンバージョントラッキングを有効にする必要があります。これにより、Click IDパラメータ`li_fat_id`がクリックURLに追加されるファーストパーティクッキーが有効になります。
Axciom ID	LiveRamp identity graphとマッチングするためのユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとマッチングするためのユーザー識別子。
First Name	コンバージョンにマッチする連絡先の名前。会社、役職、または国コードの属性が入力されている場合は必須。
Last Name	コンバージョンにマッチする連絡先の姓。会社、役職、または国コードの属性が入力されている場合は必須。
Company	マッチする連絡先の会社を表します。
Title	マッチする連絡先の役職名。
Country Code	連絡先の国を表すISO標準の2文字の国コード。
Conversion Time	変換イベントが発生した時点のエポックタイムスタンプ（ミリ秒）。マッピングされていない場合、現在のタイムスタンプで初期化されます。
Conversion Amount	この変換の金額。conversionValueオブジェクトを送信するために必要。
Currency Code	ISO形式の通貨コード。conversionValueオブジェクトを送信するために必要。
Event ID	広告主が各イベントを示すために生成した一意のID。このフィールドは重複排除に使用されます。

バッチ変換イベント

バッチ制限

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

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

パラメータ

パラメータ	説明
Conversion	APIを通じて作成された変換ルールを選択します。変換IDはカスタムテキストとして提供することができます。
Email Address (already SHA256 hashed)	すでにSHA256でハッシュ化されたプレーンテキストのメールアドレスを提供します。
Email Address (apply SHA256 hash)	プレーンテキストのメールアドレスを提供し、コネクタは空白をトリムし、小文字にし、この値をSHA256ハッシュでハッシュ化します。
LinkedIn First Party Ads Tracking UUID	First Party Cookie ID。広告主はキャンペーンマネージャーからエンリッチメントされたコンバージョントラッキングを有効にする必要があります。これにより、Click IDパラメータ`li_fat_id`がクリックURLに追加されるファーストパーティクッキーが有効になります。
Axciom ID	LiveRamp identity graphとマッチングするためのユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとマッチングするためのユーザー識別子。
First Name	コンバージョンにマッチする連絡先の名前。会社、役職、または国コードの属性が入力されている場合は必須。
Last Name	コンバージョンにマッチする連絡先の姓。会社、役職、または国コードの属性が入力されている場合は必須。
Company	マッチする連絡先の会社を表します。
Title	マッチする連絡先の役職名。
Country Code	連絡先の国を表すISO標準の2文字の国コード。
Conversion Time	変換イベントが発生した時点のエポックタイムスタンプ（ミリ秒）。マッピングされていない場合、現在のタイムスタンプで初期化されます。
Conversion Amount	この変換の金額。conversionValueオブジェクトを送信するために必要。
Currency Code	ISO形式の通貨コード。conversionValueオブジェクトを送信するために必要。
イベントID	広告主が各イベントを示すために生成する一意のID。このフィールドは重複排除に使用されます。

ベンダーのドキュメンテーション

LinkedIn: コンバージョンAPI