Engine Endpoint Configuration
Overview
The SDK allows configuration of the engine endpoint using the engineHostName field in the Account object.
If not explicitly provided, the SDK automatically falls back to a default endpoint for optimal performance and routing.
Configuration
Default Behavior
If engineHostName is not set, null, or empty, the SDK uses:
engine.monetate.net
Custom Configuration
You can override the default endpoint by setting engineHostName:
Account account = new Account();
account.setDomain(""); // Domain name
account.setName(""); // Account name
account.setInstance(""); // Instance for the domain
account.setShortname(""); // Short name for the account
account.setEngineHostName("")// Optional: Override engine endpoint- Provide only the host name (e.g., engine.monetate.net)
- Do not include protocol (https://)
- The SDK automatically applies https .
- If the value is null or empty, the default endpoint is used
🌍 Available Endpoints
Recommended (Default & Global)
- engine.monetate.net → Default (Akamai + nearest AWS region)
- engine-global.monetate.net → Direct routing to nearest AWS region (bypasses Akamai)
🌐 Region-Specific Endpoints (Advanced Use Cases)
- engine-us-east-1.monetate.net
- engine-us-west-2.monetate.net
- engine-eu-west-1.monetate.net
Use these when:
- Your infrastructure is hosted in a specific AWS region
- You require strict control over routing or data residency
⚠️ Legacy Endpoint
- api.monetate.net
This is a legacy endpoint and is not recommended for new integrations.
Usage Scenarios
Default (Recommended)
If no engineHostName is configured:
https://engine.monetate.net
Global Routing
account.setEngineHostName("engine-global.monetate.net");
Requests are sent to:
https://engine-global.monetate.net
Region-Specific Routing
account.setEngineHostName("engine-us-west-2.monetate.net");
Requests are sent to:
https://engine-us-west-2.monetate.net
Summary
- Default endpoint: engine.monetate.net
- Can be overridden via engineHostName
- Supports global and region-specific routing
- SDK handles protocol and URL construction internally