Gli script Google Ads ti consentono di utilizzare le impostazioni di targeting a livello di campagna nei tuoi account. Il supporto è disponibile per le pianificazioni pubblicitarie, le località target ed escluse, le vicinanze target e le piattaforme. Questa guida mostra come utilizzare i target delle campagne.
Pianificazioni annunci
Le pianificazioni degli annunci ti consentono di controllare quando devono essere pubblicati i tuoi annunci.
Recuperare
Puoi recuperare le pianificazioni degli annunci di una campagna utilizzando il metodo
adSchedules
dei
target della campagna.
Il seguente snippet di codice mostra come recuperare l'elenco di tutti i criteri AdSchedule
per una campagna:
const campaign = AdsApp.campaigns()
.withCondition("campaign.name = 'My campaign'")
.get()
.next();
const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
// Process your ad schedule.
...
}
Per impostazione predefinita, una campagna viene pubblicata in qualsiasi momento, pertanto non riceverai alcuna pianificazione degli annunci se non ne hai impostata una personalizzata per la campagna.
Aggiorna
Una volta recuperata una pianificazione degli annunci, puoi modificarne direttamente le proprietà. Ad esempio, puoi aggiornare il moltiplicatore di offerta di una pianificazione degli annunci nel seguente modo:
adSchedule.setBidModifier(1.1);
Crea
Per creare una nuova pianificazione annunci, puoi utilizzare il metodo
addAdSchedule
di
Campaign
.
Il seguente snippet di codice crea una pianificazione annunci personalizzata per la campagna dalle
7:00 alle 11:00 nel fuso orario dell'account, ogni sabato, con un aggiustamento dell'offerta
pari a 1,1.
campaign.addAdSchedule({
dayOfWeek: "SATURDAY",
startHour: 7,
startMinute: 0,
endHour: 11,
endMinute: 0,
bidModifier: 1.1
});
Per ulteriori dettagli sui valori consentiti per ciascun parametro, nonché sulle ulteriori limitazioni da tenere presente quando crei pianificazioni degli annunci, consulta la nostra documentazione.
Rimuovi
Puoi rimuovere una pianificazione annunci utilizzando il metodo
remove
. Per reimpostare la pianificazione personalizzata degli annunci di una campagna, puoi eliminare tutte le pianificazioni personalizzate degli annunci nel seguente modo:
const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
adSchedule.remove();
}
Località
Puoi anche scegliere come target o escludere località per la tua campagna utilizzando gli script Google Ads.
Recuperare
Puoi recuperare l'elenco delle
località target
utilizzando il metodo
targetedLocations
dei target della campagna.
Le località escluse possono essere recuperate utilizzando il metodo excludedLocations
. Il seguente snippet di codice seleziona tutte le località di targeting che hanno ricevuto
più di 100 impressioni il mese scorso.
const locations = AdsApp.targeting()
.targetedLocations()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const location of locations) {
// Process the campaign target here.
...
}
Se hai impostato la campagna in modo che venga pubblicata in tutti i paesi e le regioni, riceverai un elenco vuoto di località.
Aggiorna
Una volta recuperata una posizione, puoi modificarne direttamente le proprietà. Ad esempio, puoi aggiornare il modificatore offerta di una località nel seguente modo:
location.setBidModifier(1.1);
Crea
Puoi creare località target in una campagna utilizzando il metodo
addLocation
. Allo stesso modo, puoi escludere una località utilizzando il metodo
excludeLocation
. Il seguente snippet di codice ha come target una campagna per gli Stati Uniti con un aggiustamento
dell'offerta di 1,15, escludendo New York.
campaign.addLocation(2840, 1.15); // United States
campaign.excludeLocation(1023191); // New York city
Puoi consultare la
documentazione sul targeting geografico dell'API Google Ads
per l'elenco degli ID da utilizzare quando aggiungi il targeting per località. Per monitorare il rendimento dei tuoi target di località, puoi eseguire una ricerca nella risorsa Report location_view
.
Rimuovi
Puoi rimuovere una località target utilizzando il metodo
remove
.
Prossimità
Puoi scegliere come target di una campagna un raggio (prossimità) intorno a una località utilizzando gli script Google Ads.
Recuperare
Puoi recuperare l'elenco delle vicinanze target utilizzando il metodo
targetedProximities
nei target della campagna.
Il seguente snippet di codice seleziona tutte le vicinanze target che hanno ricevuto
più di 100 impressioni il mese scorso.
const proximities = AdsApp.targeting()
.targetedProximities()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const proximity of proximities) {
...
}
Crea
Puoi creare un target di prossimità per una campagna utilizzando il metodo
addProximity
. Il seguente snippet di codice ha come target una campagna a 20 chilometri di distanza dalle coordinate (37.423021, -122.083739).
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");
Puoi anche utilizzare questo metodo per creare lo stesso target di prossimità con un aggiustamento dell'offerta e un indirizzo:
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
bidModifier: 1.15,
address: {
streetAddress: "1600 Amphitheatre Parkway",
cityName: "Mountain View",
provinceName: "California",
provinceCode: "CA",
postalCode: "94043",
countryCode: "US"
}
});
Tieni presente che non esiste alcuna convalida per verificare che l'indirizzo appartenga effettivamente alla latitudine e alla longitudine indicate. L'indirizzo non ha altro scopo se non quello di modificare ciò che viene visualizzato nell'interfaccia di gestione delle campagne.
Rimuovi
Puoi rimuovere un target di prossimità utilizzando il metodo
remove
.
Piattaforme
Puoi recuperare l'elenco delle piattaforme a cui è destinata una campagna utilizzando il metodo
platforms
di targets della campagna.
Poiché le campagne Google Ads hanno come target tutte le piattaforme (computer, dispositivi mobili e tablet),
non puoi aggiungere o rimuovere un
Platform
criterio. L'utilizzo più comune di questo criterio di targeting è l'impostazione dell'aggiustamento delle offerte per dispositivo della campagna:
campaign.targeting()
.platforms()
.mobile()
.get()
.next().
setBidModifier(1.2);
Gli ID piattaforma sono condivisi tra le campagne e hanno valori predefiniti come
specificato nell'
appendice delle piattaforme dell'API Google Ads.
Questi ID possono essere utili per analizzare i report. Quando selezioni i criteri direttamente,
puoi utilizzare i metodi helper forniti da
PlatformSelector
.