Ihre Partnerschaften. Ihre Integration.

Advertiser abrufen

Profile und Märkte der Advertiser abrufen. Publisher können Links für eigene Kanäle mit genehmigter Partnerschaft erhalten.

Berechtigung advertisers:read

Parameter

Im Query-String der 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
}

Die Antwort enthält rows, total, page und per_page. Prüfen Sie status und approval_status; auch inaktive oder nicht genehmigte Advertiser können enthalten sein. channel_code erfordert einen Publisher-Schlüssel und einen eigenen Kanal. Verwenden Sie den öffentlichen Code, nicht die interne channel_id.

Verwenden Sie tracking_url, wenn tracking_available in links true ist. Andernfalls kann url eine normale Shop-Adresse ohne Attribution sein. Märkte haben getrennte Links. Bei einem einzelnen Markt kann tracking_url auch direkt im Advertiser-Eintrag stehen.

Kampagnen abrufen

Aktuelle Angebote und Rabattcodes abrufen, mit Tracking-Links für berechtigte Publisher-Kanäle.

Berechtigung campaigns:read

Parameter

Im Query-String der 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
}

Nur aktive Kampagnen innerhalb ihrer Gültigkeitsdauer werden angezeigt; Datumsangaben folgen schwedischer Zeit. Exklusive Kampagnen hängen vom Kontozugriff ab. Publisher-Antworten enthalten tracking_links, das leer sein kann. Advertiser-Antworten enthalten dieses Feld nicht. Verwenden Sie die gelieferten Links samt Kampagnenparametern.

Käufe und Ereignisse registrieren

Ereignisse vom Server des Advertisers mit einem Advertiser-Schlüssel senden. Der Schlüssel muss zum angegebenen Advertiser gehören.

Berechtigung transactions:write

Parameter

JSON im 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 erfordert orderReference, amount und currency. Kanal, Markt, Programm, Attribution und Provisionsregeln bestimmen, ob eine Transaktion entsteht. Andere Ereignisnamen müssen zur Programmkonfiguration passen. clickId ist im Protokoll optional; senden Sie den Wert aus der Landing-URL, um den Kauf einem registrierten Klick zuzuordnen.

200 bedeutet abgeschlossen; prüfen Sie recognized, conversion und duplicate. 202 bestätigt nur den Eingang in einer dauerhaften Warteschlange. receiptId ist eine Empfangs-ID, keine Transaktions-ID oder Provisionszusage. Dafür gibt es keinen öffentlichen Abfrage-Endpunkt; prüfen Sie die Ereignis- und Transaktionsprotokolle im Portal.

Bei unklarem Netzwerkergebnis oder 503 mit denselben Kaufdaten und derselben orderReference erneut versuchen. Die gleiche Bestellreferenz je Advertiser schützt vor doppelten Finanztransaktionen; zusätzliche Ereignisse können protokolliert werden. 202 als empfangen behandeln und nicht nur wegen einer noch unsichtbaren Transaktion erneut senden.

Tracking-Link & Weiterleitung

Besucher über Adtrade zum Advertiser leiten. Verwenden Sie bevorzugt die tracking_url aus API oder Portal.

Kein API-Schlüssel · öffentlicher Tracking-Link

Parameter

Im Query-String der 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=...

Wird ohne API-Schlüssel im Browser des Besuchers geöffnet. Eine gültige Partnerschaft liefert normalerweise 302 zur Landingpage mit clickId und Tracking-Daten. Ein ungültiger Link kann stattdessen eine Fallback-Seite anzeigen. Ein Besuch ist kein Kauf und garantiert keine Provision. Beachten Sie Programmbedingungen und Einwilligungseinstellungen.