Platform Fair Usage Guidelines
Platform Fair Usage Guidelines
Our platform is engineered to operate at an enterprise scale while delivering consistent real-time performance and reliability across all applications. To help you design and build optimized solutions, we establish these Fair Usage Guidelines.
These guidelines represent best-practice advisory thresholds based on typical high-performance architectures. They are designed to:
- Ensure stable platform performance and exceptional response times.
- Maintain consistent, high-availability service levels across all customer integrations.
- Outline expected data-model structures at scale.
- Assist developers in avoiding unexpected latency or edge-case behavior during high transaction loads.
Unless otherwise noted, these guidelines are intended as advisory recommendations to steer implementation design. If your specific application or promotional campaign structure anticipates volumes beyond these recommended guidelines, we encourage you to engage your Account Manager to discuss your requirements.
1. Wallets, Identities, and Accounts
| Optimization Area | Recommended Advisory Guideline |
|---|---|
| Wallets per Company Unit | Up to 100 million consumer Wallets per Unit. |
| Identities per Wallet | Up to 50 Identities per Wallet. |
| Active Accounts per Wallet | Up to 50 active accounts concurrently attached to a Wallet. |
| Total Accounts per Wallet | Fewer than 2,000 total accounts (inclusive of expired, cancelled, or historical Accounts) per wallet. |
2. Smart Checkout Transaction Processing
| Optimization Area | Recommended Advisory Guideline |
|---|---|
| Basket Line Item Counts | Fewer than 200 item lines per basket array payload in an Open API call. |
| Active Open Mode Campaigns | Up to 1,000 basket-level and 1,000 product-level open Campaigns. |
| Active Targeted Mode Campaigns | Up to 300 active targeted campaigns. |
3. Company Unit and Programme Setup
| Optimization Area | Recommended Advisory Guideline |
|---|---|
| Products per Campaign | Fewer than 100,000 total listed products (UPCs) per Campaign (across all Redemption Partners). |
| Units (Outlets) | Fewer than 1,000 outlets per Unit. |
| Loyalty Tiers | Fewer than 10 tiers per membership structure. |
| Audiences | Fewer than 1,000 audiences. |
| Wallets per Audience | Up to 50 million wallets per audience. |
4. Metadata
| Optimization Area | Recommended Advisory Guideline |
|---|---|
| Customer-Created Metadata | Up to 10 custom attributes/fields per entity object type. |
5. Data Ingestion
| Optimization Area | Recommended Advisory Guideline |
|---|---|
| Product Ingestion Files | Fewer than 10 million records per ingestion. |
| Recommendation Ingestion Files | Fewer than 500 million records per ingestion. |
Technical Impacts of Operating Outside Guidelines
Customers operating consistently beyond published fair usage guidelines may experience:
- Decreased real-time API response throughput or elevated latency times.
- Minor delays in processing.
- Limitations in Offer qualification or evaluation
We recognise that some enterprise use cases require non-standard scale or configuration. Where this is the case, exceptions may be considered subject to technical review and agreement.
Please contact your Account Manager if you believe your implementation may exceed any of the guidelines outlined above.