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. |
targeting | Impostazioni di targeting necessarie per la campagna pubblicitaria.
| geo browser os dispositivo vettore mobile iprange osversioni App | Questi parametri vengono passati come oggetto. Ogni nuovo parametro di puntamento è specificato con una virgola. |
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://hilltopads.com/api/v1/advertiser/campagna?key=nXzgO3Bc