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

En la versión v25 y posteriores, 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 la campaña de máximo rendimiento, el presupuesto, el grupo de recursos y los recursos, según la configuración de la campaña inteligente proporcionada en la solicitud. Una vez generados, debes inspeccionar, modificar y mejorar los recursos nuevos antes de habilitar la campaña para publicar anuncios.

La campaña de borrador de máximo rendimiento generada 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 en 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 campaña nueva se acompaña de un grupo de imágenes marcadoras de posición que se deben reemplazar antes de que se habilite la campaña nueva. Cuando el campo image_enabled es compatible y se establece en 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. Sigue el ejemplo de subir un recurso de imagen para subir imágenes nuevas.
3. Vincula los recursos nuevos al grupo de recursos de la campaña en borrador y, luego, quita los vínculos de AssetGroupAsset para las imágenes marcadoras 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

Precaución: Los parámetros gbp_enabled y image_enabled no se admiten y causan errores si se establecen en true en una solicitud. Deja ambos campos sin configurar o configúralos en false.

El mensaje GeneratePMaxDraftCampaignRequest acepta los siguientes campos:

• resource_name (obligatorio): Es el nombre del recurso del 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. En el campo validated_info de la respuesta, solo se devuelven errores de validación, advertencias o posibles problemas de conversión sin crear entidades de borrador.

• gbp_enabled (No compatible): Es opcional. Indica si se debe convertir la ubicación del Perfil de Negocio de Google (GBP) vinculada a la campaña de máximo rendimiento. Deja este campo sin configurar o en false. No se admite configurarlo en true y se devuelve un error SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (No compatible): Es opcional. Indica si se deben generar las imágenes obligatorias de la campaña de máximo rendimiento (como los tipos de imágenes horizontales, cuadradas y de logotipo). Deja este campo sin configurar o en false. No se admite configurarlo en true y se devuelve un error SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Detalles de la respuesta

El mensaje GeneratePMaxDraftCampaignResponse devuelve los nombres de los 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 de 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 conversión (se propaga cuando validate_only se establece en true y junto con los nombres de recursos de entidad generados cuando validate_only es false).

Flujo de trabajo recomendado

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

1. Genera el borrador de la campaña: Llama a SmartCampaignSettingService.GeneratePMaxDraftCampaign solo con el resource_name obligatorio establecido (deja gbp_enabled y image_enabled sin establecer o establecidos en false). Guarda los nombres de los recursos pmax_campaign, campaign_budget, asset_group y assets que se devuelven.
2. Revisa y personaliza la campaña: Como el borrador de la campaña de máximo rendimiento 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 detén la original: Cuando tengas 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 que se publique por duplicado.

Nota: Una vez que se habiliten gbp_enabled y image_enabled en una versión futura, también podrás migrar automáticamente las ubicaciones y los recursos de imagen del Perfil de Negocio de Google.