Zum Hauptinhalt springen

Erstellen Sie eine Werbekampagne

Alles über die API-Methode, mit der Sie eine Werbekampagne erstellen können.

HilltopAds avatar
Verfasst von HilltopAds
Vor über einer Woche aktualisiert

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
Evenly schrittweise erreichen des angegebenen Grenzen den ganzen Tag / über den gesamten Zeitraum


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

Facebook

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

  • 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!

Hat dies deine Frage beantwortet?