[限定提供]{class="badge informative"}

Azure ストレージのSource オーディエンス

Azure Blob StorageまたはAzure Data Lake Storage （ADLS） Gen2をAdobe Real-Time CDP Collaborationに接続して、1st パーティオーディエンスデータを取得し、アクティベーションと重複分析を行います。

このガイドを使用して、再利用可能なAzure データ接続を作成し、設定されたストレージの場所から1回限りのインポートを実行します。 開始する前に、オーディエンスファイルが​ オーディエンスソーシング仕様を満たしていることを確認してください。 設定プロセス中に、AdobeにAzure ストレージへの読み取りアクセス権を付与します。

Azure ソースの種類を選択 choose-source-type

Collaborationでは、2つのAzure取り込みオプションをサポートしています。 次の表を使用して、オーディエンスファイルの保存場所に一致するガイドパスを選択します。

データ接続ごとに​1つのソースタイプのみを設定できます。 BlobとADLSの両方からソースを取得するには、個別のデータ接続を作成します。

前提条件 prerequisites

このガイドに従う前に、​ アカウントのオンボーディングと設定を完了してください。 次に、設定ワークフローを開始する前に、この節の前提条件を完了します。

一部の手順では、Azure管理者​による操作が必要です。 組織のAzure管理者でない場合は、開始する前に適切なユーザーを特定してください。

Azureのアクセスと権限 azure-access-and-permissions

Collaborationで接続を設定する前に、ユーザーまたはAzure管理者が、オーディエンスファイルを含むストレージコンテナまたはADLS Gen2 ファイルシステムへのAdobe読み取りアクセス権を付与する必要があります。 権限の設定が完了すると、Collaboration設定ワークフローは​ 同意 ​手順でアクセスを検証します。

オーディエンスデータの準備 prepare-audience-data

オーディエンスファイルは、ソーシングを開始する前に、オーディエンスソーシング仕様（v1.2）​に準拠している必要があります。

主な要件は次の通りです。

オーディエンスファイルに存在するすべての照合キーも、Collaboration アカウントで有効にする必要があります。 ガイダンスについては、照合キーの設定を参照してください。

開始する前に必要な値 values-required

設定ワークフローを開始する前に、次の値を準備しておきます。

Azure権限の設定 set-up-azure-permissions

このセクションの手順を完了して、Azure環境を準備します。 Adobeでは、Collaboration設定ワークフローで接続を確立する前に、ストレージコンテナへの読み取りアクセスが必要です。 この作業はAzure ポータルで実行され、Azure管理者が完了する必要がある場合があります。

このセクションを完了したら、接続の設定 Azure に進みます。

AdobeのAzure サービス プリンシパル IDの取得 obtain-principal-identifier

次の手順でロールの割り当て手順を完了する前に、Adobeのアカウントチームに連絡して、お住まいの地域（北米、EMEA、オーストラリア、ニュージーランド）のAzure サービスプリンシパル IDを取得してください。 このIDを使用して、Adobeにストレージへの読み取りアクセス権を付与します。

Azure Blob Storage権限の設定 set-up-azure-blob-storage-permissions

ADLS Gen2権限の設定 set-up-adls-gen2-permissions

ADLS Gen2接続の場合、Collaborationの​Container フィールドは、AzureのADLS Gen2 ファイルシステムに対応します。 オーディエンスファイルを含むファイルシステムを使用します。

権限を割り当てる前に、ストレージアカウントに​階層名前空間が有効になっており、ファイアウォールまたはプライベートエンドポイントルールでAdobeへのアクセスが許可されていることを確認してください。

ソースタイプの権限の設定が完了したら、接続の設定 Azure に進みます。

Azure接続の設定 configure-your-azure-connection

Collaboration設定ワークフローを使用して、Azure ストレージの詳細を検証し、Adobe アクセスを確認し、自動マッピングされたID フィールドを確認して、データ接続を作成します。

新しいデータ接続を追加 add-new-data-connection

セットアップ > マイ オーディエンス​に移動し、追加アイコン（ ）を選択します。 Audience​を選択します。

{modal="regular"}

「オーディエンスを追加」ワークフローが表示されます。 「新しいデータ接続を追加」を選択し、「次へ」を選択します。

{modal="regular"}

Azure データソースを選択 select-azure-data-source

Azure Blob Storage​または​ Azure Data Lake Storage Gen2 ​を選択し、次へ​を選択します。

