Google Cloud Storage 接続
Google Cloud Storageに接続して、Adobe CX Enterprise アプリケーションから独自のバケットにデータファイルをエクスポートします。
Real-Time CDP Collaborationからこのページにアクセスした場合は、そのアプリケーションに固有の詳細については、Real-Time CDP Collaborationからのオーディエンスのアクティベーション を参照してください。
サポートされているAdobe CX Enterprise アプリケーション supported-applications
この宛先は、次のAdobe CX Enterprise アプリケーションで使用できます。
概要 overview
Google Cloud Storageへのライブアウトバウンド接続を作成して、Adobe Experience Platformから独自のバケットにデータファイルを定期的に書き出します。
APIまたはUIを介してGoogle Cloud Storage ストレージに接続する connect-api-or-ui
- Experience Platform ユーザーインターフェイスを使用してGoogle Cloud Storage ストレージの場所に接続するには、以下の「宛先に接続」と「この宛先にオーディエンスをアクティブ化」の節を参照してください。
- プログラムでGoogle Cloud Storageのストレージの場所に接続するには、Flow Service API チュートリアルを使用してファイルベースの宛先にオーディエンスをアクティブ化するを参照してください。
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。 サポートされているオーディエンスは、この宛先に対してアクティブ化するAdobe CX Enterprise アプリケーションによって異なります。
Real-Time CDP supported-audiences-rtcdp
Real-Time CDPからアクティブ化すると、次のオーディエンスがサポートされます。
このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス，
- 連合オーディエンス，
- Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
- その他。
オーディエンスのデータタイプ別にサポートされるオーディエンス：
Real-Time CDP Collaboration supported-audiences-collaboration
Real-Time CDP Collaborationでは、Adobe Experience Platformまたはその他のクラウドソースから オーディエンス を取得できます。 Real-Time CDP Collaborationのオーディエンスは一致キーで構成されています。 これらのオーディエンスは、Collaboration内でデータコラボレーションや有料メディア活動に使用できます。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しタイプと頻度については、次の表を参照してください。
データセットの書き出し export-datasets
この宛先では、データセットの書き出しをサポートしています。 データセットの書き出しを設定する方法について詳しくは、チュートリアルを参照してください。
- Experience Platform ユーザーインターフェイス 🔗を使用してデータセットを エクスポートする方法。
- Flow Service APIを使用してデータセットをプログラムで エクスポートする方法。
書き出されたデータのファイル形式 file-format
オーディエンスデータを書き出すと、Experience Platformは、指定した保存場所に.csv、parquet、または.json個のファイルを作成します。 ファイルについて詳しくは、オーディエンスアクティベーションのチュートリアルの「 サポートされている書き出し用ファイル形式」セクションを参照してください。
データセットを書き出すと、Experience Platformは、指定したストレージの場所に.parquetまたは.json個のファイルを作成します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの「成功したデータセットの書き出しを検証する」セクションを参照してください。
Google Cloud Storage アカウントを接続するための前提条件の設定 prerequisites
Experience PlatformをGoogle Cloud Storageに接続するには、まずGoogle Cloud Storage アカウントの相互運用性を有効にする必要があります。 相互運用性の設定にアクセスするには、Google Cloud Platformを開き、ナビゲーションパネルのクラウドストレージ オプションから 設定 を選択します。
設定 ページが表示されます。 ここから、Google プロジェクト ID に関する情報と Google Cloud Storage アカウントの詳細を確認できます。 相互運用性の設定にアクセスするには、上部ヘッダーから「相互運用性」を選択します。
相互運用性 ページには、認証、アクセスキー、およびサービスアカウントに関連付けられているデフォルトプロジェクトに関する情報が含まれています。 新しいアクセス キーIDとサービス アカウントの秘密アクセス キーを生成するには、サービス アカウントのキーを作成を選択します。
新しく生成したアクセス キーIDと秘密アクセス キーを使用して、Google Cloud Storage アカウントをExperience Platformに接続できます。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。 宛先の設定ワークフローで、以下の 2 つの節でリストされているフィールドに入力します。
宛先に対する認証 authenticate
宛先に対して認証を行うには、必須フィールドに入力し、宛先に接続を選択します。
-
アクセスキーID: Google Cloud Storage アカウントをExperience Platformに認証するために使用される61文字の英数字の文字列。 この値の取得方法について詳しくは、上記の前提条件の節を参照してください。
-
秘密鍵: Google Cloud Storage アカウントをExperience Platformに認証するために使用される、40文字のbase64 エンコードされた文字列。 この値の取得方法について詳しくは、上記の前提条件の節を参照してください。
-
暗号化キー: オプションで、RSA形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
これらの値について詳しくは、Google Cloud Storage の HMAC キーガイドを参照してください。 独自のアクセスキーIDとシークレットアクセスキーを生成する手順については、Google Cloud Storage ソースの概要を参照してください。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。 UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。
-
名前：この宛先に希望する名前を入力します。
-
説明: オプション。 例えば、この宛先を使用しているキャンペーンを指定できます。
-
バケット名：この宛先で使用するGoogle Cloud Storage バケットの名前を入力します。
-
フォルダーパス：書き出されたファイルをホストする宛先フォルダーへのパスを入力します。
-
ファイルの種類：書き出すファイルにExperience Platformで使用する形式を選択します。 CSV オプションを選択する際に、 ファイル形式オプションを設定することもできます。
-
圧縮形式：書き出したファイルにExperience Platformで使用する圧縮形式を選択します。
-
マニフェストファイルを含める：書き出しを実行して、書き出し場所や書き出しサイズなどの情報を含むマニフェスト JSON ファイルを含める場合は、このオプションをオンに切り替えます。 マニフェストの名前は、形式
manifest-<<destinationId>>-<<dataflowRunId>>.jsonを使用して指定されています。 サンプルマニフェストファイル を表示します。 マニフェストファイルには、次のフィールドが含まれます。flowRunId: エクスポートされたファイルを生成した データフロー実行。scheduledTime: ファイルがエクスポートされたUTCの時間。exportResults.sinkPath：書き出されたファイルが格納されているストレージの場所のパス。exportResults.name: エクスポートされたファイルの名前。size：書き出されたファイルのサイズ （バイト単位）。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。 リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。 アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の提供が完了したら、次へを選択します。
必要な Google Cloud Storage 権限 required-google-cloud-storage-permission
データを接続してGoogle Cloud Storage ストレージの場所に正常にエクスポートするには、バケットに対して次のGoogle Cloud Storage権限が必要です。
orgpolicy.policy.getresourcemanager.projects.getresourcemanager.projects.liststorage.managedFolders.createstorage.multipartUploads.abortstorage.multipartUploads.createstorage.multipartUploads.listPartsstorage.objects.createstorage.objects.list
Google Cloud Storageの アクセス制御と権限の詳細をご覧ください。
この宛先に対してオーディエンスをアクティブ化 activate
この宛先に対して、Real-Time CDPまたはReal-Time CDP Collaboration プロジェクトからオーディエンスをアクティブ化できます。
Real-Time CDPからオーディエンスをアクティブ化 activate-rtcdp
- データをアクティブ化するには、宛先の表示、宛先のアクティブ化、プロファイルの表示およびセグメントの表示 アクセス制御の権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
- IDをエクスポートするには、ID グラフの表示 アクセス制御権限が必要です。
この宛先に対するオーディエンスのアクティブ化の手順については、 バッチプロファイル書き出し宛先に対するオーディエンスデータのアクティブ化を参照してください。
スケジュール設定 scheduling
スケジュール設定手順では、Google Cloud Storage宛先に対して書き出しスケジュール を設定でき、書き出したファイルの名前を設定することもできます。
属性と ID のマッピング map
マッピング手順では、プロファイルに書き出す属性フィールドとID フィールドを選択できます。 また、書き出したファイル内のヘッダーを選択して、任意のわかりやすい名前に変更することもできます。 詳しくは、「バッチの宛先をアクティベート」UI チュートリアルのマッピング手順を参照してください。
Real-Time CDP Collaborationからオーディエンスをアクティブ化 activate-collaboration
Real-Time CDP Collaboration プロジェクトからこの宛先に対してオーディエンスをアクティブ化する方法については、Real-Time CDP Collaboration宛先の概要を参照してください。
データの正常な書き出しの検証 exported-data
データが正常に書き出されたかどうかを確認するには、Google Cloud Storage バケットを確認し、書き出したファイルに、期待されたプロファイルの母集団が含まれていることを確認します。
IP アドレスの許可リスト ip-address-allow-list
Adobe IPを契約許可リストに追加する必要がある場合は、「IP アドレス契約」を参照してください。