LiveRamp - Onboarding 接続 liveramp-onboarding

LiveRamp - Onboarding接続を使用して、Adobe Real-Time Customer Data PlatformからLiveRamp Connectまでのオーディエンスをオンボーディングします。

ユースケース use-cases

LiveRamp - Onboarding宛先を使用する方法とタイミングをより理解しやすくするために、Adobe Experience Platformのお客様がこの宛先を使用して解決できる使用例を次に示します。

マーケターとして、Adobe Experience PlatformからLiveRamp Connectにオーディエンスを送信して、IDをオンボードし、CTV識別子を使用して、モバイル、オープン web、ソーシャル、およびRamp ID プラットフォームでユーザーをターゲットにできるようにしたいと考えています。

前提条件 prerequisites

LiveRamp - Onboarding 接続では、LiveRamp の SFTP ストレージを使用してファイルを書き出します。

Experience Platform から LiveRamp - Onboarding にデータを送信するには、まず LiveRamp 資格情報が必要です。資格情報がまだない場合は、LiveRamp の担当者に連絡して資格情報を取得してください。

サポートされている ID supported-identities

LiveRamp - Onboarding では、公式の LiveRamp ドキュメントに記載されている、PII ベースの識別子、既知の識別子、カスタム ID などの ID のアクティブ化をサポートしています。

アクティブ化ワークフローのマッピングステップでは、ターゲットマッピングをカスタム属性として定義する必要があります。

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスの由来
サポートあり
説明
Segmentation Service
Experience Platform ​ セグメント化サービス ​を通じて生成されたオーディエンス。
その他すべてのオーディエンスの生成元

このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。

  • カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
  • 類似オーディエンス,
  • 連合オーディエンス,
  • Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
  • その他。

オーディエンスのデータタイプ別にサポートされるオーディエンス:

オーディエンスのデータタイプ
サポートあり
説明
ユースケース
人物オーディエンス ​
顧客プロファイルにもとづいて、マーケティング施策の特定のグループをターゲットにすることができます。
買い物客やカートの放棄が多い
​ アカウントオーディエンス ​
×
アカウントベースドマーケティング戦略のために、特定の組織内の個人をターゲットにします。
B2B マーケティング
見込みオーディエンス ​
×
まだ顧客ではないが、ターゲットオーディエンスと特徴を共有する個人をターゲットにします。
サードパーティデータによる見込み顧客の開拓
​ データセットの書き出し
×
Adobe Experience Platform データ レイクに保存されている構造化データのコレクション。
レポート,データサイエンスワークフロー

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
Audience export
LiveRamp - Onboarding 宛先で使用される識別子(氏名、電話番号など)を使用して、オーディエンスのすべてのメンバーを書き出します。
書き出し頻度
Batch
オーディエンスの評価に基づいてExperience Platformでプロファイルが更新されると、プロファイル(ID)が更新され、毎日、毎週、または毎月配信先のプラットフォームにダウンストリームで配信されます。 詳しくは、バッチ(ファイルベース)宛先を参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、View Destinations​および​Manage Destinations ​ アクセス制御権限が必要です。 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

宛先に対する認証 authenticate

宛先に対して認証を行うには、必須フィールドに入力し、Connect to destination​を選択します。

パスワードを使用したSFTP認証

パスワードによる SFTP を使用して宛先に対する認証を行う方法を示すサンプルスクリーンショット

  • Port: LiveRamp - Onboarding ストレージの場所に使用されているポート。 次の説明に従って、地理的な場所に対応するポートを使用します。

    • NA: ポート 22を使用
    • AU: ポート 2222を使用
  • Username: LiveRamp - Onboarding ストレージの場所のユーザー名。

  • Password: LiveRamp - Onboarding ストレージの場所のパスワード。

  • PGP/GPG encryption key: オプションで、RSA形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
    UI での正しい形式の PGP キーの例を示す画像

  • Subkey ID:If暗号化キーを指定する場合は、暗号化​ Subkey ID ​も指定する必要があります。 サブキー ID の取得方法については、LiveRamp 暗号化ドキュメントを参照してください。

SSH キー認証を使用したSFTP

