Come creare una campagna pubblicitaria utilizzando l'API?
Metodo: POST /api/v1/advertiser/campaign
Descrizione: È possibile creare una campagna pubblicitaria tramite API per il proprio account pubblicitario HilltopAds.
Si prega di notare che questo metodo è disponibile solo per i formati Popunder mobile e Popunder desktop.
Parametri:
nome | descrizione | esempio | commento |
key | Una chiave API unica che potete generare nella sezione API del vostro account HilltopAds. | nXzgO3Bc | È un parametro obbligatorio della richiesta. |
format | Formato pubblicitario per il quale deve essere creata la campagna. | Popunder mobile | È possibile specificare un solo formato pubblicitario. È un parametro obbligatorio della richiesta. |
rate | Prezzo per 1000 impressioni (CPM). | 1.53 | Tutti i prezzi (tariffe) sono specificati nella richiesta senza valuta, ma saranno impostati in USD nel risultato. È un parametro obbligatorio della richiesta. |
capTotale | Limite di frequenza delle impressioni. Questo parametro indica il numero di volte in cui un annuncio viene visualizzato. | 2 | È possibile specificare un solo numero. |
capResetAfter | Limite di frequenza delle impressioni. Questo parametro indica per quanto tempo mostrare l'annuncio. | 12 | È possibile specificare un solo numero. |
capPerCampagna | Limite di frequenza delle impressioni. Questo parametro indica se la regola si applica alla campagna o al banner. | campagna | Per il formato Popunder, è possibile specificare solo campagna. |
channels | Segmento e categoria di traffico per cui l'annuncio deve essere lanciato. | Mainstream/non-mainstream Alta attività Mainstream/non-mainstream Attività media Mainstream/non-mainstream Bassa attività | Per specificare più segmenti di attività, elencarli con le virgole. Si noti che è possibile specificare una sola categoria di traffico, mainstream o non mainstream. È un parametro obbligatorio della richiesta. |
type | Tipo di campagna pubblicitaria | CPM, CPC | Si prega di notare che attualmente è possibile specificare solo il tipo di campagna CPM. È un parametro obbligatorio della richiesta. |
name | Nome di una campagna pubblicitaria. | Popunder_API | Il nome della campagna deve essere unico e non deve essere ripetuto con nomi di campagne già create. È un parametro obbligatorio della richiesta. |
url | Offrire il link all'URL dove deve essere inviato il traffico. | È possibile specificare un solo collegamento. È un parametro obbligatorio della richiesta. | |
active | Specificare lo stato della campagna creata: true - ON, false - OFF. | Vero, falso | Se si specifica lo stato della campagna come Vero (ON), la campagna diventerà attiva solo dopo la moderazione. |
limitImpressionsTotal | Specificare il Totale delle Impressioni Limite | 200000 | È possibile specificare un solo numero. |
limitImpressionsDaily | Specificare il Limite di impression al giorno | 20000 | È possibile specificare un solo numero. Il min. impression al giorno limite di 15.000. |
limitBudgetTotal | Specificare il Totale Limite di Budget | 2000 | È possibile specificare un solo numero. |
limitBudgetDaily | Specificare il Budget Giornaliero Limite | 50 | È possibile specificare un solo numero. Il min. budget giornaliero limite è di $20. |
filters | È possibile consentire o non consentire l'accesso Proxy e WebView traffico filtri. | Proxy WebView | Questo parametro viene passato come un oggetto. |
targeting | Richiesto impostazioni di targeting per la campagna pubblicitaria.
| geo browser os dispositivo mobilecarrier iprange osversions App | Questi parametri vengono passati come un oggetto. Ogni nuovo sistema di targeting, viene specificato il parametro con una virgola. |
uniformDistributionDaily | Scegliere la modalità campagna limiti di dovrebbe essere raggiunto. | ASAP Evenly | Asap – raggiungere specificato campagna limiti il più rapidamente possibile |
Targeting oggetto
Nome | Esempio | Descrizione |
geo | NOI GB AU | Immettere il codice di due lettere di richiesta del paese/dei paesi, separati da virgole. |
browser | Chrome FireFox Safari |
|
os | Android iOS |
|
dispositivo | cellulare/smartphone tablet |
|
mobilecarrier | AU~vodafone |
|
iprange | 127.0.0.1 |
|
osversions | iOS 15 Win 7 |
Tutte le versioni disponibili |
App |
|
Targeting oggetto
Nome | Esempio |
Proxy | Consentire Non consentire Solo |
WebView | Consentire Non consentire Solo |
Esempio di richiesta:
Per creare una campagna pubblicitaria con i seguenti parametri:
Formato annuncio - Popunder mobile
Tariffa - 1,53 dollari
Frequenza capping - 2 visualizzazioni ogni 12 ore per la campagna
Canali - mainstream alta attività и media attività
Tipo - CPM (per un formato pubblicitario Popunder è possibile specificare solo CPM)
Nome - Popunder_API
URL - https://mywebsite.com.
Attivo - Vero
Targeting - GEO: US, UK, DE; Browser: Chrome, Safary; Dispositivo - mobile
Se il link contiene il simbolo "&", è necessario codificarlo in formato URL. In caso contrario, si potrebbe ricevere un errore nella risposta alla richiesta di modifica del link.
Ad esempio, il link
https://mywebsite.com/?token={{ctoken}}&zone={{zone_id}}deve essere specificato come
https%3A%2F%2Fmywebsite.com%2F%3Ftoken%3D%26zone%3D
Per codificare il vostro link in formato URL, potete utilizzare lo strumento.
È necessario scrivere una richiesta nel seguente formato:
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/campagna?key=nXzgO3BcSblocca tutto il potenziale dell’API della rete pubblicitaria HilltopAds!