Solicitudes de estructura

Esta guía detalla muchas de las complejidades de estructurar las solicitudes que crean y actualizan las 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 las solicitudes que modifican las campañas de máximo rendimiento las campañas de máximo rendimiento se procesan y pueden complementar las campañas de máximo rendimiento. guía de solución de problemas y el 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 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 para su publicación.

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

Es importante tener en cuenta que las operaciones para crear AssetGroup y Las entidades AssetGroupAsset deben incluirse juntas en una sola solicitud. los recursos AssetGroupAsset se deben combinar para cumplir con todos los recursos mínimos requisitos y especificaciones veremos en qué se diferencia Campañas de venta minorista. Solicitudes para crear Un AssetGroup sin todas las entidades AssetGroupAsset obligatorias genera una error; ver Estado no válido en comparación con solicitudes no válidas para obtener más contexto.

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

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

Si bien puedes crear correctamente CampaignBudget, Campaign y Asset recursos en solicitudes anteriores separadas, la campaña de máximo rendimiento no se apto para publicarse hasta que los recursos AssetGroup y AssetGroupAsset se que también creaste allí.

Requisitos mínimos para una campaña de máximo rendimiento válida que se publicará

Para personalizar aún más tus campañas de máximo rendimiento, crea recursos 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 el mismo solicitud que crea los recursos AssetGroup y AssetGroupAsset. Como alternativa, puedes crear entidades AssetGroupSignal en una solicitud independiente 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 porque existen dos formas discretas de crear grupos de recursos que den como resultado una publicación válida campaña:

• 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 utiliza 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 los recursos para entregarlos.

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

Es importante tener en cuenta que el campo Campaign.shopping_settings debe ser propagado 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 especificadas en el Campaign.shopping_settings. 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 grupos de fichas de productos AssetGroupListingGroupFilter recursos. Como mínimo, debes crear un solo árbol de nodos para mostrar todos los productos del 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 crearon 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 usar todas las opciones disponibles para las campañas de máximo rendimiento, incluida la creación de indicadores de grupos de recursos, objetivos de conversión y criterios de campaña. Si decides agregar recursos AssetGroup cuando crees el recurso AssetGroup, tu AssetGroup será sujeta a los requisitos mínimos de los elementos. En otras palabras, puedes incluir todos los recursos necesarios 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 se trabaja con campañas de máximo rendimiento en la API de Google Ads, hay una diferencia 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. Para 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 tenga éxito, no será apta para publicarse hasta que agregues, al menos, uno AssetGroup a la campaña. Si tus solicitudes tienen éxito, 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 solución de problemas guía.

La solicitud no es válida

Una solicitud que no tendría éxito porque colocaría la campaña o recurso en un estado no válido. Por ejemplo, la API de Google Ads muestra un error si: intenta crear un AssetGroup para una campaña que no es de venta minorista sin incluir el de recursos mínimos requeridos. Este es Debes incluir un AssetGroup y sus recursos AssetGroupAsset en el misma solicitud. Esto también significa que todos tus recursos AssetGroupAsset deben las especificaciones correctas de un elemento field_type determinado para evitar para que tu solicitud no falle.

Agrupa operaciones con solicitudes de mutación

Las campañas de máximo rendimiento se componen de varios recursos, y tienes para crear estos recursos separados en solicitudes únicas o en una solicitud de mutación masiva. Sin embargo, AssetGroups y las AssetGroupAssets asociadas en las campañas de máximo rendimiento estándares deben crearse en una única solicitud atómica, como ya se indicó.

Su campaña no será apta para publicarse hasta que haya creado correctamente los recursos necesarios mencionados en esta guía. Cuando se emiten solicitudes, usarás los nombres de recursos reales de los recursos a los que se hace referencia en las solicitudes. Cuando emitas solicitudes de modificación masiva que contengan varias operaciones, usa los nombres de recursos formados con ID temporales.

Orden de las operaciones

Ya sea que uses una solicitud de mutación masiva para crear una campaña de máximo rendimiento campaña, debe ordenar sus solicitudes y operaciones de manera que nunca hacer referencia a un recurso antes de que se cree. En el caso de la modificación masiva solicitudes, esto significa ordenar las operaciones de una manera que haga referencia a Los recursos se enumeran antes que los recursos que hacen referencia a ellos.

Si eliges crear recursos del recurso en la misma solicitud de mutación masiva que crea un AssetGroup y sus recursos AssetGroupAsset, todos los AssetOperations debe estar antes de todos los AssetGroupAssetOperations, como 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á requisitos mínimos de recursos después de los primeros AssetGroupAssetOperation y mostrar un error sin continuar con el resto de las operaciones para cada solicitud. Como resultado, ninguno de los recursos de la solicitud se agregaría a tu cuenta de Google Ads. Además, ni el AssetGroup ni ninguno de los servicios Se crearían AssetGroupAsset recursos.

Actualizar grupos de recursos

Después de crear un AssetGroup válido, no podrás emitir solicitudes posteriores que daría como resultado un estado no válido, en el que los requisitos mínimos del recurso ya no se cumplen. Cualquiera de estas solicitudes arroja un error. Por ejemplo, si Crea un AssetGroup con un solo MARKETING_IMAGE. (el requisito mínimo), cualquier solicitud para quitar AssetGroupAsset asociada con ese MARKETING_IMAGE mostraría un error.

Esto es particularmente importante en el caso de los grupos de recursos de las campañas de venta minorista crearse sin ningún recurso asociado. Las solicitudes posteriores para agregar recursos al AssetGroup mediante la creación de AssetGroupAsset recursos solo tendrá éxito si el que la solicitud cumplía con todos los requisitos de los recursos. En otras palabras, no puedes agregar recursos estos grupos de recursos de forma incremental.