LiveRamp - Onboarding 接続 liveramp-onboarding

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

ユースケース use-cases

LiveRamp - Onboarding 宛先を使用する方法とタイミングを理解しやすくするために、Adobe Experience Platform のお客様がこの宛先を使用して解決できるユースケースのサンプルを以下に示します。

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

前提条件 prerequisites

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

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

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

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

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

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

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

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

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

宛先への接続 connect

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

宛先に対する認証 authenticate

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

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

SSH キー認証を使用した SFTP

宛先の詳細の入力 destination-details

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

アラートの有効化 enable-alerts

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

宛先接続の詳細の入力を終えたら「次へ」を選択します。

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

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

スケジュール設定 scheduling

スケジュール設定ステップでは、以下に示す設定で各オーディエンスの書き出しスケジュールを作成します。

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

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

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

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

属性と ID のマッピング map

マッピング ​ステップでは、書き出すプロファイル属性および ID を選択できます。

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

必要なマッピングをすべて追加したら、「次へ」を選択してアクティブ化ワークフローを終了します。

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

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

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

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

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

Platform では、次の 2 つの CSV ファイルを LiveRamp - Onboarding に書き出します。

書き出される 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

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

例えば、書き出された 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 セクションはセグメント化サービスから生成されたオーディエンスを記述しているのに対して、CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e はカスタムアップロードとして Platform に読み込まれたオーディエンスを記述しています。

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

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

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

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

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

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

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

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

その他のリソース additional-resources

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

変更ログ changelog

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