API トリガーキャンペーンの高スループットモードのアクティブ化 high-throughput

このページ: API トリガーのキャンペーンに対して高スループットモードを有効にすると、プロファイルに依存することなく、1秒あたり最大5000 トランザクションで非常に大規模なリアルタイムのトランザクションメッセージ(電子メールとプッシュ)を送信できます。

高スループットモードは、非常に大規模なリアルタイムのトランザクションメッセージ (1秒あたり最大5000 トランザクション)が必要な組織向けに設計されています。 通常のAPI トリガー型キャンペーンとは異なり、高スループットキャンペーンはAdobe プロファイルとは独立して動作し、別の設定モデルを必要とします。

このページでは、高スループットキャンペーンと標準的なAPI トリガーキャンペーンの違い、設定の要件、各モードを選択するタイミングについて説明します。

ガードレールと制限 guardrails

  • アクセス - スイスを除くすべての地域で、高スループットトランザクションメッセージングアドオンを使用してライセンスを取得した組織で利用できます。

  • チャネル:メールとプッシュ通知。

  • ハイスループットキャンペーンの​Personalization:

  • ハイスループットチャネル設定の​Personalization – 高スループットチャネル設定では、not​はコンテクストまたはプロファイルベースのパーソナライゼーションをサポートします。

  • 一致するリソース – 高スループットキャンペーン、チャネル設定、およびIP プールは、相互にのみ使用できます。 標準リソースと高スループットリソースは混在できません。

  • API エンドポイント – 高スループットキャンペーンは、標準のAPI トリガーキャンペーンとは異なるエンドポイントを使用します。 詳しくは、API トリガーキャンペーンの実行を参照してください。

  • キャンペーンの排他性 - 高スループットキャンペーンでは、アドビのプロファイルは使用されません。 プロファイルが存在するかどうかに関係なく、メッセージは配信されます。

    さらに、キャンペーンは、プロファイル対応とプロファイル以外の両方のユースケースに使用できません。 両方が必要な場合は、2 つの個別のキャンペーンを作成し、コンテキストに基づいてトリガーするキャンペーンを呼び出し元のシステムが決定するようにします。

  • フィードバックとトラッキング用のデータセット - ハイスループットキャンペーンのフィードバックとトラッキングのデータは、プロファイルに対して有効になっていない専用データセットに保存されます。 その結果、一致するプロファイルが存在する場合でも、これらのイベントはプロファイルにステッチされません。

    使用されるデータセットは次のとおりです。

    • AJO メッセージフィードバックイベントデータセット - プロファイル以外 - メールとプッシュフィードバックの両方に使用されます。
    • AJO メールトラッキングエクスペリエンスイベントデータセット - プロファイル以外 - メールトラッキングにのみ使用されます。 プッシュ用のプロファイル以外の専用トラッキングデータセットはまだ使用できません。
  • スループット割り当て – 高スループットアドオンの下でプロビジョニングされたスループットは、高スループットキャンペーン専用です。 API トリガーによる標準的なキャンペーンと高スループットのキャンペーンの間でスループットが共有されることはありません。

  • サポートされていない機能:

  • プッシュ通知:

    • Web プッシュ – 高スループット web プッシュ キャンペーンは共有インフラストラクチャ上で実行され、高スループット モバイル プッシュ用に確保されている専用の容量のメリットを受けません。
    • ペイロードサイズ - 最大ペイロードサイズは 5 KB です。
    • ブロックリストの動作 - メッセージがブロックリストにヒットした場合、配信に関するフィードバックは保持されますが、プロファイルの更新に関するフィードバックは生成されません。 つまり、ブロックリストへの登録に伴う応答は、Adobe Experience Platform でのプロファイルの更新やトークンの無効化をトリガーしません。

標準のキャンペーンと高スループットキャンペーンの選択

次の表を使用して、ユースケースに適合するAPI トリガーのキャンペーンタイプを決定します。

