Convertire le campagne smart in campagne Performance Max

In v25 e versioni successive, 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, un budget, un gruppo di asset e degli asset in base alla configurazione della campagna intelligente fornita nella richiesta. Una volta generate, devi esaminare, modificare e migliorare le nuove risorse prima di attivare la campagna per la pubblicazione degli annunci.

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

  • status è impostato su PAUSED.
  • La sua idoneità alla pubblicazione si riflette in primary_status.
  • contains_eu_political_advertising è impostato su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING per impostazione predefinita (se non è già 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 pubblicare gli 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 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 di un asset immagine.
  3. Collega i nuovi asset al gruppo di asset della campagna bozza e poi rimuovi i link AssetGroupAsset 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 per collegare i gruppi di asset agli asset.

Parametri di richiesta

Il messaggio GeneratePMaxDraftCampaignRequest accetta i seguenti campi:

  • resource_name (obbligatorio): il nome della risorsa 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 è supportata e restituisce un errore SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

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

Dettagli della risposta

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

  • pmax_campaign: il nome della risorsa Campaign della bozza della 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 delle risorse Asset collegate alla campagna Performance Max generata.
  • validated_info: informazioni di convalida o possibili problemi di conversione restituiti dal controllo della conversione (compilati sia quando validate_only è impostato su true sia insieme ai nomi delle risorse delle entità generate quando validate_only è false).

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

  1. Genera la bozza della campagna: chiama SmartCampaignSettingService.GeneratePMaxDraftCampaign impostando solo il campo 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 della campagna Performance Max viene creata con status = PAUSED e creation_status = INCOMPLETE, controlla 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 pubblicare gli annunci, aggiorna il campo status della campagna Performance Max impostandolo su ENABLED, poi aggiorna il campo status della campagna intelligente originale impostandolo su PAUSED per evitare la pubblicazione di annunci duplicati.
Indietro
Panoramica
Avanti
Visualizzare i suggerimenti