Répertorier des filtres de groupe dans les tâches par lot

Lorsque vous utilisez des filtres de groupe de fiches dans le contexte d'un élément AdGroupCriterion.listing_group ou AssetGroupListingGroupFilter, vous devez prendre en compte certains points lors de la conception de votre intégration.

Fractionnement par lot

Important :Nous vous recommandons d'ajouter à une tâche par lot des opérations AssetGroupListingGroupFilterOperation ciblant les mêmes opérations AssetGroup et AdGroupCriterionOperation contenant un listing_group qui cible le même AdGroup de manière consécutive, afin que l'ensemble d'opérations soit traité de manière atomique lors du fractionnement par lot.

Si des opérations d'une tâche par lot contiennent des critères de groupe d'annonces ou des filtres de groupes d'assets, elles sont divisées en plusieurs sous-lots lorsqu'elles sont reçues par le serveur de l'API Google Ads. Notez que contrairement aux opérations standards dans une tâche par lot, chaque sous-lot contenant des opérations de filtrage de groupe de fiches est traité de manière atomique.

La manière dont les tâches par lot contenant des filtres de groupe de fiches sont divisées en sous-lots est déterminée par les facteurs suivants:

1. Type de filtre de groupe de fiches
2. AdGroupCriterion ou AssetGroup ciblé par le filtre de groupe de fiches
3. Ordre de priorité des opérations

Gardez à l'esprit les points suivants sur la façon dont les opérations sont regroupées:

• Toutes les opérations AssetGroupListingGroupFilterOperation consécutives ciblant le même AssetGroup sont regroupées dans un sous-lot atomique (pas de comportement d'échec partiel).
• Toutes les opérations AdGroupCriterionOperation consécutives contenant un listing_group ciblant le même AdGroup sont regroupées dans un sous-lot atomique (pas de comportement d'échec partiel).
• Toutes les autres opérations consécutives sont regroupées dans des sous-lots non atomiques (comportement en cas d'échec partiel).

Terme clé :consécutif fait référence à l'ordre des opérations dans la tâche par lot.

Le diagramme ci-dessous illustre ce concept. Chacune des cases grises représente une tâche par lot envoyée à l'aide de l'API Google Ads. Dans les zones grises, les opérations individuelles sont regroupées par couleur pour représenter les sous-lots créés par le serveur d'API Google Ads. L'ordre des opérations dans chacune des cases grises correspond à l'ordre dans lequel les opérations auraient été ajoutées à la tâche par lot.

Limites

Lorsque vous utilisez des filtres de groupe de fiches dans le contexte de tâches par lot, les limites suivantes s'appliquent:

• La durée d'un seul lot d'opérations AssetGroupListingGroupFilterOperation contenant une listing_group et ciblant le même AdGroup ne peut pas dépasser 20 000 opérations. Toutefois, il est recommandé de ne pas dépasser 10 000 opérations.
• Un seul lot d'opérations AssetGroupListingGroupFilterOperation ciblant le même AssetGroup ne peut pas dépasser 10 000 opérations.
• Si vous enfreignez l'une de ces conditions, l'ensemble de la tâche par lot échoue.