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

概要 overview

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

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

SAS ベースの認証を使用すると、パブリックインターネット接続を介して Data Landing Zone コンテナに安全にアクセスできます。ユーザーが Data Landing Zone コンテナにアクセスする場合、ネットワークの変更は必要ありません。つまり、ネットワークに対して許可リストの設定や地域間設定は必要ありません。

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

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

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

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

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

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

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

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

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

オーディエンスデータ を書き出す際、Platform は、指定されたストレージの場所に .csv、parquet または .json ファイルを作成します。 ファイルについて詳しくは、Audience Activation チュートリアルの 書き出しでサポートされるファイル形式の節を参照してください。

データセット を書き出す際、Platform は、指定されたストレージの場所に .parquet または .json ファイルを作成します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの データセットの書き出しが成功したことを確認するの節を参照してください。

前提条件 prerequisites

Data Landing Zone の宛先を使用するには、次の前提条件を満たす必要があります。

Data Landing Zone コンテナの Azure 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

Data Landing Zone 資格情報を取得するには、Platform API を使用する必要があります。 資格情報を取得するための 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

必要に応じて、資格情報を更新することもできます。 Connectors API の /credentials エンドポイントにPOSTリクエストを行うことで、SASToken を更新できます。

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 呼び出しで返され Data Landing Zone 表示名（containerName）と SAS URL を入力し、「次へ」を選択します。

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

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

Data Landing Zone コンテナが Azure Storage Explorer に接続され、Experience Platform から Data Landing Zone コンテナへのファイルの書き出しを開始できるようになりました。ファイルを書き出すには、以下の節で説明されているように、Experience PlatformUI で Data Landing Zone の宛先への接続を確立する必要があります。

宛先への接続 connect

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

宛先に対する認証 authenticate

「 前提条件」セクションの説明に従って、Data Landing Zone コンテナが Azure Storage Explorer に接続されていることを確認します。 Data Landing Zone は、Adobeがプロビジョニングしたストレージであるため、宛先への認証のためにExperience PlatformUI でさらに手順を実行する必要はありません。

宛先の詳細を入力 destination-details

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

アラートの有効化 enable-alerts

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

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

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

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

スケジュール設定

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

属性と ID のマッピング map

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

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

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