Entwickler-API
Mit der Plattform-API ist es möglich, alle Funktionen zu automatisieren, die im Admin-Panel zu finden sind.
1. Was können Werbetreibende automatisieren?- Kampagnen/Gruppen, Variationen, Angebote und Anzeigenformate
- Ausrichten/Blockieren von Ausrichtungsoptionen, Kategorien
- Ziele
- Statistiken einschließlich Adblock-Nutzerdaten abrufen
- Tagesbudget, Kontofinanzierung, Zahlungsarten
- Name der Landing Page, URL und Algorithmus für den Verkehrsanteil
- Anzeigenformate und Anzeigenbereiche
- Websites, URL-Überprüfungen
- Anzeigentypen und Produktkategorien blockieren
- Alle Statistiken, einschließlich Adblock-Nutzerdaten, abrufen
- Gebotspreise pro Anzeigenformat/GEO, Preismodelle
- Zahlungsarten
- Die Schnittstelle der API ist schnell und einfach zu bedienen
- Wählen Sie einfach einen Parameter aus und klicken Sie auf die Schaltfläche Ausprobieren, um automatisch Code zu generieren
Nutzung der Plattform-API
Wir haben gerade unsere Plattform-API auf Version 2 aktualisiert. Diese neueste Version ermöglicht es Ihnen, jede einzelne Funktion innerhalb des Admin Panels zu automatisieren. Sie können die API für einfache Prozesse wie die Automatisierung von sich wiederholenden Aufgaben nutzen, um Zeit zu sparen, bis hin zu komplexeren Projekten wie der Änderung von Bannermotiven im laufenden Betrieb.
Eigenschaften
Sowohl Publishern als auch Advertisern steht eine breite Palette von Funktionen zur Verfügung. Hier ist eine Zusammenfassung dessen, was automatisiert werden kann:
Inserenten
- Einzel-/Gruppenkampagnen, Varianten, Angebote, Anzeigenformate.
- Targeting/Blockierung von Targeting-Optionen, Kategorien, Tagesaufteilung.
- Ziele.
- Ziehen Sie Statistiken einschließlich Adblock-Nutzerdaten.
- Tagesbudget, Kontofinanzierung, Zahlungsarten.
- Name der Landing Page, URL und Algorithmus für den Verkehrsanteil.
Verlage
- Anzeigenformate und Anzeigenbereiche.
- Websites, URL-Überprüfungen.
- Blockieren Sie Anzeigentypen und Produktkategorien.
- Erfassen Sie alle Statistiken, einschließlich der Daten von Adblock-Nutzern.
- Gebotspreise pro Anzeigenformat/GEO, Preismodelle.
- Zahlungsarten.
Bevor Sie beginnen
Die API-Schnittstelle zeigt eine Liste von Gruppentiteln. Klicken Sie auf eine Gruppe und alle verfügbaren Optionen werden eingeblendet.
HTTP-Verben
Die API unterstützt die folgende Untergruppe von HTTP-Verben. Bitte beachten Sie, dass nicht alle Funktionen alle Verben unterstützen werden.
Fangen wir an!
Einrichten
Um auf eingeschränkte API-Anfragen zugreifen zu können, muss ein Session Token gesetzt werden. Um ein Token zu setzen, müssen Sie ein gültiges Konto haben.
Die Erstellung von API-Tokens ist in Ihrem Menü Mein Profil verfügbar. Wählen Sie API-Tokens.
Klicken Sie auf Neues API-Token.
Geben Sie den Namen des Tokens ein, für dieses Tutorial haben wir unseren "testToken" genannt, und klicken Sie auf Speichern.
Die Token-ID wird erstellt.
Anmeldung bei der API
Klicken Sie in der API-Schnittstelle auf die Schaltfläche Anmelden oben rechts auf dem Bildschirm und geben Sie Ihren Benutzernamen und Ihr Passwort ein oder geben Sie ein API-Token an. Klicken Sie auf Senden und eine Anmeldeanfrage wird an die API gesendet, um ein gültiges Sitzungs-Token zu erhalten. Dieses Token wird dann verwendet, um alle API-Anfragen zu validieren, die Sie während der Sitzung stellen möchten.
Wie man eine Anfrage an die API stellt
Klicken Sie auf die Gruppe Kampagnen und die Gruppe wird erweitert, um die verfügbaren Anfragen aufzulisten:
Klicken Sie auf die Anfrage, die Sie automatisieren möchten. In diesem Beispiel werden wir Daten für die CID 1923724 anfordern:
Klicken Sie auf Kampagne abrufen, wodurch sich das Fenster öffnet. Geben Sie die ID-Nummer der Kampagne in das Feld ein:
Klicken Sie dann auf die Schaltfläche Jetzt ausprobieren. Der Response Body wird den Code automatisch generieren.
Ein Antwortcode von 200 bedeutet, dass die Verwendung in Ordnung ist.
So pausieren Sie eine Kampagne
Hier ein weiteres Beispiel. Wählen Sie zunächst die richtige Funktion aus der Gruppe "Kampagnen":
Klicken Sie auf Pause für eine oder mehrere Kampagnen. Klicken Sie nach dem Öffnen auf den Beispielwert und dann auf das gelbe Feld. Dadurch wird die json-Struktur automatisch in das Feld body eingefügt.
Der aktuelle Wert ist Null. Ändern Sie nun die Null in die CID, die Sie auf Pause stellen wollen. Klicken Sie dann auf die Schaltfläche Ausprobieren, um den erforderlichen Code zu erzeugen.
So aktualisieren Sie die Preise einer Kampagne
Wählen Sie die richtige Funktion:
Klicken Sie auf Eine Kampagne aktualisieren, um das Fenster zu öffnen. Fügen Sie die CID in das Feld "Kampagnen-ID" ein und klicken Sie dann auf "Beispielwert". Klicken Sie auf das gelbe Feld, um die Json-Struktur in das Feld "Body" zu kopieren.
Dieser Code enthält einige verschiedene Funktionen, aber wir wollen den Code für die Preisgestaltung der Kampagne, also löschen Sie den Teil des Codes, der nicht benötigt wird, und lassen Sie den Code für die Preisgestaltung der Kampagne im Feld, wie unten dargestellt:
Jetzt müssen wir zwei Dinge in der Body Box ändern, das Modell (unten ist eine Liste der Werte, die mit dem Preismodell zusammenhängen).
CampaignPricing {
model (integer, optional): Campaign pricing model (1: CPC, 2: CPM, 3: CPA, 4: Smart CPM, 5: CPV) = [‘1’, ‘2’, ‘3’, ‘4’, ‘5’],
price (number, optional): Campaign price
}
Wir bleiben bei CPC, also belassen wir das Modell bei 1
Nun müssen wir den Preis von Null auf den gewünschten Preis ändern. Wir ändern ihn in 200, was bedeutet, dass der neue Preis 200 Cent oder zwei Euro beträgt.
Klicken Sie dann einfach auf die Schaltfläche Ausprobieren, um den Code zu generieren. Einfach!
Wie Sie sehen können, ist die API vollgepackt mit Automatisierungsfunktionen. Die einzige Grenze ist Ihre Vorstellungskraft, um die Möglichkeiten der Automatisierung zu nutzen.
Abschließend stellen Sie sicher, dass Sie unseren API-Newsletter abonnieren, den Sie unten auf der API-Benutzeroberfläche finden, damit Sie die neuesten Nachrichten und Aktualisierungen erhalten können.