Targeting della campagna

Gli script Google Ads ti consentono di modificare le impostazioni di targeting a livello di campagna nei tuoi account. L'assistenza è disponibile per pianificazioni degli annunci, località target ed escluse, prossimità target e piattaforme. Questa guida mostra come utilizzare i target delle campagne.

Pianificazioni annunci

Le pianificazioni degli annunci ti consentono di stabilire quando pubblicare gli annunci.

Recupera

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 di 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 sempre. Di conseguenza, non verranno ripristinate le pianificazioni degli annunci se non hai impostato una pianificazione degli annunci personalizzata per la campagna.

Aggiorna

Dopo aver recuperato una pianificazione annunci, puoi modificarne direttamente le proprietà; ad esempio, puoi aggiornare il modificatore di offerta di una pianificazione annunci nel seguente modo:

adSchedule.setBidModifier(1.1);

Crea

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

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

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

Per ulteriori informazioni sui valori consentiti per ciascun parametro e per ulteriori limitazioni da tenere presenti quando crei le pianificazioni degli annunci, consulta la nostra documentazione.

Rimuovi

Puoi rimuovere una pianificazione degli annunci utilizzando il relativo metodo remove. Per reimpostare la pianificazione degli annunci personalizzata di una campagna, puoi eliminare tutte le pianificazioni degli annunci personalizzate di una campagna nel seguente modo:

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

Località

Puoi anche scegliere come target o escludere le 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 campagna per la pubblicazione in tutti i paesi e tutte le regioni, visualizzerai un elenco vuoto di località.

Aggiorna

Dopo aver recuperato una località, puoi modificarne direttamente le proprietà. Ad esempio, potresti aggiornare il modificatore di offerta di una località nel seguente modo:

location.setBidModifier(1.1);

Crea

Puoi creare località target in una campagna utilizzando il metodo addLocation. Analogamente, 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 pari a 1,15, escludendo New York City.

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

Per l'elenco degli ID da utilizzare quando aggiungi il targeting per località, consulta la documentazione sul targeting geografico dell'API Google Ads. Per monitorare il rendimento delle località target, puoi cercare nella risorsa location_viewReport.

Rimuovi

Puoi rimuovere una località target utilizzando il metodo remove.

Prossimità

Puoi scegliere come target di una campagna un raggio (vicinanze) intorno a una località utilizzando gli script Google Ads.

Recupera

Puoi recuperare l'elenco delle prossimità target utilizzando il metodo targetedProximities per i target della campagna. Il seguente snippet di codice seleziona tutte le prossimità 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 intorno alle 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 esiste una convalida per verificare che l'indirizzo appartenga effettivamente alla latitudine e alla longitudine specificate. L'indirizzo serve solo a modificare ciò che viene visualizzato nell'interfaccia di Gestione campagna.

Rimuovi

Puoi rimuovere un target di prossimità utilizzando il relativo metodo remove.

Piattaforme

Puoi recuperare l'elenco di piattaforme scelte come target da una campagna utilizzando il metodo platforms dei target della campagna. Poiché le campagne Google Ads hanno come target tutte le piattaforme (computer, dispositivi mobili e tablet), non puoi aggiungere o rimuovere un criterio di Platform. 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 durante l'analisi dei report. Quando selezioni direttamente i criteri, puoi utilizzare i metodi helper forniti da PlatformSelector.