Sus asociaciones. Tu integración.

Fetch anunciantes

Lea los perfiles y mercados del anunciante. Los afiliados pueden recuperar enlaces para su propio canal con una asociación aprobada.

Permiso advertisers:read

Parámetros

En la cadena de consulta URL

curl --get "https://adtrade.io/api/v1/advertisers?market=SE&page=1&per_page=50" \
  --header "Authorization: Bearer $ADTRADE_API_KEY" \
  --header "Accept: application/json"

{
    "rows": [
        {
            "id": 4,
            "advertiser_code": "100",
            "name": "Example Store",
            "status": "active",
            "approval_status": "approved",
            "website_url": "https://shop.example.com",
            "tracking_url": null,
            "links": []
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 50
}

La respuesta contiene hileras, total, página y per_page. Check status and approval_status; la lista puede incluir anunciantes inactivos o no aprobados. channel_code requiere una clave de afiliado y un canal de propiedad. Utilice el código público, no el canal_id interno.

Use tracking_url cuando tracking_available es cierto en enlaces. De lo contrario, url puede ser una dirección de tienda ordinaria sin atribución. Cada mercado tiene su propio vínculo. Un solo mercado también puede poblar tracking_url en la fila del anunciante.

Campañas de captura

Recuperar las ofertas actuales y los códigos de descuento, con enlaces de seguimiento para los canales de afiliado elegibles.

Permiso campaigns:read

Parámetros

En la cadena de consulta URL

curl --get "https://adtrade.io/api/v1/campaigns?market=SE&page=1&per_page=50" \
  --header "Authorization: Bearer $ADTRADE_API_KEY" \
  --header "Accept: application/json"

{
    "rows": [
        {
            "id": "12",
            "advertiser_id": "4",
            "advertiser_name": "Example Store",
            "description": "10% discount",
            "discount_code": "EXAMPLE10",
            "markets": [
                "SE"
            ],
            "tracking_links": [
                {
                    "channel_code": "1234567",
                    "channel_name": "Example Channel",
                    "market": "SE",
                    "url": "https://adtrade.io/t?a=100&c=1234567&m=SE&campaign=12&voucher=EXAMPLE10"
                }
            ]
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 50
}

Sólo se muestran campañas activas dentro de su período de validez; las fechas siguen el tiempo sueco. Las campañas exclusivas dependen del acceso a la cuenta. Las respuestas del afiliado incluyen tracking_links, que pueden estar vacías. Las respuestas de los anunciantes no incluyen este campo. Reutiliza los enlaces devueltos y sus parámetros de campaña.

Registro de compras y eventos

Envíe un evento desde el servidor del anunciante usando una clave del anunciante. La clave debe pertenecer al anunciante especificado en la solicitud.

Permiso transactions:write

Parámetros

Cuerpo de la solicitud JSON

curl --request POST "https://adtrade.io/t" \
  --header "Authorization: Bearer $ADTRADE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "event": "Purchase", "advertiserCode": "100",
    "channelCode": "1234567", "market": "SE",
    "clickId": "CLICK_ID_FROM_LANDING_URL",
    "orderReference": "EXAMPLE-1001",
    "amount": "200.00", "currency": "SEK"
  }'

{
    "status": "accepted",
    "queued": true,
    "receiptId": "00000000-0000-4000-8000-000000000001",
    "event": "Purchase"
}

{
    "success": true,
    "eventId": 101,
    "event": "Purchase",
    "recognized": true,
    "conversion": true,
    "duplicate": false,
    "transaction": {
        "id": 1001,
        "status": "pending",
        "orderReference": "EXAMPLE-1001",
        "amount": "200.00",
        "commissionAmount": "16.00",
        "currency": "SEK"
    }
}

Purchase requiere orderReference, cantidad y moneda. Las reglas de canal, mercado, programa, atribución y comisión determinan si se crea una transacción. Otros nombres de eventos deben coincidir con la configuración del programa. clickId es opcional en el protocolo; enviar el valor de la URL de aterrizaje para vincular la compra a un clic registrado.

200 significa que el procesamiento ha terminado; comprueba recognized, conversion y duplicate. 202 solo confirma la recepción en una cola duradera. receiptId es un identificador de recibo, no un identificador de transacción ni una promesa de comisión. No existe un endpoint público de consulta para este identificador; revisa los registros de eventos y transacciones del portal.

Después de un resultado de red incierto o 503, reingrese con los mismos datos de compra y orderReference. La misma referencia de pedido para un anunciante protege contra las transacciones financieras duplicadas, pero se pueden registrar registros adicionales de eventos. Trate 202 como se ha recibido; no reenviar sólo porque la transacción todavía no es visible.

Compra de comprobante exclusivo

Información de servidor opcional para compras sin atribución de clics. La clave de API identifica al anunciante; una campaña exclusiva activada explícitamente determina el canal y el programa.

Permiso transactions:write

Parámetros

Cuerpo de la solicitud JSON

curl --request POST "https://adtrade.io/api/v1/tracking/voucher-purchase" \
  --header "Authorization: Bearer $ADTRADE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"voucher":"EXAMPLE10","orderReference":"EXAMPLE-1001","amount":"200.00","currency":"SEK","market":"SE"}'

{
    "success": true,
    "conversion": true,
    "duplicate": false,
    "attributionMethod": "exclusive_voucher",
    "transaction": {
        "id": 1001,
        "status": "pending",
        "orderReference": "EXAMPLE-1001",
        "amount": "200.00",
        "commissionAmount": "16.00",
        "currency": "SEK"
    }
}

Desactivado por defecto; devuelve 404 hasta que se active. El código debe coincidir exactamente, ser inequívoco y ser válido para el mercado y la fecha de compra. Nunca envíes clickId ni channelCode aquí: las compras con clic siguen usando /t. Reutiliza exactamente el mismo orderReference en los reintentos y entre integraciones; los pedidos existentes nunca se reasignan. Este endpoint procesa la compra directamente en PostgreSQL y devuelve 200 tras procesarla, incluso en modo Kafka. Comprueba conversion, conversionBlocked y duplicate.

Después de un resultado de red incierto o 503, reingrese con los mismos datos de compra y orderReference. La misma referencia de pedido para un anunciante protege contra las transacciones financieras duplicadas, pero se pueden registrar registros adicionales de eventos. Trate 202 como se ha recibido; no reenviar sólo porque la transacción todavía no es visible.

Enlace de seguimiento " redirect

Enviar visitantes al anunciante a través de Adtrade. Preferir el tracking_url devuelto por la API o portal.

No API key · enlace de seguimiento público

Parámetros

En la cadena de consulta URL

https://adtrade.io/t?a=100&c=1234567&m=SE&r=article-123

HTTP/1.1 302 Found
Location: https://shop.example.com/?advertiserCode=100&channelCode=1234567&market=SE&clickId=...

Abierta por el navegador del visitante sin una clave de API. Una asociación válida normalmente devuelve 302 a la página de aterrizaje del anunciante con clickId y la información de seguimiento. Un enlace inválido puede mostrar una página de retroceso en su lugar. Una visita no es una compra y no garantiza comisión. Siga los términos del programa y los ajustes de consentimiento.