Convierte las campañas inteligentes en campañas de máximo rendimiento

A partir de la versión v25_2, la API de Google Ads presenta el método SmartCampaignSettingService.GeneratePMaxDraftCampaign para ayudarte a convertir una campaña inteligente en una campaña de máximo rendimiento.

Cómo funciona la conversión

Cuando llamas a SmartCampaignSettingService.GeneratePMaxDraftCampaign, la API genera un borrador de campaña de máximo rendimiento basado en la configuración de una campaña inteligente existente.

La campaña de máximo rendimiento en borrador generada se inicializa con los siguientes valores de estado:

Esto te permite inspeccionar, modificar y mejorar la campaña de máximo rendimiento, el presupuesto, el grupo de recursos y los recursos generados antes de habilitar la campaña para que publique anuncios.

Parámetros de solicitud

El mensaje GeneratePMaxDraftCampaignRequest acepta los siguientes campos:

  • resource_name (obligatorio): Es el nombre del recurso del objeto SmartCampaignSetting asociado con la campaña inteligente existente que deseas convertir, con el siguiente formato:

    customers/customer_id/smartCampaignSettings/campaign_id

  • validate_only (Opcional): Si es true, se valida la solicitud, pero no se ejecuta. En el campo validated_info de la respuesta, solo se muestran los errores, las advertencias o los posibles problemas de conversión de la validación.

  • gbp_enabled (Actualmente no se admite): Indica si se debe convertir y vincular la ubicación del Perfil de Negocio de Google (GBP) asociada con la campaña inteligente a la campaña de máximo rendimiento generada. Actualmente, no se implementó la configuración de este campo en true, por lo que se devolverá un error GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

  • image_enabled (Actualmente no se admite): Indica si se deben generar automáticamente las imágenes obligatorias para la campaña de máximo rendimiento (como los recursos de imagen horizontales, cuadrados y de logotipo). Actualmente, no se implementó la configuración de este campo en true, por lo que se devolverá un error IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detalles de la respuesta

El mensaje GeneratePMaxDraftCampaignResponse devuelve los nombres de recursos del borrador de campaña de máximo rendimiento recién generado y sus entidades asociadas:

  • pmax_campaign: Es el nombre del recurso Campaign de la campaña de máximo rendimiento del borrador generado.
  • campaign_budget: Es el nombre del recurso CampaignBudget vinculado a la campaña de máximo rendimiento generada.
  • asset_group: Es el nombre del recurso AssetGroup vinculado a la campaña de máximo rendimiento generada.
  • assets: Es una lista de nombres de recursos Asset vinculados a la campaña de máximo rendimiento generada.
  • validated_info: Es información de validación adicional o posibles problemas de conversión que se muestran cuando validate_only se establece en true.

Para convertir una campaña inteligente, usa el siguiente flujo de trabajo:

  1. Genera el borrador de campaña: Llama a SmartCampaignSettingService.GeneratePMaxDraftCampaign solo con el conjunto de resource_name requerido (deja gbp_enabled y image_enabled sin configurar o configúralos como false). Guarda los nombres de recursos pmax_campaign, campaign_budget, asset_group y assets que se devolvieron.
  2. Revisa y personaliza la campaña: Como la campaña de máximo rendimiento en borrador se crea con status = PAUSED y creation_status = INCOMPLETE, inspecciona y configura su presupuesto, grupo de recursos y recursos.
  3. Habilita la campaña: Cuando tengas todo listo para publicar anuncios, actualiza el status de la campaña a ENABLED y el creation_status a COMPLETE.