Structurer les requêtes

Ce guide détaille de nombreuses subtilités de structuration des demandes qui créent et mettent à jour des campagnes Performance Max. Il peut s'agir d'une ressource utile pour concevoir votre intégration. Ce guide explique comment les requêtes qui modifient les campagnes Performance Max sont traitées. Il peut s'agir d'une ressource associée au guide de dépannage de Performance Max et au guide de traitement par lot de Performance Max.

Créer des campagnes Performance Max

Dans l'API Google Ads, les entités d'une campagne Performance Max sont représentées par une combinaison de plusieurs ressources uniques.

Campagnes Performance Max standards

Les campagnes Performance Max standards nécessitent un ensemble minimal de ressources pour être diffusées.

• Budget de la campagne
• Campaign
• Groupes d'assets
• Éléments du groupe d'assets
• Assets

Il est important de noter que les opérations de création d'entités AssetGroup et AssetGroupAsset doivent être incluses dans une seule requête, et que les ressources AssetGroupAsset doivent être combinées pour respecter l'ensemble des exigences et spécifications minimales concernant les éléments. Découvrez les différences pour les campagnes retail. Les requêtes de création d'un AssetGroup sans toutes les entités AssetGroupAsset requises entraînent une erreur. Consultez la section État non valide ou requêtes non valides pour en savoir plus.

Il existe différentes options pour structurer les demandes qui créent des campagnes Performance Max. La décision de regrouper les opérations et de structurer les requêtes dépend en grande partie de vos objectifs et de votre infrastructure.

• Créez les ressources CampaignBudget, Campaign et Asset dans des requêtes distinctes avant de créer les ressources AssetGroup et AssetGroupAsset.
• Incluez toutes ces ressources dans une seule demande mutate.

Bien que vous puissiez créer les ressources CampaignBudget, Campaign et Asset dans des demandes précédentes distinctes, la campagne Performance Max ne pourra pas être diffusée tant que les ressources AssetGroup et AssetGroupAsset ne seront pas également créées.

Conditions minimales requises pour une campagne Performance Max valide

Vous pouvez personnaliser davantage vos campagnes Performance Max en créant des ressources supplémentaires, comme illustré dans le diagramme.

• Signaux de groupe d'assets
• Objectifs de conversion de la campagne
• Critères de la campagne

Vous pouvez inclure des opérations permettant de créer des ressources AssetGroupSignal dans la même requête qui crée les ressources AssetGroup et AssetGroupAsset. Vous pouvez également créer des entités AssetGroupSignal dans une requête distincte après la création de AssetGroup.

Campagne Performance Max avec des options supplémentaires

Campagnes Performance Max pour le commerce

Les campagnes retail sont uniques en ce sens qu'il existe deux façons de créer des groupes d'assets qui aboutissent à une campagne de diffusion valide:

• Groupes de composants sans aucun élément
• Groupes de composants contenant TOUS les composants requis (recommandé)

Lorsque vous choisissez d'exclure des assets de groupes d'assets, Google utilise automatiquement ceux fournis dans votre compte Merchant Center associé pour créer des annonces. Toutefois, nous vous recommandons de fournir des composants pour toucher l'ensemble de l'inventaire. Pour diffuser des campagnes Performance Max pour le commerce, vous devez disposer de l'ensemble minimal de ressources ci-dessous.

• CampaignBudget
• Campaign (avec les valeurs ShoppingSettings renseignées)
• AssetGroup
• AssetGroupListingGroupFilter

Il est important de noter que le champ Campaign.shopping_settings doit être renseigné dans les campagnes retail. De plus, les final_urls listés dans chaque AssetGroup doivent correspondre aux URL associées à l'ID de compte Merchant Center spécifié dans Campaign.shopping_settings. Enfin, chaque AssetGroup doit être associé à une arborescence de groupes de fiches produit valide, composée d'une ou de plusieurs ressources AssetGroupListingGroupFilter. Vous devez au minimum créer une seule arborescence de nœuds pour prendre en compte tous les produits du flux Merchant Center spécifié.

Chacune de ces ressources peut être créée séparément ou via une seule requête. Toutefois, la campagne ne pourra être diffusée que lorsque toutes ces ressources auront été créées correctement.

Conditions minimales requises pour une campagne Performance Max de diffusion valide pour le commerce

Les campagnes retail peuvent utiliser toutes les options disponibles pour les campagnes Performance Max standards, y compris la création de signaux de groupe d'assets, d'objectifs de conversion de campagne et de critères de campagne. Si vous choisissez d'ajouter des éléments à un AssetGroup lors de la création de la ressource AssetGroup, votre AssetGroup est soumis aux exigences minimales concernant les éléments. En d'autres termes, vous pouvez choisir de n'inclure aucun élément ou d'inclure tous les éléments obligatoires.

