Targeting della campagna

Gli script Google Ads ti consentono di utilizzare le impostazioni di targeting a livello di campagna nei tuoi account. È disponibile assistenza per pianificazioni degli annunci, località scelti come target ed escluse, prossimità e piattaforme scelti come target. Questa guida mostra come lavorare con i target di campagna.

Pianificazioni annunci

Le programmazioni degli annunci ti consentono di controllare quando devono essere pubblicati.

Recupera

Puoi recuperare le pianificazioni degli annunci di una campagna utilizzando il metodo adSchedules del target della campagna. Il seguente snippet di codice mostra come recuperare l'elenco di tutti AdSchedule i criteri 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 hai impostato una pianificazione degli annunci personalizzata per la campagna.

Aggiorna

Dopo aver recuperato una pianificazione degli annunci, puoi modificarne direttamente le proprietà. Ad esempio, puoi aggiornare il modificatore dell'offerta di una pianificazione degli annunci come segue:

adSchedule.setBidModifier(1.1);

Crea

Per creare una nuova pianificazione degli annunci, puoi utilizzare il metodo addAdSchedule di Campaign. Il seguente snippet di codice crea una pianificazione degli annunci personalizzata per la campagna dalle 07:00 alle 11:00 nel fuso orario dell'account, ogni sabato, con un modificatore dell'offerta di 1,1.

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
});

Nota: esiste un limite di sei pianificazioni annunci per ogni giorno della settimana. Ad esempio, è supportata la suddivisione di ogni giorno in sei periodi di 4 ore, ma non la suddivisione in 24 periodi di 1 ora.

Per ulteriori dettagli sui valori consentiti per ciascun parametro, nonché sulle limitazioni aggiuntive da tenere presenti durante la creazione delle pianificazioni degli annunci, consulta la nostra documentazione.

Rimuovi

Puoi rimuovere una pianificazione annunci utilizzando il relativo metodo.remove Per reimpostare la pianificazione personalizzata degli annunci di una campagna, puoi eliminare tutte le sue 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.

Recupera

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à target 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 pubblicazione della campagna in tutti i paesi e le regioni, verrà visualizzato un elenco vuoto di località.

Aggiorna

Una volta recuperata una stazione di ricarica, puoi modificarne direttamente le proprietà. Ad esempio, puoi aggiornare il modificatore dell'offerta di una località come segue:

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 modificatore di offerta di 1, 15 ed esclude New York.

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

Puoi consultare la documentazione del targeting geografico dell'API Google Ads per l'elenco degli ID da utilizzare quando aggiungi il targeting per località. Per monitorare il rendimento dei targeting per località, puoi eseguire ricerche nella risorsa location_view Report.

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.

Recupera

Puoi recuperare l'elenco delle prossimità 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 relativo metodo addProximity. Il seguente snippet di codice sceglie come target una campagna a 20 chilometri dalle coordinate (37,423021 -122,083739).

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

Puoi utilizzare questo metodo anche per creare lo stesso target di prossimità con un modificatore di 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 viene eseguita alcuna convalida per verificare che l'indirizzo appartenga effettivamente alla latitudine e alla longitudine specificate. 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 relativo metodo remove.

Piattaforme

Puoi recuperare l'elenco delle piattaforme di destinazione di una campagna utilizzando il metodo platforms del campo target. Poiché le campagne Google Ads hanno come target tutte le piattaforme (computer, dispositivi mobili e tablet), non puoi aggiungere o rimuovere un criterio Platform. L'utilizzo più comune di questo criterio di targeting è impostare l'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 sulle piattaforme dell'API Google Ads. Questi ID possono essere utili durante l'analisi dei report. Quando selezioni direttamente i criteri, puoi utilizzare i metodi di assistenza forniti da PlatformSelector.