Campagne intelligenti

Attenzione: a partire dal 23 settembre 2026, la creazione di campagne intelligenti è deprecata e non è più supportata. Il tentativo di creare una campagna intelligente restituisce SmartCampaignError.CREATION_FAILED in v24 e versioni successive o AuthorizationError.ACTION_NOT_PERMITTED in v23. Le campagne intelligenti nel tuo account continuano a pubblicare annunci e possono comunque essere aggiornate o interrogate nei report.

Nota: in v25 e versioni successive, puoi utilizzare SmartCampaignSettingService.GeneratePMaxDraftCampaign per convertire una campagna intelligente in una campagna Performance Max (non disponibile in v24 e versioni precedenti). Per maggiori dettagli, consulta la guida Converti le campagne intelligenti in campagne Performance Max.

Le campagne intelligenti sono progettate per aiutare le piccole imprese a raggiungere più clienti online. Richiedono una configurazione e una manutenzione minime. Le campagne intelligenti si basano sulla tecnologia pubblicitaria di Google per ottimizzare automaticamente la campagna in base ai dettagli della tua attività e ai tuoi obiettivi, che si tratti di chiamate dei clienti, visite alla tua sede o azioni sul tuo sito web.

Creazione della campagna

Il flusso di lavoro per la creazione di campagne intelligenti richiede alcuni passaggi diversi rispetto ad altri tipi di campagne. Come best practice, aggiungi le entità in una singola richiesta GoogleAdsService.Mutate.

Di seguito sono riportati i passaggi del workflow di creazione delle campagne intelligenti (le relazioni e le impostazioni delle entità descritte in questi passaggi si applicano anche quando esamini o aggiorni le campagne intelligenti nel tuo account). Per ulteriori dettagli, consulta l'esempio di codice completo.

1. Crea un elenco di temi delle parole chiave con i suggerimenti della SmartCampaignSuggestService, della KeywordThemeConstantService o con temi delle parole chiave in formato libero. Questi temi delle parole chiave vengono utilizzati per recuperare diversi livelli di suggerimenti per il budget, creare criteri per le campagne basate sui temi delle parole chiave e generare suggerimenti per le creatività degli annunci di testo.
2. Recupera i suggerimenti per l'importo del budget, i titoli e le descrizioni degli annunci da SmartCampaignSuggestService. Questo servizio utilizza le informazioni sulla tua attività, la località target, la lingua di destinazione e i temi delle parole chiave per suggerire un importo del budget giornaliero high, low o recommended, nonché fino a tre titoli e due testi descrittivi per l'annuncio stesso.
3. Crea una CampaignBudget utilizzando l'importo del budget suggerito. L'utilizzo dell'importo del budget suggerito consente di massimizzare il rendimento della campagna. Il budget di una campagna intelligente non può essere condiviso con altre campagne.
4. Crea un Campaign e un SmartCampaignSetting. Un SmartCampaignSetting non può esistere separatamente dal Campaign a cui è associato, quindi crea le due entità insieme nella stessa richiesta Mutate utilizzando nomi di risorse temporanei negativi (come customers/{customer_id}/campaigns/-1) per collegare le risorse dipendenti.
5. Crea un elenco di oggetti CampaignCriterion. Questa guida utilizza i temi delle parole chiave compilati nel passaggio 1 per creare i criteri della campagna per i temi delle parole chiave e descrive anche gli altri tipi di criteri della campagna supportati.
6. Crea un AdGroup. A una campagna intelligente può essere associato un solo AdGroup.
7. Crea un AdGroupAd utilizzando un SmartCampaignAdInfo contenente da 3 a 15 titoli e da 2 a 4 descrizioni.

Sede del profilo dell'attività

Quando generi suggerimenti o configuri una campagna, fornisci l'identificatore della sede del profilo dell'attività per massimizzare il rendimento della campagna intelligente.

L'identificatore della sede di Profilo dell'attività può essere ottenuto dal campo name dell'API Business Profile o dall' interfaccia utente di Profilo dell'attività.

Se impostato sull'oggetto SmartCampaignSuggestionInfo o SmartCampaignSetting, l'identificatore deve essere una stringa nel seguente formato:

locations/locationId

Se viene recuperato dall'API Business Profile, l'identificatore è già nel formato corretto. Tuttavia, se viene recuperato dalla UI, l'identificatore deve essere aggiunto a locations/.

Stato della campagna

Per recuperare lo stato di una campagna intelligente, chiama SmartCampaignSettingService.GetSmartCampaignStatus con il resource_name della SmartCampaignSetting della campagna (customers/{customer_id}/smartCampaignSettings/{campaign_id}). Questo metodo fornisce una visualizzazione più aggregata dello stato di una campagna intelligente rispetto a campaign.primary_status o campaign.primary_status_reasons.

GetSmartCampaignStatusResponse include SmartCampaignStatus (ELIGIBLE, NOT_ELIGIBLE, PENDING, PAUSED, REMOVED o ENDED) insieme ai dettagli specifici dello stato:

• not_eligible_details: include SmartCampaignNotEligibleReason (ACCOUNT_ISSUE, BILLING_ISSUE, BUSINESS_PROFILE_LOCATION_REMOVED o ALL_ADS_DISAPPROVED).
• eligible_details: include last_impression_date_time (il timestamp dell'ultima impressione osservata nelle 48 ore precedenti) e end_date_time (se applicabile).
• paused_details, removed_details e ended_details: includi i rispettivi timestamp paused_date_time, removed_date_time o end_date_time nel fuso orario del cliente (yyyy-MM-dd HH:mm:ss).

Considerazioni per i report

Le campagne intelligenti sono progettate con una struttura semplificata, che limita ogni campagna a un singolo gruppo di annunci. Questa struttura ha implicazioni specifiche per i report:

• Metriche a livello di gruppo di annunci: poiché esiste un solo gruppo di annunci per campagna intelligente, tutte le metriche sul rendimento (come clic, impressioni e conversioni) a livello di gruppo di annunci sono identiche alle metriche dell'intera campagna.
• Recupero delle metriche: quando esegui query per i dati sul rendimento, puoi recuperare le metriche a livello di campagna. Sebbene sia possibile recuperare le metriche a livello di gruppo di annunci, queste non forniscono ulteriori dettagli oltre a quelli disponibili a livello di campagna.

Per la maggior parte delle esigenze di generazione di report relative alle campagne intelligenti, l'esecuzione di query su campaign e sulle metriche associate fornisce un quadro completo del rendimento.