Skip to content
adscapi

Amazon Ads CAPI Payload Preview

The server-side request adscapi builds when you track() a purchase and Amazon Ads is configured. Secrets and hashed values show as placeholders.

Request

POST
Endpoint
https://advertising-api.amazon.com/accounts/{AMAZON_ADS_ADVERTISER_ID}/dsp/conversionDefinitions/eventData
Headers
Authorization: Bearer {AMAZON_ADS_TOKEN}
Content-Type: application/json
Body (purchase example)
{
  "source": "SERVER_TO_SERVER",
  "eventData": [
    {
      "name": "OFF_AMAZON_PURCHASES",
      "conversionDefinitionID": "amzn-conversion-definition-123",
      "clientDedupeId": "order_1001",
      "timestamp": "2025-02-13T13:20:00.000Z",
      "value": 49.99,
      "currency": "USD"
    }
  ]
}

Verified against the library dispatcher (src/dispatchers/amazon.ts). See the Amazon Ads setup guide for where to get each secret.

Required secrets

AMAZON_ADS_ADVERTISER_IDAMAZON_ADS_TOKEN

Amazon Ads activates when every secret is present. One missing key and the platform no-ops — the rest still receive the event.

Event-name mapping

Canonical eventAmazon Ads receives
page_viewPAGE_VIEW
leadLEAD
signup_startsignup_start (custom event passthrough)
signupSIGN_UP
checkout_createdCHECKOUT
purchaseOFF_AMAZON_PURCHASES
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • conversionDefinitionID must be supplied per event as properties.amazon_conversion_definition_id; without it the dispatcher skips the send entirely.
  • The dispatcher computes hashed email/phone but never attaches them — the payload carries no user identity fields.
  • timestamp is an ISO 8601 string; clientDedupeId is the transaction id (falls back to eventId plus current time).

Frequently Asked Questions

Related Tools

Discover more free tools to fix your tracking

Event Payload Playground

Pick a canonical conversion event, fill the fields, and see the exact JSON payload adscapi builds — before you write a line of code.

Try it now

PII Hash Previewer

Type a raw email or phone number and see the normalized value plus its SHA-256 hash — the exact rules adscapi applies per platform. Nothing leaves the browser.

Try it now

Platform Coverage Explorer

Search all 26 ad platforms adscapi dispatches to — support level, required secrets, and setup docs, always in sync with the library registry.

Try it now

Ready to track Amazon Ads conversions server-side?

adscapi is free and open source. Set your platform tokens, call track() once, and every configured Conversions API receives the event — hashed the way each platform expects.

Get startednpm install adscapi