Solicitudes de estructura

En esta guía, se detallan muchas de las complejidades de la estructuración de solicitudes que crean y actualizan campañas de máximo rendimiento. Puede ser un recurso útil a medida que diseñas tu integración. En esta guía, se explica cómo se procesan las solicitudes que modifican las campañas de máximo rendimiento y puede ser un recurso complementario de la guía de solución de problemas de las campañas de máximo rendimiento y la guía de procesamiento por lotes de las campañas de máximo rendimiento.

Crea campañas de máximo rendimiento

En la API de Google Ads, las entidades de las campañas de máximo rendimiento se representan como una combinación de varios recursos únicos.

Campañas de máximo rendimiento estándares

Las campañas de máximo rendimiento estándares requieren un conjunto mínimo de recursos para publicarse.

• Presupuesto de la campaña
• Campaña
• Recursos de campaña (solo para campañas con lineamientos de la marca habilitados)
• Grupos de recursos
• Recursos del grupo de recursos
• Recursos

En el caso de las campañas con lineamientos de desarrollo de la marca habilitados, las operaciones para crear Campaign y los recursos CampaignAsset obligatorios deben incluirse en una sola solicitud, y los recursos CampaignAsset deben cumplir con los requisitos y las especificaciones mínimos de los recursos.

Es importante tener en cuenta que las operaciones para crear entidades AssetGroup y AssetGroupAsset deben incluirse juntas en una sola solicitud, y los recursos AssetGroupAsset deben combinarse para cumplir con todos los requisitos mínimos de los recursos y las especificaciones. Consulta cómo esto es diferente para las campañas de venta minorista. Las solicitudes para crear un AssetGroup sin todas las entidades AssetGroupAsset requeridas generan un error. Para obtener más contexto, consulta Estado no válido frente a solicitudes no válidas.

Existen diferentes opciones para estructurar las solicitudes que crean campañas de máximo rendimiento. La decisión sobre cómo agrupar las operaciones y estructurar las solicitudes depende en gran medida de tus objetivos y tu infraestructura.

• Crea los recursos CampaignBudget, Campaign, Asset y CampaignAsset en solicitudes separadas antes de crear los recursos AssetGroup y AssetGroupAsset. (En el caso de las campañas con lineamientos de desarrollo de la marca habilitados, los recursos Campaign y los recursos CampaignAsset obligatorios deben incluirse juntos en una sola solicitud).
• Incluye todos estos recursos en una sola solicitud de mutación.

Si bien puedes crear correctamente los recursos CampaignBudget, Campaign, Asset y CampaignAsset en solicitudes previas independientes, la campaña de máximo rendimiento no será apta para publicarse hasta que también se creen los recursos AssetGroup y AssetGroupAsset.

Requisitos mínimos para una campaña de máximo rendimiento apta para la publicación

Puedes personalizar aún más tus campañas de máximo rendimiento creando recursos adicionales, como se muestra en el diagrama.

• Indicadores de grupo de recursos
• Objetivos de conversión de la campaña
• Criterios de la campaña

Puedes incluir operaciones para crear recursos AssetGroupSignal en la misma solicitud que crea los recursos AssetGroup y AssetGroupAsset. Como alternativa, puedes crear entidades AssetGroupSignal en una solicitud independiente después de crear el objeto AssetGroup.

Campaña de máximo rendimiento con opciones adicionales

Campañas de máximo rendimiento para minoristas

Las campañas de venta minorista son únicas porque existen dos formas discretas de crear grupos de recursos que generan una campaña apta para la publicación:

• Grupos de recursos sin recursos
• Grupos de recursos que contienen TODOS los recursos obligatorios (opción preferida)

Cuando decides excluir recursos de los grupos de recursos, Google utiliza automáticamente los recursos proporcionados en tu cuenta de Merchant Center vinculada para crear anuncios. Sin embargo, te recomendamos que proporciones recursos para llegar a todo el inventario. Las campañas de máximo rendimiento para las ventas minoristas requieren el siguiente conjunto mínimo de recursos para publicarse.

• CampaignBudget
• Campaign (con ShoppingSettings completado)
• AssetGroup
• AssetGroupListingGroupFilter

Es importante tener en cuenta que el campo Campaign.shopping_settings debe completarse en las campañas de venta minorista. Además, el final_urls que se indica en cada AssetGroup debe coincidir con las URLs asociadas al ID de la cuenta de Merchant Center especificado en Campaign.shopping_settings. Por último, cada AssetGroup debe tener un árbol de grupos de fichas de producto válido y asociado, compuesto por uno o más recursos AssetGroupListingGroupFilter. Como mínimo, debes crear un solo árbol de nodos para tener en cuenta todos los productos de tu feed de Merchant Center especificado.

Cada uno de estos recursos se puede crear por separado o en una sola solicitud. Sin embargo, la campaña no será apta para publicarse hasta que todos estos recursos se hayan creado correctamente.