機能/要件
標準API トリガーキャンペーン
ハイスループットキャンペーン
対象
基本製品に含まれます
高スループットトランザクションメッセージアドオンが必要です。
スループット
1 秒あたり最大 500 トランザクション
1 秒あたり最大 5,000 トランザクション
チャネル
電子メール、モバイルメッセージ、プッシュ通知
メール、プッシュ
パーソナライゼーション
API ペイロード内のプロファイル + コンテキスト
API ペイロード内のコンテキストのみ
プロファイルとステッチ
プロファイルにステッチされたイベントが存在するか、作成されます
プロファイルなし
メッセージボリューム
標準の使用権限とメッセージパック
個別の階層化されたメッセージボリューム
インフラストラクチャ
スタンダード
拡張
稼動時間
99.9%
99.99%
ヘルスチェック API
○
○

つまり、次のようになります。

  • 次の場合は、標準API トリガー キャンペーンを選択します。

    • 高いスループットは契約されていません。
    • スループットのニーズが 500 TPS未満である。
    • Adobe Profiles に基づくパーソナライゼーションが必要である。
    • 今後のターゲティングのために、キャンペーンデータをプロファイルにステッチする必要がある。
    • メールやプッシュ以外のチャネルを使用する必要がある。
  • 次の場合は、高スループット​キャンペーンを選択します。

    • 500 TPS を超えるスループットが必要である。
    • プロファイルのステッチが不要である。
    • すべてのパーソナライゼーションを API ペイロードで渡すことができる。
    • メールやプッシュのチャネルを使用する必要がある。

高スループット API トリガーキャンペーンの設定 configure-high-throughput

の前提条件を満たしたら、両方のチャネルの製品UIで高スループットを設定できます。

  • 電子メール:専用の高スループット IP プールを作成してから、それを使用する高スループット電子メールチャネル設定を作成します。 詳細情報
  • プッシュ:高スループット プッシュ チャネル設定を作成します。 詳細情報
CAUTION
高スループットチャネル設定(およびメールの場合はIP プール)は、高スループット API トリガーキャンペーンでのみ使用できます。 作成後にタイプを変更することはできません。標準リソースを高スループットに変換することはできません。その逆も同様です。

前提条件 prerequisite

高スループットのトランザクションメッセージ アドオンを購入した後、Adobe カスタマーケアまたはAdobe担当者に連絡して、必要なバックエンドアクティベーション を完了できるようにします。

NOTE
この操作は、各チャネル設定に対してではなく、1回だけ実行する必要があります。

API トリガーによる高スループットなメールキャンペーンの設定 setup-guidelines

高スループットメールキャンペーンを設定するには、次の手順に従います。

専用IP プールの作成 create-ip-pool

高いスループットを実現するには、専用のIP プールが必要です。これは、2つの地域で高い可用性とパフォーマンスを維持するために構築されているためです。

ハイスループットアドオンを購入すると、送信IPは、プライマリリージョンで割り当てられたIPに加えて、セカンダリリージョンでプロビジョニングされます。

  • フェールオーバー - プライマリ領域が使用できなくなった場合、すべての高スループットトラフィックは自動的にセカンダリ領域に切り替わるので、トランザクションメッセージは引き続き配信されます。
  • IP ウォームアップ - セカンダリ領域のIPが必要なときに準備されていることを確認するために、高スループットトラフィックの一部がセカンダリ領域を通じて継続的にルーティングされます。 このIPは暖かいです。 送信履歴のないIP アドレスから送信すると、インターネットサービスプロバイダー(ISP)が電子メールを拒否する可能性があります。

次のようにIP プールを作成します。

  1. IP プールを作成します。 詳細情報

  2. 「ハイスループットを有効にする」オプションを選択します。

  3. 専用IP プール用の1つ以上のセカンダリ リージョン IPを選択します。 これにより、高スループットトラフィックの高可用性が保証されます。

    「ハイスループットを有効にする」オプションが選択された IP プール作成画面

専用IP プールは、高スループットチャネル設定で使用できるようになりました。

高スループットのメールチャネル設定の作成 configuration-guidelines

  1. 電子メール チャネル設定を作成します。 詳細情報

  2. 「メール設定」で「トランザクション」電子メールタイプを選択します。

  3. 「高スループットとして作成」切り替えを有効にします。

    高スループット電子メールチャネル設定

  4. 「IP プールの詳細」セクションで、作成した高スループット IP プールを選択します。 高スループット IP プールのみが一覧表示されます。

  5. チャネル設定を送信します。

これで、高スループットのメールチャネル設定は、高スループット API トリガーキャンペーンで使用できるようになりました。

