Cuando trabajas con filtros de grupos de fichas en el contexto de un AdGroupCriterion.listing_group
o un 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 del grupo de recursos, las operaciones del 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 las operaciones de filtro de grupos de fichas se trata de forma atómica.
Los siguientes factores determinan la forma en que los trabajos por lotes que contienen filtros de grupo de lista se dividen en sublotes:
- Tipo de filtro de grupo de fichas
- La
AdGroupCriterion
o laAssetGroup
para la que se segmenta el filtro del grupo de fichas - Orden de las operaciones
Ten en cuenta los siguientes puntos sobre cómo se agrupan las operaciones:
- Todas las operaciones consecutivas de
AssetGroupListingGroupFilterOperation
que se orientan 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ómicos (comportamiento de falla parcial).
En el siguiente diagrama, se ilustra este concepto. Cada uno de los cuadros grises representa un trabajo por lotes, tal como se envió a través de 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 fichas en el contexto de trabajos por lotes, se aplican las siguientes limitaciones:
- Un solo lote de operaciones
AssetGroupListingGroupFilterOperation
que contenga unlisting_group
y se oriente a la mismaAdGroup
no puede superar las 20,000 operaciones de longitud. Sin embargo, se recomienda no exceder las 10,000 operaciones. - Un solo lote de operaciones
AssetGroupListingGroupFilterOperation
segmentadas al mismoAssetGroup
no puede superar las 10,000 operaciones. - La infracción de cualquiera de estas condiciones hace que falle todo el trabajo por lotes.