LinkedInをデータパイプラインソースとして設定 ​

LinkedInをデータパイプラインソースとして設定し、LinkedIn Marketing APIから広告アカウント、キャンペーン、クリエイティブ、分析データを抽出し、宛先に同期します。

このガイドでは、LinkedIn認証情報の準備、LinkedInのWorkatoへの接続、パイプラインの設定、サポート対象オブジェクト、同期モード、制限について説明します。

サポートされている機能 ​

LinkedInをパイプラインソースとして使用する場合、次の機能がサポートされます。

• LinkedIn Marketing API接続: https経由でLinkedIn Marketing APIに接続します。
• マルチアカウント同期: Sync all ad accountsフィールドは、コネクションがアクセスできるすべてのLinkedIn広告アカウントをパイプラインが自動的に検出して同期するかどうかを制御します。
• 完全同期と増分同期: Account、campaign、creative構造オブジェクトは、実行ごとに完全同期を使用します。 Ad Analyticsオブジェクトは、ローリング日付ウィンドウに基づく増分同期をサポートします。 詳細については、同期モードを参照してください。
• オブジェクトレベルの選択: パイプラインに含めるLinkedInオブジェクトを選択します。
• 削除追跡: LinkedInでアーカイブまたはキャンセルされたAccount、Campaign Group、Campaign、Creativeレコードは、宛先で削除済みとしてマークされます。 詳細については、削除追跡を参照してください。
• スキーマドリフト処理: ソースで新しく追加されたフィールドを自動同期するかブロックするかを選択します。
• フィールドレベルのデータ保護: 同期先に同期する前に機密フィールドをマスクします。
• 設定可能な同期頻度: 時間ベースまたはcronベースのスケジュールで同期をスケジュールします。 最小間隔は15分です。

前提条件 ​

LinkedInをデータパイプラインソースとして設定する前に、次の要件を満たしてください。

• 同期する広告アカウントへのアクセス権を持つLinkedIn Campaign Managerアカウント。
• OAuth 2.0認証情報。 LinkedInのMarketing APIは、OAuth 2.0認可コードグラントのみをサポートします。 クライアント認証情報はサポートされていません。 設定手順については、LinkedInに接続を参照してください。

推奨権限 ​

パイプラインはLinkedInに対して読み取り操作のみを実行します。 LinkedInに接続するときは、フィールドを空白のままにするのではなく、Scopesフィールドで次のスコープを選択します。 詳細については、LinkedInに接続を参照してください。

Manage your advertising accountsは、LinkedIn広告アカウントへの書き込みアクセス権も付与します。 パイプライン自体は読み取り操作のみを実行します。

LinkedInに接続 ​

LinkedInに接続するには、次の手順を実行します。

パイプラインの設定 ​

LinkedInをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

LinkedInデータパイプラインは、LinkedIn Marketing APIからデータを同期します。 次の表は、サポートされているオブジェクトをカテゴリ別に示しています。 各オブジェクトは、宛先内の個別のテーブルとして同期されます。

アカウントとキャンペーン構造 ​

これらのオブジェクトは、LinkedIn Campaign Manager内のアカウント、キャンペーン、クリエイティブ構造を定義します。

Creative Serving Status Historyは個別に選択可能なオブジェクトです。 オブジェクトが抽出されるときに、各クリエイティブの配信ステータスフィールドから行を派生します。

リード生成 ​

これらのオブジェクトは、リード取得フォームと送信された回答を同期します。

Lead Gen Formは現在、常に0件のレコードを返します。

広告分析（日次パフォーマンス） ​

これらのオブジェクトは、日次粒度で広告パフォーマンス指標をレポートします。

Ad Analytics Creative x Conversionは、コンバージョン別に分割されたクリエイティブレベルのパフォーマンスをレポートします。

広告分析（月次デモグラフィック） ​

これらのオブジェクトは、オーディエンスのデモグラフィックまたはデバイス別に分割された広告パフォーマンスを月次粒度でレポートします。

このカテゴリに固有の動作については、デモグラフィック分析データの遅延および低ボリュームのデモグラフィック内訳はまばらになる場合がありますを参照してください。

同期モード ​

LinkedInデータパイプラインは、完全同期と増分同期をサポートします。 同期モードはオブジェクトごとに固定されています。 オブジェクトをパイプラインに追加するときに変更することはできません。

フル同期 ​

完全同期では、選択したオブジェクトの利用可能なレコードをLinkedInから読み取り、宛先テーブルを上書きします。 When first started, this pipeline should pick up records fromフィールドが設定されている場合、該当するメタデータオブジェクトは、初回実行時のみ、ネイティブの変更タイムスタンプがその日付より後ではないレコードを除外します。

Account、Account User、Campaign Group、Campaign、Creative、Creative Serving Status History、Conversion、Lead Gen Form、Lead Gen Form Responseは、LinkedInのMarketing APIがこれらのオブジェクトに対して機能する変更時刻フィルターを公開していないため、常に完全同期を使用します。 大規模なアカウントへの影響については、すべてのアカウントとキャンペーン構造オブジェクトは完全同期のみで同期されますを参照してください。