Campagne Performance Max pour le commerce avec des options supplémentaires

État non valide ou requêtes non valides

Lorsque vous utilisez des campagnes Performance Max dans l'API Google Ads, il existe une distinction importante entre les états non valides et les requêtes non valides.

État non valide

La campagne ne peut pas être diffusée en raison de sa configuration. Par exemple, vous pouvez créer une ressource Campaign autonome avec un advertising_channel_type PERFORMANCE_MAX. Bien que la demande de création de la campagne aboutisse, celle-ci ne peut pas être diffusée tant que vous n'avez pas ajouté au moins un élément AssetGroup. Si vos demandes aboutissent, mais que votre campagne ou vos groupes d'assets ne sont pas diffusés, vous pouvez utiliser CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus et AssetGroupPrimaryStatusReason pour en déterminer la raison, comme indiqué dans le guide de dépannage.

Requête non valide

Demande qui n'aboutirait pas, car la campagne ou la ressource se trouverait dans un état non valide. Par exemple, l'API Google Ads génère une erreur si vous essayez de créer une AssetGroup pour une campagne non commerciale sans inclure le nombre minimal de composants requis. C'est pourquoi vous devez inclure un AssetGroup et ses ressources AssetGroupAsset dans la même requête. Cela signifie également que toutes vos ressources AssetGroupAsset doivent répondre aux spécifications correctes pour un field_type donné afin d'éviter l'échec de l'ensemble de la requête.

Regrouper des opérations avec des requêtes mutate

Les campagnes Performance Max sont composées de plusieurs ressources. Vous avez la possibilité de créer ces ressources distinctes dans des requêtes uniques ou dans une seule demande de mutation multiple. Toutefois, comme indiqué précédemment, AssetGroups et la AssetGroupAssets associée dans les campagnes Performance Max standards doivent être créés dans une seule requête atomique.

Votre campagne ne peut pas être diffusée tant que vous n'avez pas créé toutes les ressources requises mentionnées dans ce guide. Lorsque vous envoyez des requêtes distinctes, utilisez les noms de ressources réels des ressources référencées dans les requêtes suivantes. Lorsque vous émettez des requêtes de mutation en masse contenant plusieurs opérations, utilisez des noms de ressources formés à l'aide d'ID temporaires.

Ordre de priorité des opérations

Que vous utilisiez ou non une demande de mutation multiple pour créer une campagne Performance Max, vous devez organiser vos requêtes et opérations de manière à ne jamais référencer une ressource avant sa création. Dans le cas de requêtes de mutation en masse, cela signifie que les opérations sont ordonnées de manière à ce que les ressources référencées soient répertoriées avant celles qui les référencent.

Si vous choisissez de créer des ressources Asset dans la même demande de mutation en masse qui crée un AssetGroup et ses ressources AssetGroupAsset, toutes les AssetOperations doivent figurer avant toutes les AssetGroupAssetOperations, comme illustré dans le schéma.

Le serveur Google Ads regroupe les AssetGroupAssetOperations consécutifs et évalue si une AssetGroup répond aux exigences minimales en matière d'éléments après la dernière opération dans ce groupe. Si vous alternez entre AssetOperations et AssetGroupAssetOperations dans votre requête, le serveur d'API évalue les exigences minimales en matière d'éléments après le premier AssetGroupAssetOperation et renvoie une erreur sans effectuer les autres opérations de la requête. Par conséquent, aucun des composants de la demande ne sera ajouté à votre compte Google Ads. De plus, ni le AssetGroup, ni les ressources AssetGroupAsset associées ne seront créés.

Modifier les groupes de composants

Une fois que vous avez créé un AssetGroup valide, vous ne pouvez pas émettre de requêtes ultérieures qui entraîneraient un état non valide dans lequel les exigences minimales concernant les éléments ne sont plus remplies. Toute requête de ce type génère une erreur. Par exemple, si vous créez un AssetGroup avec un seul MARKETING_IMAGE (exigence minimale), toute requête de suppression du AssetGroupAsset associé à cet MARKETING_IMAGE renverra une erreur.

Cela est particulièrement important pour les groupes d'assets des campagnes retail créées sans assets associés. Les requêtes ultérieures d'ajout d'éléments à AssetGroup en créant des ressources AssetGroupAsset n'aboutiront que si elles répondaient à toutes les exigences concernant les éléments. En d'autres termes, vous ne pouvez pas ajouter d'assets à ces groupes de façon incrémentielle.