Requisitos mínimos para una campaña de máximo rendimiento de venta minorista válida para la publicación

Las campañas minoristas pueden utilizar todas las opciones disponibles para las campañas de máximo rendimiento estándares, incluida la creación de indicadores de grupos de recursos, objetivos de conversión de la campaña y criterios de la campaña. Si decides agregar activos a un AssetGroup cuando crees el recurso AssetGroup, tu AssetGroup estará sujeto a los requisitos mínimos de activos. En otras palabras, puedes incluir todos los recursos requeridos o no incluir ninguno.

Campaña de máximo rendimiento para venta minorista con opciones adicionales

Estado no válido frente a solicitudes no válidas

Cuando trabajas con campañas de máximo rendimiento en la API de Google Ads, es importante distinguir entre los estados no válidos y las solicitudes no válidas.

Estado no válido

La campaña no es apta para publicarse debido a su configuración. Por ejemplo, puedes crear un recurso Campaign independiente con un advertising_channel_type de PERFORMANCE_MAX. Si bien la solicitud para crear la campaña se realiza correctamente, esta no es apta para publicarse hasta que agregues al menos un AssetGroup a la campaña. Si tus solicitudes se realizan correctamente, pero no se publican tus campañas o grupos de recursos, puedes usar CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus y AssetGroupPrimaryStatusReason para determinar el motivo, como se detalla en la guía de solución de problemas.

La solicitud no es válida

Una solicitud que no tendría éxito porque pondría la campaña o el recurso en un estado no válido. Por ejemplo, la API de Google Ads genera un error si intentas crear un objeto AssetGroup para una campaña que no es de venta minorista sin incluir los recursos mínimos obligatorios. Por eso, debes incluir un AssetGroup y sus recursos AssetGroupAsset en la misma solicitud. Esto también significa que todos tus recursos AssetGroupAsset deben cumplir con las especificaciones correctas para un field_type determinado, de modo que no falle toda la solicitud.

Agrupa operaciones con solicitudes de mutación

Las campañas de máximo rendimiento se componen de varios recursos, y tienes la opción de crear estos recursos separados en solicitudes únicas o en una sola solicitud de mutación masiva. Sin embargo, los objetos AssetGroups y los objetos AssetGroupAssets asociados en las campañas de máximo rendimiento estándares se deben crear en una sola solicitud atómica, como ya se mencionó.

Tu campaña no es apta para publicarse hasta que crees correctamente todos los recursos necesarios que se indican en esta guía. Cuando envíes solicitudes separadas, usa los nombres de recursos reales de los recursos a los que se hace referencia en las solicitudes posteriores. Cuando emitas solicitudes de mutación masiva que contengan varias operaciones, usa nombres de recursos formados con IDs temporales.

Orden de las operaciones

Independientemente de si usas una solicitud de mutación masiva para crear una campaña de máximo rendimiento, debes ordenar tus solicitudes y operaciones de manera que nunca hagas referencia a un recurso antes de que se cree. En el caso de las solicitudes de mutación masiva, esto significa ordenar las operaciones de tal manera que los recursos a los que se hace referencia aparezcan antes de los recursos que hacen referencia a ellos.

Si eliges crear recursos de Asset en la misma solicitud de mutación masiva que crea un objeto AssetGroup y sus recursos de AssetGroupAsset, todos los objetos AssetOperations deben aparecer antes que todos los objetos AssetGroupAssetOperations, como se muestra en el diagrama.

El servidor de Google Ads agrupa los AssetGroupAssetOperations consecutivos y evalúa si un AssetGroup cumple con los requisitos mínimos de recursos después de la última operación de ese grupo. Si alternas entre AssetOperations y AssetGroupAssetOperations en tu solicitud, el servidor de la API evaluará los requisitos mínimos de los recursos después del primer AssetGroupAssetOperation y devolverá un error sin continuar con el resto de las operaciones de la solicitud. Como resultado, no se agregaría ninguno de los recursos de la solicitud a tu cuenta de Google Ads. Además, no se crearían ni el AssetGroup ni ninguno de los recursos AssetGroupAsset asociados.

Actualiza grupos de recursos

Después de crear un objeto AssetGroup válido, no puedes emitir solicitudes posteriores que generen un estado no válido en el que ya no se cumplan los requisitos mínimos de los recursos. Cualquier solicitud de este tipo generará un error. Por ejemplo, si creas un AssetGroup con un solo MARKETING_IMAGE (el requisito mínimo), cualquier solicitud para quitar el AssetGroupAsset asociado a ese MARKETING_IMAGE mostrará un error.

Esto es particularmente importante en el caso de los grupos de recursos de las campañas de venta minorista creados sin recursos asociados. Las solicitudes posteriores para agregar recursos a AssetGroup creando recursos AssetGroupAsset solo se realizarían correctamente si la solicitud cumpliera con todos los requisitos de los recursos. En otras palabras, no puedes agregar recursos a estos grupos de recursos de forma incremental.