DestinationsAd destinations

Admitad

Forward purchase and lead events from Ours Privacy to Admitad via the s2s postback URL so publishers receive accurate commission credit.

Admitad

Admitad (now Mitgo) is a global affiliate network. This destination sends server-to-server conversion postbacks to https://ad.admitad.com/r so Admitad can credit the originating publisher when one of your customers converts.

Server-side postbacks are the recommended integration mode for Admitad: they avoid browser cookie loss, ad-blocker drop-off, and the ITP/cross-domain tracking penalties Admitad applies to client-side pixels.

How attribution works

  1. A publisher (affiliate) sends a user to your site through an Admitad-tracked link.
  2. Admitad attaches a click identifier (admitad_uid) to the landing URL.
  3. The Ours Privacy SDK reads admitad_uid from the URL and stores it on the visitor (default cookie window: 395 days, matching Admitad's recommendation).
  4. When the visitor converts (e.g. completes an order), Ours Privacy sends a postback to Admitad with the stored uid plus order metadata.
  5. Admitad uses uid to look up the originating click and credits the right publisher.

If uid is missing on a conversion event the dispatch is skipped with a logged reason — sending an unattributable hit would only inflate your "no source" bucket in Admitad reporting.

Configuring Admitad

In the Ours Privacy dashboard, click DestinationsAdd destinationAdmitad (Mitgo).

Required settings

SettingDescription
Campaign CodeYour Admitad program identifier. From the advertiser dashboard: Programs › Integration › Custom integration › Postback.
Postback KeyStatic security token issued per program. Stored encrypted; never displayed after save.
Default Action CodeAdmitad target-action identifier (e.g. 1 = sale, 2 = lead). Used when an event mapping does not provide its own action code.

Optional settings

SettingDescription
Default Tariff CodeRate code used when an event mapping does not override it. Defaults to 1.
Default Payment TypeConstant Admitad expects. Defaults to sale. Only change if your Admitad program manager has instructed otherwise.

Default event mapping

The Admitad destination ships with mappings grouped by purpose so each field's role is obvious:

Attribution

FieldRequiredDefault mappingDescription
Admitad Click ID (uid)Yesevent.default_properties.admitad_uidThe click identifier captured on landing. Without it Admitad cannot attribute the conversion.
Action Code OverrideNoempty (uses Default Action Code)Per-event override — use it when the same destination handles both sales and leads.
Tariff Code OverrideNoempty (uses Default Tariff Code)Per-event override — use when the program uses different rate cards by SKU or customer type.
Payment Type OverrideNoempty (uses Default Payment Type)Per-event override of the payment_type constant.

Order details

FieldRequiredDefault mappingDescription
Order IDYesevent.event_properties.order_idYour internal order/transaction ID. Admitad uses this as the dedup key — retries with the same order_id are safe.
Order Value (price)Noevent.event_properties.valuePost-discount, pre-tax subtotal. Period decimal separator (199.99); no thousand separators.
Currency CodeNoevent.event_properties.currencyISO 4217 (USD, EUR, GBP). Strongly recommended whenever Order Value is set — Admitad otherwise assumes program native currency.
PromocodeNoevent.event_properties.couponCoupon code applied to the order. Used for promocode-based attribution and reconciliation.

Customer data

FieldRequiredDefault mappingDescription
Client IDNovisitor.external_idStable customer identifier. Admitad uses it for new-vs-returning splits.
Country CodeNovisitor.countryISO 3166-1 alpha-2 country (US, DE). Used for geo-targeted commission rates.
CityNovisitor.cityPlain-text city. Reporting-only.

Product details

Use these only when your Admitad program pays per-product commission or you need item-level reporting.

FieldRequiredDefault mappingDescription
QuantityNoevent.event_properties.quantityTotal units in the order.
Product IDNoevent.event_properties.product_idSKU identifier for a single line item.
Position IDNoempty1-based index of this line item within the order.
Position CountNoemptyTotal number of line items in the order.

Capturing admitad_uid

The Ours Privacy Web SDK captures admitad_uid from the URL automatically and stores it on the visitor — no extra configuration needed. The destination reads it back on conversion via event.default_properties.admitad_uid.

If you fire conversions from the Server-Side API (HTTP) rather than the Web SDK, include the click ID on the event payload:

{
  "event": "Order Completed",
  "default_properties": {
    "admitad_uid": "abc123def456"
  },
  "event_properties": {
    "order_id": "ORDER-9001",
    "value": 199.99,
    "currency": "USD"
  }
}

Tracking a conversion

ours('track', 'Order Completed', {
  order_id: 'ORDER-9001',
  value: 199.99,
  currency: 'USD',
  coupon: 'SUMMER10',
  product_id: 'SKU-42',
  quantity: 2,
});

When it dispatches

  • The destination dispatches whenever an event matched to its mapping has both uid and order_id available.
  • Missing uid → dispatch skipped with a logged reason (no retry, no error). This prevents unattributable hits from inflating your reporting.
  • Missing order_id → non-retryable error logged. Order ID is mandatory for Admitad's deduplication system.
  • Missing destination settings (Campaign Code / Postback Key / Default Action Code) → non-retryable error logged.

Error handling and retries

Status returned by AdmitadBehavior
2xxSuccess.
4xx (except 429)Non-retryable. Check Campaign Code and Postback Key.
429Retried automatically. Admitad rate-limits at 600 req/min per program.
5xxRetried automatically.

After 5 retries, dispatch is abandoned and the event is logged as failed.

Operational notes

  • Idempotency. Admitad deduplicates by (campaign_code, action_code, order_id), so retrying the same order_id is safe and never double-counts.
  • Postback latency. Conversions can take a few minutes to appear in the Admitad dashboard.
  • Secrets. Your Postback Key is stored encrypted and is redacted from every log line and dispatch payload.

Additional information

Reach out to support@oursprivacy.com to enable this destination for your account.

How is this guide?

On this page