Skip to content
/
LinkedIn Export Integrati...
Last updated

LinkedIn Export Integration

Treasure DataからLinkedInにジョブ結果を直接エクスポートできます。このエクスポートデータコネクタを使用して、Data Management Platform (DMP) セグメントを作成し、オーディエンスリストをMatched Audiencesに動的にアップロードまたは更新できます。LinkedIn Export Connectorは以下の機能をサポートしています:

  • セグメントが存在しない場合、新しいDMPセグメントを自動作成します。
  • DMPセグメントから連絡先またはアカウントを追加または削除します。
  • 値がハッシュ化されていない場合、ユーザーのメールアドレスを自動検出してハッシュ化します。
  • 無効な値をスキップまたは停止するオプションを指定できます。

前提条件

  • Treasure Dataの基本的な知識
  • 有効なLinkedIn Ad Accountアカウント
  • LinkedInの広告主アカウントへのTreasure Dataアカウントアクセスの認証

要件、制限事項、および動作

  • プレーンテキストとマスク(ハッシュ化)されたメールアドレスは、同じデータ列に含めることができます。 プレーンテキストのメールアドレスは、LinkedInに送信される前にハッシュ化されます。
  • LinkedInはリフレッシュトークンの有効期限を365日に制限しています。 1年後、データのアップロードを継続するには、新しい認証を作成する必要があります。
  • オーディエンスカウントは、完全にアップロードが完了するまで最大48時間かかる場合があります。 ユーザーと企業がDMPセグメントに追加されると、初回のマッチングプロセスでIDを宛先セグメントに解決するのに最大48時間かかる場合があります。完了すると、セグメントのステータスは「Ready」になります。

TD Consoleを使用して接続を作成する

新しい接続を作成する

Treasure Dataでは、クエリを実行する前に、エクスポート時に使用するデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。

  1. TD Consoleを開きます。
  2. Integrations Hub > Catalogに移動します。
  3. LinkedInを検索して選択します。Createを選択します。
  4. 以下のダイアログが開きます。
  5. Click here to connect to a new accountを選択します。まだログインしていない場合はLinkedInにログインするため、またはTreasure Dataへのアクセスを許可するための同意ページにリダイレクトされます。
  6. TD consoleにリダイレクトされます。最初のステップ(新しい接続を作成する)を繰り返し、新しいOAuth接続を選択します。
  7. Continueを選択し、新しいLinkedIn接続に名前を付けます。
  8. Doneを選択します。

データ接続でエクスポート結果を設定する

このステップでは、クエリを作成または再利用します。クエリでデータ接続を設定します。場合によっては、クエリで列マッピングを定義する必要があります。

パラメータを指定して接続を設定する

  1. TD Consoleを開きます。
  2. Data Workbench > Queriesに移動します。
  3. データのエクスポートに使用する予定のクエリを選択します。
  4. クエリエディタの上部にあるExport Resultsを選択します。Choose Integrationダイアログが開きます。

結果をエクスポートするために使用する接続を選択する際には、既存の接続を使用するか、新しい接続を作成するかの2つのオプションがあります。

既存の接続を使用する

  1. 検索ボックスに接続名を入力してフィルタリングします。
  2. 接続を選択します。
  3. Export Resultsダイアログが開きます。
  4. Ad Account IDを入力します。
  5. Segment Nameを入力します。または、セグメントIDを入力する場合は、Segment IDを入力してからUsing Segment IDチェックボックスを選択します。
  6. Doneを選択します。

新しいLinkedIn接続を作成する

  1. New Integrationを選択し、TypeドロップダウンからLinkedInを選択します。
  2. Create Integrationダイアログが開きます。
  3. Catalogリンクを選択してCatalogページに移動します。
  4. 前述の「新しい接続を作成する」で説明されている手順(OAuth接続の作成を含む)を完了します。
  5. 新しいLinkedIn接続に必要な認証情報を入力します。

Export Resultsを完了する

以下のパラメータを設定し、Doneを選択します。

ParametersDescription
Ad Account ID (required)Ad Account ID
Audience TypeContact List (Users) または Account List (Companies)
Segment NameDMPセグメント名
Using Segment IDSegment NameではなくSegment IDを使用している場合は、このチェックボックスを選択します。
Segment IDDMPセグメントID
Segment Description (optional)DMPセグメントの説明
DMP Segment ModeAddまたはRemove。mode = Addで、Segment Nameが存在しない場合、指定された名前のDMPが作成されます。
Ignore Invalid Records無効な行を無視し、他の行のインポートを継続するオプション。無効な行はジョブログに記録されます。このオプションが選択されていない場合(デフォルト)、無効なレコードが検出されるとジョブが終了し、アップロードされたデータは元に戻されません。

クエリの列名

LinkedInデータコネクタは、以下の列とデータ型を理解し解釈します。エイリアス列名を、以下に指定された列と一致するように変更する必要があります。

列に値がない場合、ジョブは失敗します。

以下の表は、LinkedIn export integrationで使用可能な列を説明しています:

Column nameTypeRequiredDescription

email

string

optional

Contact List(Users)に適用されます。ユーザーのメールアドレス、SHA256ハッシュ化されたメールアドレス、またはSHA512ハッシュ化されたメールアドレス。ユーザーのメールアドレスは、LinkedInに送信される前にSHA256でハッシュ化されます。

入力リクエストは検証され、以下の検証ルールが満たされない場合は失敗します:

  • 入力リクエストには、少なくとも1つの有効なemail、google_aid、apple_idfa、または
  • 有効なfirst_nameとlast_nameを提供する必要があります
