Azure Blob 接続

宛先の変更ログ changelog

2023 年 7 月のExperience Platformリリースに伴い、 Azure Blob の宛先には、次に示す新しい機能が用意されています。

概要 overview

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

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

はじめに

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

既に有効な Blob の宛先については、このドキュメントの残りの部分をスキップし、次のチュートリアルに進んでください。 宛先へのオーディエンスのアクティブ化.

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

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

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

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

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

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

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

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

エクスポートするデータのファイル形式 file-format

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

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

宛先への接続 connect

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

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

宛先に対する認証 authenticate

宛先を認証するには、必須フィールドに入力し、「宛先に接続」を選択します。

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

  • 暗号化キー:必要に応じて、RSA 形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。正しい形式の暗号化キーの例については、以下の画像を参照してください。

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

宛先の詳細の入力 destination-details

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

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

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

  • フォルダーパス:書き出したファイルをホストする宛先フォルダーへのパス。

  • コンテナ: Azure Blob Storage この宛先で使用するコンテナ。

  • ファイルタイプ:書き出したファイルに使用する形式Experience Platformを選択します。 選択時に、 CSV オプションを選択する場合は、 ファイル形式設定オプションの設定.

  • 圧縮形式:書き出したファイルにExperience Platformが使用する圧縮タイプを選択します。

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

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

アラートの有効化 enable-alerts

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

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

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

IMPORTANT
  • データをアクティブ化するには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントを表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

  • 書き出す idID グラフを表示 アクセス制御権限.

    img-md
    w-100 modal-image
    ワークフローでハイライト表示された ID 名前空間を選択して、宛先に対するオーディエンスをアクティブ化します。

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

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

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

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