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 cambian las campañas de máximo rendimiento y pueden 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ándar requieren un conjunto mínimo de recursos para publicarse.

• Presupuesto de la campaña
• Campaign
• Grupos de recursos
• Recursos del grupo de recursos
• Recursos

Es importante tener en cuenta que las operaciones para crear las 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 se diferencia de esto para las campañas de venta minorista. Las solicitudes para crear un AssetGroup sin todas las entidades AssetGroupAsset requeridas generan un error. Consulta Comparación entre el estado no válido y las solicitudes no válidas para obtener más contexto.

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

• Crea los recursos CampaignBudget, Campaign y Asset en solicitudes separadas antes de crear los recursos AssetGroup y AssetGroupAsset.
• Incluye todos estos recursos en una sola solicitud de mutación.

Si bien puedes crear correctamente los recursos CampaignBudget, Campaign y Asset en solicitudes anteriores separadas, 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 válida que se publicará

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 las campañas

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 la creación de AssetGroup.

Campaña de máximo rendimiento con opciones adicionales

Campañas de máximo rendimiento para venta minorista

Las campañas de venta minorista son únicas en el sentido de que existen dos formas discretas de crear grupos de recursos que dan como resultado 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 que lleguen a todo el inventario. Las campañas de máximo rendimiento para venta minorista requieren el siguiente conjunto mínimo de recursos para publicarse.

• CampaignBudget
• Campaign (con ShoppingSettings 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, los final_urls enumerados en cada AssetGroup deben coincidir con las URLs asociadas con el ID de la cuenta de Merchant Center especificado en el Campaign.shopping_settings. Por último, cada AssetGroup debe tener un árbol de grupo de fichas de productos válido asociado que contenga uno o más recursos AssetGroupListingGroupFilter. Como mínimo, debes crear un solo árbol de nodos 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 correctamente.

Requisitos mínimos para una campaña de máximo rendimiento para la venta minorista válida que se publique

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 la campaña. Si decides agregar elementos a una AssetGroup cuando creas el recurso AssetGroup, tu AssetGroup estará sujeta a los requisitos mínimos de los elementos. En otras palabras, puedes incluir ningún recurso o todos los necesarios.

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

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

Cuando se trabaja con campañas de máximo rendimiento en la API de Google Ads, hay una diferencia importante entre los estados y las solicitudes no válidos.

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 realiza correctamente, no es apta para publicarse hasta que agregues al menos un AssetGroup a la campaña. Si tus solicitudes se realizan correctamente, pero tu campaña o grupos de recursos no se publican, 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 muestra un error si intentas crear un AssetGroup para una campaña que no es de venta minorista 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 a fin de evitar que falle toda la solicitud.

Agrupa operaciones con solicitudes de mutación

Las campañas de máximo rendimiento constan de varios recursos y tienes la opción de crearlos por separado en solicitudes únicas o en una sola solicitud de modificación masiva. Sin embargo, AssetGroups y el AssetGroupAssets asociado en las campañas de máximo rendimiento estándares deben crearse 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 necesarios que se indican en esta guía. Cuando emitas solicitudes independientes, usa los nombres de recursos reales de los recursos a los que se hace referencia en las solicitudes posteriores. Cuando emitas solicitudes de modificación masiva que contengan varias operaciones, usa nombres de recursos formados con ID temporales.

Orden de las operaciones

Independientemente de que uses 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 su creación. 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 eliges crear recursos de recursos en la misma solicitud de mutación masiva que crea un AssetGroup y sus recursos AssetGroupAsset, todos los AssetOperations deben aparecer antes de todos los AssetGroupAssetOperations, como se muestra en el diagrama.

El servidor de Google Ads agrupa en lotes AssetGroupAssetOperations consecutivos y evalúa si un AssetGroup cumple con los requisitos mínimos de los elementos 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 los 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ían el AssetGroup ni los recursos AssetGroupAsset asociados.

Actualizar grupos de recursos

Después de crear un AssetGroup válido, no podrás emitir solicitudes posteriores que generen un estado no válido en el que ya no se cumplan los requisitos mínimos de los elementos. Cualquiera de estas solicitudes 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 ese MARKETING_IMAGE mostrará un error.

Esto es muy importante en el caso de grupos de recursos en campañas de venta minorista creadas sin ningún recurso asociado. Las solicitudes posteriores para agregar recursos a AssetGroup mediante la creación de recursos AssetGroupAsset solo tendrán éxito 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.