Passer au contenu principal

Créer une campagne de publicité

Tout sur la méthode API avec laquelle vous pouvez créer une campagne publicitaire.

HilltopAds avatar
Écrit par HilltopAds
Mis à jour il y a plus d’une semaine

Comment créer une campagne publicitaire avec l’API ?

Méthode : POST /api/v1/advertiser/campagne

Description : Vous pouvez créer une campagne publicitaire via l'API pour votre compte publicitaire HilltopAds.

Veuillez noter que cette méthode n'est disponible que pour les formats Popunder mobile et Popunder desktop.

Paramètres :

nom

description

exemple

commentaire

key

Une clé API unique que vous pouvez générer dans la section API de votre compte HilltopAds.

nXzgO3Bc

Il s'agit d'un paramètre obligatoire dans la demande.

format

Format publicitaire pour lequel la campagne doit être créée.

Popunder mobile

Vous ne pouvez spécifier qu'un seul format de publicité.

Il s'agit d'un paramètre obligatoire dans la demande.

rate

Prix pour 1000 impressions (CPM).

1.53

Tous les prix (taux) sont spécifiés dans la demande sans la devise, mais seront exprimés en USD dans le résultat.

Il s'agit d'un paramètre obligatoire dans la demande.

capTotal

Plafond de la fréquence d'impression. Ce paramètre indique le nombre de fois qu'une annonce est diffusée.

2

Vous ne pouvez spécifier qu'un seul numéro.

capResetAfter

Plafond de la fréquence d'impression. Ce paramètre indique la durée d'affichage de la publicité.

12

Vous ne pouvez spécifier qu'un seul numéro.

capForCampaign

Plafond de la fréquence d'impression. Ce paramètre indique si la règle s'applique à la campagne ou à la bannière.

campagne

Pour le format Popunder, vous ne pouvez spécifier que campagne.

channels

Segment et catégorie de trafic pour lesquels la publicité doit être lancée.

Principal/non principal Haute activité

Activités générales/non générales Activité moyenne

Généraliste/non généraliste Faible activité

Pour spécifier plusieurs segments d'activité, vous devez les énumérer avec des virgules. Notez que vous ne pouvez spécifier qu'une seule catégorie de trafic - grand public ou non grand public.

Il s'agit d'un paramètre obligatoire dans la demande.

type

Type de campagne publicitaire

CPM, CPC

Veuillez noter qu'à l'heure actuelle, vous ne pouvez spécifier que le type de campagne CPM.

Il s'agit d'un paramètre obligatoire dans la demande.

name

Nom d'une campagne publicitaire.

Popunder_API

Le nom de la campagne doit être unique et ne pas être répété avec les noms des campagnes déjà créées.

Il s'agit d'un paramètre obligatoire dans la demande.

url

Proposer le lien URL où le trafic doit être envoyé.

Vous ne pouvez spécifier qu'un seul lien.

Il s'agit d'un paramètre obligatoire dans la demande.

active

Indiquez le statut de la campagne créée : true - activé, false - désactivé.

Vrai, faux

Si le statut de la campagne est Vrai (ON), la campagne ne sera active qu'après modération.

limitImpressionsTotal

Indiquez le nombre Total d'Impressions Limite

200000

Vous ne pouvez spécifier qu'un seul numéro.

limitImpressionsDaily

Spécifiez le Quotidien Impressions Limite

20000

Vous ne pouvez spécifier qu'un seul numéro. Le min. quotidien impressions limite est de 15 000.

limitBudgetTotal

Spécifiez le Budget Total de la Limite de

2000

Vous ne pouvez spécifier qu'un seul numéro.

limitBudgetDaily

Spécifiez le Quotidien de Limite de Budget

50

Vous ne pouvez spécifier qu'un seul numéro. Le min. le budget quotidien de la limite est de 20$.

filters

Vous pouvez autoriser/interdire Proxy et WebView trafic des filtres.

Proxy

WebView

Ces paramètres sont transmis comme un objet.

targeting

Nécessaire de paramètres de ciblage pour la campagne de publicité.


geo

navigateur

os

appareil

opérateur_mobile

iprange

osversions

App

Ces paramètres sont transmis comme un objet. Chaque nouveau ciblage paramètre est spécifié avec une virgule.

uniformDistributionDaily

Choisissez la façon dont la campagne limites devrait être atteint.

ASAP

Evenly

Asap – atteindre la campagne des limites, aussi rapidement que possible
Evenly – progressivement atteindre les limites spécifiées au long de la journée / de plus l'ensemble de la période


Targeting object

Name

Example

Description

geo

US

GB

AU

Enter the two-letter code of the required country/countries, separated by commas.

browser

Chrome

FireFox

Safari

os

Android

iOS

device

mobile/smartphone

tablet

mobilecarrier

AU~vodafone

iprange

127.0.0.1

osversions

iOS 15

Win 7

All available versions

App

Facebook

Targeting object

Name

Example

Proxy

Allow

Disallow

Only

WebView

Allow

Disallow

Only

Exemple de demande :

Pour créer une campagne publicitaire avec les paramètres suivants :

  • Format de l'annonce - Popunder mobile

  • Taux - 1,53

  • Fréquence des captures - 2 affichages par 12 heures pour la campagne

  • Canaux - activité principale élevée и activité moyenne

  • Type - CPM (pour un format publicitaire Popunder, vous pouvez spécifier uniquement le CPM)

  • Nom - Popunder_API

  • Actif - Vrai

  • Ciblage - GEO : US, UK, DE ; Navigateur : Chrome, Safari ; Appareil - mobile

Veuillez noter que si votre lien contient le symbole "& ;", vous devez l'encoder au format URL-encodé. Dans le cas contraire, vous risquez de recevoir une erreur dans la réponse à la demande de modification du lien.

Par exemple, le lien

https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}

doit être spécifié comme

https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D

Pour coder votre lien au format URL, vous pouvez utiliser l'outil.

Vous devez rédiger une demande dans le format suivant :

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

Débloquez tout le potentiel de l’API du réseau publicitaire HilltopAds !

Avez-vous trouvé la réponse à votre question ?