Google Cloud Storage 接続
概要 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
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス,
- 連合オーディエンス,
- Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
- その他。
オーディエンスのデータタイプ別にサポートされるオーディエンス:
書き出しのタイプと頻度 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を開き、ナビゲーションパネルのSettings オプションから Cloud Storage を選択します。
Settings ページが表示されます。 ここから、Google プロジェクト ID に関する情報と Google Cloud Storage アカウントの詳細を確認できます。相互運用性の設定にアクセスするには、上部ヘッダーから「Interoperability」を選択します。
Interoperability ページには、認証、アクセスキー、およびサービスアカウントに関連付けられているデフォルトプロジェクトに関する情報が含まれています。 新しいアクセス キーIDとサービス アカウントの秘密アクセス キーを生成するには、Create a Key for a Service Accountを選択します。
新しく生成したアクセス キーIDと秘密アクセス キーを使用して、Google Cloud Storage アカウントをExperience Platformに接続できます。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つの節でリストされているフィールドに入力します。
宛先に対する認証 authenticate
宛先に対して認証を行うには、必須フィールドに入力し、Connect to destinationを選択します。
-
Access key ID: Google Cloud Storage アカウントをExperience Platformに認証するために使用される61文字の英数字の文字列。 この値の取得方法について詳しくは、上記の前提条件の節を参照してください。
-
Secret access key: Google Cloud Storage アカウントをExperience Platformに認証するために使用される、40文字のbase64 エンコードされた文字列。 この値の取得方法について詳しくは、上記の前提条件の節を参照してください。
-
Encryption key: オプションで、RSA形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
これらの値について詳しくは、Google Cloud Storage の HMAC キーガイドを参照してください。独自のアクセスキーIDとシークレットアクセスキーを生成する手順については、Google Cloud Storage ソースの概要を参照してください。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。
-
Name:この宛先の優先名を入力します。
-
Description:オプション。例えば、この宛先を使用しているキャンペーンを指定できます。
-
Bucket name:この宛先で使用するGoogle Cloud Storage バケットの名前を入力します。
-
Folder path:書き出されたファイルをホストする宛先フォルダーへのパスを入力します。
-
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を選択します。
必要な 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
- データをアクティブ化するには、View Destinations、Activate Destinations、View ProfilesおよびView Segments アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
- IDをエクスポートするには、View Identity Graph アクセス制御権限が必要です。
{width="100" modal="regular"}
この宛先に対するオーディエンスのアクティブ化の手順については、 バッチプロファイル書き出し宛先に対するオーディエンスデータのアクティブ化を参照してください。
スケジュール設定 scheduling
Scheduling手順では、宛先に対して書き出しスケジュール Google Cloud Storageを設定でき、書き出したファイルの名前を設定することもできます。
属性と ID のマッピング map
Mapping ステップでは、プロファイルにエクスポートする属性フィールドとID フィールドを選択できます。 また、書き出したファイル内のヘッダーを選択して、任意のわかりやすい名前に変更することもできます。詳しくは、「バッチの宛先をアクティベート」UI チュートリアルのマッピング手順を参照してください。
データの正常な書き出しの検証 exported-data
データが正常に書き出されたかどうかを確認するには、Google Cloud Storage バケットを確認し、書き出したファイルに、期待されたプロファイルの母集団が含まれていることを確認します。
IP アドレスの許可リスト ip-address-allow-list
Adobe IPを契約許可リストに追加する必要がある場合は、「IP アドレス契約」を参照してください。