Dina samarbeten. Din integration.

Hämta annonsörer

Läs annonsörernas profiler och marknader. Publicister kan få länkar för en egen kanal med ett godkänt samarbete.

Behörighet advertisers:read

Parametrar

I URL:ens query-sträng

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
}

Svaret innehåller rows, total, page och per_page. Kontrollera status och approval_status; listan kan även innehålla annonsörer som inte är aktiva eller godkända. channel_code kan bara användas med en publicistnyckel för en egen kanal. Använd kanalens kod, inte dess interna channel_id.

Använd tracking_url när tracking_available är true i links. url kan annars vara en vanlig butiksadress utan attribuering. Flera marknader ger separata länkar. En ensam marknad kan också ge tracking_url på annonsörsraden.

Hämta kampanjer

Hämta aktuella erbjudanden och rabattkoder, med färdiga spårningslänkar för publicistens behöriga kanaler.

Behörighet campaigns:read

Parametrar

I URL:ens query-sträng

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
}

Endast aktiva kampanjer inom giltighetsperioden visas; datumen följer svensk tid. Exklusiva kampanjer begränsas av kontots åtkomst. Publicistens svar får tracking_links, som kan vara tom. Annonsörens svar har inte detta fält. Återanvänd returnerade länkar och deras kampanjparametrar.

Registrera köp och händelser

Skicka en händelse från annonsörens server med en annonsörsnyckel. Nyckeln måste tillhöra annonsören som anges i anropet.

Behörighet transactions:write

Parametrar

JSON i request body

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 kräver orderReference, amount och currency. Kanal, marknad, program, attribuering och provisionsregler avgör om en transaktion skapas. Andra händelsenamn måste motsvara programmets konfiguration. clickId är valfritt i protokollet; skicka det från landningslänken för att knyta köpet till ett registrerat klick.

200 betyder att händelsen har behandlats; kontrollera recognized, conversion och duplicate. 202 betyder endast att den har tagits emot i en beständig kö. receiptId är ett mottagnings-ID, inte ett transaktions-ID eller ett löfte om provision. Det finns ingen publik metod för att slå upp detta ID; följ utfallet i portalens händelse- och transaktionslogg.

Vid osäkert nätverksutfall eller 503: försök igen med samma köpdata och samma orderReference. Samma orderreferens för en annonsör skyddar mot dubbla finansiella transaktioner, men fler händelseposter kan loggas. Behandla 202 som mottaget och skicka inte om bara för att transaktionen ännu inte syns.

Spårningslänk & redirect

Länka besökaren till annonsören via Adtrade. Använd i första hand den färdiga tracking_url som API:t eller portalen ger dig.

Ingen API-nyckel · publik spårningslänk

Parametrar

I URL:ens query-sträng

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=...

Öppnas av besökarens webbläsare utan API-nyckel. Ett giltigt samarbete ger normalt 302 till annonsörens landningssida med clickId och spårningsinformation. En ogiltig länk kan i stället visa en fallback-sida. Ett besök är inte ett köp och skapar ingen garanterad provision. Följ programmets villkor och samtyckesinställningar.