SSH キーを使用して宛先に対する認証を行う方法を示すサンプルスクリーンショット

  • Port: LiveRamp - Onboarding ストレージの場所に使用されているポート。 次の説明に従って、地理的な場所に対応するポートを使用します。

    • EU: ポート 4222を使用
  • Username: LiveRamp - Onboarding ストレージの場所のユーザー名。

  • SSH Key: SSH ストレージの場所へのログインに使用される秘密LiveRamp - Onboarding キー。 この秘密鍵は、Base64 でエンコードされた文字列の形式にする必要があり、パスワードで保護しないでください。

    • SSH キーを LiveRamp - Onboarding サーバーに接続するには、LiveRamp のテクニカルサポートポータルを通じてチケットを送信し、公開鍵を入力する必要があります。詳しくは、LiveRamp ドキュメントを参照してください。
  • PGP/GPG encryption key: オプションで、RSA形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
    UI での正しい形式の PGP キーの例を示す画像

  • Subkey ID:If暗号化キーを指定する場合は、暗号化​ Subkey ID ​も指定する必要があります。 サブキー ID の取得方法については、LiveRamp 暗号化ドキュメントを参照してください。

宛先の詳細の入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。

宛先の詳細を入力する方法を示す Experience Platform UIのスクリーンショット

  • Name:今後この宛先を認識する際に使用する名前。
  • Description:今後この宛先を特定するのに役立つ説明です。
  • Region: LiveRamp SFTP ストレージのインスタンスの地理的地域。
  • Folder path:書き出されたファイルをホストするLiveRamp uploads サブフォルダーへのパス。 uploads 接頭辞がフォルダーパスに自動的に追加されます。LiveRampでは、ファイルを他の既存のフィードから分離し、すべての自動処理がスムーズに実行されるように、Adobe Real-Time CDPからの配信用に専用のサブフォルダーを作成することをお勧めします。
    • 例えば、ファイルをuploads/my_export_folderに書き出す場合は、my_export_folder フィールドに​ Folder path ​と入力します。
  • Compression format:書き出したファイルにExperience Platformで使用する圧縮タイプを選択します。 利用できるオプションは​ GZIP ​または​ None ​です。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読に関するガイドを参照してください。

宛先接続の詳細の提供が完了したら、Next​を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
データをアクティブ化するには、View DestinationsActivate DestinationsView Profiles​および​View Segments ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

この宛先に対してオーディエンスをアクティブ化する手順については、バッチプロファイル書き出し宛先に対するオーディエンスデータのアクティブ化を参照してください。

スケジュール設定 scheduling

Scheduling ステップで、各オーディエンスの書き出しスケジュールを作成し、次の設定を行います。

  • File export options: Export full files。 増分ファイル書き出しは現在、LiveRamp 宛先ではサポートされていません。
  • Frequency: Daily、WeeklyまたはMonthly
  • Date:必要に応じて、書き出しの開始時間と終了時間を選択します。

オーディエンスのスケジュール設定ステップを示す Experience Platform UIのスクリーンショット。

書き出すファイルの名前は現在、ユーザーが設定することはできません。LiveRamp - Onboarding 宛先に書き出すすべてのファイルは、次のテンプレートに基づいて自動的に名前が付けられます。

%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%

書き出されたファイル名テンプレートを示す Experience Platform UIのスクリーンショット。

例えば、Luma という名前の組織の場合、書き出すファイルの名前は次のようになります。

Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv

属性と ID のマッピング map

Mapping ステップで、プロファイルに書き出す属性とIDを選択できます。

IMPORTANT
この宛先では、アクティブ化フローごとに 1 つのソース ID 名前空間のアクティブ化をサポートしています。EmailPhone など、複数の ID 名前空間を書き出す必要がある場合は、ID ごとに個別のアクティブ化フローを作成する必要があります。

Mapping ステップでは、Target field マッピングによって、書き出されたCSV ファイルの列ヘッダーの名前が定義されます。 Target field​のカスタム名を指定することで、書き出したファイルのCSV列ヘッダーを任意のわかりやすい名前に変更できます。

IMPORTANT
LiveRamp への初回のファイル配信後にターゲットフィールドに変更が加えられた場合は、LiveRamp アカウントチームに通知するか、LiveRamp サポートにチケットを送信して、変更が自動処理プロセスに確実に反映されるようにしてください。
  1. Mapping ステップで、Add new mapping​を選択します。 画面に新しいマッピング行が表示されます。

    マッピング画面を示す Experience Platform UI のスクリーンショット。

  2. Select source field ウィンドウで、Select attributes カテゴリを選択し、マッピングするXDM属性を選択するか、Select identity namespace カテゴリを選択して、宛先にマッピングするIDを選択します。

    ソースマッピング画面を示す Experience Platform UI のスクリーンショット。

  3. Select target field ウィンドウで、選択したソースフィールドをマッピングする属性名を入力します。 ここで定義した属性名が、書き出された CSV ファイルに列ヘッダーとして反映されます。

    ターゲットマッピング画面を示す Experience Platform UI のスクリーンショット。

    Target field​に直接入力して、属性名を入力することもできます。

    ターゲットマッピング画面を示す Experience Platform UI のスクリーンショット。

