データアクティベーション用の Guardrail
Last update: Thu Dec 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
このページでは、アクティベーション動作に関するデフォルトの使用方法とレートの制限について説明します。次のガードレールを確認する際は、正しく宛先に接続されているとみなされます。
- ほとんどのお客様は、これらのデフォルトの上限を超えることはありません。カスタム制限の詳細については、カスタマーケア担当者にお問い合わせください。
- このドキュメントで概要を説明する上限は、常に改善されています。 定期的に更新を確認してください。
- 個々のダウンストリームの制限によっては、一部の宛先は、このページで説明するものよりも厳しいガードレールを持つ場合があります。また、接続してデータをアクティブ化する宛先のページのカタログを確認します。
ガードレールのタイプ limit-types
このドキュメントでは、次の 2 種類のデフォルトの上限について説明します。
パフォーマンスガードレール（ソフト制限）
パフォーマンスガードレールは、使用例の範囲に関連する使用制限です。 パフォーマンスガードレールを超えると、パフォーマンスが低下し、遅延が発生する場合があります。 Adobeは、そのようなパフォーマンスの低下に対して責任を負いません。 パフォーマンスガードレールを常に上回るお客様は、パフォーマンスの低下を避けるために、追加の容量をライセンスすることを選択できます。
システムが適用するガードレール（ハード制限）
システムが適用するガードレールは、Real-Time CDP UI または API によって適用されます。 UI や API によってブロックされたり、エラーが返されたりするので、上限を超えることはできません。
アクティベーションの制限 activation-limits
次のガードレールは、宛先に対してリアルタイム顧客プロファイルデータをアクティブ化する際の推奨制限を提供します。
一般的なアクティベーションガードレール general-activation-guardrails
以下のガードレールは、通常、すべての宛先タイプを通してアクティベーションに適用されます。
1 つの宛先に対するオーディエンスの最大数
250
パフォーマンスガードレール
最大 250 個のオーディエンスをデータフローの 1 つの宛先にマッピングすることをお勧めします。
宛先に対して 250 を超えるオーディエンスをアクティブ化する必要がある場合は、次のいずれかを実行できます。
- アクティブ化しないオーディエンスのマッピングを解除する。または
- 新しいデータフローを目的の宛先に作成し、オーディエンスをこの新しいデータフローにマッピングします。
一部の宛先では、その宛先にマッピングされたオーディエンスの数が 250 人未満に制限される場合があることに注意してください。 これらの宛先は、ページの下の各セクションで呼び出されます。
宛先にマッピングされる属性の最大数
50
パフォーマンスガードレール
複数の宛先および宛先タイプの場合、書き出し用にマッピングするプロファイル属性および ID を選択できます。最適なパフォーマンスを得るには、最大 50 個の属性をデータフローで宛先にマッピングする必要があります。
宛先の最大数
100
システムが適用するガードレール
宛先に対してアクティブ化されるデータのタイプ
プロファイルデータ（ID および ID マップを含む）
システムが適用するガードレール
現在、宛先へ プロファイルレコード属性 の書き出しのみ可能です。イベントデータを記述する XDM 属性は、現時点では書き出しでサポートされていません。
宛先に対してアクティブ化されるデータのタイプ - 配列およびマップ属性のサポート
使用不可
システムが適用するガードレール
現時点では、
配列またはマップ属性 を宛先に書き出すことは
不可能 です。このルールの例外は、ストリーミングとファイルベースの両方のアクティベーションで書き出される
ID マップです。
ストリーミングのアクティベーション streaming-activation
以下のガードレールは、ストリーミングの宛先を通じたアクティベーションに適用されます。
1 秒あたりのアクティベーション数（プロファイル書き出しを含む HTTP メッセージ）
N/A
-
現在、パートナー宛先の API エンドポイントに Experience Platform から送信される 1 秒あたりのメッセージ数に制限はありません。
制限や待ち時間は、Experience Platform がデータを送信するエンドポイントによって決まります。また、データの接続とアクティベーションを行う宛先の
カタログページも確認するようにします。
バッチ（ファイルベース）のアクティベーション batch-file-based-activation
以下のガードレールは、バッチ（ファイルベース）の宛先を通じたアクティベーションに適用されます。
アクティベーションの頻度
1 日に 1 回、またはより頻繁な 3 時間、6 時間、8 時間、12 時間ごとに 1 回の増分書き出しを行います。
システムが適用するガードレール
特定の時間にエクスポート可能なオーディエンスの最大数
100
パフォーマンスガードレール
バッチ宛先データフローには、最大 100 個のオーディエンスを追加することをお勧めします。
アクティベートするファイルあたりの最大行数（レコード数）
500 万
システムが適用するガードレール
Adobe Experience Platform は、書き出したファイルを、ファイルあたり 500 万件のレコード（行）で自動的に分割します。各行は 1 つのプロファイルを表します。
filename.csv、
filename_2.csv、
filename_3.csv のように、分割ファイル名には、ファイルが大きな書き出しの一部であることを示す数字が付加されます。詳しくは、「バッチの宛先をアクティベート」チュートリアルの
スケジュールの節を参照してください。
アドホックアクティベーション ad-hoc-activation
以下のガードレールは、アドホックアクティベーションメソッドに適用されます。
アドホックアクティベーションジョブごとにアクティブ化されたオーディエンス
80
システムが適用するガードレール
現在、各アドホックアクティベーションジョブは、最大 80 人のオーディエンスをアクティブ化できます。 1 回のジョブで 80 を超えるオーディエンスをアクティブ化しようとすると、ジョブが失敗します。 この動作は、今後のリリースで変更される可能性があります。
オーディエンスごとの同時アドホックアクティベーションジョブ
1
システムが適用するガードレール
オーディエンスごとに複数の同時アドホックアクティベーションジョブを実行しないでください。
エッジパーソナライゼーションの宛先のアクティベーション edge-destinations-activation
以下のガードレールは、エッジパーソナライゼーションの宛先を通じたアクティベーションに適用されます。
10
パフォーマンスガードレール
データフローは、サンドボックスあたり 10 個のカスタムパーソナライゼーションの宛先に設定できます。
サンドボックスごとにパーソナライゼーションの宛先にマッピングされる属性の最大数
30
システムが適用するガードレール
サンドボックスごとに、データフローでパーソナライゼーションの宛先にマッピングできる属性は最大 30 個です。
50
パフォーマンスガードレール
1 つのAdobe Targetの宛先に対するアクティベーションフローで、最大 50 個のオーディエンスをアクティブ化できます。
データセットの書き出し dataset-exports
データセットのエクスポートは、現在、 最初にフルにしてから増分にしてください pattern. この節で説明するガードレール 最初のフルエクスポートに適用 これは、データセット書き出しワークフローの設定後に発生します。
データセットタイプ dataset-types
データセット書き出しガードレールは、次に示すように、Experience Platformから書き出される 2 種類のデータセットに適用されます。
XDM エクスペリエンスイベントスキーマに基づくデータセット
XDM Experience Events スキーマに基づくデータセットの場合、データセットスキーマには最上位レベルのが含まれます timestamp 列。 データは追加専用の方法で取り込まれます。
XDM 個別プロファイルスキーマに基づくデータセット
XDM 個別プロファイルスキーマに基づくデータセットの場合、データセットスキーマに最上位レベルは含まれません timestamp 列。 データはアップサート方式で取り込まれます。
以下のソフトガードレールは、Experience Platformから書き出されたすべてのデータセットに適用されます。 さらに、様々なデータセットや圧縮タイプに固有の、以下のハードガードレールも確認します。
書き出されたデータセットのサイズ
50 億レコード
パフォーマンスガードレール
ここで説明するデータセットエクスポートの制限は、次のとおりです。 ソフトガードレール. 例えば、ユーザーインターフェイスで 50 億レコードを超えるデータセットの書き出しがブロックされることはありませんが、動作は予測不可能で、書き出しに失敗したり、書き出しに非常に長い時間がかかる場合があります。
スケジュールされたデータセットエクスポートのガードレール
スケジュールされた、または繰り返しのデータセットエクスポートの場合、以下のガードレールは、エクスポートするファイルの 2 つの形式（JSON または parquet）で同じで、データセットタイプ別にグループ化されます。
JSON ファイルへの書き出しは、圧縮モードでのみサポートされます。
データセットタイプ
ガードレール
ガードレールのタイプ
説明
に基づくデータセット XDM エクスペリエンスイベントスキーマ
過去 365 日間のデータ
システムが適用するガードレール
過去の暦年のデータがエクスポートされます。
に基づくデータセット XDM 個別プロファイルスキーマ
データフロー内のすべての書き出しファイルの 100 億レコード
システムが適用するガードレール
データセットのレコード数は、圧縮 JSON ファイルまたは Parquet ファイルの場合は 100 億レコード未満、非圧縮 Parquet ファイルの場合は 100 万レコード未満にする必要があります。そうしないと、書き出しが失敗します。 書き出し対象のデータセットが許可されたしきい値を超える場合は、そのデータセットのサイズを小さくします。
詳細を表示： データセットの書き出し.
Destination SDK ガードレール destination-sdk-guardrails
Destination SDK は、Experience Platform の宛先統合パターンを設定し、選択したデータと認証形式に基づいて、オーディエンスとプロファイルのデータをエンドポイントに配信できるようにする設定 API のスイートです。以下のガードレールは、Destination SDK を使用して設定する宛先に適用されます。
5
パフォーマンスガードレール
Destination SDK を使用して、最大 5 つのプライベートカスタムストリーミングまたはバッチの宛先を作成できます。宛先を 5 つ以上作成する必要がある場合は、カスタムケア担当者にお問い合わせください。
Destination SDK のプロファイル書き出しポリシー
maxBatchAgeInSecs（最小 1.800、最大 3.600）maxNumEventsInBatch（最小 1.000、最大 10.000）
システムが適用するガードレール
「
設定可能な集計」オプションを使用する場合は、HTTP メッセージが API ベースの宛先に送信される頻度と、メッセージに含めるプロファイル数を決定する最小値と最大値に注意してください。
宛先のスロットルと再試行ポリシー destination-throttling-and-retry-policy
特定の宛先に対するしきい値や制限のスロットルの詳細。 また、この節では、宛先の再試行ポリシーに関する情報も提供します。
エンタープライズの宛先（HTTP API、Amazon Kinesis、Azure EventHubs）
Experience Platformは 95％の確率で、エンタープライズ宛先の各データフローにおいて、送信に成功したメッセージのスループット待ち時間を 10 分未満、リクエスト数を 1 秒あたり 10,000 件未満で提供しようと試みます。
エンタープライズ環境の宛先へのリクエストが失敗した場合、Experience Platform は失敗したリクエストを保存し、リクエストをエンドポイントに送信するために 2 回再試行します。
次の手順
その他のExperience Platformサービスガードレール、エンドツーエンドの遅延情報、およびReal-Time CDP製品説明ドキュメントのライセンス情報の詳細については、次のドキュメントを参照してください。