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 illustra come utilizzare i target della 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 sempre, pertanto non riceverai più pianificazioni annunci se non hai impostato una pianificazione annunci personalizzata per la tua 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. Il seguente snippet di codice 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 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 degli annunci utilizzando il 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, 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. 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

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 Report location_view.

Rimuovi

Puoi rimuovere una località target utilizzando il metodo remove.

Prossimità

Puoi scegliere come target di una campagna un'area definita da un raggio (di 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 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 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 metodo remove.

Piattaforme

Puoi recuperare l'elenco delle piattaforme di destinazione di una campagna utilizzando il metodo platforms 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 Platform. L'uso 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 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.