Entwickler-API
Mit der Plattform-API lassen sich alle Funktionen automatisieren, die im Admin-Panel zu finden sind.
1. Was können Werbetreibende automatisieren?
Kampagnen/Gruppen, Varianten, Angebote und Anzeigenformate
Targeting/Sperrung von Targeting-Optionen, Kategorien
Ziele
Statistiken abrufen, einschließlich Adblock-Nutzerdaten
Tagesbudget, Kontofinanzierung, Zahlungsarten
Name der Landingpage, URL und Traffic-Verteilungsalgorithmus
2. Was können Publisher automatisieren?
Anzeigenformate und Anzeigenzonen
Sites, URL-Verifizierungen
Anzeigentypen und Produktkategorien blockieren
Alle Statistiken abrufen, einschließlich Adblock-Nutzerdaten
Gebotspreise pro Anzeigenformat/GEO, Preismodelle
Zahlungsarten
3. So verwendest du die API
Die API-Oberfläche ist schnell und einfach zu bedienen
Wähle einfach einen Parameter aus und drücke die Ausprobieren Schaltfläche, um automatisch Code zu generieren
So verwendest du die Plattform-API
Wir haben unsere Plattform-API gerade auf Version 2 aktualisiert. Diese neueste Version ermöglicht es dir, jede einzelne Funktion im Admin-Panel zu automatisieren. Du kannst die API für einfache Prozesse wie die Automatisierung sich wiederholender Aufgaben nutzen, um Zeit zu sparen, bis hin zu komplexeren Projekten wie dem dynamischen Ändern von Banner-Creatives.
Funktionen
Sowohl Publisher als auch Werbetreibende haben eine große Auswahl an verfügbaren Funktionen. Hier ist eine Zusammenfassung dessen, was automatisiert werden kann:
Werbetreibende
Einzel-/Gruppenkampagnen, Varianten, Angebote, Anzeigenformate.
Targeting/Sperrung von Targeting-Optionen, Kategorien, Tageszeitplanung.
Ziele.
Statistiken abrufen, einschließlich Adblock-Nutzerdaten.
Tagesbudget, Kontofinanzierung, Zahlungsarten.
Name der Landingpage, URL und Traffic-Verteilungsalgorithmus.
Publisher
Anzeigenformate und Anzeigenzonen.
Sites, URL-Verifizierungen.
Anzeigentypen und Produktkategorien blockieren.
Alle Statistiken abrufen, einschließlich Adblock-Nutzerdaten.
Gebotspreise pro Anzeigenformat/GEO, Preismodelle.
Zahlungsarten.
Bevor wir beginnen
Die API-Oberfläche zeigt eine Liste von Gruppentiteln. Klicke auf eine Gruppe und alle verfügbaren Optionen werden aufgeklappt.
HTTP-Methoden
Die API unterstützt die folgende Teilmenge der HTTP-Methoden. Bitte beachte, dass nicht alle Funktionen alle Methoden unterstützen.
Lass uns loslegen!
Einrichten
Um auf eingeschränkte API-Anfragen zugreifen zu können, muss ein Sitzungs-Token gesetzt sein. Um ein Token festzulegen, musst du ein gültiges Konto haben.
Die Erstellung des API-Tokens ist unter deinem Mein Profil Menü verfügbar. Wähle API-Tokens aus.
Klicke auf Neuer API-Token.
Gib den Namen des Tokens ein, für dieses Tutorial haben wir unseres ‚testToken‘ genannt, dann klicke auf Speichern.
Die Token-ID wurde erstellt.
Bei der API anmelden
Klicke in der API-Oberfläche oben rechts auf die Anmelden Schaltfläche und gib deinen Benutzernamen und dein Passwort ein oder stelle einen API-Token bereit. Klicke auf Senden und eine Anmeldeanfrage wird an die API gesendet, um einen gültigen Sitzungs-Token abzurufen. Dieser Token wird dann verwendet, um alle API-Anfragen zu validieren, die du während der Sitzung stellen möchtest.
So stellst du eine Anfrage an die API
Nehmen wir das Beispiel der Kampagnen-Gruppe: Klicke darauf und die Gruppe wird aufgeklappt, um die verfügbaren Anfragen aufzulisten:
Klicke auf die Anfrage, die du automatisieren möchtest. In diesem Beispiel rufen wir Daten für die CID 1923724 mit Folgendem ab:
Klicke auf Kampagne abrufen wodurch sich das Fenster erweitert. Gib die Kampagnen-ID-Nummer in das Feld ein:
Dann klicke auf die Jetzt ausprobieren Schaltfläche. Der Antwortkörper generiert den Code automatisch.
Ein Response-Code von 200 bedeutet, dass alles in Ordnung ist.
So pausierst du eine Kampagne
Hier ist ein weiteres Beispiel. Wähle zunächst die richtige Funktion aus der Kampagnen-Gruppe aus:
Klicke auf Pausieren für eine oder mehrere Kampagnen. Sobald sie geöffnet ist, klicke auf den Beispielwert und dann auf das gelbe Feld; dadurch wird die JSON-Struktur automatisch in das Body-Feld eingefügt.
Der aktuelle Wert ist jetzt null, also ändere die Null jetzt in die CID, die du pausieren möchtest. Dann klicke auf die Ausprobieren Schaltfläche, um den benötigten Code zu generieren.
So aktualisierst du die Preisgestaltung einer Kampagne
Wähle die richtige Funktion aus:
Klicke auf Kampagne aktualisieren, um das Fenster zu öffnen. Füge die CID in das Kampagnen-ID-Feld ein und klicke dann auf Beispielwert, klicke auf das gelbe Feld, wodurch die JSON-Struktur in das Body-Feld kopiert wird.
Dieser Code enthält einige verschiedene Funktionen, aber wir wollen den Code für die Kampagnenpreisgestaltung, also lösche den nicht benötigten Teil des Codes und lasse den Code für die Kampagnenpreisgestaltung im Feld, wie unten:
Jetzt müssen wir im Body-Feld zwei Dinge ändern: das Modell (unten ist eine Liste der Werte für das jeweilige Preismodell).
Wir bleiben bei CPC, also lassen wir das Modell auf 1
Jetzt müssen wir den Preis von null auf den gewünschten Preis ändern. Wir ändern ihn auf 200, was bedeutet, dass der neue Preis 200 Cent oder zwei Euro beträgt.
Dann klicke einfach auf die Ausprobieren Schaltfläche, um den Code zu generieren. Ganz einfach!
Wie du sehen kannst, steckt die API voller Funktionen zur Automatisierung; die einzige Grenze ist deine Fantasie, um die Kraft der Automatisierung zu entfesseln.
Stelle schließlich sicher, dass du unseren API-Newsletter abonnierst, den du unten in der API-Oberfläche findest, damit du die neuesten Nachrichten und Updates erhältst.
War das hilfreich?