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
- A publisher (affiliate) sends a user to your site through an Admitad-tracked link.
- Admitad attaches a click identifier (
admitad_uid) to the landing URL. - The Ours Privacy SDK reads
admitad_uidfrom the URL and stores it on the visitor (default cookie window: 395 days, matching Admitad's recommendation). - When the visitor converts (e.g. completes an order), Ours Privacy sends a postback to Admitad with the stored
uidplus order metadata. - Admitad uses
uidto 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 Destinations → Add destination → Admitad (Mitgo).
Required settings
| Setting | Description |
|---|---|
| Campaign Code | Your Admitad program identifier. From the advertiser dashboard: Programs › Integration › Custom integration › Postback. |
| Postback Key | Static security token issued per program. Stored encrypted; never displayed after save. |
| Default Action Code | Admitad target-action identifier (e.g. 1 = sale, 2 = lead). Used when an event mapping does not provide its own action code. |
Optional settings
| Setting | Description |
|---|---|
| Default Tariff Code | Rate code used when an event mapping does not override it. Defaults to 1. |
| Default Payment Type | Constant 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
| Field | Required | Default mapping | Description |
|---|---|---|---|
Admitad Click ID (uid) | Yes | event.default_properties.admitad_uid | The click identifier captured on landing. Without it Admitad cannot attribute the conversion. |
| Action Code Override | No | empty (uses Default Action Code) | Per-event override — use it when the same destination handles both sales and leads. |
| Tariff Code Override | No | empty (uses Default Tariff Code) | Per-event override — use when the program uses different rate cards by SKU or customer type. |
| Payment Type Override | No | empty (uses Default Payment Type) | Per-event override of the payment_type constant. |
Order details
| Field | Required | Default mapping | Description |
|---|---|---|---|
| Order ID | Yes | event.event_properties.order_id | Your internal order/transaction ID. Admitad uses this as the dedup key — retries with the same order_id are safe. |
Order Value (price) | No | event.event_properties.value | Post-discount, pre-tax subtotal. Period decimal separator (199.99); no thousand separators. |
| Currency Code | No | event.event_properties.currency | ISO 4217 (USD, EUR, GBP). Strongly recommended whenever Order Value is set — Admitad otherwise assumes program native currency. |
| Promocode | No | event.event_properties.coupon | Coupon code applied to the order. Used for promocode-based attribution and reconciliation. |
Customer data
| Field | Required | Default mapping | Description |
|---|---|---|---|
| Client ID | No | visitor.external_id | Stable customer identifier. Admitad uses it for new-vs-returning splits. |
| Country Code | No | visitor.country | ISO 3166-1 alpha-2 country (US, DE). Used for geo-targeted commission rates. |
| City | No | visitor.city | Plain-text city. Reporting-only. |
Product details
Use these only when your Admitad program pays per-product commission or you need item-level reporting.
| Field | Required | Default mapping | Description |
|---|---|---|---|
| Quantity | No | event.event_properties.quantity | Total units in the order. |
| Product ID | No | event.event_properties.product_id | SKU identifier for a single line item. |
| Position ID | No | empty | 1-based index of this line item within the order. |
| Position Count | No | empty | Total 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
uidandorder_idavailable. - 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 Admitad | Behavior |
|---|---|
| 2xx | Success. |
| 4xx (except 429) | Non-retryable. Check Campaign Code and Postback Key. |
| 429 | Retried automatically. Admitad rate-limits at 600 req/min per program. |
| 5xx | Retried 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 sameorder_idis 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?