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

最終更新日: 2024-01-22
  • トピック:
  • Destinations
    このトピックの詳細を表示
  • 作成対象:
  • Developer
    User
    Admin
    Leader
重要

このドキュメントページでは、 Data Landing Zone 宛先. また、 Data Landing Zone ソース ソースカタログ内。 詳しくは、 Data Landing Zone ソース ドキュメント。

概要

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

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

次に接続: データランディングゾーン API または UI を介したストレージ

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

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

オーディエンスの起源 サポートあり 説明
Segmentation Service Experience Platform セグメント化サービス.
カスタムアップロード CSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度

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

項目 タイプ メモ
書き出しタイプ プロファイルベース 宛先のアクティベーションワークフローのプロファイル属性の選択画面で選択したように、該当するスキーマフィールド(例:PPID)と共に、セグメントのすべてのメンバーを書き出しています。
書き出し頻度 バッチ バッチ宛先では、ファイルが 3 時間、6 時間、8 時間、12 時間、24 時間の単位でダウンストリームプラットフォームに書き出されます。 詳しくは、バッチ(ファイルベース)宛先を参照してください。

前提条件

を使用する前に満たす必要がある前提条件は、次のとおりです。 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 ストレージに接続します。

Azure UI で強調表示されているリソースを選択します。

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

Azure UI で強調表示されている接続方法を選択します。

接続方法を選択した後、表示名​およびお使いの Data Landing Zone コンテナに対応する​Blobコンテナ SAS URL を入力します。

の資格情報を取得します。 Data Landing Zone

Platform API を使用して、 Data Landing Zone 認証情報。 資格情報を取得するための API 呼び出しを以下に示します。 ヘッダーに必要な値の取得について詳しくは、 Adobe Experience Platform API の概要 ガイド。

API 形式

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination
クエリパラメーター 説明
dlz_destination The dlz_destination タイプを使用すると、API はランディングゾーンの宛先コンテナを、使用可能な他のタイプのコンテナと区別できます。

リクエスト

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

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-user-container",
    "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-user-container?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}
プロパティ 説明
containerName ランディングゾーンの名前。
SASToken ランディングゾーンの共有アクセス署名トークン。 この文字列には、リクエストを承認するために必要なすべての情報が含まれます。
SASUri ランディングゾーンの共有アクセス署名 URI です。 この文字列は、認証先のランディングゾーンへの URI と、対応する SAS トークンの組み合わせです。

更新 Data Landing Zone 資格情報

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

API 形式

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh
クエリパラメーター 説明
dlz_destination The dlz_destination タイプを使用すると、API はランディングゾーンの宛先コンテナを、使用可能な他のタイプのコンテナと区別できます。
refresh The refresh 「 」アクションを使用すると、ランディングゾーンの資格情報をリセットし、新しい SASToken.

リクエスト

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

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-user-container",
    "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-user-container?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

表示名 (containerName) および Data Landing Zone 上記の API 呼び出しで返される SAS URL で、を選択します。 次へ.

Azure UI でハイライト表示されている接続情報を入力します。

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

Azure UI に表示される設定の概要です。

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

Azure UI で強調表示された DLZ ユーザーコンテナの概要。

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

宛先への接続

重要

宛先に接続するには、 宛先の表示 および 宛先の管理 アクセス制御権限. 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

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

宛先に対する認証

次のページとの連携を確認します: Data Landing Zone コンテナ Azure Storage Explorer 例えば、 前提条件 」セクションに入力します。 理由: Data Landing Zone は、Adobeがプロビジョニングしたストレージです。Experience PlatformUI で追加の手順を実行して、宛先への認証をおこなう必要はありません。

宛先の詳細を入力

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

  • 名前:この宛先に希望する名前を入力します。
  • 説明:オプション。例えば、この宛先を使用しているキャンペーンを指定できます。
  • フォルダーパス:書き出したファイルをホストする宛先フォルダーへのパス。
  • ファイルタイプ:書き出したファイルに使用する形式Experience Platformを選択します。 選択時に、 CSV オプションを選択する場合は、 ファイル形式設定オプションの設定.
  • 圧縮形式:書き出したファイルにExperience Platformが使用する圧縮タイプを選択します。
  • マニフェストファイルを含める:書き出しの場所や書き出しサイズなどに関する情報を含むマニフェスト JSON ファイルを書き出しに含める場合は、このオプションをオンに切り替えます。 マニフェストの名前は、形式を使用して付けられます manifest-<<destinationId>>-<<dataflowRunId>>.json. を表示します。 サンプルマニフェストファイル. マニフェストファイルには、次のフィールドが含まれます。
    • flowRunId: データフローの実行 書き出されたファイルを生成した
    • scheduledTime:ファイルが書き出されたときの UTC 時刻 (UTC)。
    • exportResults.sinkPath:書き出されたファイルが格納されるストレージの場所のパス。
    • exportResults.name:書き出されたファイルの名前。
    • size:書き出されるファイルのサイズ(バイト単位)。

アラートの有効化

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

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

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

重要
  • データをアクティブ化するには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントを表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • 書き出す idID グラフを表示 アクセス制御権限.
    ワークフローでハイライト表示された ID 名前空間を選択して、宛先に対するオーディエンスをアクティブ化します。

詳しくは、 プロファイルの一括書き出し先に対するオーディエンスデータのアクティブ化 を参照してください。

スケジュール設定

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

属性と ID のマッピング

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

データセットを書き出し

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

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

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

このページ