Targeting della campagna

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

Pianificazioni annunci

Le pianificazioni annunci ti consentono di controllare quando devono essere pubblicati i tuoi annunci.

Recuperare

Puoi recuperare le pianificazioni annunci di una campagna utilizzando il adSchedules metodo dei target della campagna. Il seguente snippet di codice mostra come recuperare l'elenco di tutti i AdSchedule 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, quindi non riceverai alcuna pianificazione 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 un modificatore di offerta di una pianificazione degli annunci nel seguente modo:

adSchedule.setBidModifier(1.1);

Crea

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

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

Nota: è previsto 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 di ogni giorno in 24 periodi di 1 ora.

Per ulteriori dettagli sui valori consentiti per ogni parametro, nonché sulle restrizioni aggiuntive da tenere presenti durante la creazione delle pianificazioni 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 targetedLocations metodo dei targetdella campagna. Le località escluse possono essere recuperate utilizzando il excludedLocations metodo. 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 in modo che venga pubblicata in tutti i paesi e le regioni, riceverai un elenco vuoto di località.

Aggiorna

Una volta recuperata una località, puoi modificarne direttamente le proprietà. Ad esempio, puoi aggiornare un modificatore di offerta di una località nel seguente modo:

location.setBidModifier(1.1);

Crea

Puoi creare target per località in una campagna utilizzando il suo addLocation metodo. Allo stesso modo, puoi escludere una località utilizzando il excludeLocation metodo. Il seguente snippet di codice ha come target una campagna negli 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

Per l'elenco degli ID da utilizzare quando aggiungi il targeting per località, consulta la documentazione relativa al targeting geografico dell'API Google Ads. Per monitorare il rendimento dei target per località, puoi cercare la location_view risorsa del report.

Rimuovi

Puoi rimuovere un target per località utilizzando il remove metodo.

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 prossimità target utilizzando il targetedProximities metodo dei 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 suo addProximity metodo. Il seguente snippet di codice ha come target una campagna a 20 chilometri 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 è prevista 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 suo remove metodo.

Piattaforme

Puoi recuperare l'elenco delle piattaforme target di una campagna utilizzando il platforms metodo dei targetdella 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 dell'offerta per dispositivo della campagna:

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

Gli ID delle piattaforme 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 l'analisi dei report. Quando selezioni i criteri direttamente, puoi utilizzare i metodi helper forniti da PlatformSelector.