Azure Blob 接続

宛先の変更ログ changelog

2023 年 7 月の Experience Platform リリースでは、 Azure Blob 宛先に次のような新機能が提供されます。

概要 overview

Azure Blob(以下「Blob」)は、Microsoft のクラウド用オブジェクトストレージソリューションです。このチュートリアルでは、Experience Platform ユーザーインターフェイスを使用して Blob 宛先を作成する手順を説明します。

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

はじめに

このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

有効なBlobの宛先がすでにある場合は、このドキュメントの残りをスキップして、「宛先へのオーディエンスの有効化🔗に関するチュートリアルに進んでください。

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

このセクションでは、この宛先にエクスポートできるオーディエンスのタイプについて説明します。

オーディエンスオリジン
サポートあり
説明
Segmentation Service
Audiences Experience Platform セグメント化 サービス によって生成されます。
カスタムアップロード
CSV ファイルから Experience Platform に読み込まれたオーディエンス。

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

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

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

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

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

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

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

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

宛先への接続 connect

IMPORTANT
宛先に接続するには、 View DestinationsManage Destinations アクセス制御 権限が必要です。 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

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

宛先に対する認証 authenticate

宛先に対して認証を行うには、必須フィールドに入力して [ Connect to destination] を選択します。

  • Connection string: 接続文字列は、BLOB ストレージ内のデータにアクセスするために必要です。 Blob 接続文字列のパターンは DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY} で始まります。

  • Encryption key:オプションで、RSA 形式の公開キーを添付して、エクスポートされたファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。

    UI での正しい形式の PGP キーの例を示す画像

宛先の詳細の入力 destination-details

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

  • Name:この宛先を識別するのに役立つ名前を入力します。

  • Description:この宛先の説明を入力します。

  • Folder path:エクスポートされたファイルホスト宛先フォルダーへのパスを入力します。

  • Container:この宛先で使用する Azure Blob Storage コンテナの名前を入力します。

  • File type:Experience Platform書き出すファイルに使用する形式を選択します。 CSVオプションを選択すると、ファイル形式オプションを設定こともできます。

  • Compression format:Experience Platformエクスポートするファイルに使用する圧縮タイプを選択します。

  • Include manifest file: エクスポートの場所、エクスポート サイズなどに関する情報を含むマニフェスト JSON ファイルをエクスポートに含める場合は、このオプションをオンに切り替えます。 マニフェストには 形式 manifest-<<destinationId>>-<<dataflowRunId>>.jsonを使用して名前が付けられます。 サンプルマニフェストファイル表示。マニフェストファイルには、次のフィールドが含まれています。

    • flowRunId:書き出されたファイルを生成した ​ データフロー実行 ​
    • scheduledTime: ファイルが書き出された時間(UTC 単位)。
    • exportResults.sinkPath:書き出されたファイルが格納されるストレージの場所のパス。
    • exportResults.name:エクスポートするファイルの名前。
    • size:エクスポートするファイルのサイズ(バイト単位)。

アラートの有効化 enable-alerts

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

宛先接続の詳細の指定が完了したら、 [ Next] を選択します。

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

IMPORTANT

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

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

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

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6