Converti le campagne smart in campagne Performance Max

A partire dalla release v25_2, l'API Google Ads introduce il metodo SmartCampaignSettingService.GeneratePMaxDraftCampaign per aiutarti a convertire una campagna intelligente in una campagna Performance Max.

Come funziona la conversione

Quando chiami SmartCampaignSettingService.GeneratePMaxDraftCampaign, l'API genera una bozza di campagna Performance Max in base alla configurazione di una campagna intelligente esistente.

La bozza di campagna Performance Max generata viene inizializzata con i seguenti valori di stato:

• status è impostato su PAUSED.
• creation_status è impostato su INCOMPLETE.

In questo modo puoi esaminare, modificare e migliorare la campagna Performance Max, il budget, il gruppo di asset e gli asset generati prima di attivare la campagna per la pubblicazione degli annunci.

Parametri di richiesta

Attenzione:i parametri gbp_enabled e image_enabled non sono attualmente implementati e causeranno errori se impostati su true in una richiesta. Questi campi verranno abilitati in una release futura.

Il messaggio GeneratePMaxDraftCampaignRequest accetta i seguenti campi:

• resource_name (obbligatorio): il nome della risorsa SmartCampaignSetting associata alla campagna intelligente esistente che vuoi convertire, nel seguente formato:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (facoltativo): se true, la richiesta viene convalidata ma non eseguita. Nella risposta viene restituito solo il campo validated_info con errori di convalida, avvisi o possibili problemi di conversione.

• gbp_enabled (non supportato al momento): indica se convertire e collegare la sede del profilo dell'attività su Google associata alla campagna smart alla campagna Performance Max generata. L'impostazione di questo campo su true non è attualmente implementata e restituirà un errore GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (Attualmente non supportato): indica se generare automaticamente le immagini richieste per la campagna Performance Max (ad esempio asset immagine orizzontali, quadrati e con logo). L'impostazione di questo campo su true non è attualmente implementata e restituirà un errore IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Dettagli della risposta

Il messaggio GeneratePMaxDraftCampaignResponse restituisce i nomi delle risorse della bozza di campagna Performance Max appena generata e delle relative entità:

• pmax_campaign: il nome della risorsa Campaign della bozza di campagna Performance Max generata.
• campaign_budget: il nome della risorsa CampaignBudget collegata alla campagna Performance Max generata.
• asset_group: il nome della risorsa AssetGroup collegata alla campagna Performance Max generata.
• assets: un elenco di nomi di risorse Asset collegati alla campagna Performance Max generata.
• validated_info: informazioni di convalida aggiuntive o possibili problemi di conversione restituiti quando validate_only è impostato su true.

Workflow consigliato

Per convertire una campagna intelligente, utilizza il seguente flusso di lavoro:

1. Genera la bozza di campagna: chiama SmartCampaignSettingService.GeneratePMaxDraftCampaign con solo il set resource_name obbligatorio (lascia gbp_enabled e image_enabled non impostati o impostati su false). Salva i nomi delle risorse pmax_campaign, campaign_budget, asset_group e assets restituiti.
2. Esamina e personalizza la campagna: poiché la bozza di campagna Performance Max viene creata con status = PAUSED e creation_status = INCOMPLETE, esamina e configura il budget, il gruppo di asset e gli asset.
3. Attiva la campagna: quando gli annunci sono pronti per l'erogazione, aggiorna lo status della campagna impostandolo su ENABLED e il creation_status su COMPLETE.

Nota:una volta attivati gbp_enabled e image_enabled in una release futura, potrai anche eseguire la migrazione automatica delle sedi GBP e degli asset immagine.