データアクティベーション用のガードレール

IMPORTANT
このガードレール ページに加えて、販売注文と対応する 製品説明でライセンスの使用権限を確認してください。

このページでは、アクティベーション動作に関するデフォルトの使用方法とレートの制限について説明します。次のガードレールを確認する際は、正しく宛先に接続されているとみなされます。

NOTE
  • ほとんどのお客様は、これらのデフォルトの上限を超えることはありません。カスタムの上限について詳しくは、カスタマーケア担当者にお問い合わせください。
  • このドキュメントで概要を説明する上限は、常に改善されています。 定期的にアップデートを確認してください。
  • 個々のダウンストリームの制限によっては、一部の宛先は、このページで説明するものよりも厳しいガードレールを持つ場合があります。また、接続してデータをアクティブ化する宛先のページのカタログを確認します。

ガードレール タイプ limit-types

このドキュメントでは、次の 2 種類のデフォルトの上限について説明します。

ガードレール タイプ
説明
パフォーマンスガードレール(ソフトリミット)
パフォーマンスガードレールは、ユースケースのスコーピングに関連する使用制限です。 パフォーマンスガードレールを超えると、パフォーマンスの低下や待ち時間が発生する場合があります。 Adobeは、このようなパフォーマンス低下に対する責任を負いません。 パフォーマンスのガードレールを常に超えるお客様は、パフォーマンスの低下を避けるために、追加容量のライセンスを選択できます。
システムで適用されるガードレール(ハードリミット)
システムに適用されたガードレールは、Real-Time CDP UI または API によって適用されます。 これらは、UI と API によってこれをブロックされるか、エラーを返すので、超えることはできない制限です。

アクティベーションの制限 activation-limits

次のガードレールは、宛先にリアルタイム顧客プロファイルデータをアクティブ化する際の推奨上限を示します。

一般的なアクティベーションガードレール general-activation-guardrails

以下のガードレールは、通常、すべての宛先タイプを通してアクティベーションに適用されます。

ガードレール
上限
上限のタイプ
説明
単一の宛先に対するオーディエンスの最大数
250
パフォーマンスガードレール

データフロー内の単一の宛先に最大 250 個のオーディエンスをマッピングすることをお勧めします。

宛先に対して 250 を超えるオーディエンスをアクティブ化する必要がある場合は、次のいずれかを実行できます。

  • アクティブ化をやめるオーディエンスのマッピングを解除する。または
  • 新しいデータフローを目的の宛先に作成し、オーディエンスをこの新しいデータフローにマッピングします。

一部の宛先では、その宛先にマッピングされたオーディエンスの数が 250 個未満に制限される場合があることに注意してください。 これらの宛先は、ページの下の各セクションで呼び出されます。

宛先にマッピングされる属性の最大数
50
パフォーマンスガードレール
複数の宛先および宛先タイプの場合、書き出し用にマッピングするプロファイル属性および ID を選択できます。最適なパフォーマンスを得るには、最大 50 個の属性をデータフローで宛先にマッピングする必要があります。
宛先の最大数
100
システムに適用されたガードレール
サンドボックスごとに、接続してデータをアクティブ化できる宛先を最大 100 個作成できます。 エッジパーソナライゼーションの宛先(カスタムパーソナライゼーション)は、100 件の推奨される宛先のうち、最大 10 件を構成できます。
宛先に対してアクティブ化されるデータのタイプ
プロファイルデータ(ID および ID マップを含む)
システムに適用されたガードレール
現在、宛先へ​ プロファイルレコード属性 ​の書き出しのみ可能です。イベントデータを記述する XDM 属性は、現時点では書き出しでサポートされていません。
宛先に対してアクティブ化されるデータのタイプ - 配列およびマップ属性のサポート
部分的に使用可能
システムに適用されたガードレール
配列属性を ファイルベースの宛先に書き出すことができます。 配列をターゲットファイルの文字列にフラット化するには、引き続き array_to_string 関数を使用する必要があります。 機能について 🔗 詳細を参照 。

