[限定提供]{class="badge informative"}
オーディエンスソーシング用にGoogle Cloud Storageを設定
このガイドの手順に従って、Google Cloud Storage （GCS）バケットをAdobe Real-Time CDP Collaborationに接続し、UIを通じてファーストパーティオーディエンスデータのソーシングを開始します。
GCS バケットをCollaborationに接続すると、エンジニアリングのサポートなしでファーストパーティのオーディエンスデータを直接取り込むことができます。 接続が完了すると、Adobe Collaborationはバケットから定期的にオーディエンスを調達し、コラボレーションプロジェクト内でアクティベーションや重複分析のために利用できるようになります。 オーディエンスをアクティベートしたり、共同作業者との重複分析で使用したりするには、オーディエンスを分類する必要があります。
このガイドでは、前提条件の準備、GCS バケットの認証、自動マッピングされたID フィールドの確認、データ更新のスケジュール設定、ソーシングが正常に完了したことの確認など、エンドツーエンドの設定ワークフローについて説明します。
Google Cloud Storageから取得したオーディエンスは、Adobe Experience Platformから取得したオーディエンスと同じガバナンスとデータ処理ルールに従います。
その他の使用可能なソーシング方法には、Experience Platform、Amazon S3、Snowflake、およびCSV ファイルのアップロード があります。
前提条件 prerequisites
設定ワークフローを開始する前に、このセクションのすべての項目を完了してください。 不完全な前提条件は、設定が失敗したり、オーディエンスがソーシング後に表示されなかったりする最も一般的な理由です。 このガイドに従う前に、 アカウントのオンボーディングと設定を完了している必要があります。
このセクションの一部の手順では、Google Cloud管理者による操作が必要です。 組織のGoogle Cloud管理者でない場合は、開始する前に適切なユーザーを特定してください。
GCSのアクセスと権限 gcs-access-permissions
続行する前に、次の点をGoogle Cloud管理者に確認してください。
- Adobeには、GCS バケットに対する認証とオーディエンスファイルの読み取りに必要な権限が付与されています。
- Google Cloud Storage オーディエンスのソーシングは、お住まいの地域で利用できます。 ご利用いただけるかどうかは、地域（NA、EMEA、ANZ）によって異なります。 お住まいの地域でGCSのソーシングがまだ利用できない場合は、Adobeのアカウント担当者にお問い合わせください。
オーディエンスデータの準備 prepare-audience-data
オーディエンスファイルは、ソーシングを開始する前に、オーディエンスソーシング仕様（v1.2）に準拠している必要があります。 完全なスキーマ定義とフィールドレベルの例については、仕様を確認してください。 主な要件は次の通りです。
- ファイル形式： CSV。1つのフィールド内の複数の値の区切り記号としてカンマを使用し、パイプ （
|）を使用します。 - 必須フィールド：すべてのレコードには、
AUDIENCE_ID列と、サポートされている一致キー列が少なくとも1つ含まれている必要があります。 - サポートされている一致キー：
HASHED_EMAIL_SHA_256、HASHED_PHONE_SHA_256、HASHED_IPV4_SHA_256、CRM_ID、LOYALTY_ID、ADFIXUS_ID。 - ハッシュ化要件：すべての一致キー値は、アップロード前にトリミング、小文字、およびSHA256 ハッシュ化する必要があります。 Collaborationでは、取り込み前にデータをハッシュ化または正規化しません。
- 列の一貫性： バケットに複数のオーディエンスファイルが含まれている場合、すべてのファイルで同じ列構造を使用する必要があります。
オーディエンスファイルに存在するすべての照合キーも、Collaboration アカウントで有効にする必要があります。 一致キーを追加または有効にするには、一致キーの設定を参照してください。
開始する前に必要な値 required-values
設定ウィザードを開始する前に、次の値を準備しておく必要があります。
sourcing/testdata/path1/）。Google Cloud Storage接続の設定 configure-gcs-connection
設定ワークフローは、セットアップ ワークスペース内のマルチステップ ウィザードです。 各ステップを順番に進めていきます。 接続を作成する前に、最終レビュー画面の鉛筆アイコンを使用して、任意の手順に戻ることができます。
新しいデータ接続を追加 add-data-connection
セットアップ ワークスペース内のマイオーディエンス タブから、追加アイコン（
）を選択します。 Audienceを選択します。
これが初めてのオーディエンスの場合は、追加 オプションを選択することもできます。
オーディエンスを追加ワークフローが表示されます。 「新しいデータ接続を追加」を選択し、「次へ」を選択します。
{modal="regular"}
データソースとしてGoogle Cloud Storageを選択 select-gcs
データソース選択画面には、使用可能なすべての接続タイプが一覧表示されます。 「Google Cloud Storage」を選択し、「次へ」を選択します。
必要な設定手順（GCS バケットの設定やIAM ロールの割り当てなど）の概要を示す前提条件ダイアログが表示され、データが オーディエンスソーシング仕様 に準拠している必要があることに注意します。 「オンボーディングを開始」を選択して、続行する前にコンプライアンスを確認します。
Google Cloud Storage接続の詳細を入力 authenticate-gcs-connection
CollaborationによるGoogle Cloud Storage バケットへのアクセスを許可するために必要な詳細を入力してください。 必要な情報を入力したら、次へを選択します。
同意とデータ使用の確認 confirm-consent
Collaborationで処理する前に、オーディエンスデータから同意オプトアウトが削除されていることを確認する必要があります。 データがこの要件を満たしているかどうかわからない場合は、続行する前に、 ガバナンスポリシーと施行アクション ガイドを確認してください。 確認チェックボックスを選択し、OKを選択して続行します。
接続の詳細を提供 provide-connection-details
このデータ接続の名前とオプションの説明を入力します。 指定した名前は、My data connections タブに表示され、複数のデータ接続を管理する場合にこのソースを区別するのに役立ちます。
- データ接続名 （必須）
- データ接続の説明 （オプション）。
「次へ」をクリックして続行します。
自動マッピングされたID フィールドの確認 auto-mapped-fields
マッピング画面は読み取り専用です。 Collaborationは、オーディエンスソーシング仕様で定義された列名に基づいて、オーディエンスファイルのソース ID フィールドをターゲットフィールドに自動的にマッピングします。 この段階では、マッピングされたフィールドに変換を追加、削除、または適用することはできません。
表示されるマッピングが、オーディエンスファイルのフィールドを反映していることを確認します。 そうでない場合は、続行する前にファイルを停止して修正し、 オーディエンスソーシング仕様に準拠させます。 「次へ」をクリックして続行します。
データ更新のスケジュール schedule-data-refresh
スケジュール ビューで、Collaborationが更新されたオーディエンスデータをGCS バケットから取得する頻度を設定し、ソーシングのアクティブな日付範囲を定義します。
頻度 ドロップダウンを使用して、CollaborationがGCS バケットから更新されたオーディエンスデータを取得する頻度を選択します。 利用できる間隔の範囲は、日単位から 6日単位 です。
入力フィールドに日付範囲を入力するか、カレンダーアイコンを選択して、アクティブなソーシング期間の 開始日 と 終了日 を設定します。 終了日に達すると、ソーシングが停止され、以前にソースしたオーディエンスは期限切れになり、コラボレーションプロジェクトで使用できなくなります。
「次へ」をクリックして続行します。
接続を確認して完了 review-and-complete
接続を作成する前に、設定の概要を確認します。 概要画面には、次のセクションが表示されます。
- データ接続：設定したGCS バケットの資格情報とフォルダーパス。
- 詳細：このデータ接続の名前とオプションの説明。
- マッピング：自動マッピングされたソースおよびターゲット ID フィールド。
- スケジュール：更新頻度とアクティブな日付範囲。
鉛筆アイコン（
）を選択します。 セクションの横に移動して、そのステップに戻って変更を加えます。 すべてのセクションが正しい場合は、完了を選択します。
確認ダイアログが表示され、Collaborationがデータ接続を作成し、オーディエンスのソーシングが進行中であることを示します。
ソース別オーディエンスの確認 review-sourced-audiences
コンフィギュレーションウィザードが完了すると、CollaborationはGCS バケットからオーディエンスのソーシングを非同期で開始します。 セットアップ / マイオーディエンスに移動して、進行状況を監視します。 ソーシングはすぐに完了するわけではありません。必要な時間は、データのサイズと設定された更新頻度によって異なります。
オーディエンスのソーシングの進捗状況の監視 monitor-sourcing-progress
Collaborationがオーディエンスデータを取得している間、My audiences ワークスペースの上部にあるバナーは、ソーシングが進行中であることを示します。 個々のオーディエンスは、各オーディエンスのソーシング完了後にのみリストに表示されます。
ソースされたオーディエンスの詳細の表示 view-audience-details
ソーシングが完了すると、Google Cloud Storage個のオーディエンスが、他の接続からソーシングされたオーディエンスと共に個のマイオーディエンス タブに表示されます。 特定のオーディエンスの詳細ビューを開くには、行項目を選択するか、オーディエンスを表示します。
詳細ビューには、オーディエンスのステータス、ソースおよびデータ接続名が、次のパネルとともに表示されます。
- ID: データが利用可能になると、オーディエンスのID数と内訳の合計が表示されます。
- カテゴリ: オーディエンスの整理またはフィルタリングに適用されたタグ。
- 接続アクセス: オーディエンスがプライベート、パブリック、または特定の共同作業者と共有されているかどうか。
- メタデータの可視化：どのオーディエンス情報（ID数、重複率、インデックスなど）が共同作業者に表示されるか。
コラボレーションプロジェクトでオーディエンスを使用する前に、これらの設定を確認してください。 カテゴリ、接続アクセス、またはメタデータの表示を更新するには、個々のオーディエンスの表示と管理を参照してください。
オーディエンス設定の編集 edit-audience-settings
詳細ビューを開かずに、自分のオーディエンスのリストビューからオーディエンスメタデータを直接編集できます。 オーディエンスのチェックボックスを選択してアクションツールバーを表示し、アクションを選択します。メタデータ表示を編集、接続アクセスを編集、名前と説明を編集、カテゴリを編集、または削除。
GCS データ接続の表示 view-gcs-connection
一致キーとスケジュールを含む接続自体を確認または管理するには、設定 > データ接続に移動します。 新しいGCS接続がすぐに利用できます。 オーディエンスソースは Google Cloud Storage として表示されます。
既知の制限事項 known-limitations
Google Cloud Storage オーディエンスソーシングを設定して使用する場合は、次の制約に注意してください。
- 一致キーの制約： データ接続で一致キーが有効になると、削除できません。 既存の接続に一致するキーを追加することはできますが、無効にしたり削除したりすることはできません。 アクティブな一致キーを変更するには、 データ接続を削除して新しい接続を作成する必要があります。
- ソースごとに1つのアクティブなデータ接続： アクティブなGoogle Cloud Storage データ接続は一度に1つしかサポートされていません。 別のバケットからオーディエンスを調達する必要がある場合は、既存の接続を削除し、新しいバケットを指す新しい接続を作成します。
- サブフォルダーのサポート： オーディエンスファイルは、指定されたフォルダーパス内に直接配置する必要があります。 Collaborationは、そのパス内のサブフォルダーをトラバースしません。
トラブルシューティング troubleshooting
このセクションでは、最初の接続を確立した後に発生する問題を解決する場合に使用します。 認証中に発生するエラーについては、資格情報とバケット権限を確認するか、管理者にお問い合わせください。
オーディエンスが表示されていないか、ソーシングに予想以上の時間がかかっています
- ソーシング時間は、データ量と設定された更新頻度に応じて拡大・縮小されます。 大規模なデータセットでは、処理時間の延長が期待されます。
- オーディエンスが24時間以内に表示されない場合は、オーディエンスファイルが設定中に指定したフォルダーパスに存在することを確認し、オーディエンスソーシング仕様に準拠してください。
- 接続のエラーインジケーターについては、データ接続 タブを確認してください。
- これらの手順を実行しても問題が解決しない場合は、Adobe カスタマーサポートに連絡し、データ接続名とバケットの詳細を提供してください。
最初に成功した後、データ接続に失敗したステータスが表示される
- 接続を作成してから、GCS バケットの権限と資格情報が変更されていないことを確認します。 Adobeのバケットへのアクセス権を削除すると、その後のソーシング実行が失敗します。
- オーディエンスファイルが設定済みのフォルダーパスにまだ存在し、オーディエンスソーシング仕様に準拠していることを確認します。
- 権限とファイルの可用性を確認した後も問題が解決しない場合は、接続を削除して新しい接続を作成するか、Adobe カスタマーサポートにお問い合わせください。
スケジュールされた更新中にオーディエンスファイル形式エラーが発生する
- バケット内の更新されたファイルが、 オーディエンスソーシング仕様の列構造とフィールド要件に準拠していることを確認します。
- 設定されたフォルダーパス内のすべてのファイルで、同じ列構造が使用されていることを確認します。 同じパス内の混在フォーマットのファイルは、部分的なソーシング失敗を引き起こす可能性があります。
次の手順 next-steps
Google Cloud StorageをCollaborationのデータソースとして設定しました。 ソーシングが完了すると、オーディエンスはマイオーディエンス ワークスペースで使用できるようになり、コラボレーションプロジェクトで使用できるようになります。
ここから、次の操作を実行できます。
その他のオーディエンスのソーシング方法については、次を参照してください。