{modal="regular"}。

残りの手順を続行して、Azure接続を検証し、Adobeへのアクセスを確認し、フィールドマッピングを確認して、データ接続を作成します。

接続資格情報を入力 enter-connection-credentials

資格情報​手順で、Azureのストレージの場所にアクセスするために必要な情報を入力します。

必要な値を入力したら、Azureに接続​を選択します。

接続が正常に確立されたことを示す確認メッセージが表示されます。 「次へ」をクリックして続行します。

{modal="regular"}

AdobeにAzure ストレージへのアクセス権を付与する grant-adobe-access

同意 ステップで、Collaborationは以前に設定したAzure権限を検証します。

同意URL​の横にある起動アイコンを選択して、Azureで認証ワークフローを開きます。 ストレージの場所に対する同意を付与する権限を持つアカウントでログインし、設定されたストレージの場所へのAdobe アクセスを付与するAzure認証プロンプトを実行します。 認証が完了したら、Collaborationに戻り、同意を確認​を選択してAdobeのアクセス権を検証します。

同意検証が成功すると、同意付与​確認メッセージが表示されます。 「次へ」をクリックして続行します。

{modal="regular"}

フィールドマッピングの確認 review-field-mappings

フィールドマッピング​手順では、CollaborationはサポートされているID フィールドをソースファイルから自動的にマッピングします。

手作業による設定は必要ありません。

表示されたマッピングを確認し、ソースフィールドがオーディエンスファイルのID列と一致することを確認します。 「次へ」をクリックして続行します。

{modal="regular"}

接続を確認して完了 review-and-complete

レビュー​手順で、ストレージアカウント、コンテナ、ソースパス、テナント ID、フィールドマッピングを確認します。

レビューページには、現在のAzure ワークフローが1回のソーシング実行を実行し、定期的なスケジュールを設定していないことも示されています。

設定が正しい場合は、完了​を選択します。

{modal="regular"}

接続を確認し、ソースとなるオーディエンスを監視する confirm-connection-and-monitor-audiences

Complete​を選択すると、Collaborationはデータ接続を作成し、Setup > My data connections​に移動します。

接続が作成されたことを確認します confirm-connection-created

データ接続​の接続カードは、接続が正常に作成されたことを確認します。 ソースの種類（Azure Blob Storage​または​Azure Data Lake Storage Gen2）、作成日、一致するキー、オーディエンスサイズ、現在の接続ステータスが表示されます。

{modal="regular"}

ソース別オーディエンスの表示 view-sourced-audiences

接続が作成されると、Collaborationは、設定されたAzure場所からオーディエンスのソーシングを自動的に開始します。 設定 / マイオーディエンス​に移動して、ソーシングの進行状況を監視し、ソーシングされたオーディエンスを確認します。

ソースされたオーディエンスは、マイ オーディエンス テーブルに表示されます。 オーディエンスのステータス、ID数、ソース、データ接続、最終更新日を使用して、想定されるオーディエンスがAzure接続からソースされていることを確認します。

既知の制限事項 known-limitations

Azure データ接続を作成または管理する前に、次の制限事項を確認してください。

トラブルシューティング troubleshooting

オーディエンスが表示されない、またはソーシングが遅い audiences-not-appearing

接続を作成した後にソースされたオーディエンスが表示されない場合は、次の操作を実行します。

オーディエンスソース。ただし、ゼロまたは予期しないIDが表示される zero-identities

オーディエンスがソーシング後に表示されますが、ID数がゼロまたは予想よりも少ない場合は、次のアクションを実行します。

初回成功後に接続に失敗しました connection-failed

これらのチェックは、接続が正常に作成されたが、後で失敗した状態になった場合に使用します。

インポートまたはフォーマットエラー format-errors

ファイル構造、ハッシュ、または列形式の問題が原因でソーシングが失敗した場合は、これらのチェックを使用します。

次の手順 next-steps

ソーシング完了後、オーディエンスは​ マイオーディエンス ​で、アクティベーション、重複分析、測定ワークフローに使用できます。 共同作業者と共にソースされたオーディエンスをアクティブ化するには、​ オーディエンスのアクティブ化を参照してください。

その他の使用可能なソーシング方法には、Experience Platform、Amazon S3、Google Cloud Storage、Snowflake、およびCSV ファイルのアップロードがあります。 その他のオーディエンスのソーシング方法については、次を参照してください。