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を使用している場合、イベントIDを追加する必要はもうありません。ただし、Tealium iQを使用せずにEventStreamを使用する場合は、以下のアプローチがまだ必要になる場合があります。

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

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

コンバージョンの作成

Tealiumを使用して、Campaign Managerインターフェース内で追跡されるコンバージョンイベントを作成することができます。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` (整数)
Attribution Type (`attributionType`) パラメータ値： `LAST_TOUCH_BY_CAMPAIGN` `LAST_TOUCH_BY_CONVERSION`	コンバージョンアクションがどのようにカウントされるべきかを説明するモデル：各キャンペーン：コンバージョンアクションは、それが帰属できる各キャンペーンに対して一度カウントされます（デフォルト）最後のキャンペーン：（単一のキャンペーン）コンバージョンアクションは、少なくとも1つの関連キャンペーンがある各コンバージョンに対して一度カウントされます。	左側のセクションの両方の値をサポートするドロップダウン：各キャンペーン：複数のキャンペーンに関連付けられたコンバージョンアクションの場合、コンバージョンウィンドウ内でインタラクションがあったすべてのキャンペーンがコンバージョンのクレジットを得ます。最後のキャンペーン：キャンペーンに関連付けられたコンバージョンアクションの場合、コンバージョンウィンドウ内で最も最近の広告インタラクションがあったキャンペーンがコンバージョンのクレジットを得ます。
Type (`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は、マッピングするアクションにコンバージョンイベントを取得します。キャンペーンとコンバージョンの関連付けオーバーレイを使用して、コンバージョンをキャンペーンにマップします。コンバージョンとキャンペーンの値を選択した後、関連付けを作成を選択し、成功メッセージが表示されるのを待ちます。

パラメータ	説明
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。広告主は、キャンペーンマネージャーからエンリッチメントされたコンバージョントラッキングを有効にする必要があります。これにより、クリックURLに`li_fat_id`というクリックIDパラメータが追加されるファーストパーティクッキーが有効になります。
Axciom ID	LiveRampアイデンティティグラフとマッチングするためのユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとマッチングするためのユーザー識別子。
First Name	コンバージョンにマッチする連絡先の名前。会社、役職、または国コードの属性が入力されている場合は必須。
Last Name	コンバージョンにマッチする連絡先の姓。会社、役職、または国コードの属性が入力されている場合は必須。
Company	連絡先の会社を表します。
Title	連絡先の役職名。
Country Code	連絡先の国を表すISO 3166標準の2文字の国コード。

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

パラメータ	説明
Conversion Time	コンバージョンイベントが発生したエポックタイムスタンプ（ミリ秒）。マッピングされていない場合、現在のタイムスタンプで初期化されます。
Conversion Amount	このコンバージョンの金額。conversionValueオブジェクトを送信するために必要です。
Currency Code	ISO 4217形式の通貨コード。conversionValueオブジェクトを送信するために必要です。
Event 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分
リクエストの最大サイズ：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。広告主は、キャンペーンマネージャーからエンリッチメントされたコンバージョントラッキングを有効にする必要があります。これにより、クリックURLに`li_fat_id`というクリックIDパラメータが追加されるファーストパーティクッキーが有効になります。
Axciom ID	LiveRampアイデンティティグラフとマッチングするためのユーザー識別子。
Oracle Moat ID	Oracle Moat Identityとマッチングするためのユーザー識別子。
名前	コンバージョンに一致する連絡先の名前。会社、役職、または国コードの属性が入力されている場合は必須です。
姓	コンバージョンに一致する連絡先の姓。会社、役職、または国コードの属性が入力されている場合は必須です。
会社	連絡先の会社を表します。
役職	連絡先の役職名。
国コード	連絡先の国を表すISO 3166標準の2文字の国コード。

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

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

自動重複排除

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

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

ベンダー文書

LinkedIn: Conversions API