データランディングゾーンの宛先

Adobe CX Enterprise アプリケーションからData Landing Zone クラウド ストレージの場所にデータ ファイルをエクスポートします。

サポートされているAdobe CX Enterprise アプリケーション supported-applications

この宛先は、次のAdobe CX Enterprise アプリケーションで使用できます。

Data Landing Zone の仕組み overview

Data Landing Zoneは、Adobe Experience Platformによってプロビジョニングされたクラウドストレージインターフェイスです。 Experience Platformから安全なクラウドベースのファイルストレージにファイルを書き出すために使用します。 Experience Platformとそのアプリケーション（Customer Journey Analytics、Journey Orchestration、Intelligent Services、Real-Time Customer Data Platformなど）は、サンドボックスごとに1つのData Landing Zone コンテナをプロビジョニングします。 すべてのコンテナの合計データ量は、Experience Platform製品およびサービス ライセンスで提供される合計データ量に制限されます。

Experience Platformは、7日後にData Landing Zone コンテナ内のすべてのファイルを自動的に削除します。 7日間が経過する前に書き出したファイルを手動で削除することもできます。

Data Landing Zone宛先コネクタは、AzureまたはAmazon Web Services（AWS）で実行中のExperience Platformで使用できます。 認証メカニズムは、宛先がプロビジョニングされるクラウドによって異なります。 宛先とそのユースケースに関する他のすべてが同じです。 2つの認証メカニズムについて詳しくは、「Azure Blobでプロビジョニングされたデータランディングゾーンに対する認証」および「AWSでプロビジョニングされたデータランディングゾーンに対する認証」の節を参照してください。。

クラウド サポートに基づいて、データ ランディング ゾーンの宛先の実装がどのように異なるかを示す {modal="regular"}

APIまたはUIを介して​ データランディングゾーン ​ ストレージに接続します connect-api-or-ui

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

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。 サポートされているオーディエンスは、この宛先に対してアクティブ化するAdobe CX Enterprise アプリケーションによって異なります。

Real-Time CDP supported-audiences-rtcdp

Real-Time CDPからアクティブ化すると、次のオーディエンスがサポートされます。

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

Real-Time CDP Collaboration supported-audiences-collaboration

Real-Time CDP Collaborationでは、Adobe Experience Platformまたはその他のクラウドソースから​ オーディエンス ​を取得できます。 Real-Time CDP Collaborationのオーディエンスは一致キーで構成されています。 これらのオーディエンスは、Collaboration内でデータコラボレーションや有料メディア活動に使用できます。

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

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

データセットの書き出し export-datasets

この宛先では、データセットの書き出しをサポートしています。 データセットの書き出しを設定する方法について詳しくは、チュートリアルを参照してください。

書き出されたデータのファイル形式 file-format

オーディエンスデータ​を書き出すと、Experience Platformは、指定した保存場所に.csv、parquet、または.json個のファイルを作成します。 ファイルについて詳しくは、オーディエンスアクティベーションのチュートリアルの「​ サポートされている書き出し用ファイル形式」セクションを参照してください。

データセット​を書き出すと、Experience Platformは、指定したストレージの場所に.parquetまたは.json個のファイルを作成します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの「成功したデータセットの書き出しを検証する」セクションを参照してください。

Azure Blobでプロビジョニングされたデータランディングゾーンへの認証 authenticate-dlz-azure

Azure Storage Explorer またはコマンドラインインターフェイスを通じて、コンテナに対してファイルの読み取りと書き込みを行うことができます。

Data Landing ZoneはSAS ベースの認証をサポートしています。 標準のAzure Blob ストレージ セキュリティ メカニズムは、保存中および転送中のデータを保護します。 SASは共有アクセス署名を表します。

パブリック インターネット接続でデータを保護するには、SAS ベースの認証を使用してData Landing Zone コンテナに安全にアクセスしてください。 Data Landing Zone コンテナにアクセスするためにネットワークを変更する必要はありません。 つまり、ネットワークに対しての設定や複数の地域の設定を行う必要はありません。

Data Landing Zone コンテナをAzure Storage Explorerに接続します connect-container-to-storage-explorer

Azure Storage Explorerを使用して、Data Landing Zone コンテナの内容を管理します。 Data Landing Zoneの使用を開始するには、まず資格情報を取得してください。 次に、Azure Storage Explorerに入力して、Data Landing Zone コンテナを接続します。

Azure Storage Explorerで、接続ダイアログを開きます。 「リソースを選択」ウィンドウが表示され、接続可能なリソースが一覧表示されます。 Blob container を選択し、Data Landing Zone ストレージに接続します。

次に、接続方法として「共有アクセス署名 URL (SAS)」を選択し、「次へ」をクリックします。

接続方法を選択したら、Data Landing Zone コンテナに対応する​ 表示名 ​と​ Blobコンテナ SAS URL ​を指定します。

Data Landing Zoneの資格情報を取得 retrieve-dlz-credentials

この節で説明しているように、Experience Platform APIを使用してData Landing Zone資格情報を取得します。 ヘッダーに必要な値の取得について詳しくは、Adobe Experience Platform APIの概要 ガイドを参照してください。

