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

En v25 y versiones posteriores, puedes usar el SmartCampaignSettingService.GeneratePMaxDraftCampaign método 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, un presupuesto, un grupo de recursos y recursos, según la configuración de la campaña inteligente proporcionada en la solicitud. Una vez que se generen, debes inspeccionar, modificar y mejorar los recursos nuevos antes de habilitar la campaña para publicar anuncios.

El borrador de campaña de máximo rendimiento generado se inicializa con los siguientes valores de estado:

  • status se establece como PAUSED.
  • Su elegibilidad para la publicación se refleja en primary_status.
  • contains_eu_political_advertising se establece como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING de forma predeterminada (si aún no se especificó en la campaña inteligente). Verifica y actualiza este campo si tu campaña incluye publicidad política de la UE.

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 publicar anuncios.

Recursos en borrador

La nueva campaña se acompaña de un grupo de imágenes marcadoras de posición que deben reemplazarse antes de que se habilite la nueva campaña. Cuando el campo image_enabled es compatible y se establece como true en la solicitud, la API genera imágenes automáticamente en lugar de usar imágenes marcadoras de posición. Puedes inspeccionar los recursos nuevos en el campo assets de la respuesta y reemplazarlos siguiendo estos pasos:

  1. Revisa la guía de requisitos de recursos.
  2. Sube imágenes nuevas siguiendo el ejemplo de recurso de imagen de carga.
  3. Vincula los recursos nuevos al grupo de recursos de la campaña en borrador y, luego, quita los AssetGroupAsset vínculos para las imágenes de marcador de posición (ya sea en la misma solicitud de mutación atómica o después de vincular los recursos nuevos para que se sigan cumpliendo los requisitos mínimos de recursos) siguiendo la guía para vincular grupos de recursos a recursos.

Parámetros de solicitud

El GeneratePMaxDraftCampaignRequest mensaje acepta los siguientes campos:

  • resource_name (Obligatorio): Es el nombre del recurso de 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, la solicitud se valida, pero no se ejecuta. Solo se muestran los errores de validación, las advertencias o los posibles problemas de conversión en el campo validated_info de la respuesta sin crear entidades de borrador.

  • gbp_enabled (no compatible): 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 false; no se admite establecerlo como true y se muestra un SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED error.

  • image_enabled (no compatible): Opcional. Indica si se deben generar las imágenes requeridas de la campaña de máximo rendimiento (como los tipos de imagen horizontal, cuadrada y de logotipo). Deja este campo sin configurar o false; no se admite establecerlo como true y se muestra un SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED error.

Detalles de la respuesta

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

  • pmax_campaign: Es el nombre del recurso Campaign del borrador de campaña de máximo rendimiento 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 la información de validación o los posibles problemas de conversión que muestra la verificación de conversión (se propaga cuando validate_only se establece como 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 la campaña en borrador: Llama a SmartCampaignSettingService.GeneratePMaxDraftCampaign con solo el resource_name obligatorio establecido (deja gbp_enabled y image_enabled sin configurar o establécelos como false). Guarda los nombres de recursos pmax_campaign, campaign_budget, asset_group y assets que se muestran.
  2. Revisa y personaliza la campaña: Debido a que 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 y pausa la original: Cuando estés 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.