Vos partenariats. Votre intégration.

Obtenez des annonceurs

Lisez les profils et les marchés des annonceurs. Les éditeurs peuvent récupérer des liens pour leur propre canal avec un partenariat approuvé.

Autorisation advertisers:read

Paramètres

Dans la chaîne de requêtes 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 réponse contient des lignes, le total, la page et par_page. Vérifier le statut et approbation_status; la liste peut inclure des annonceurs inactifs ou non approuvés. channel_code nécessite une clé d'éditeur et un canal propriétaire. Utilisez le code public, pas le canal_id interne.

Utilisez tracking_url lorsque tracking_available est vrai dans les liens. Autrement, l'url peut être une adresse de magasin ordinaire sans attribution. Chaque marché a son propre lien. Un marché unique peut également peupler tracking_url sur la ligne de l'annonceur.

Campagnes de collecte

Récupérer les offres actuelles et les codes de rabais, avec des liens de suivi pour les canaux d'éditeurs admissibles.

Autorisation campaigns:read

Paramètres

Dans la chaîne de requêtes 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
}

Seules les campagnes actives pendant leur période de validité sont indiquées; les dates suivent l'heure suédoise. Les campagnes exclusives dépendent de l'accès au compte. Les réponses de l'éditeur incluent tracking_links, qui peut être vide. Les réponses de l'annonceur n'incluent pas ce champ. Réutiliser les liens retournés et leurs paramètres de campagne.

Inscrivez les achats et les événements

Envoyer un événement depuis le serveur de l'annonceur en utilisant une clé d'annonceur. La clé doit appartenir à l'annonceur spécifié dans la demande.

Autorisation transactions:write

Paramètres

Corps de la requête 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 nécessite orderReference, le montant et la monnaie. Le canal, le marché, le programme, l'attribution et les règles de commission déterminent si une transaction est créée. D'autres noms d'événements doivent correspondre à la configuration du programme. clickId est optionnel dans le protocole; envoyer la valeur de l'URL d'atterrissage pour lier l'achat à un clic enregistré.

200 signifie que le traitement est terminé ; vérifiez recognized, conversion et duplicate. 202 confirme uniquement la réception dans une file durable. receiptId est un identifiant de reçu, pas un identifiant de transaction ni une promesse de commission. Aucun point d’accès public ne permet de rechercher cet identifiant ; consultez les journaux des événements et transactions dans le portail.

Après un résultat de réseau incertain ou 503, réessayez avec les mêmes données d'achat et orderReference. La même référence de commande pour un annonceur protège contre les transactions financières dupliquées, mais des enregistrements d'événements supplémentaires peuvent être enregistrés. Traitez le 202 tel qu'il a été reçu; ne renvoyez pas simplement parce que la transaction n'est pas encore visible.

Achat de bons exclusifs

Serveur optionnel pour les achats sans attribution de clic. La clé API identifie l'annonceur; une campagne exclusive explicitement activée détermine le canal et le programme.

Autorisation transactions:write

Paramètres

Corps de la requête 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"
    }
}

Désactivé par défaut ; renvoie 404 tant qu’il n’est pas activé. Le code doit correspondre exactement, être sans ambiguïté et être valide pour le marché et la date d’achat. N’envoyez jamais clickId ou channelCode ici : les achats avec clic continuent d’utiliser /t. Réutilisez exactement le même orderReference lors des nouvelles tentatives et entre les intégrations ; les commandes existantes ne sont jamais réattribuées. Ce point d’accès traite l’achat directement dans PostgreSQL et renvoie 200 après traitement, même en mode Kafka. Vérifiez conversion, conversionBlocked et duplicate.

Après un résultat de réseau incertain ou 503, réessayez avec les mêmes données d'achat et orderReference. La même référence de commande pour un annonceur protège contre les transactions financières dupliquées, mais des enregistrements d'événements supplémentaires peuvent être enregistrés. Traitez le 202 tel qu'il a été reçu; ne renvoyez pas simplement parce que la transaction n'est pas encore visible.

Lien de suivi & redirection

Envoyez les visiteurs à l'annonceur via Adtrade. Préférez le tracking_url retourné par l'API ou le portail.

Aucune clé API · lien de suivi public

Paramètres

Dans la chaîne de requêtes 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=...

Ouvert par le navigateur visitators sans clé API. Une société de personnes valide renvoie normalement 302 à la page d'atterrissage de l'annonceur avec clickId et des informations de suivi. Un lien non valide peut afficher une page de repli à la place. Une visite n'est pas un achat et ne garantit pas la commission. Suivez les termes du programme et les paramètres de consentement.