Wie erstellt man eine Werbekampagne mit der API?
Methode: POST /api/v1/advertiser/campaign
Beschreibung: Sie können eine Werbekampagne über API für Ihr HilltopAds Werbekonto erstellen.
Bitte beachten Sie, dass diese Methode nur für die Formate Popunder mobile und Popunder desktop zur Verfügung steht.
Parameter:
Name | Beschreibung | Beispiel | Kommentar |
key | Ein eindeutiger API-Schlüssel, den Sie im API-Bereich Ihres HilltopAds-Kontos generieren können | nXzgO3Bc | Dies ist ein erforderlicher Parameter in der Anfrage. |
format | Werbeformat, für das die Kampagne erstellt werden soll. | Popunder mobil | Sie können nur ein Werbeformat angeben. Dies ist ein erforderlicher Parameter in der Anfrage. |
rate | Preis für 1000 Impressionen (TKP). | 1.53 | Alle Preise (Tarife) werden in der Anfrage ohne Währung angegeben, aber im Ergebnis in USD gesetzt. Dies ist ein erforderlicher Parameter für die Anfrage. |
capTotal | Obergrenze der Einblendungshäufigkeit. Dieser Parameter gibt an, wie oft eine Anzeige gezeigt wird. | 2 | Sie können nur eine Nummer angeben. |
capResetAfter | Obergrenze der Einblendungshäufigkeit. Dieser Parameter gibt an, wie lange die Anzeige gezeigt werden soll. | 12 | Sie können nur eine Nummer angeben. |
capForCampaign | Obergrenze der Einblendungshäufigkeit. Dieser Parameter gibt an, ob die Regel für die Kampagne oder das Banner gilt. | Kampagne | Für das Popunder-Format können Sie nur Kampagne angeben. |
channels | Segment und Verkehrskategorie, für die die Anzeige geschaltet werden soll. | Mainstream/Nicht-Mainstream Hohe Aktivität Mainstream/Nicht-Mainstream Mittlere Aktivität Mainstream/Non-Mainstream Geringe Aktivität | Um mehrere Aktivitätssegmente anzugeben, führen Sie diese mit Kommas auf. Beachten Sie, dass Sie nur eine Verkehrskategorie - Mainstream oder Non-Mainstream - angeben können. Dies ist ein erforderlicher Parameter in der Anfrage. |
type | Art der Werbekampagne | CPM, CPC | Bitte beachten Sie, dass Sie derzeit nur den CPM-Kampagnentyp angeben können. Dies ist ein erforderlicher Parameter für die Anfrage. |
name | Name einer Werbekampagne. | Popunder_API | Der Kampagnenname muss eindeutig sein und darf sich nicht mit Namen bereits erstellter Kampagnen wiederholen. Dies ist ein erforderlicher Parameter für die Anfrage. |
url | Bieten Sie einen URL-Link an, an den der Verkehr weitergeleitet werden soll. | Sie können nur einen Link angeben. Dies ist ein erforderlicher Parameter für die Anfrage. | |
active | Geben Sie den Status der erstellten Kampagne an: true - EIN, false - AUS. | Wahr, falsch | Wenn Sie den Kampagnenstatus als Wahr (EIN) angeben, wird die Kampagne erst nach der Moderation aktiv. |
limitImpressionsTotal | Geben Sie den Gesamten Impressionen Begrenzen | 200000 | Sie können nur eine Nummer. |
limitImpressionsDaily | Geben Sie die Täglichen Eindrücke Beschränken | 20000 | Sie können nur eine Nummer. Der min. tägliche Eindrücke limit: 15.000. |
limitBudgetTotal | Geben Sie das Gesamt-Budget-Limit | 2000 | Sie können nur eine Nummer. |
limitBudgetDaily | Geben Sie das Tagesbudget Begrenzen | 50 | Sie können nur eine Nummer. Der min. tägliche budget-limit ist $20. |
filters | Sie können allow/disallow Proxy und WebView Datenverkehr filtern. | Proxy WebView | Diese parameter übergeben wird, als ein Objekt. |
targeting | Erforderlich targeting-Einstellungen für die Werbe-Kampagne.
| geo browser os Gerät Mobilfunkbetreiber iprange osversions App | Diese Parameter übergeben werden, als ein Objekt. Jede neue targeting-parameter angegeben ist, ein Komma. |
uniformDistributionDaily | Wählen Sie aus, wie die Kampagne Grenzen erreicht werden sollte. | ASAP Evenly | Asap – erreichen der angegebenen Kampagne Grenzen so schnell wie möglich |
Targeting-Objekt
Name | Beispiel | Beschreibung |
geo | US GB AU | Geben Sie den zwei-letter-code für das gewünschte Land/die Länder, die durch Kommas getrennt. |
browser | Chrome FireFox Safari |
|
os | Android iOS |
|
Gerät | Handy/smartphone tablet |
|
Mobilfunkbetreiber | AU~vodafone |
|
iprange | 127.0.0.1 |
|
osversions | iOS 15 Win 7 |
Alle verfügbaren Versionen |
App |
|
Targeting-Objekt
Name | Beispiel |
Proxy | Erlauben Disallow Nur |
WebView | Erlauben Disallow Nur |
Beispiel für eine Anfrage:
So erstellen Sie eine Werbekampagne mit den folgenden Parametern:
Anzeigenformat - Popunder mobile
Tarif - $1.53
Häufigkeit der Einblendungen - 2 Anzeigen pro 12 Stunden für die Kampagne
Kanäle - Hauptstrom hohe Aktivität и mittlere Aktivität
Typ - CPM (für ein Popunder-Anzeigenformat können Sie nur CPM angeben)
Name - Popunder_API
URL - .https://mywebsite.com
Aktiv - Wahr
Targeting - GEO: US, UK, DE; Browser: Chrome, Safary; Gerät - mobil
Bitte beachten Sie, dass Sie, wenn Ihr Link das Symbol '&' enthält, diesen in ein URL-kodiertes Format umwandeln müssen. Andernfalls erhalten Sie möglicherweise eine Fehlermeldung in der Antwort auf die Linkänderungsanfrage.
Zum Beispiel, der Link
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}
sollte angegeben werden als
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Um Ihren Link in ein URL-kodiertes Format zu kodieren, können Sie .the tool verwenden
Sie müssen einen Antrag in folgendem Format schreiben:
curl -X POST --data '{"format": "Popunder mobile", "channels":["Mainstream High Activity", "Mainstream Medium Activity"], "type": "CPM", "rate":1.53, "name": "Popunder_API", "url": "https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D", "active":true, "capTotal":2, "capResetAfter":12, "capForCampaign": "campaign", "targeting":{"geo":{"operator": "in", "operand":["US", "UK", "DE"]}, "browser":{"operator": "in", "operand":["Chrome", "Safary"]}, "device":{"operator": "in", "operand":["Mobile/smartphone"]}}}' https://api.hilltopads.com/v1/advertiser/campaign?key=nXzgO3Bc
Entfalte das volle Potenzial der HilltopAds-Werbenetzwerk-API!