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

概要 overview

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

Experience Platformでは、Data Landing Zone コンテナにアップロードされたすべてのファイルに対して、厳密な7日間の有効期間（TTL）が適用されます。 すべてのファイルは 7 日後に削除されます。

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

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

APIまたはUIを介してData Landing Zone ストレージに接続する connect-api-or-ui

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

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

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

書き出しのタイプと頻度 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に接続する必要があります。

Azure Storage Explorer UI 内で、左側のナビゲーションバーの「接続」アイコンを選択します。リソースを選択​ウィンドウが開き、接続するオプションが表示されます。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資格情報を取得する必要があります。 資格情報を取得するためのAPI呼び出しについて以下に説明します。 ヘッダーに必要な値の取得について詳しくは、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 APIの/credentials エンドポイントにPOST リクエストを行うことで、Connectorsを更新できます。

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資格情報を取得する必要があります。 資格情報を取得するためのAPI呼び出しについて以下に説明します。 ヘッダーに必要な値の取得について詳しくは、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 Storage Explorer セクションの説明に従って、​ コンテナをに接続していることを確認してください。 Data Landing ZoneはAdobeでプロビジョニングされたストレージであるため、Experience Platform UIでさらに手順を実行して宛先に対する認証を行う必要はありません。

宛先の詳細を入力 destination-details

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

アラートの有効化 enable-alerts

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

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

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

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

スケジュール設定 scheduling

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

属性と ID のマッピング map

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

データの正常な書き出しの検証 exported-data

データが正常に書き出されたかどうかを確認するには、Data Landing Zone ストレージを確認し、書き出されたファイルに想定されるプロファイル母集団が含まれていることを確認してください。