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

En v25 (a partir del v25.2), puedes usar el método SmartCampaignSettingService.GeneratePMaxDraftCampaign para convertir una campaña inteligente en una campaña de máximo rendimiento. Este método no está disponible en v24 ni en versiones anteriores.

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.

La campaña de máximo rendimiento preliminar generada se inicializa con su status establecido en PAUSED (y su elegibilidad para la publicación reflejada en primary_status). Si todos los convertidores de funciones fallan en la validación de la campaña inteligente, la solicitud falla con un error SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.

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. La generación del borrador de la campaña de máximo rendimiento no modifica ni pausa la campaña inteligente original, que permanece activa hasta que la pauses manualmente.

Parámetros de solicitud

El mensaje GeneratePMaxDraftCampaignRequest acepta los siguientes campos:

  • resource_name (Obligatorio): Es el nombre del recurso del objeto SmartCampaignSetting que se volverá a generar para la campaña inteligente 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 devuelven errores, advertencias o posibles problemas de conversión sin crear entidades de borrador.

  • gbp_enabled (No admitido): Opcional. Indica si se debe convertir la ubicación del Perfil de Negocio de Google (GBP) vinculada con la campaña de máximo rendimiento. Deja este campo sin configurar o establece false. Establecerlo en true no se implementa en v25 y devuelve un error de SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

  • image_enabled (No admitido): Opcional. Indica si se deben generar las imágenes requeridas para la campaña de máximo rendimiento (como los tipos de imágenes horizontales, cuadradas y de logotipo). Deja este campo sin configurar o establece false. Establecerlo en true no se implementa en v25 y devuelve un error de SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detalles de la respuesta

El mensaje GeneratePMaxDraftCampaignResponse devuelve los nombres de recursos de la campaña de máximo rendimiento en borrador generada y sus entidades asociadas:

  • pmax_campaign: Es el nombre del recurso Campaign de la campaña de máximo rendimiento en borrador generada.
  • 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 la información de validación o los posibles problemas de conversión que devuelve la verificación de conversiones (se propaga cuando validate_only se establece en true y junto con los nombres de recursos de la entidad generada cuando validate_only es false).

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 obligatorios (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, inspecciona y configura su presupuesto, grupo de recursos y recursos.
  3. Habilita la campaña y detén la original: Cuando esté todo listo para publicar anuncios, actualiza el status de la campaña de máximo rendimiento a ENABLED y, luego, actualiza el status de la campaña inteligente original a PAUSED para evitar la publicación duplicada.