Google Cloud Storage 接続

Last update: Wed Oct 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
宛先

作成対象：

管理者
ユーザー

概要 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

✓

Experience Platform セグメント化サービスを通じて生成されたオーディエンス。

カスタムアップロード

✓

CSV ファイルから Experience Platform に読み込まれたオーディエンス。

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

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

項目

タイプ

メモ

書き出しタイプ

Profile-based

宛先のアクティベーションワークフローのプロファイル属性の選択画面で選択したように、セグメントのすべてのメンバーを該当するスキーマフィールドと共に書き出します。

書き出し頻度

Batch

バッチ宛先では、ファイルが 3 時間、6 時間、8 時間、12 時間、24 時間の単位でダウンストリームプラットフォームに書き出されます。詳しくは、バッチ（ファイルベース）宛先を参照してください。

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

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

書き出されたデータのファイル形式 file-format

オーディエンスデータ を書き出すと、Experience Platformは、指定されたストレージの場所に .csv、parquet または .json ファイルを作成します。ファイルについて詳しくは、Audience Activation チュートリアルの書き出しでサポートされるファイル形式の節を参照してください。

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

Google Cloud Storage アカウントを接続するための前提条件の設定 prerequisites

Experience Platformを Google Cloud Storage に接続するには、まず Google Cloud Storage アカウントの相互運用性を有効にする必要があります。相互運用性設定にアクセスするには、Google Cloud Platform を開き、ナビゲーションパネルの「Settings」オプションから「Cloud Storage」を選択します。

「クラウドストレージ」と「設定」がハイライト表示された Google Cloud Platform ダッシュボード。

Settings ページが表示されます。ここから、Google プロジェクト ID に関する情報と Google Cloud Storage アカウントの詳細を確認できます。相互運用性設定にアクセスするには、上部のヘッダーから「Interoperability」を選択します。

Google Cloud Platform ダッシュボードでハイライト表示された「相互運用性」タブ。

Interoperability ページには、認証、アクセスキーおよびサービスアカウントに関連付けられたデフォルトプロジェクトに関する情報が含まれています。サービスアカウントの新しいアクセスキー ID と秘密アクセスキーを生成するには、「Create a Key for a Service Account」を選択します。

Google Cloud Platform ダッシュボードでハイライト表示された「サービスアカウントのキーを作成」コントロール。

新しく生成されたアクセスキー ID と秘密アクセスキーを使用して、Google Cloud Storage アカウントをExperience Platformに接続できます。

宛先への接続 connect

IMPORTANT

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

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

宛先に対する認証 authenticate

宛先に対する認証を行うには、必須フィールドに入力し、「Connect to destination」を選択します。

Access key ID:61 文字の英数字から成る文字列で、Experience Platformに対する Google Cloud Storage アカウントの認証に使用します。この値の取得方法について詳しくは、上記の前提条件の節を参照してください。
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.get
resourcemanager.projects.get
resourcemanager.projects.list
storage.managedFolders.create
storage.multipartUploads.abort
storage.multipartUploads.create
storage.multipartUploads.listParts
storage.objects.create
storage.objects.list

詳しくは、のアクセス制御と権限 Google Cloud Storage を参照してください。

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

IMPORTANT

データをアクティブ化するには、View Destinations、Activate Destinations、View Profiles、View Segments アクセス制御権限が必要です。アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
ID を書き出すには、View Identity Graph アクセス制御権限が必要です。
{width="100" modal="regular"}

この宛先に対してオーディエンスをアクティブ化する手順については、プロファイル書き出しのバッチ宛先に対するオーディエンスデータのアクティブ化を参照してください。

スケジュール設定

Scheduling の手順では、ース先に対して書き出しスケジュールを設定 Google Cloud Storage できます。また、書き出したファイルの名前を設定することもできます。

属性と ID のマッピング map

Mapping の手順では、プロファイルに書き出す属性フィールドと ID フィールドを選択できます。また、書き出したファイル内のヘッダーを選択して、任意のわかりやすい名前に変更することもできます。詳しくは、「バッチの宛先をアクティベート」UI チュートリアルのマッピング手順を参照してください。

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

データが正常に書き出されたかどうかを確認するには、Google Cloud Storage バケットを確認し、書き出したファイルに、期待されたプロファイルの母集団が含まれていることを確認します。

IP アドレスの許可リスト ip-address-allow-list

許可リストにAdobe許可リストに加えるの IP を登録する必要がある場合は、IP アドレスの記事を参照してください。

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6