NOTE
高スループット API トリガーのメールキャンペーンを作成する場合、選択できるのは高スループットチャネル設定のみです。

高スループットプッシュ施策の設定 setup-push

電子メールと同様に、インターフェイスで直接、自分でプッシュするための高スループットを設定できます。 これを行うには、以下の手順に従います。

  1. プッシュ チャネル設定を作成します。 詳細情報

  2. 「高スループットとして作成」切り替えを有効にします。

    高スループット プッシュ チャネル設定 {width="80%"}

  3. プッシュ設定のプラットフォームと対応するアプリ IDを選択します。

    note
    NOTE
    高スループット切り替えが有効になっている場合、​ プッシュアプリ ID パーソナライゼーション ​は使用できません。
  4. チャネル設定を送信します。

高スループット プッシュ チャネル設定は、高スループット API トリガーのキャンペーンで使用できるようになりました。

NOTE
高スループット API トリガーのプッシュキャンペーンを作成する場合、選択できるのは高スループットチャネル設定のみです。
AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how High throughput mode for API triggered campaigns differs from standard API triggered campaigns, its guardrails and setup requirements, and when to choose each mode for very large-scale, real-time transactional messages (email and push) without relying on profiles.

Intents:

  • Decide between a standard API triggered campaign and a High throughput campaign
  • Know the guardrails and limitations of High throughput campaigns
  • Set up High throughput campaigns: a dedicated IP pool and a channel configuration for email, a channel configuration for push
  • Know how to personalize a High throughput campaign (contextual data only)
  • Know which datasets store feedback and tracking data for High throughput campaigns

Glossary:

  • High throughput mode (also written High Throughput): A mode of API triggered campaigns designed for very large-scale, real-time transactional messaging, which operates independently of Adobe Profiles (product-specific)
  • Standard API triggered campaign: An API triggered campaign that is not in High throughput mode
  • High Throughput transactional messaging add-on: The add-on that organizations must be licensed with to use High throughput campaigns (product-specific)
  • Contextual data: Personalization data passed in the API payload
  • AJO Message Feedback Event Dataset - Non Profile: Dataset used for both email and push feedback of High throughput campaigns
  • AJO Email Tracking Experience Event Dataset - Non Profile: Dataset used for email tracking only of High throughput campaigns

Guardrails:

  • Throughput: High throughput campaigns support up to 5000 transactions per second; standard API triggered campaigns support up to 500 transactions per second.
  • Channels: Email and push notifications for High throughput campaigns.
  • Personalization: all personalization must be included in the API payload as contextual data. Profile-based personalization is not supported, and validation errors occur if profile variables are used.
  • Channel configurations that use profile-based personalization cannot be used with High throughput campaigns. Only channel configurations without profile personalization can be used.
  • High throughput campaigns use a different API endpoint than standard API triggered campaigns.
  • High throughput campaigns do not use Adobe Profiles. Messages are delivered whether or not a profile exists.
  • A campaign cannot be used for both profile-enabled and non-profile use cases. If you need both, create two separate campaigns, and make the calling system decide which one to trigger based on the context.
  • Feedback and tracking data for High throughput campaigns are stored in dedicated datasets that are not enabled for profiles, so these events are not stitched to profiles, even if a matching profile exists. A dedicated non-profile tracking dataset for push is not yet available.
  • The throughput provisioned under the High Throughput add-on is exclusively reserved for High throughput campaigns. There is no sharing of throughput between standard and High throughput API triggered campaigns.
  • Personalized PDF attachments are not supported when a High throughput campaign fails over to another region.
  • Web push: High Throughput web push campaigns run on shared infrastructure and do not benefit from the dedicated capacity reserved for High Throughput mobile push.
  • Push payload size: the maximum payload size is 5 KB (hard limit).
  • Denylist behavior for push: when a message hits a denylist, delivery feedback is retained but no profile-update feedback is produced, so denylist responses do not trigger profile updates or token invalidation in Adobe Experience Platform.
  • High throughput channel configurations (and, for email, IP pools) can only be used with High throughput API triggered campaigns, and not with standard transactional messaging using API triggered campaigns or journeys.
  • The type of a channel configuration or IP pool cannot be changed after creation: a standard resource cannot be converted to High throughput, and vice versa.
  • Push App id personalization is not available in High throughput push channel configurations.
  • When creating a High throughput API triggered campaign, only High throughput channel configurations are available for selection.

