Metodo: PUT /api/v1/advertiser/campaign/{id}
Descrizione: È possibile aggiornare una campagna pubblicitaria creata attraverso l'API del proprio account 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. |
campagnaID | ID della campagna pubblicitaria da aggiornare
| 123456 | È possibile specificare l'ID di una sola campagna pubblicitaria. È un parametro obbligatorio della richiesta. |
format | Formato pubblicitario da aggiornare nella 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 aggiornato. | 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. È 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 aggiornata: 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 aggiornare i seguenti parametri nella campagna pubblicitaria creata con l'ID 123456:
Tariffa - a 2,53 dollari
Frequenza capping - a 1 display ogni 24 ore per campagna
URL - a https://mywebsit2.com
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 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