データアクティベーション用のガードレール
このページでは、アクティベーション動作に関するデフォルトの使用方法とレートの制限について説明します。次のガードレールを確認する際は、正しく宛先に接続されているとみなされます。
- ほとんどのお客様は、これらのデフォルトの上限を超えることはありません。カスタムの上限について詳しくは、カスタマーケア担当者にお問い合わせください。
- このドキュメントで概要を説明する上限は、常に改善されています。 定期的にアップデートを確認してください。
- 個々のダウンストリームの制限によっては、一部の宛先は、このページで説明するものよりも厳しいガードレールを持つ場合があります。また、接続してデータをアクティブ化する宛先のページのカタログを確認します。
ガードレール タイプ limit-types
このドキュメントでは、次の 2 種類のデフォルトの上限について説明します。
アクティベーションの制限 activation-limits
次のガードレールは、宛先にリアルタイム顧客プロファイルデータをアクティブ化する際の推奨上限を示します。
一般的なアクティベーションガードレール general-activation-guardrails
以下のガードレールは、通常、すべての宛先タイプを通してアクティベーションに適用されます。
データフロー内の単一の宛先に最大 250 個のオーディエンスをマッピングすることをお勧めします。
宛先に対して 250 を超えるオーディエンスをアクティブ化する必要がある場合は、次のいずれかを実行できます。
- アクティブ化をやめるオーディエンスのマッピングを解除する。または
- 新しいデータフローを目的の宛先に作成し、オーディエンスをこの新しいデータフローにマッピングします。
一部の宛先では、その宛先にマッピングされたオーディエンスの数が 250 個未満に制限される場合があることに注意してください。 これらの宛先は、ページの下の各セクションで呼び出されます。
array_to_string
関数を使用する必要があります。 機能について 🔗 詳細を参照 。現時点では、マップ属性 を宛先に書き出すことは できません。 このルールの例外は、ストリーミングとファイルベースの両方のアクティベーションで書き出される ID マップです。
ストリーミングのアクティベーション streaming-activation
以下のガードレールは、ストリーミングの宛先を通じたアクティベーションに適用されます。
制限や待ち時間は、Experience Platform がデータを送信するエンドポイントによって決まります。また、データの接続とアクティベーションを行う宛先のカタログページも確認するようにします。
バッチ(ファイルベース)のアクティベーション batch-file-based-activation
以下のガードレールは、バッチ(ファイルベース)の宛先を通じたアクティベーションに適用されます。
filename.csv
、filename_2.csv
、filename_3.csv
のように、分割ファイル名には、ファイルが大きな書き出しの一部であることを示す数字が付加されます。詳しくは、「バッチの宛先をアクティベート」チュートリアルのスケジュールの節を参照してください。アドホックアクティベーション ad-hoc-activation
以下のガードレールは、アドホックアクティベーションメソッドに適用されます。
エッジパーソナライゼーションの宛先のアクティベーション edge-destinations-activation
以下のガードレールは、エッジパーソナライゼーションの宛先を通じたアクティベーションに適用されます。
データセットの書き出し dataset-exports
データセットの書き出しは現在、最初の完全かつ増分 パターンでサポートされています。 この節で説明しているガードレールは データセット書き出しワークフローの設定後に発生する 最初の完全書き出しに適用される)。
データセットタイプ dataset-types
データセット書き出しガードレールは、以下に説明するように、Experience Platformから書き出された 2 種類のデータセットに適用されます。
XDM エクスペリエンスイベントスキーマに基づくデータセット
XDM エクスペリエンスイベントスキーマに基づくデータセットの場合、データセットスキーマには最上位の timestamp 列が含まれます。 データは、追加専用で取り込まれます。
XDM 個人プロファイルスキーマに基づくデータセット
XDM 個人プロファイルスキーマに基づくデータセットの場合、データセットスキーマには最上位の timestamp 列が含まれません。 データはアップサート方式で取り込まれます。
以下のソフトガードレールは、Experience Platformから書き出されたすべてのデータセットに適用されます。 様々なデータセットと圧縮タイプに固有の、後述するハードガードレールも確認してください。
スケジュールされたデータセット書き出しのガードレール
スケジュール設定された、または繰り返しデータセットの書き出しの場合、以下のガードレールは、書き出されたファイル(JSON または parquet)の 2 つの形式と同じで、データセットタイプごとにグループ化されています。
詳しくは、 データセットの書き出しを参照してください。
Destination SDK ガードレール destination-sdk-guardrails
Destination SDK は、Experience Platform の宛先統合パターンを設定し、選択したデータと認証形式に基づいて、オーディエンスとプロファイルのデータをエンドポイントに配信できるようにする設定 API のスイートです。以下のガードレールは、Destination SDK を使用して設定する宛先に適用されます。
maxBatchAgeInSecs
(最小 1,800、最大 3,600)maxNumEventsInBatch
(最小 1,000、最大 10,000)
宛先のスロットルと再試行ポリシー destination-throttling-and-retry-policy
特定の宛先に対するしきい値や制限のスロットルの詳細。 また、この節では、宛先の再試行ポリシーに関する情報も提供します。
エンタープライズ環境の宛先へのリクエストが失敗した場合、Experience Platform は失敗したリクエストを保存し、リクエストをエンドポイントに送信するために 2 回再試行します。
次の手順
他のExperience Platformサービスのガードレール、エンドツーエンドの待ち時間の情報およびReal-Time CDP Product Description のドキュメントからのライセンス情報について詳しくは、次のドキュメントを参照してください。