Zum Hauptinhalt springen

cURL Beispiele

Übersicht​

Dieser Leitfaden enthält gebrauchsfertige cURL-Befehle für die Authentifizierung und Erstellung von Kampagnen über die ExoClick-API. Alle Beispiele verwenden standardmäßige JSON- oder Form-Data-Formate, je nach den Anforderungen des Endpunkts.

Authentifizierung (Anmeldung)​

Sie können sich mit Ihren Kontoanmeldedaten oder einem permanenten API-Token authentifizieren. Beide geben ein temporäres Bearer Token zurück, das für alle nachfolgenden Anfragen verwendet wird.

A - Anmeldung mit Benutzername und Passwort​

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "username": "YOUR_USERNAME",
       "password": "YOUR_PASSWORD"
     }'

B - Anmeldung mit API-Token​

Verwenden Sie dies, wenn Sie ein Token in Ihrem ExoClick Dashboard (Profil > API Tokens) erstellt haben.

curl -X POST "https://api.exoclick.com/v2/login" \
     -H "Content-Type: application/json" \
     -d '{
       "api_token": "YOUR_API_TOKEN"
     }'

300x250 Banner-Kampagnen-Erstellungsablauf​

Befolgen Sie diese Schritte in genauer Reihenfolge. Beachten Sie den Übergang von JSON zu Form-Data in den letzten Schritten.

Schritt 1: Landing Page URL erstellen (Bibliothek)​

Registriert Ihre Ziel-URL.

Format: JSON

curl -X POST "https://api.exoclick.com/v2/library/url" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://your-landing-page.com"
     }'

Ergebnis: Speichern Sie die zurückgegebene "id" (z. B. "6512406").

Schritt 2: Bild hochladen (Bibliothek)​

Registriert Ihr kreatives Asset. Das Bild muss genau 300x250 groß sein.

Format: Form-Data

curl -X POST "https://api.exoclick.com/v2/library/file" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "file=@/path/to/your/image_300x250.jpg" \
     -F "type=image"

Ergebnis: Speichern Sie die zurückgegebene "id" (z. B. "6884966").

Schritt 3: Kampagnen-Shell erstellen​

Legt die Zielsetzung, das Budget und die Vorlage img_banner fest.

Format: JSON

curl -X POST "https://api.exoclick.com/v2/campaigns" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Banner 300x250",
  "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
}'

Ergebnis: Speichern Sie die zurückgegebene "id" (z. B. "8140060").

Schritt 4: Hinzufügen der Variation​

Verknüpft die URL (Schritt 1) und das Bild (Schritt 2) mit der Kampagne (Schritt 3).

Format: Form-Data

curl -X POST "https://api.exoclick.com/v2/campaigns/8140060/variation" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "id_library_url=6512406" \
     -F "id_library_file=6884966" \
     -F "active=1"

Alle IDs, die bei jedem Schritt zurückgegeben werden, müssen gespeichert und bei nachfolgenden Anfragen verwendet werden. Denken Sie daran, YOUR_TOKEN, Dateipfade und IDs durch Ihre tatsächlichen Werte zu ersetzen.