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:

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

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.

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.