Methode: PUT /api/v1/advertiser/campaign/{id}
Beschreibung: Sie können eine erstellte Werbekampagne über die API für Ihr HilltopAds-Konto aktualisieren.
Bitte beachten Sie, dass diese Methode nur für Popunder mobile und Popunder desktop Formate verfügbar ist.
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. |
campaignID | ID der zu aktualisierenden Werbekampagne
| 123456 | Sie können die ID von nur einer Werbekampagne angeben. Dies ist ein erforderlicher Parameter in der Anfrage. |
Format | In der Kampagne zu aktualisierendes Werbeformat | 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 in der 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 aktualisiert werden muss. | 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 in der 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 in der 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 in der Anfrage. | |
active | Geben Sie den Status der aktualisierten Kampagne an: true - EIN, false - AUS | Wahr, falsch | Wenn Sie den Kampagnenstatus als Wahr (EIN) angeben, wird die Kampagne erst nach der Moderation aktiv. |
targeting | Erforderliche Targeting-Einstellungen für die Werbekampagne. | geo Browser os Gerät Mobilfunkträger iprange osversionen App | Diese Parameter werden als Objekt übergeben. Jeder neue Zielparameter wird mit einem Komma angegeben. |
Beispiel für eine Anfrage:
So aktualisieren Sie die folgenden Parameter in der erstellten Werbekampagne mit der ID 123456:
Rate - bis $2.53
Frequenzkappungen- bis zu 1 Anzeige pro 24 Stunden für Kampagne
URL - zu https://mywebsit2.com
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 das Tool verwenden.
Sie müssen einen Antrag in folgendem Format schreiben:
curl -X PUT --data '{"rate": "2.53", "capTotal":1, "capResetAfter":24, "capForCampaign": "campaign", "url": "https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D"}' https://hilltopads.com/api/v1/advertiser/campaign/123456?key=nXzgO3Bc