現時点では、マップ属性​ を宛先に書き出すことは ​できません。 このルールの例外は、ストリーミングとファイルベースの両方のアクティベーションで書き出される 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.csvfilename_2.csvfilename_3.csv のように、分割ファイル名には、ファイルが大きな書き出しの一部であることを示す数字が付加されます。詳しくは、「バッチの宛先をアクティベート」チュートリアルのスケジュールの節を参照してください。

アドホックアクティベーション ad-hoc-activation

以下のガードレールは、アドホックアクティベーションメソッドに適用されます。

ガードレール
上限
上限のタイプ
説明
アドホックアクティベーションジョブごとにアクティベートされたオーディエンス
80
システムに適用されたガードレール
現在、各アドホックアクティベーションジョブは、最大 80 個のオーディエンスをアクティベートできます。 1 つのジョブにつき 80 個を超えるオーディエンスをアクティベートしようとすると、ジョブが失敗します。 この動作は、今後のリリースで変更される可能性があります。
オーディエンスごとの同時アドホックアクティベーションジョブ
1
システムに適用されたガードレール
オーディエンスごとに複数の同時アドホックアクティベーションジョブを実行しないでください。

エッジパーソナライゼーションの宛先のアクティベーション edge-destinations-activation

以下のガードレールは、エッジパーソナライゼーションの宛先を通じたアクティベーションに適用されます。

ガードレール
上限
上限のタイプ
説明
カスタムパーソナライゼーションの宛先の最大数
10
パフォーマンスガードレール
データフローは、サンドボックスあたり 10 個のカスタムパーソナライゼーションの宛先に設定できます。
サンドボックスごとにパーソナライゼーションの宛先にマッピングされる属性の最大数
30
システムに適用されたガードレール
サンドボックスごとに、データフローでパーソナライゼーションの宛先にマッピングできる属性は最大 30 個です。
1 つの Adobe Target の宛先にマッピングされるオーディエンスの最大数
50
パフォーマンスガードレール
1 つのAdobe Targetの宛先に対して、アクティベーションフローで最大 50 個のオーディエンスをアクティブ化できます。

データセットの書き出し dataset-exports

データセットの書き出しは現在、最初の完全かつ増分 パターンでサポートされています。 この節で説明しているガードレールは データセット書き出しワークフローの設定後に発生する 最初の完全書き出しに適用される)。

データセットタイプ dataset-types

データセット書き出しガードレールは、以下に説明するように、Experience Platformから書き出された 2 種類のデータセットに適用されます。

XDM エクスペリエンスイベントスキーマに基づくデータセット
XDM エクスペリエンスイベントスキーマに基づくデータセットの場合、データセットスキーマには最上位の timestamp 列が含まれます。 データは、追加専用で取り込まれます。

XDM 個人プロファイルスキーマに基づくデータセット
XDM 個人プロファイルスキーマに基づくデータセットの場合、データセットスキーマには最上位の timestamp 列が含まれません。 データはアップサート方式で取り込まれます。

以下のソフトガードレールは、Experience Platformから書き出されたすべてのデータセットに適用されます。 様々なデータセットと圧縮タイプに固有の、後述するハードガードレールも確認してください。

ガードレール
上限
上限のタイプ
説明
書き出されたデータセットのサイズ
50 億件のレコード
パフォーマンスガードレール
ここで説明するデータセット書き出しの制限は ソフトガードレール です。 例えば、ユーザーインターフェイスでは 50 億レコードを超えるデータセットの書き出しはブロックされませんが、動作は予測できず、書き出しが失敗したり、非常に長い書き出し待ち時間が発生したりする場合があります。

スケジュールされたデータセット書き出しのガードレール

スケジュール設定された、または繰り返しデータセットの書き出しの場合、以下のガードレールは、書き出されたファイル(JSON または parquet)の 2 つの形式と同じで、データセットタイプごとにグループ化されています。

WARNING
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 Product Description のドキュメントからのライセンス情報について詳しくは、次のドキュメントを参照してください。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6