Cómo usar filtros de grupos de fichas en trabajos por lotes

Cuando trabajes con filtros de grupos de fichas en el contexto de un AdGroupCriterion.listing_group o un AssetGroupListingGroupFilter, ten en cuenta las siguientes consideraciones cuando diseñes tu integración.

División por lotes

Punto clave: Te recomendamos agregar AssetGroupListingGroupFilterOperation operaciones (create, update, y remove) orientadas al mismo AssetGroup, y AdGroupCriterionOperation operaciones (create, update, y remove) para criterios LISTING_GROUP AdGroupCriterion.listing_group) orientadas al mismo AdGroup a un trabajo por lotes de forma consecutiva, de modo que el conjunto de operaciones se trate de forma atómica durante la división por lotes.

Si hay operaciones en un trabajo por lotes que contienen criterios de grupo de anuncios o filtros de grupos de fichas de 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. A diferencia de las operaciones estándar en un trabajo por lotes, cada sublote que contiene operaciones de filtro de grupos de fichas se trata de forma atómica.

La forma en que los trabajos por lotes que contienen filtros de grupos de fichas se dividen en sublotes está determinada por los siguientes factores:

1. Tipo de filtro de grupos de fichas
2. El AdGroup o AssetGroup al que se orienta el filtro de grupos de fichas
3. Orden de las operaciones

Ten en cuenta cómo se agrupan las operaciones:

• Todas las operaciones consecutivas AssetGroupListingGroupFilterOperation (create, update y remove) orientadas al mismo AssetGroup se agrupan en un sublote atómico (sin comportamiento de falla parcial).
• Todas las AdGroupCriterionOperation operaciones consecutivas (create, update, y remove) para LISTING_GROUP criterios (AdGroupCriterion.listing_group) orientadas al mismo AdGroup 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).

Nota: Si también creas el AssetGroup en el mismo trabajo por lotes, coloca las operaciones AssetOperation (create) de requisitos previos para los recursos Asset nuevos antes del AssetGroupOperation (create), seguido inmediatamente por sus AssetGroupAssetOperation (create) operaciones (que se ejecutan juntas en un sublote atómico anterior) y, luego, las operaciones AssetGroupListingGroupFilterOperation consecutivas (que se ejecutan en el siguiente sublote atómico). Debido a que forman dos sublotes separados, una falla en el AssetGroupListingGroupFilterOperation sublote revierte los filtros de grupos de fichas sin revertir los recursos AssetGroup y AssetGroupAsset recién creados.

Término clave: Consecutivo se refiere al orden de las operaciones en el trabajo por lotes. Si las operaciones orientadas al mismo AdGroup o AssetGroup se intercalan con operaciones orientadas a un grupo diferente, se dividen en sublotes separados y ya no se procesan como una sola transacción atómica.

En el siguiente diagrama, se ilustra este concepto. Cada uno de los cuadros 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 que se habrían agregado las operaciones al trabajo por lotes.

Limitaciones

Cuando trabajes con filtros de grupos de fichas en el contexto de trabajos por lotes, se aplican las siguientes limitaciones:

• Un solo sublote atómico de operaciones consecutivas AdGroupCriterionOperation (create, update, y remove) para criteriosLISTING_GROUP (AdGroupCriterion.listing_group) orientadas al mismo AdGroup no puede superar las 20,000 operaciones de longitud. Sin embargo, se recomienda no superar las 10,000 operaciones. Debido a que cada AddBatchJobOperationsRequest tiene un límite de 10,000 operaciones, se debe subir un sublote AdGroup de 10,001 a 20,000 operaciones en al menos dos solicitudes AddBatchJobOperations consecutivas.
• Un solo sublote atómico de operaciones AssetGroupListingGroupFilterOperation consecutivas (create, update y remove) orientadas al mismo AssetGroup no puede superar las 10,000 operaciones.
• Si se incumple cualquiera de estos límites de recuento de operaciones (o se supera el límite interno de tamaño de bytes serializados del servidor para un solo sublote), se anula el trabajo por lotes en ese sublote: los sublotes anteriores que ya se completaron permanecen confirmados, mientras que todas las operaciones del sublote infractor y los sublotes posteriores fallan con InternalError.INTERNAL_ERROR.

Solución de problemas

Las operaciones de filtro de grupos de fichas en un trabajo por lotes se procesan como una transacción, lo que puede generar situaciones en las que muchas operaciones fallan debido a una pequeña cantidad de operaciones erróneas. Además, debido a la forma en que se procesan las BatchJob operaciones, la causa raíz de las fallas puede aparecer en un índice antes o después de las fallas posteriores.

Por ejemplo, cuando se procesa una respuesta de ListBatchJobResults:

• Para los grupos de fichas AdGroupCriterionOperation, es posible que las operaciones consecutivas orientadas al mismo AdGroup hayan fallado con CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION (Product group operations are atomic within the same ad group. This operation failed because another operation targeting the same ad group ID was invalid.).
• Para AssetGroupListingGroupFilterOperation operaciones, es posible que las operaciones consecutivas orientadas al mismo AssetGroup hayan fallado con BatchJobError.ASSET_GROUP_LISTING_GROUP_FILTER_TRANSACTION_FAILURE.

Estos errores indican que se revirtió la operación en ese índice porque falló otra operación en el mismo sublote atómico. Para identificar la causa raíz del problema, itera a través de los statusmensajes en cada BatchJobResult, antes y después del operation_index del error de transacción, para las operaciones que comparten el mismo AdGroup o AssetGroup ID.