Solicitudes de estructura

En esta guía, se detallan muchas de las complejidades de estructurar solicitudes que crean y actualizan campañas de máximo rendimiento. Puede ser un recurso útil cuando diseñes tu integración. En esta guía, se explica cómo se procesan las solicitudes que mutan las campañas de máximo rendimiento. Puede ser un recurso complementario de la guía para solucionar 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 la campaña (solo para las campañas con los lineamientos de la marca habilitados)
• Grupos de recursos
• Recursos del grupo de recursos
• Recursos

En el caso de las campañas con los lineamientos de la marca habilitados, las operaciones para crear recursos de Campaign y los recursos de CampaignAsset obligatorios deben incluirse en una sola solicitud, y los recursos de 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 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 obligatorias generan un error. Consulta Estado no válido frente a solicitudes no válidas para obtener más contexto.

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 de 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 los lineamientos de la marca habilitados, los recursos Campaign y los recursos CampaignAsset obligatorios se deben incluir 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 que una campaña de máximo rendimiento sea válida y se publique

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

• Indicadores de grupos 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 separada después de crear el 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, ya que existen dos formas distintas de crear grupos de recursos que generen una campaña de publicación válida:

• Grupos de recursos sin recursos personalizados (o solo con recursos HTML5 MEDIA_BUNDLE)
• 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 venta minorista de máximo rendimiento requieren el siguiente conjunto mínimo de recursos para publicarse:

• CampaignBudget
• Campaign (con ShoppingSetting propagado)
• AssetGroup
• AssetGroupListingGroupFilter

El campo Campaign.shopping_setting se debe propagar en las campañas de venta minorista. Además, cualquier final_urls que aparezca en un AssetGroup debe coincidir con el dominio del sitio web asociado al ID de la cuenta de Merchant Center especificado en Campaign.shopping_setting. Por último, cada AssetGroup debe tener un árbol de grupos de fichas de productos válido y asociado que esté compuesto por uno o más recursos AssetGroupListingGroupFilter. Como mínimo, debes crear un árbol de nodos único 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 venta minorista de máximo rendimiento válida que publique anuncios

Las campañas de venta minorista de máximo rendimiento pueden usar todas las opciones disponibles para las campañas de máximo rendimiento estándar, incluida la creación de indicadores de grupos de recursos, objetivos de conversión de campañas y criterios de campañas. Si decides agregar recursos personalizados (que no sean recursos HTML5 MEDIA_BUNDLE) a un AssetGroup cuando creas el recurso AssetGroup, tu solicitud debe cumplir con todos los requisitos mínimos de recursos (incluidos los recursos de marca a nivel de la campaña si los lineamientos de la marca están habilitados). En otras palabras, no incluyas ningún recurso personalizado o incluye todos los recursos obligatorios.

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, hay una distinción importante 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. Aunque la solicitud para crear la campaña se realice correctamente, esta no será apta para publicarse hasta que le agregues, al menos, un AssetGroup. Si tus solicitudes se realizan correctamente, pero tu campaña o tus grupos de recursos no publican anuncios, puedes usar CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus y AssetGroupPrimaryStatusReason para determinar el motivo, como se detalla en la guía para solucionar problemas.

La solicitud no es válida

Es una solicitud que no se completaría porque colocaría la campaña o el recurso en un estado no válido. Por ejemplo, la API de Google Ads arroja un error si intentas crear un AssetGroup para una campaña que no es de venta minorista (que no sea una campaña de máximo rendimiento de Servicios locales) sin incluir los recursos mínimos obligatorios. Por este motivo, 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 para evitar que 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 crearlos en solicitudes individuales o en una sola solicitud de mutación masiva. Sin embargo, los AssetGroups y los AssetGroupAssets asociados en las campañas de máximo rendimiento estándares se deben crear en una sola solicitud atómica, como ya se indicó.

Tu campaña no será apta para publicarse hasta que hayas creado correctamente todos los recursos requeridos que se indican en esta guía. Cuando emitas solicitudes independientes, usa los nombres reales de los recursos a los que se hace referencia en las solicitudes posteriores. Cuando emitas solicitudes de mutación masivas 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 modo 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 se enumeren antes que los recursos que hacen referencia a ellos.

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

El servidor de Google Ads agrupa en lotes las operaciones AssetGroupAssetOperations consecutivas 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 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á 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 de AssetGroupAsset asociados.

Actualiza los grupos de recursos

Después de crear un AssetGroup válido, no puedes emitir solicitudes posteriores que dejen un grupo de recursos por debajo de los requisitos mínimos de recursos. Cualquier solicitud de este tipo arroja un error. Por ejemplo, si creas un AssetGroup con un solo MARKETING_IMAGE (el requisito mínimo), una solicitud para quitar solo ese MARKETING_IMAGE AssetGroupAsset devuelve un error. Sin embargo, en las campañas de venta minorista de máximo rendimiento, puedes volver a confiar en los recursos generados automáticamente de Google Merchant Center (AssetGroup) quitando todos los vínculos personalizados de AssetGroupAsset en una sola solicitud.

En el caso de los grupos de recursos de las campañas de venta minorista de máximo rendimiento creados sin ningún recurso personalizado asociado, las solicitudes posteriores para vincular recursos personalizados (que no sean recursos HTML5 MEDIA_BUNDLE) deben garantizar que se establezca al menos un final_urls en el AssetGroup (completándolo primero si se omitió originalmente) y deben proporcionar todos los recursos mínimos obligatorios (incluidos los recursos de la marca a nivel de la campaña si los lineamientos de la marca están habilitados) en una sola solicitud atómica. No vincules recursos opcionales, como YOUTUBE_VIDEO, por sí solos ni agregues recursos del anuncio de forma incremental en solicitudes separadas. Si solo vinculas recursos personalizados opcionales, el grupo de recursos quedará en un estado no admitido que bloqueará las ediciones en la IU de Google Ads. Para obtener más detalles, consulta Vincula grupos de recursos a recursos en las campañas de máximo rendimiento de venta minorista.