google_aidstringoptional最大32文字ですべて小文字のプレーンテキスト文字列。例: cdda802e-fb9c-47ad-0794d394c912
apple_idfastringoptional最大32文字ですべて大文字のプレーンテキスト文字列。例: EA7583CD-A667-48BC-B806-42ECB2B48606。
first_namestringoptional最大35文字で、特殊文字を含まない、マッチする連絡先の名を表すプレーンテキスト文字列。例: Mike
last_namestringoptional最大35文字で、特殊文字を含まない、マッチする連絡先の姓を表すプレーンテキスト文字列。例: Smith
companystringoptional最大50文字で、特殊文字を含まない、マッチする連絡先の会社名を表すプレーンテキスト文字列。例: Microsoft Corporation
titlestringoptional最大50文字で、特殊文字を含まない、マッチする連絡先の役職名を表すプレーンテキスト文字列。例: Software Engineer
countrystringoptionalISO標準の2文字の国コード。例: US

company_name

string

optional

アカウントリスト（Companies）に適用されます。この会社の会社名を表す文字列。

入力リクエストは検証され、以下の検証ルールが満たされない場合は失敗します:

  • 入力リクエストは、以下の少なくとも1つを提供する必要があります:
    • company_name
    • organization_urn
    • company_website_domain
    • company_email_domain
    • company_page_url
company_website_domainstringoptional会社のウェブサイトドメイン。
company_email_domainstringoptional会社のメールドメイン（ウェブサイトドメインとは異なる場合があります）。
organization_urnstringoptionalこの特定の会社のLinkedIn会社ページurn、例: urn:li:organizationUrn:123
company_page_urlstringoptionalこの特定の会社のLinkedIn会社ページURL（最大長100文字）、例: linkedin.com/company/microsoft
stock_symbolstringoptionalこの特定の会社の株式シンボル（最大5文字）、例: MSFT
citystringoptionalこの特定の会社の都市（最大50文字）、例: San Francisco
statestringoptionalこの特定の会社の州または県（最大50文字）、例: California または CA
company_countrystringoptionalISO標準化された2文字の国コード、例: US
postal_codestringoptionalこの特定の会社の郵便番号（最大20文字）、例: 94103
industrystringoptional業種名（最大50文字）、例: Technology
industry_twostringoptional
industry_threestringoptional

LinkedInデータを入力するためのクエリ例

Treasure Dataから、以下のクエリを実行し、結果をLinkedIn接続にエクスポートします:

以下のクエリ例は、DMP Segment Modeが追加に指定されている場合、Segment Nameで指定された既存のDMP Segmentにすべてのメールをアップロードします。または、指定された名前で新しいDMP Segmentが作成されてから、ハッシュ化されたメールがアップロードされます。

SELECT
 user_email AS email, google_aid, first_name, last_name
FROM
 my_table;

以下のクエリ例は、DMP Segment Modeが追加に指定されている場合、指定されたDMP SegmentにAccount Listをアップロードします

SELECT
 company_name,
 company_website_domain
FROM
 company_info

エクスポート用のスケジュールジョブの使用（オプション）

スケジュールジョブとResult Exportを使用して、指定した宛先に出力結果を定期的に書き込むことができます。

Audience StudioでSegmentをアクティベートする

Audience Studioでアクティベーションを作成することで、ターゲットプラットフォームにセグメントデータを送信することもできます。

  1. Audience Studioに移動します。
  2. 親セグメントを選択します。
  3. ターゲットセグメントを開き、右クリックして、Create Activationを選択します。
  4. Detailsパネルで、アクティベーション名を入力し、前のセクションの設定パラメータに従ってアクティベーションを設定します。
  5. Output Mappingパネルでアクティベーション出力をカスタマイズします。

  • Attribute Columns
    • Export All Columnsを選択して、変更を加えずにすべての列をエクスポートします。
    • + Add Columnsを選択して、エクスポート用の特定の列を追加します。Output Column Nameは、同じSourceカラム名で事前入力されます。Output Column Nameを更新できます。+ Add Columnsを選択し続けて、アクティベーション出力に新しい列を追加します。
  • String Builder
    • + Add stringを選択して、エクスポート用の文字列を作成します。以下の値から選択します:
      • String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
      • Timestamp: エクスポートの日時。
      • Segment Id: セグメントID番号。
      • Segment Name: セグメント名。
      • Audience Id: 親セグメント番号。
  1. Scheduleを設定します。

  • スケジュールを定義する値を選択し、オプションでメール通知を含めます。
  1. Createを選択します。

（オプション）CLIを使用したエクスポート統合

TD Toolbeltを使用して、結果をWhatsApp Businessにエクスポートすることもできます。WhatsApp Businessにエクスポートする情報を、td queryコマンドの--resultオプションとして指定します（TD Toolbelt Query Commandsを参照）。このオプションはJSONとしてフォーマットされ、一般的な構造は次のとおりです:

    {  "clientId": your client id,  "clientSecret": your client secret,  "refreshToken": your refresh token,  "adAccountId": your adAccount ID,  "audienceType": "contact_list" or "account_list",  "segmentName": your segment name,  "segmentId": null,  "usingSegmentId": false or true,  "segmentDescription": your description,  "mode": "add" or "remove",  "ignoreInvalidRecords": true,  "oauthWarningFlag": null}

関連情報

Previous page
Next page