API 形式

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

リクエスト

次のリクエストの例では、既存のランディングゾーンの資格情報を取得します。

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

応答

次の応答は、現在のSASTokenとSASUriを含むランディングゾーンの資格情報と、ランディングゾーンコンテナに対応するstorageAccountNameを返します。

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

Data Landing Zone資格情報を更新 update-dlz-credentials

資格情報はいつでも更新できます。 SASTokenを更新するには、Connectors APIの/credentials エンドポイントにPOST リクエストを行います。

API 形式

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

リクエスト

次のリクエストは、ランディングゾーンの資格情報を更新します。

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \

応答

次の応答は、SASTokenとSASUriの更新された値を返します。

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

前述のAPI呼び出しで返される表示名（containerName）とData Landing Zone SAS URLを入力し、次へ​を選択します。

概要​ウィンドウが開き、Blob エンドポイントと権限を含む設定の概要が表示されます。 準備ができたら、「接続」を選択します。

接続が成功すると、Azure Storage Explorer UI と Data Landing Zone コンテナが更新されます。

Data Landing Zone コンテナをAzure Storage Explorerに接続した状態で、Experience PlatformからData Landing Zone コンテナへのファイルの書き出しを開始できます。 ファイルを書き出すには、宛先への接続の説明に従って、Experience Platform UIのData Landing Zone宛先に接続します。

AWSでプロビジョニングされたデータランディングゾーンへの認証 authenticate-dlz-aws

この節の手順に従って、AWSでプロビジョニングされたData Landing Zone インスタンスの資格情報を取得します。 次に、任意のクライアントを使用してData Landing Zone インスタンスに接続します。

Data Landing Zoneの資格情報を取得 retrieve-dlz-credentials-aws

この節で説明しているように、Experience Platform APIを使用してData Landing Zone資格情報を取得します。 ヘッダーに必要な値の取得について詳しくは、Adobe Experience Platform APIの概要 ガイドを参照してください。

API 形式

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

リクエスト

次のリクエストの例では、既存のランディングゾーンの資格情報を取得します。

curl --request GET \
  --url 'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  --header 'Authorization: Bearer ***' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key' \
  --header 'x-gw-ims-org-id: yourorg@AdobeOrg'

応答

次の応答は、現在のawsAccessKeyId、awsSecretAccessKeyおよびその他の情報を含む、ランディングゾーンの資格情報を返します。

{
    "credentials": {
        "awsAccessKeyId": "ABCDW3MEC6HE2T73ZVKP",
        "awsSecretAccessKey": "A1B2Zdxj6y4xfR0QZGtf/phj/hNMAbOGtzM/JNeE",
        "awsSessionToken": "***"
    },
    "dlzPath": {
        "bucketName": "your-bucket-name",
        "dlzFolder": "dlz-destination"
    },
    "dlzProvider": "Amazon S3",
    "expiryTime": 1734494017
}

宛先への接続 connect

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

宛先に対する認証 authenticate

Data Landing ZoneがAzureでプロビジョニングされている場合は、Data Landing Zone コンテナをAzure Storage Explorerに接続の説明に従って、Data Landing Zone コンテナをAzure Storage Explorerに接続していることを確認してください。 Data Landing ZoneはAdobeでプロビジョニングされたストレージであるため、Experience Platform UIでさらに手順を実行して宛先に対する認証を行う必要はありません。

宛先の詳細を入力 destination-details

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

アラートの有効化 enable-alerts

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

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

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

この宛先に対して、Real-Time CDPまたはReal-Time CDP Collaboration プロジェクトからオーディエンスをアクティブ化できます。

Real-Time CDPからオーディエンスをアクティブ化 activate-rtcdp

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

スケジュール設定 scheduling

スケジュール設定​手順では、Data Landing Zone宛先に対して書き出しスケジュール ​を設定でき、書き出したファイルの名前を設定することもできます。

属性と ID のマッピング map

マッピング​手順では、プロファイルに書き出す属性フィールドとID フィールドを選択できます。 また、書き出したファイル内のヘッダーを選択して、任意のわかりやすい名前に変更することもできます。 詳しくは、「バッチの宛先をアクティベート」UI チュートリアルのマッピング手順を参照してください。

Real-Time CDP Collaborationからオーディエンスをアクティブ化 activate-collaboration

Real-Time CDP Collaboration プロジェクトからこの宛先に対してオーディエンスをアクティブ化する方法については、Real-Time CDP Collaboration宛先の概要を参照してください。

データが正常に書き出されたことを検証 exported-data

書き出しが成功したことを確認するには、Data Landing Zone ストレージを確認し、書き出されたファイルに必要なプロファイル母集団が含まれていることを確認します。

書き出したファイルの削除 delete-exported-files

Experience Platformは、7日後にData Landing Zone コンテナから書き出されたファイルを自動的に削除します。 7日間が経過する前に、コンテナから手動でファイルを削除することもできます。 手動による削除は、AzureとAWSの両方でプロビジョニングされたData Landing Zone コンテナで使用できます。