Prerequisites and permissions:

  • The organization must be licensed with the High Throughput transactional messaging add-on.
  • A one-time backend activation after purchasing the add-on, requested through Adobe Customer Care or your Adobe representative (not needed for each channel configuration).
  • Email: a new dedicated High throughput IP pool, and a new email channel configuration with the Create as a High throughput configuration toggle enabled that uses this IP pool.
  • Push: a new push channel configuration with the Create as a High throughput configuration toggle enabled, with the platform(s) and App id(s) selected. No IP pool is needed.

Applicability:

  • Access: available across all regions except Switzerland.
  • Applies to API triggered campaigns, in High throughput mode.

Terminology:

  • Canonical name: High throughput mode — variants: High Throughput mode, High throughput campaigns
  • Acronym: TPS — transactions per second (used on the page body)
  • Do not confuse: “Standard API triggered campaign” (included in the base offering, standard entitlement and message packs, standard infrastructure, uptime 99,9%) ≠ “High throughput campaign” (requires the High Throughput transactional messaging add-on, separate tiered message volumes, enhanced infrastructure, uptime 99,99%); both have a health check API

FAQ:

  • Q: When should I choose a standard API triggered campaign? — When you do not have High Throughput contracted, your throughput needs are under 500 TPS, you require personalization based on Adobe Profiles, you want campaign data stitched to profiles for future targeting, or you want to use another channel than Email or Push.
  • Q: When should I choose a High throughput campaign? — When you need throughput over 500 TPS, you do not require profile stitching, you can pass all personalization in the API payload, and you want to use the Email or Push channel.
  • Q: Can a High throughput campaign use profile attributes for personalization? — No. Profile-based personalization is not supported, and validation errors occur if profile variables are used. Pass all personalization as contextual data in the API payload.
  • Q: Can one campaign serve both profile-enabled and non-profile use cases? — No. Create two separate campaigns, and make the calling system decide which one to trigger.
  • Q: Is throughput shared between standard and High throughput campaigns? — No. The throughput provisioned under the High Throughput add-on is exclusively reserved for High throughput campaigns.
  • Q: How do I set up High throughput campaigns? — Both email and push can be self-configured in the UI. For email, create a dedicated High throughput IP pool, then create a channel configuration with the Create as a High throughput configuration toggle enabled and select that IP pool. For push, create a push channel configuration with the toggle enabled and select the platform(s) and App id(s); no IP pool is needed. App id personalization is not available for High throughput push.

Related pages:

  • Personalizing content with contextual data: Learn how to personalize content using contextual data (campaigns/api-triggered-campaign-content.md#contextual)
  • Endpoint used by High throughput campaigns: Execute an API triggered campaign (campaigns/trigger-campaigns.md#trigger)
  • Channel configurations with profile-based personalization: profile-based personalization (email/surface-personalization.md)
  • Personalized PDF attachments: Learn more about personalized PDF attachments (email/pdf-attachments.md#personalized-attachments)
  • Create IP pools: Learn how to create IP pools (configuration/ip-pools.md)
  • Set up channel configurations: Learn how to set up channel configurations (configuration/channel-surfaces.md)
  • Set up push channel configurations: Learn how to create a push channel configuration (push/push-configuration.md#message-preset)
  • Push App id personalization: Learn about push App id personalization (push/push-configuration.md#app-id-personalization)

Personas:

  • developer: Can pass all personalization for High throughput campaigns as contextual data in the API payload. Can call a different API endpoint than the one used for standard API triggered campaigns. Can use the AJO Message Feedback Event Dataset - Non Profile and the AJO Email Tracking Experience Event Dataset - Non Profile for feedback and tracking. The page states that profile variables cause validation errors, and push payload size is limited to 5 KB. Where: “Guardrails & limitations”.

Onboarding:

  • Level: Experienced
  • First minimal step: Create a new IP pool.
  • Success check: The page states a Health check API is available for the High Throughput Campaign.
  • Next: Learn how to personalize content using contextual data: Edit the API triggered campaign content (campaigns/api-triggered-campaign-content.md); Learn how to set up channel configurations: Set up channel configurations (configuration/channel-surfaces.md)
recommendation-more-help
journey-optimizer-help