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>

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

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

linkedin_event_id_11563522_172

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

Analyze > Conversion Trackingに移動します。
Create Conversion > Conversions API or CSVを選択します。使用ケースに応じて選択します。詳細については、LinkedIn: Conversion Trackingを参照してください。
インテグレーションを選択し、必要なSettingsの値を入力します。これには、追跡したいKey Conversion Behaviorも含まれます。
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` (integer)
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キャンペーンと1対多の関係を持つことができます。Tealiumは、マッピングするアクションにコンバージョンイベントを取得します。キャンペーンとコンバージョンの関連付けオーバーレイを使用して、コンバージョンをキャンペーンにマップします。コンバージョンとキャンペーンの値を選択した後、関連付けを作成を選択し、成功メッセージが表示されるのを待ちます。

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

アクション

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

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

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

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

パラメータ

次のパラメータのうち少なくとも1つを送信する必要があります：メールアドレス、LinkedIn First Party Ads Tracking UUID、Acxiom 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。広告主は、キャンペーンマネージャーからエンリッチメントされたコンバージョントラッキングを有効にする必要があります。これにより、クリックIDパラメータ`li_fat_id`がクリックURLに追加されるようになります。
Acxiom 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。広告主は、キャンペーンマネージャーからエンリッチメントされたコンバージョントラッキングを有効にする必要があります。これにより、クリックIDパラメータ`li_fat_id`がクリックURLに追加されるようになります。
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タグ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