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

Lorsque vous utilisez des filtres de groupes de fiches dans le contexte d'une AdGroupCriterion.listing_group ou d'un AssetGroupListingGroupFilter, vous devez tenir compte de certains points lorsque vous concevez votre intégration.

Division par lot

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

Si une tâche par lot contient des opérations contenant des critères de groupe d'annonces ou des filtres de groupes de listes 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 d'une tâche par lot, chaque sous-lot contenant des opérations de filtrage de groupe sous forme de liste est traité de manière atomique.

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

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

Tenez compte des points suivants concernant le regroupement des opérations:

• Toutes les opérations AssetGroupListingGroupFilterOperation consécutives ciblant le même AssetGroup sont regroupées dans un sous-lot atomique (aucun comportement d'échec partiel).
• Toutes les opérations AdGroupCriterionOperation consécutives contenant un élément listing_group ciblant le même AdGroup sont regroupées dans un sous-lot atomique (aucun 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é :le terme consécutif désigne l'ordre des opérations d'une 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 cases grises, les opérations individuelles sont regroupées par couleur pour représenter les sous-lots créés par le serveur de l'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 groupes de listes dans le contexte de tâches par lot, les limites suivantes s'appliquent:

• Un seul lot d'opérations AssetGroupListingGroupFilterOperation contenant un élément 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.
• Le non-respect de l'une de ces conditions entraîne l'échec de l'ensemble du job par lot.