En esta guía, se detallan muchas de las complejidades de la estructuración de las solicitudes que crean y actualizan las campañas de máximo rendimiento. Puede ser un recurso útil mientras diseñas tu integración. En esta guía, se explica cómo se procesan las solicitudes que mutan las campañas de máximo rendimiento y pueden ser un recurso complementario de la guía para solucionar problemas relacionados con 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ándar requieren un conjunto mínimo de recursos para publicarse.
Es importante tener en cuenta que las operaciones para crear las entidades AssetGroup
y AssetGroupAsset
se deben incluir juntas en una sola solicitud, y los recursos AssetGroupAsset
deben combinarse para cumplir con todos los requisitos y especificaciones mínimos de los recursos. Consulta las diferencias con 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 cuando se trata de estructurar las solicitudes para crear campañas de máximo rendimiento. La decisión de cómo agrupar las operaciones y estructurar las solicitudes depende en gran medida de los objetivos y la infraestructura.
- Crea los recursos
CampaignBudget
,Campaign
yAsset
en solicitudes separadas antes de crear los recursosAssetGroup
yAssetGroupAsset
. - Incluye todos estos recursos en una sola solicitud de modificación.
Si bien puedes crear correctamente los recursos CampaignBudget
, Campaign
y Asset
en solicitudes anteriores independientes, la campaña de máximo rendimiento no
se podrá publicar hasta que también se creen los recursos AssetGroup
y
AssetGroupAsset
.
Requisitos mínimos para publicar una campaña de máximo rendimiento válida
Puedes personalizar aún más tus campañas de máximo rendimiento si creas recursos adicionales, como se muestra en el diagrama.
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 la AssetGroup
.
Campaña de máximo rendimiento con opciones adicionales
Campañas de máximo rendimiento para la venta minorista
Las campañas de venta minorista son únicas porque existen dos formas discretas de crear grupos de recursos que generan una campaña de publicación válida:
- Grupos de recursos sin ningún recurso
- Grupos de recursos que contienen TODOS los recursos obligatorios (opción preferida)
Cuando eliges excluir recursos de los grupos de recursos, Google usa 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 la venta minorista requieren el siguiente conjunto mínimo de recursos para publicarse.
CampaignBudget
Campaign
(conShoppingSettings
propagado)AssetGroup
AssetGroupListingGroupFilter
Es importante tener en cuenta que el campo Campaign.shopping_settings
debe propagarse en las campañas de venta minorista. Además, el final_urls
que aparece en cada AssetGroup
debe coincidir con las URLs asociadas con el ID de la cuenta de Merchant Center especificado en la Campaign.shopping_settings
. Por último, cada AssetGroup
debe tener un árbol de grupo de fichas de productos válido y asociado compuesto por uno o más recursos AssetGroupListingGroupFilter
. Como mínimo, debes crear un árbol de nodos único para incluir todos los productos en el 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 de forma correcta.
Requisitos mínimos para publicar una campaña de máximo rendimiento para minoristas válida
Las campañas de venta minorista 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, los objetivos de conversión y los criterios de las campañas. Si eliges agregar recursos a una AssetGroup
cuando creas el recurso AssetGroup
, tu AssetGroup
estará sujeto a los requisitos mínimos de los recursos. En otras palabras, puedes incluir ningún recurso o 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 la forma en que está configurada. Por ejemplo, puedes crear un recurso
Campaign
independiente con unadvertising_channel_type
dePERFORMANCE_MAX
. Si bien la solicitud para crear la campaña se realiza correctamente, no es apta para publicarse hasta que agregues al menos unAssetGroup
a la campaña. Si tus solicitudes se realizan correctamente, pero tu campaña o tus grupos de recursos no se publican, puedes usarCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
yAssetGroupPrimaryStatusReason
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 se realizaría correctamente porque pondría la campaña o el recurso en un estado no válido. Por ejemplo, la API de Google Ads muestra un error si
intentas crear un elemento
AssetGroup
para una campaña que no es de venta minorista sin incluir los recursos mínimos obligatorios. Es por eso que debes incluir unAssetGroup
y sus recursosAssetGroupAsset
en la misma solicitud. Esto también significa que todos tus recursosAssetGroupAsset
deben cumplir con las especificaciones correctas de unfield_type
determinado para evitar que falle toda la solicitud.
Operaciones de agrupación con solicitudes de modificación
Las campañas de máximo rendimiento se componen de varios recursos y puedes
crear recursos independientes en solicitudes únicas o en una sola
solicitud de modificación masiva. Sin embargo, AssetGroups
y el AssetGroupAssets
asociado a las campañas de máximo rendimiento estándares se deben crear en una sola solicitud atómica, como se indicó anteriormente.
Tu campaña no será apta para publicarse hasta que hayas creado correctamente todos los recursos necesarios que se indican en esta guía. Cuando emitas solicitudes separadas, usa los nombres de recursos reales de los recursos a los que se hace referencia en solicitudes posteriores. Cuando emitas solicitudes de modificación masiva que contengan varias operaciones, usa nombres de recursos formados con el uso de ID 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 su creación. En el caso de las solicitudes de mutación masiva, esto significa ordenar las operaciones de manera que los recursos a los que se hace referencia se enumeren antes que los recursos que hacen referencia a ellos.
Si eliges crear recursos de elementos en la misma solicitud de mutación masiva que crea un AssetGroup
y sus recursos AssetGroupAsset
, todos los AssetOperations
deben aparecer antes que todos los AssetGroupAssetOperations
, como se muestra en el diagrama.
El servidor de Google Ads agrupa en lotes los AssetGroupAssetOperations
consecutivos y evalúa si un AssetGroup
cumple con los requisitos mínimos de los recursos después de la última operación en 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 mostrará un error sin continuar con el resto de las operaciones de la solicitud. Como resultado, ninguno de los recursos de la solicitud se agregaría a tu
cuenta de Google Ads. Además, no se crearía AssetGroup
ni ninguno de los recursos AssetGroupAsset
asociados.
Actualizar grupos de recursos
Después de crear un AssetGroup
válido, no puedes emitir solicitudes posteriores que den como resultado un estado no válido en el que ya no se cumplan los requisitos mínimos del recurso. Cualquier solicitud de este tipo arroja un error. Por ejemplo, si creas un AssetGroup
con un solo MARKETING_IMAGE
(el requisito mínimo), cualquier solicitud para quitar la AssetGroupAsset
asociada con esa MARKETING_IMAGE
mostrará un error.
Esto es importante en el caso de los grupos de recursos en campañas de venta minorista creadas sin ningún recurso asociado. Las solicitudes posteriores para agregar elementos a AssetGroup
mediante la creación de recursos AssetGroupAsset
solo se completarían si la solicitud cumplía con todos los requisitos de los elementos. En otras palabras, no puedes agregar recursos a estos grupos de recursos de forma incremental.