Convertire le campagne smart in campagne Performance Max

A partire da v25 (v25.2), puoi utilizzare il metodo SmartCampaignSettingService.GeneratePMaxDraftCampaign per convertire una campagna intelligente in una campagna Performance Max. Questo metodo non è disponibile in v24 e versioni precedenti.

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.

La bozza di campagna Performance Max generata viene inizializzata con il relativo status impostato su PAUSED (e la relativa idoneità alla pubblicazione riflessa in primary_status). Se tutti i convertitori di funzionalità non superano la convalida per la campagna intelligente, la richiesta non va a buon fine e viene visualizzato un errore SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.

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. La generazione della bozza della campagna Performance Max non modifica né mette in pausa la campagna intelligente originale, che rimane attiva finché non la metti in pausa manualmente.

Parametri di richiesta

Il messaggio GeneratePMaxDraftCampaignRequest accetta i seguenti campi:

• resource_name (obbligatorio): il nome della risorsa di SmartCampaignSetting da rigenerare per la campagna intelligente 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 vengono restituiti solo errori di convalida, avvisi o possibili problemi di conversione nel campo validated_info senza creare entità bozza.

• gbp_enabled (non supportato): facoltativo. Se convertire la sede del Profilo dell'attività su Google collegata alla campagna Performance Max. Lascia questo campo non impostato o false; l'impostazione su true non è implementata in v25 e restituisce un errore SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (non supportato): facoltativo. Se generare le immagini della campagna Performance Max richieste (ad esempio tipi di immagini orizzontali, quadrate e con logo). Lascia questo campo non impostato o false; l'impostazione su true non è implementata in v25 e restituisce un errore SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Dettagli della risposta

Il messaggio GeneratePMaxDraftCampaignResponse restituisce i nomi delle risorse della bozza di campagna Performance Max 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 o possibili problemi di conversione restituiti dal controllo delle conversioni (compilati sia quando validate_only è impostato su true sia insieme ai nomi delle risorse delle entità generate quando validate_only è false).

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, esamina e configura il budget, il gruppo di asset e gli asset.
3. Attiva la campagna e metti in pausa l'originale: quando è tutto pronto per la pubblicazione degli annunci, aggiorna lo status della campagna Performance Max a ENABLED, poi aggiorna lo status della campagna smart originale a PAUSED per evitare la pubblicazione di annunci duplicati.