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を通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス,
- 連合オーディエンス,
- Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
- その他。
オーディエンスのデータタイプ別にサポートされるオーディエンス:
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
宛先に対する認証 authenticate
宛先に対して認証を行うには、必須フィールドに入力し、Connect to destinationを選択します。
パスワードを使用したSFTP認証
-
Port: LiveRamp - Onboarding ストレージの場所に使用されているポート。 次の説明に従って、地理的な場所に対応するポートを使用します。
- NA: ポート
22を使用 - AU: ポート
2222を使用
- NA: ポート
-
Username: LiveRamp - Onboarding ストレージの場所のユーザー名。
-
Password: LiveRamp - Onboarding ストレージの場所のパスワード。
-
PGP/GPG encryption key: オプションで、RSA形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
-
Subkey ID:If暗号化キーを指定する場合は、暗号化 Subkey ID も指定する必要があります。 サブキー ID の取得方法については、LiveRamp 暗号化ドキュメントを参照してください。
SSH キー認証を使用したSFTP
-
Port: LiveRamp - Onboarding ストレージの場所に使用されているポート。 次の説明に従って、地理的な場所に対応するポートを使用します。
- EU: ポート
4222を使用
- EU: ポート
-
Username: LiveRamp - Onboarding ストレージの場所のユーザー名。
-
SSH Key: SSH ストレージの場所へのログインに使用される秘密LiveRamp - Onboarding キー。 この秘密鍵は、Base64 でエンコードされた文字列の形式にする必要があり、パスワードで保護しないでください。
- SSH キーを LiveRamp - Onboarding サーバーに接続するには、LiveRamp のテクニカルサポートポータルを通じてチケットを送信し、公開鍵を入力する必要があります。詳しくは、LiveRamp ドキュメントを参照してください。
-
PGP/GPG encryption key: オプションで、RSA形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
-
Subkey ID:If暗号化キーを指定する場合は、暗号化 Subkey ID も指定する必要があります。 サブキー ID の取得方法については、LiveRamp 暗号化ドキュメントを参照してください。
宛先の詳細の入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。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
この宛先に対してオーディエンスをアクティブ化する手順については、バッチプロファイル書き出し宛先に対するオーディエンスデータのアクティブ化を参照してください。
スケジュール設定 scheduling
Scheduling ステップで、各オーディエンスの書き出しスケジュールを作成し、次の設定を行います。
- File export options: Export full files。 増分ファイル書き出しは現在、LiveRamp 宛先ではサポートされていません。
- Frequency: Daily、WeeklyまたはMonthly
- Date:必要に応じて、書き出しの開始時間と終了時間を選択します。
オーディエンスのスケジュール設定ステップを示す
書き出すファイルの名前は現在、ユーザーが設定することはできません。LiveRamp - Onboarding 宛先に書き出すすべてのファイルは、次のテンプレートに基づいて自動的に名前が付けられます。
%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%
書き出されたファイル名テンプレートを示す
例えば、Luma という名前の組織の場合、書き出すファイルの名前は次のようになります。
Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv
属性と ID のマッピング map
Mapping ステップで、プロファイルに書き出す属性とIDを選択できます。
Email や Phone など、複数の ID 名前空間を書き出す必要がある場合は、ID ごとに個別のアクティブ化フローを作成する必要があります。Mapping ステップでは、Target field マッピングによって、書き出されたCSV ファイルの列ヘッダーの名前が定義されます。 Target fieldのカスタム名を指定することで、書き出したファイルのCSV列ヘッダーを任意のわかりやすい名前に変更できます。
-
Mapping ステップで、Add new mappingを選択します。 画面に新しいマッピング行が表示されます。
-
Select source field ウィンドウで、Select attributes カテゴリを選択し、マッピングするXDM属性を選択するか、Select identity namespace カテゴリを選択して、宛先にマッピングするIDを選択します。
-
Select target field ウィンドウで、選択したソースフィールドをマッピングする属性名を入力します。 ここで定義した属性名が、書き出された CSV ファイルに列ヘッダーとして反映されます。
Target fieldに直接入力して、属性名を入力することもできます。
必要なすべてのマッピングを追加したら、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-59f65b6442dfとups_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 ページのおよび指標は、各オーディエンスに対して表示されるのではなく、同じ結合ポリシーを使用するオーディエンスグループごとに集計されます。
同じ結合ポリシーを使用するオーディエンスのグループに対してデータフロー実行が生成されるので、オーディエンス名はモニタリングダッシュボードに表示されません。
書き出されたデータの 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月 | 機能とドキュメントの更新 |
|
| 2023年7月 | 初回リリース | 宛先の初回リリースとドキュメントを公開しました。 |