Exemples de facteurs

Vue d'ensemble

Ce guide fournit des instructions étape par étape pour l'authentification et la création de campagnes via l'API ExoClick à l'aide de Postman. Tous les exemples précisent le type de demande, les en-têtes et le format du corps requis pour chaque point d'extrémité.

Authentification (Login)

Vous pouvez vous authentifier à l'aide des informations d'identification de votre compte ou d'un jeton API permanent. Les deux types d'authentification renvoient un jeton de support temporaire utilisé pour toutes les demandes ultérieures.

A - Se connecter avec le nom d'utilisateur et le mot de passe

Request Type: POST URL: https://api.exoclick.com/v2/login

Headers:

Content-Type: application/json

Corps (JSON brut):

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD"
}

B - Connexion avec un jeton API

Utilisez ceci si vous avez généré un jeton dans votre tableau de bord ExoClick (Profil > Jetons API).

Request Type: POST URL: https://api.exoclick.com/v2/login

Headers:

Content-Type: application/json

Corps (JSON brut):

{
  "api_token": "YOUR_API_TOKEN"
}

flux de création d'une campagne de bannières 300x250

Suivez ces étapes dans l'ordre exact. Notez le passage de JSON à Form-Data dans les dernières étapes.

Étape 1 : Créer l'URL de la page d'atterrissage (bibliothèque)

Enregistre votre URL de destination. Les bannières standard nécessitent un id_library_url.

Request Type: POST URL: https://api.exoclick.com/v2/library/url

Headers:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Corps (JSON brut):

{
  "url": "https://your-landing-page.com"
}

Result: Enregistrez l'"id" retourné (par exemple, 6512406).

Étape 2 : Téléchargement d'une image (bibliothèque)

Enregistrez votre bien créatif. L'image doit avoir une taille exacte de 300x250.

Request Type: POST URL: https://api.exoclick.com/v2/library/file

Headers:

Authorization: Bearer YOUR_TOKEN

Corps (données de formulaire):

Clé	Type	Valeur
file	Fichier	Sélectionnez votre fichier image (300x250)
type	Texte	image

Result: Enregistrez l'identifiant retourné (par exemple, 6884966).

Étape 3 : Créer une enveloppe de campagne

Définit le ciblage, le budget et le modèle img_banner.

Request Type: POST URL: https://api.exoclick.com/v2/campaigns

Headers:

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Corps (JSON brut):

{
  "name": "Banner 300x250 Production",
  "status": 0,
  "advertiser_ad_type": 0,
  "media_storage_template": "img_banner",
  "size": "300x250",
  "categories": {
    "type": "targeted",
    "elements": [97, 98, 99]
  },
  "countries": {
    "type": "targeted",
    "elements": [
      {
        "country": "USA",
        "regions": [0]
      }
    ]
  },
  "pricing": {
    "model": 4,
    "price": 300
  },
  "start_date": "2026-03-02",
  "daily_limit_type": 1,
  "max_daily_budget": 2000,
  "budget_delivery_mode": 1,
  "run_on_responsive_zones": 1
}

Result: Enregistrez l'identifiant retourné (par exemple, 8140060).

Étape 4 : Ajouter la variante

Relie l'URL (étape 1) et l'image (étape 2) à la campagne (étape 3).

Request Type: POST URL: https://api.exoclick.com/v2/campaigns/8140060/variation (Remplacez 8140060 par votre identifiant de campagne actuel de l'étape 3)

Headers:

Authorization: Bearer YOUR_TOKEN

Corps (données de formulaire):

Clé	Type	Valeur
id_library_url	Texte	6512406 (de l'étape 1)
id_library_file (fichier d'identification de bibliothèque)	Texte	6884966 (de l'étape 2)
active	Texte	1

Tous les identifiants renvoyés à chaque étape doivent être sauvegardés et utilisés dans les requêtes suivantes. N'oubliez pas de remplacer YOUR_TOKEN, les chemins d'accès aux fichiers et les ID par vos valeurs réelles.