必要なすべてのマッピングを追加したら、Next​を選択してアクティベーション ワークフローを終了します。

書き出されたデータ/データ書き出しの検証 exported-data

データは、設定した LiveRamp - Onboarding ストレージの場所に CSV ファイルとして書き出されます。

書き出されたファイルの最大サイズは1,000万行です。 選択したオーディエンスが1,000万行を超える場合、Experience Platformは配信ごとに複数のファイルを生成します。 1つのファイル制限を超える場合は、LiveRamp担当者に連絡し、バッチ取り込みの設定を依頼してください。

ファイルをLiveRamp - Onboarding宛先に書き出す場合、Experience Platformは、各結合ポリシーIDに対して1つのCSV ファイルを生成します。

例えば、次のオーディエンスについて考えてみます。

  • オーディエンス A(結合ポリシー 1)
  • オーディエンス B(結合ポリシー 2)
  • オーディエンス C(結合ポリシー 1)
  • オーディエンス D(結合ポリシー 1)

Experience Platformは2つのCSV ファイルをLiveRamp - Onboardingに書き出します:

  • オーディエンス A、C および D を含んだ 1 つの CSV ファイル。
  • オーディエンス B を含んだ 1 つの CSV ファイル。

書き出される CSV ファイルには、次の例に示すように、選択した属性とそれに対応するオーディエンスステータスを持つプロファイルが別々の列に含まれ、属性名と audience_namespace:audience_ID ペアが列ヘッダーとして含まれます。

ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X

書き出されたファイルに含まれているプロファイルは、次のオーディエンス選定ステータスのいずれかと一致する可能性があります。

  • Active:プロファイルは現在、オーディエンスに対して選定されています。
  • Expired:プロファイルはオーディエンスに対して選定されなくなりましたが、過去に選定されたことがあります。
  • ""(空の文字列):プロファイルはオーディエンスに対して選定されたことはありません。

例えば、書き出された CSV ファイルに、1 つの email 属性、Experience Platform セグメント化サービスから生成された 2 つのオーディエンスおよび読み込まれた 1 つの外部オーディエンスが含まれている場合は、次のようになります。

email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,

上記の例では、ups_aa2e3d98-974b-4f8b-9507-59f65b6442dfups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7fのセクションはSegmentation Serviceからのオーディエンスを表し、CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e​ カスタムアップロード ​としてExperience Platformにインポートされたオーディエンスを表します。

Experience Platformでは、各結合ポリシーIDに対して1つのCSV ファイルが生成されるので、結合ポリシーIDごとに個別のデータフロー実行も生成されます。

つまり、Identities activated データフロー実行​Profiles received ページのおよび指標は、各オーディエンスに対して表示されるのではなく、同じ結合ポリシーを使用するオーディエンスグループごとに集計されます。

同じ結合ポリシーを使用するオーディエンスのグループに対してデータフロー実行が生成されるので、オーディエンス名はモニタリングダッシュボードに表示されません。

「アクティブ化された ID」指標を示す Experience Platform UI のスクリーンショット。

書き出されたデータの LiveRamp へのアップロード upload-to-liveramp

データが LiveRamp - Onboarding ストレージに正常に書き出されたら、LiveRamp プラットフォームにデータをアップロードする必要があります。

ファイルを LiveRamp - Onboarding ストレージから LiveRamp オーディエンスにアップロードする方法について詳しくは、最初のファイルをオーディエンスにアップロードする際の考慮事項のドキュメントを参照してください。

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのように データガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

その他のリソース additional-resources

LiveRamp - Onboarding ストレージの設定方法について詳しくは、公式ドキュメントを参照してください。

変更ログ changelog

この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。

変更ログを表示
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto
リリース月 更新タイプ 説明
2025年2月 機能とドキュメントの更新
  • 週単位および月単位の配信頻度のサポートを追加しました。
2024年3月 機能とドキュメントの更新
  • ヨーロッパおよびオーストラリア LiveRamp SFTP インスタンスへの配信のサポートを追加しました。
  • 新しくサポートされる地域の特定の設定を説明するドキュメントを更新しました。
  • 最大ファイルサイズを1,000万行に増加(以前は500万行だった)。
  • ファイルサイズの増加を反映してドキュメントを更新しました。
2023年7月 初回リリース 宛先の初回リリースとドキュメントを公開しました。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6