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

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

Fractionnement par lot

Si une tâche par lot contient des critères de groupe d'annonces ou des filtres de groupes de fiches de groupes d'assets, les opérations de la tâche par lot 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 groupes de fiches est traité de manière atomique.

La manière dont les tâches par lot contenant des filtres de groupes 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 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 (pas de comportement de défaillance partielle).
• 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 de défaillance partielle).
• Toutes les autres opérations consécutives sont regroupées dans des sous-lots non atomiques (comportement de défaillance partielle).

Le schéma suivant 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 que le serveur de l'API Google Ads crée. 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:

• Un seul lot d'opérations AssetGroupListingGroupFilterOperation contenant un listing_group et ciblant le même AdGroup ne peut pas dépasser 20 000 opérations. Toutefois, nous vous recommandons 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 de la tâche par lot.

Dépannage

Les opérations de filtrage de groupe de listes dans une tâche par lot sont traitées comme une seule transaction, ce qui peut entraîner des scénarios où de nombreuses opérations échouent en raison d'un petit nombre d'opérations erronées. De plus, en raison de la manière dont les opérations BatchJob sont traitées, la cause première des échecs peut apparaître à un indice avant ou après les échecs en aval.

Par exemple, lorsque vous traitez une réponse de ListBatchJobResults, vous pouvez constater que plusieurs opérations ont échoué avec un message d'état, Ad group is invalid due to the listing groups it contains. Ce message indique généralement que l'opération à cet indice a été annulée en raison d'une opération ayant échoué à un autre indice. Pour identifier la cause du problème, nous vous recommandons d'itérer sur tous les messages d'état dans BatchJobResult, avant et après l'index du message d'erreur Ad group is invalid, à la recherche d'informations d'erreur supplémentaires.