Convertire le campagne smart in campagne Performance Max

In v25 e versioni successive, puoi utilizzare il SmartCampaignSettingService.GeneratePMaxDraftCampaign metodo per convertire una campagna intelligente in una campagna Performance Max. Questo metodo non è disponibile nella v24 e versioni precedenti.

Come funziona la conversione

Quando chiami SmartCampaignSettingService.GeneratePMaxDraftCampaign, l' API genera una bozza di campagna Performance Max, un budget, un gruppo di asset e asset, in base alla configurazione della campagna intelligente fornita nella richiesta. Una volta generati, devi esaminare, modificare e migliorare le nuove risorse prima di attivare la campagna per la pubblicazione degli annunci.

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

• status è impostato su PAUSED.
• L'idoneità alla pubblicazione è indicata in primary_status.
• contains_eu_political_advertising è impostato su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING per impostazione predefinita (se non è già stato specificato nella campagna intelligente). Verifica e aggiorna questo campo se la tua campagna contiene pubblicità politica nell'UE.

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.

Bozze degli asset

La nuova campagna è accompagnata da un gruppo di immagini segnaposto che devono essere sostituite prima che la nuova campagna venga attivata. Quando il campo image_enabled è supportato e impostato su true nella richiesta, l'API genera automaticamente le immagini anziché utilizzare immagini segnaposto. Puoi esaminare i nuovi asset nel campo assets della risposta e sostituirli seguendo questi passaggi:

1. Consulta la guida ai requisiti degli asset.
2. Carica nuove immagini seguendo l'esempio di caricamento degli asset immagine.
3. Collega i nuovi asset al gruppo di asset della bozza di campagna e poi rimuovi i AssetGroupAsset link per le immagini segnaposto (nella stessa richiesta di modifica atomica o dopo aver collegato i nuovi asset in modo che i requisiti minimi degli asset rimangano soddisfatti) seguendo la guida Collegare i gruppi di asset agli asset.

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, nel campo validated_info vengono restituiti solo errori di convalida, avvisi o possibili problemi di conversione senza creare entità bozza.

• gbp_enabled (non supportato): facoltativo. Indica 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 è supportata e restituisce un SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED errore.

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

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 di conversione (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 workflow:

1. Genera la bozza di campagna: chiama SmartCampaignSettingService.GeneratePMaxDraftCampaign con solo il campo resource_name obbligatorio impostato (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 e metti in pausa l'originale: quando è tutto pronto per la pubblicazione degli annunci, aggiorna status della campagna Performance Max su ENABLED, quindi aggiorna status della campagna intelligente originale su PAUSED per evitare la pubblicazione di annunci duplicati.