Flow Service API を使用して、ファイルベースの宛先に対するオーディエンスをアクティブ化します
拡張されたファイル書き出し機能を使用すると、Experience Platformからファイルを書き出す際に拡張カスタマイズ機能にアクセスできます。
- 追加のファイル命名オプション。
- 書き出されたファイルにカスタムファイルヘッダーを設定する機能(マッピングステップの改善による)
- を選択できます ファイルタイプ エクスポートされたファイルの。
- 書き出された CSV データファイルの形式をカスタマイズする機能。
この機能は、以下に示す 6 つのクラウドストレージカードでサポートされています。
この記事では、の使用に必要なワークフローについて説明します フローサービス API Adobe Experience Platformから上記にリンクされたいずれかのクラウドストレージの場所に対象プロファイルを書き出します。
はじめに get-started
このガイドでは、Adobe Experience Platform の次のコンポーネントに関する十分な知識が必要です。
- Experience Data Model (XDM) System:Experience Platform がカスタマーエクスペリエンスのデータの整理に使用する、標準化されたフレームワーク。
- Segmentation Service: Adobe Experience Platform Segmentation Service では、でオーディエンスを作成し、オーディエンスを生成できます Adobe Experience Platform から Real-Time Customer Profile データ。
- Sandboxes:Experience Platform には、単一の Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。
次の節では、Platform でファイルベースの宛先に対してデータをアクティブ化するために必要な追加情報を示します。
必要な権限 permissions
プロファイルを書き出すには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントの表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
エクスポートする id、が必要です ID グラフの表示 アクセス制御権限.
API 呼び出し例の読み取り reading-sample-api-calls
このチュートリアルでは、API 呼び出しの例を提供し、リクエストの形式を設定する方法を示します。これには、パス、必須ヘッダー、適切な形式のリクエストペイロードが含まれます。また、API レスポンスで返されるサンプル JSON も示されています。ドキュメントで使用される API 呼び出し例の表記について詳しくは、 トラブルシューテングガイドのAPI 呼び出し例の読み方に関する節を参照してくださいExperience Platform。
必須ヘッダーおよびオプションヘッダーの値の収集 gather-values-headers
に対して呼び出しを行うため Platform API を使用する場合、最初にを完了する必要があります。 Experience Platform認証のチュートリアル. 認証チュートリアルを完了すると、必要な各ヘッダーの値がすべて提供されます Experience Platform API 呼び出し(下図を参照)。
- Authorization: Bearer
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Experience Platform のリソースは、特定の仮想サンドボックスに分離できます。Platform API へのリクエストでは、操作を実行するサンドボックスの名前と ID を指定できます。次に、オプションのパラメーターを示します。
- x-sandbox-name:
{SANDBOX_NAME}
ペイロードを含むすべてのリクエスト (POST
, PUT
, PATCH
)には、追加のメディアタイプヘッダーが必要です。
- Content-Type:
application/json
API リファレンスドキュメント api-reference-documentation
このチュートリアルに含まれるすべての API 操作について、付属リファレンスドキュメントが用意されています。を参照してください。 フローサービス - Adobe Developer web サイトの Destinations API ドキュメント. このチュートリアルと API リファレンスのドキュメントを並行して使用することをお勧めします。
用語集 glossary
この API チュートリアルで発生する用語の説明については、を参照してください。 用語集セクション (API リファレンスドキュメント)。
オーディエンスを書き出す宛先を選択 select-destination
プロファイルの書き出しワークフローを開始する前に、オーディエンスの書き出し先とする宛先の接続仕様およびフロー仕様 ID を特定します。 以下の表を参照してください。
4fce964d-3f37-408f-9778-e597338a21ee
1a0514a6-33d4-4c7f-aff8-594799c47549
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
752d422f-b16f-4f0d-b1c6-26e448e3b388
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
36965a81-b1c6-401b-99f8-22508f1e6a26
fd36aaa4-bf2b-43fb-9387-43785eeeb799
これらの ID は、このチュートリアルの次の手順で様々なフローサービスエンティティを構築するために必要です。 また、接続仕様自体の一部を参照して、特定のエンティティを設定し、Flow Service API から接続仕様を取得できるようにする必要もあります。 テーブル内のすべての宛先の接続仕様を取得する例を以下に示します。
リクエスト
accordion | ||
---|---|---|
取得 connection spec (用) Amazon S3 | ||
|
応答
accordion | ||
---|---|---|
Amazon S3 – 接続仕様 | ||
|
リクエスト
accordion | ||
---|---|---|
取得 connection spec (用) Azure Blob Storage | ||
|
応答
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
リクエスト
accordion | ||
---|---|---|
取得 connection spec (用) Azure Data Lake Gen 2(ADLS Gen2) | ||
|
応答
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
リクエスト
accordion | ||
---|---|---|
取得 connection spec (用) Data Landing Zone(DLZ) | ||
|
応答
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
リクエスト
accordion | ||
---|---|---|
取得 connection spec (用) Google Cloud Storage | ||
|
応答
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
リクエスト
accordion | ||
---|---|---|
取得 connection spec (SFTP の場合) | ||
|
応答
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
クラウドストレージの宛先へのオーディエンス書き出しデータフローを設定するには、次の手順に従います。 一部の手順では、リクエストと応答はクラウドストレージの様々な宛先間で異なります。 その場合、ページ上のタブを使用して、オーディエンスの接続および書き出し先となる宛先に固有のリクエストと応答を取得します。 正しいを使用するようにしてください connection spec
および flow spec
設定している宛先に対して。
ソース接続の作成 create-source-connection
オーディエンスを書き出す宛先を決定したら、ソース接続を作成する必要があります。 この ソース接続 は、内部への接続を表します Experience Platformプロファイルストア.
リクエスト
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、インラインコメントを削除します。
code language-shell |
---|
|
応答
code language-json |
---|
|
リクエストが成功した場合は、ID (id
)に設定します。 etag
. 後でデータフローを作成する際に必要になるので、ソース接続 ID をメモしておきます。
ベース接続の作成 create-base-connection
A ベース接続 は、資格情報を宛先に安全に保存します。 宛先のタイプによって、その宛先に対して認証するために必要な資格情報は異なる場合があります。 これらの認証パラメーターを見つけるには、まず connection spec
「」の節で説明されているように、目的の宛先に対して オーディエンスを書き出す宛先を選択 その後、を見てください。 authSpec
応答の。 については、以下のタブを参照してください authSpec
サポートされるすべての宛先のプロパティ。
accordion | ||
---|---|---|
Amazon S3 - Connection spec 表示中 auth spec | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください connection spec 以下の例では、で認証パラメーターを見つける場所に関する追加情報を提供しています。 connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec 表示中 auth spec | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください connection spec 以下の例では、で認証パラメーターを見つける場所に関する追加情報を提供しています。 connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec 表示中 auth spec | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください connection spec 以下の例では、で認証パラメーターを見つける場所に関する追加情報を提供しています。 connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec 表示中 auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec 表示中 auth spec | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください connection spec 以下の例では、で認証パラメーターを見つける場所に関する追加情報を提供しています。 connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec 表示中 auth spec | |||||
でハイライト表示された行にインラインコメントが付いていることに注意してください connection spec 以下の例では、で認証パラメーターを見つける場所に関する追加情報を提供しています。 connection spec.
|
認証仕様で指定されたプロパティの使用(例: authSpec
の応答から)を使用して、以下の例に示すように、各宛先タイプに固有の必要な資格情報を含むベース接続を作成できます。
リクエスト
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - アクセスキーと秘密鍵の認証を使用したベース接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 – 想定される役割認証を使用したベース接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
Amazon S3 ベース接続応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - ベース接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
Azure Blob Storage - ベース接続応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - ベース接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - ベース接続応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - ベース接続リクエスト | |||||
|
応答
accordion | ||
---|---|---|
Data Landing Zone - ベース接続応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - ベース接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
Google Cloud Storage - ベース接続応答 | ||
|
リクエスト
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
パスワードを使用した SFTP - ベース接続リクエスト | |||||||||||||||||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SSH キーを使用した SFTP - ベース接続リクエスト | |||||||||||||||||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
SFTP - ベース接続応答 | ||
|
書き出したファイルへの暗号化の追加
オプションで、書き出したファイルに暗号化を追加できます。 これを行うには、から項目を追加する必要があります encryptionSpecs
. 必須パラメーターがハイライト表示された以下のリクエストの例を参照してください。
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
リクエスト
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、インラインコメントを削除します。
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
応答
code language-json |
---|
|
応答からの接続 ID をメモしておきます。 この ID は、次の手順でターゲット接続を作成する際に必要になります。
ターゲット接続の作成 create-target-connection
次に、ターゲット接続を作成する必要があります。 ターゲット接続 書き出されたオーディエンスの書き出しパラメーターを保存します。 書き出しパラメータには、書き出し場所、ファイル形式、圧縮、およびその他の詳細が含まれます。 例えば、CSV ファイルの場合は、複数の書き出しオプションを選択できます。 でサポートされるすべての CSV 書き出しオプションに関する詳細な情報を取得します ファイル形式設定ページ.
を参照してください。 targetSpec
宛先ので指定されたプロパティ connection spec
各宛先タイプでサポートされるプロパティを理解するため。 については、以下のタブを参照してください targetSpec
サポートされるすべての宛先のプロパティ。
accordion | ||
---|---|---|
Amazon S3 - Connection spec ターゲット接続パラメーターの表示 | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください。 connection spec 以下の例では、の場所に関する追加情報を提供しています。 target spec 接続仕様のパラメーター。 以下の例で、ターゲットパラメーターも確認できます ではない オーディエンス書き出し宛先に適用できます。
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec ターゲット接続パラメーターの表示 | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください。 connection spec 以下の例では、の場所に関する追加情報を提供しています。 target spec 接続仕様のパラメーター。 以下の例で、ターゲットパラメーターも確認できます ではない オーディエンス書き出し宛先に適用できます。
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec ターゲット接続パラメーターの表示 | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください。 connection spec 以下の例では、の場所に関する追加情報を提供しています。 target spec 接続仕様のパラメーター。 以下の例で、ターゲットパラメーターも確認できます ではない オーディエンス書き出し宛先に適用できます。
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec ターゲット接続パラメーターの表示 | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください。 connection spec 以下の例では、の場所に関する追加情報を提供しています。 target spec 接続仕様のパラメーター。 以下の例で、ターゲットパラメーターも確認できます ではない オーディエンス書き出し宛先に適用できます。
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec ターゲット接続パラメーターの表示 | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください。 connection spec 以下の例では、の場所に関する追加情報を提供しています。 target spec 接続仕様のパラメーター。 以下の例で、ターゲットパラメーターも確認できます ではない オーディエンス書き出し宛先に適用できます。
|
accordion | ||
---|---|---|
SFTP - Connection spec ターゲット接続パラメーターの表示 | ||
でハイライト表示された行にインラインコメントが付いていることに注意してください。 connection spec 以下の例では、の場所に関する追加情報を提供しています。 target spec 接続仕様のパラメーター。 以下の例で、ターゲットパラメーターも確認できます ではない オーディエンス書き出し宛先に適用できます。
|
上記の仕様を使用すると、以下のタブに示すように、目的のクラウドストレージの宛先に固有のターゲット接続リクエストを作成できます。
リクエスト
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - ターゲット接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - CSV オプションを使用したターゲット接続リクエスト | |||||
|
応答
accordion | ||
---|---|---|
ターゲット接続 – 応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - ターゲット接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - CSV オプションを使用したターゲット接続リクエスト | |||||
|
応答
accordion | ||
---|---|---|
ターゲット接続 – 応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - ターゲット接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - CSV オプションを使用したターゲット接続リクエスト | |||||
|
応答
accordion | ||
---|---|---|
ターゲット接続 – 応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - ターゲット接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - CSV オプションを使用したターゲット接続リクエスト | |||||
|
応答
accordion | ||
---|---|---|
ターゲット接続 – 応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - ターゲット接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - CSV オプションを使用したターゲット接続リクエスト | |||||
|
応答
accordion | ||
---|---|---|
ターゲット接続 – 応答 | ||
|
リクエスト
accordion | |||||
---|---|---|---|---|---|
SFTP - ターゲット接続リクエスト | |||||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
accordion | |||||
---|---|---|---|---|---|
SFTP - CSV オプションを使用したターゲット接続リクエスト | |||||
|
応答
accordion | ||
---|---|---|
ターゲット接続 – 応答 | ||
|
「」に注目してください target connection ID
応答から。 この ID は、次の手順で、オーディエンスを書き出すデータフローを作成する際に必要になります。
リクエストが成功した場合は、ID (id
)に設定します。 etag
. 後でデータフローを作成する際に必要になるので、ターゲット接続 ID をメモしておきます。
データフローの作成 create-dataflow
宛先設定の次の手順は、データフローを作成することです。 A データフロー 以前に作成したエンティティを結び付け、オーディエンスの書き出しスケジュールを設定するためのオプションも提供します。 データフローを作成するには、目的のクラウドストレージ宛先に応じて以下のペイロードを使用し、前の手順で取得したフローエンティティ ID を置き換えます。 この手順では、属性または ID マッピングに関連する情報をデータフローに追加しません。 それは次のステップに続きます。
リクエスト
accordion | ||
---|---|---|
へのオーディエンス書き出しデータフローの作成 Amazon S3 宛先 – リクエスト | ||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
データフローの作成 – 応答 | ||
|
リクエスト
accordion | ||
---|---|---|
へのオーディエンス書き出しデータフローの作成 Azure Blob Storage 宛先 – リクエスト | ||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
データフローの作成 – 応答 | ||
|
リクエスト
accordion | ||
---|---|---|
へのオーディエンス書き出しデータフローの作成 Azure Data Lake Gen 2(ADLS Gen2) 宛先 – リクエスト | ||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
データフローの作成 – 応答 | ||
|
リクエスト
accordion | ||
---|---|---|
へのオーディエンス書き出しデータフローの作成 Data Landing Zone 宛先 – リクエスト | ||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
データフローの作成 – 応答 | ||
|
リクエスト
accordion | ||
---|---|---|
へのオーディエンス書き出しデータフローの作成 Google Cloud Storage 宛先 – リクエスト | ||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
データフローの作成 – 応答 | ||
|
リクエスト
accordion | ||
---|---|---|
SFTP 宛先へのオーディエンス書き出しデータフローの作成 – リクエスト | ||
リクエストの例では、ハイライト表示された行にインラインコメントが付いていることに注意してください。このコメントによって追加情報が提供されます。 リクエストを選択したターミナルにコピー&ペーストする際に、リクエスト内のインラインコメントを削除します。
|
応答
accordion | ||
---|---|---|
データフローの作成 – 応答 | ||
|
応答のデータフロー ID をメモします。 この ID は、後の手順で必要になります。
書き出しにオーディエンスを追加
この手順では、宛先に書き出すオーディエンスを選択することもできます。 この手順と、データフローにオーディエンスを追加するためのリクエスト形式について詳しくは、内の例を参照してください。 宛先データフローの更新 の節(API リファレンスドキュメントの)。
属性および ID マッピングの設定 attribute-and-identity-mapping
データフローを作成したら、書き出す属性と ID のマッピングを設定する必要があります。 これは、次の 3 つの手順で構成されます。
- 入力スキーマの作成
- 出力スキーマの作成
- マッピングセットの設定による作成済みスキーマの接続
例えば、UI に表示される次のマッピングを取得するには、上記の 3 つの手順を実行し、次の見出しで詳しく説明する必要があります。
入力スキーマの作成
入力スキーマを作成するには、まず 結合スキーマ 宛先に書き出し可能な ID です。 これは、ソースマッピングとして選択できる属性および ID のスキーマです。
属性と ID を取得するためのリクエストと応答の例を以下に示します。
属性を取得するリクエスト
code language-shell |
---|
|
応答
以下の応答は、簡潔にするために短縮されました。
code language-json |
---|
|
ID の取得リクエスト
code language-shell |
---|
|
応答
応答は、入力スキーマを作成する際に使用できる ID を返します。 この応答は、次の両方を返します 標準 および custom Experience Platformで設定した ID 名前空間。
code language-json |
---|
|
次に、上記の応答をコピーし、それを使用して入力スキーマを作成する必要があります。 上記の応答から JSON 応答全体をコピーして、に配置できます。 jsonSchema
以下に示すオブジェクト。
入力スキーマの作成リクエスト
code language-shell |
---|
|
応答
code language-json |
---|
|
応答の ID は、作成した入力スキーマの一意の ID を表します。 後の手順で再利用できるように、応答から ID をコピーします。
出力スキーマの作成
次に、書き出しの出力スキーマを設定する必要があります。 まず、既存のパートナースキーマを見つけて検査する必要があります。
リクエスト
以下の例では、を使用しています。 connection spec ID
(Amazon S3 の場合) この値を、宛先に固有の接続仕様 ID に置き換えてください。
code language-shell |
---|
|
スキーマの例を使用した応答
上記の呼び出しを実行する際に取得した応答をInspectします。 オブジェクトを見つけるには、応答をドリルダウンする必要があります targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
次に、出力スキーマを作成します。 上記で取得した JSON 応答をコピーし、に貼り付けます。 jsonSchema
オブジェクトを下に配置します。
リクエスト
code language-shell |
---|
|
応答
code language-json |
---|
|
応答の ID は、作成した入力スキーマの一意の ID を表します。 後の手順で再利用できるように、応答から ID をコピーします。
マッピングセットを作成 create-mapping-set
次に、を使用します data prep API 入力スキーマ ID、出力スキーマ ID および目的のフィールドマッピングを使用してマッピングセットを作成するには、
リクエスト
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
応答
code language-json |
---|
|
マッピングセットの ID をメモします。次の手順で、既存のデータフローをマッピングセット ID で更新する際に必要になります。
次に、更新するデータフローの ID を取得します。
参照: 宛先データフローの詳細の取得 データフローの ID の取得について説明します。
最後に、以下を行う必要があります PATCH
作成したマッピングセット情報を含むデータフロー。
リクエスト
code language-shell |
---|
|
応答
Flow Service API からの応答は、更新されたデータフローの ID を返します。
code language-json |
---|
|
他のデータフロー更新を行う other-dataflow-updates
データフローを更新するには、 PATCH
操作。 例えば、データフローにマーケティングアクションを追加できます。 または、データフローを更新して、フィールドを必須キーまたは重複排除キーとして選択できます。
マーケティングアクションの追加 add-marketing-action
を追加します マーケティングアクション。以下のリクエストと応答の例を参照してください。
If-Match
ヘッダーは、 PATCH
リクエスト。 このヘッダーの値は、更新するデータフローの一意のバージョンです。 etag の値は、データフロー、ターゲット接続などのフローエンティティが正常に更新されるたびに更新されます。https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
エンドポイント {ID}
は、更新するデータフロー ID です。If-Match
以下の例のように、を作成する際に二重引用符で囲んだヘッダー PATCH
リクエスト。リクエスト
code language-shell |
---|
|
応答
応答が成功すると、応答コードが返されます 200
さらに、更新されたデータフローの ID および更新された eTag。
code language-json |
---|
|
必須キーを追加 add-mandatory-key
を追加します 必須キー。以下のリクエストと応答の例を参照してください。
If-Match
ヘッダーは、 PATCH
リクエスト。 このヘッダーの値は、更新するデータフローの一意のバージョンです。 etag の値は、データフロー、ターゲット接続などのフローエンティティが正常に更新されるたびに更新されます。https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
エンドポイント {ID}
は、更新するデータフロー ID です。If-Match
以下の例のように、を作成する際に二重引用符で囲んだヘッダー PATCH
リクエスト。リクエスト
code language-shell |
---|
|
code language-shell |
---|
|
応答
code language-json |
---|
|
重複排除キーを追加 add-deduplication-key
を追加します 重複排除キー。以下のリクエストと応答の例を参照してください
If-Match
ヘッダーは、 PATCH
リクエスト。 このヘッダーの値は、更新するデータフローの一意のバージョンです。 etag の値は、データフロー、ターゲット接続などのフローエンティティが正常に更新されるたびに更新されます。https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
エンドポイント {ID}
は、更新するデータフロー ID です。If-Match
以下の例のように、を作成する際に二重引用符で囲んだヘッダー PATCH
リクエスト。リクエスト
code language-shell |
---|
|
code language-shell |
---|
|
応答
code language-json |
---|
|
データフローの検証(データフローの実行を取得) get-dataflow-runs
データフローの実行を確認するには、Dataflow Runs API を使用します。
リクエスト
code language-shell |
---|
|
応答
code language-json |
---|
|
に関する情報を確認できます データフロー実行 API から返される様々なパラメーター API リファレンスドキュメント
API エラー処理 api-error-handling
このチュートリアルの API エンドポイントは、一般的なExperience PlatformAPI エラーメッセージの原則に従っています。 こちらを参照してください API ステータスコード および リクエストヘッダーエラー エラー応答の解釈について詳しくは、Platform トラブルシューティングガイドを参照してください。
次の手順 next-steps
このチュートリアルでは、目的のクラウドストレージ宛先の 1 つに Platform を正常に接続し、オーディエンスを書き出すためのそれぞれの宛先へのデータフローを設定しました。 次のページでは、Flow Service API を使用した既存のデータフローの編集方法などの詳細を確認します。