増分同期 ​

増分同期では、前回正常に実行された後に変更された日付範囲のレコードのみを抽出します。 すべてのAd Analyticsオブジェクトは、ローリング日付ウィンドウカーソルを使用します。 各実行では、最後に同期された日付からウィンドウを前方に進めます。

• 日次オブジェクト。 広告分析（日次パフォーマンス）のオブジェクトは、遅延アトリビューションを取得するために、実行ごとに直近7日間を再クエリします。 このルックバックウィンドウは固定されており、ユーザーが設定することはできません。
• 月次オブジェクト。 広告分析（月次デモグラフィック）のオブジェクトは、ルックバック再クエリなしで1か月ずつ進みます。
• 履歴バックフィル。 Ad Analyticsオブジェクトは、When first started, this pipeline should pick up records fromフィールドに入力した日付ではなく、固定のコネクター側開始日からバックフィルされます。 日次オブジェクトとAd Analytics by Impression Deviceは、1年分の履歴をバックフィルします。 残りの月次Memberオブジェクトは、これらの内訳に対するLinkedInの保持制限に合わせて2年分をバックフィルします。

各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

削除追跡 ​

Account、Campaign Group、Campaign、Creativeは、ネイティブのLinkedInステータスフィールドで削除追跡を直接実行できないため、合成_workato_is_archived列を使用して削除を追跡します。 詳細については、合成列を参照してください。

Account User、Conversion、Lead Gen Form Responseには、ネイティブのソフト削除フィールドがありません。 このコネクターのすべての完全同期オブジェクトに共通する標準の宛先差分動作に従い、完全同期レスポンスにレコードが表示されなくなった場合、そのレコードは削除済みとして扱われます。

Ad Analyticsオブジェクトは削除を追跡しません。 分析行は、LinkedInが削除する個別のレコードではなく、日付または月に対して再計算された指標を表します。

スキーマとデータ型の処理 ​

LinkedInデータを同期するときは、次のスキーマ動作が適用されます。

タイムスタンプ ​

ほとんどのアカウントおよびキャンペーン構造のタイムスタンプフィールドは、エポックミリ秒整数を使用します。 Lead Gen Formにはタイムスタンプフィールドがありません。一方、Lead Gen Form Responseはエポックミリ秒のsubmittedAtフィールドを使用します。 Ad Analyticsオブジェクトは、単一のタイムスタンプではなく日付範囲を使用します。 日次オブジェクトにはdate列があり、月次オブジェクトにはレポート月の初日に設定されたmonth列があります。

Ad Analyticsオブジェクトの複合キー ​

Ad Analyticsオブジェクトは、単一のレコードIDではなく複合upsertキーを使用します。 キーは、キャンペーン、クリエイティブ、またはアカウント識別子とdateまたはmonth列を組み合わせます。 Ad Analytics Creative x Conversionは、クリエイティブ識別子、コンバージョン識別子、dateを組み合わせた3部構成のキーを使用します。

合成列 ​

Workatoは、特定のオブジェクトの同期先テーブルに次の合成列を追加します:

機密データの処理 ​

LinkedInオブジェクトには、個人を特定できる情報（PII）が含まれる場合があります。 次のオブジェクトには、一般的に機密フィールドが含まれます:

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。 詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

LinkedInをデータパイプラインソースとして使用する場合、次の制限が適用されます。

すべてのアカウントとキャンペーン構造オブジェクトは完全同期のみで同期 ​

同期のたびに、Account、Account User、Campaign Group、Campaign、Creative、Creative Serving Status History、Conversionの完全なオブジェクトリストを再取得します。 詳細については、完全同期を参照してください。 キャンペーンまたはクリエイティブの数が多いアカウントでは、API負荷を軽減するために、同期間隔を長くすることを検討してください。

デモグラフィック分析データの遅延 ​

Member内訳およびAd Analytics by Impression Deviceオブジェクトは、これらの内訳に対するLinkedInの処理遅延を考慮して、現在の日付の2日前までのデータを反映します。 残りのAd Analyticsオブジェクトは、現在の日付の1日前までのデータを反映します。

低ボリュームのデモグラフィック内訳はまばらになる場合があります ​

LinkedInはAd Analytics by Member Job Titleにプライバシーしきい値を適用し、レポートウィンドウ内で少なくとも3件のイベントがある上位100件のジョブタイトルの結果のみを返します。 このしきい値を下回るジョブタイトルは結果に表示されません。

アクセストークンの有効期限が切れたら再接続 ​

コネクターは、期限切れまたは無効なLinkedInアクセストークンを認可エラーとして扱います。 LinkedInアクセストークンは60日後に期限切れになります。 新しいトークンを取得するには、LinkedInコネクションに再接続します。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。 これより高い頻度で同期をトリガーすることはできません。