Cuando trabajas con filtros de grupos de fichas en el contexto de una AdGroupCriterion.listing_group
o una AssetGroupListingGroupFilter
, debes tener en cuenta algunas consideraciones cuando diseñes tu integración.
División por lotes
Si hay operaciones en un trabajo por lotes que contienen criterios de grupos de anuncios o filtros de grupos de fichas de grupos de recursos, las operaciones en el trabajo por lotes se dividen en varios sublotes cuando las recibe el servidor de la API de Google Ads. Ten en cuenta que, a diferencia de las operaciones estándar en un trabajo por lotes, cada sublote que contiene operaciones de filtro de grupos de listas se trata de forma atómica.
La forma en que los trabajos por lotes que contienen filtros de grupos de listas se dividen en sublotes se determina según los siguientes factores:
- Tipo de filtro de grupo de fichas
- Los grupos
AdGroupCriterion
oAssetGroup
a los que se orienta el filtro del grupo de fichas - Orden de las operaciones
Ten en cuenta estos puntos sobre cómo se agrupan las operaciones:
- Todas las operaciones
AssetGroupListingGroupFilterOperation
consecutivas dirigidas al mismoAssetGroup
se agrupan en un sublote atómico (sin comportamiento de falla parcial). - Todas las operaciones consecutivas de
AdGroupCriterionOperation
que contienen unlisting_group
dirigido al mismoAdGroup
se agrupan en un sublote atómico (sin comportamiento de falla parcial). - Todas las demás operaciones consecutivas se agrupan en sublotes no atómicas (comportamiento de falla parcial).
En el siguiente diagrama, se ilustra este concepto. Cada una de las casillas grises representa un trabajo por lotes enviado con la API de Google Ads. Dentro de los cuadros grises, las operaciones individuales se agrupan por color para representar los sublotes que crea el servidor de la API de Google Ads. El orden de las operaciones en cada uno de los cuadros grises corresponde al orden en el que las operaciones se habrían agregado al trabajo por lotes.
Limitaciones
Cuando se trabaja con filtros de grupos de listas en el contexto de trabajos por lotes, se aplican las siguientes limitaciones:
- Un solo lote de operaciones
AssetGroupListingGroupFilterOperation
que contiene unlisting_group
y se orienta al mismoAdGroup
no puede superar las 20,000 operaciones de duración. Sin embargo, se recomienda no exceder las 10,000 operaciones. - Un solo lote de operaciones de
AssetGroupListingGroupFilterOperation
dirigido al mismoAssetGroup
no puede exceder las 10,000 operaciones. - El incumplimiento de cualquiera de estas condiciones hace que falle todo el trabajo por lotes.