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'un AdGroupCriterion.listing_group ou d'un AssetGroupListingGroupFilter, tenez compte des points suivants lors de la conception de votre intégration.

Fractionnement par lot

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

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

La manière dont les jobs par lot contenant des filtres de groupes de fiches sont divisés en sous-lots est déterminée par les facteurs suivants :

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

Tenez compte de la manière dont les opérations sont regroupées :

• Toutes les opérations consécutives AssetGroupListingGroupFilterOperation ciblant le même AssetGroup sont regroupées dans un sous-lot atomique (aucun comportement d'échec partiel).
• Toutes les opérations consécutives AdGroupCriterionOperation contenant un 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 d'échec partiel).

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

Le schéma suivant illustre ce concept. Chacune des cases grises représente un job par lot tel qu'il est envoyé à 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 au job par lot.

Limites

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

• Un seul lot d'opérations AdGroupCriterionOperation contenant un 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 l'une de ces conditions n'est pas respectée, l'ensemble du job par lot échoue.

Dépannage

Les opérations de filtre de groupes de fiches d'un job par lot sont traitées comme une seule transaction, ce qui peut entraîner l'échec de nombreuses opérations 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 index avant ou après les échecs en aval.

Par exemple, lorsque vous traitez une réponse de ListBatchJobResults, vous constaterez peut-être 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 index a été annulée en raison d'un échec d'opération à un autre index. Pour identifier la cause première du problème, nous vous recommandons de parcourir tous les messages d'état dans le BatchJobResult, avant et après l'index du message d'erreur Ad group is invalid, afin de trouver des informations d'erreur supplémentaires.