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をオンボードし、Ramp ID識別子を使用して、モバイル、オープン web、ソーシャル、およびCTV プラットフォームでユーザーをターゲットにできるようにしたいと考えています。

前提条件 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

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

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

宛先への接続 connect

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

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

宛先に対する認証 authenticate

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

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

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

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

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

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

  • PGP/GPG暗号化キー: オプションで、RSA形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。正しくフォーマットされた暗号化キーの例を次の画像に表示します。
    UI での正しい形式の PGP キーの例を示す画像

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

SSH キー認証を使用したSFTP

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

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

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

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

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

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

宛先の詳細を入力 destination-details

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

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

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

アラートの有効化 enable-alerts

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

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

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

IMPORTANT
データをアクティブ化するには、宛先の表示宛先のアクティブ化プロファイルの表示​および​セグメントの表示 ​ アクセス制御の権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

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

スケジュール設定 scheduling

​ スケジュール設定手順で、各オーディエンスの書き出しスケジュールを作成し、次に示す設定を行います。

  • ファイル書き出しオプション: 完全なファイルを書き出し。 増分ファイル書き出しは現在、LiveRamp 宛先ではサポートされていません。
  • 頻度: 一度、毎日、毎週、または毎月
  • 日付:必要に応じて、書き出しの開始時間と終了時間を選択します。

オーディエンスのスケジュール設定ステップを示す 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

マッピング​手順では、プロファイルに書き出す属性とIDを選択できます。

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

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

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

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

  2. ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して、マッピングするXDM属性を選択するか、ID名前空間を選択 カテゴリを選択して、宛先にマッピングするIDを選択します。

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

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

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

    属性名は、ターゲットフィールド​に直接入力して入力することもできます。

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

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

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

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

書き出されたファイルの最大サイズは1億行です。 選択したオーディエンスが1億行を超える場合、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ごとに個別のデータフロー実行も生成されます。

つまり、​ データフロー実行 ページで受信した​アクティブ化された IDと​ プロファイルの受信 ​指標は、各オーディエンスに対して表示されるのではなく、同じ結合ポリシーを使用するオーディエンスグループごとに集計されます。

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

「アクティブ化された 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 4-row-3 layout-auto
リリース月 更新タイプ 説明
2026年7月 機能とドキュメントの更新
  • 1回限りの配信ケイデンスのサポートを追加しました。
  • 最大ファイルサイズを1億行に増加(以前は1,000万行でした)。
2025年2月 機能とドキュメントの更新
  • 週単位および月単位の配信頻度のサポートを追加しました。
2024年3月 機能とドキュメントの更新
  • ヨーロッパおよびオーストラリア LiveRamp SFTP インスタンスへの配信のサポートを追加しました。
  • 新しくサポートされる地域の特定の設定を説明するドキュメントを更新しました。
  • 最大ファイルサイズを1,000万行に増加(以前は500万行だった)。
  • ファイルサイズの増加を反映してドキュメントを更新しました。
2023年7月 初回リリース 宛先の初回リリースとドキュメントを公開しました。
recommendation-more-help
experience-platform-help-destinations