Structurer les requêtes

Ce guide décrit en détail les nombreuses subtilités de la structuration des requêtes qui créent et mettent à jour les campagnes Performance Max. Il peut s'agir d'une ressource utile pour concevoir votre intégration. Ce guide explique comment les demandes qui modifient les campagnes Performance Max sont traitées. Il peut être utilisé en complément du guide de dépannage Performance Max et du guide sur le traitement par lot Performance Max.

Créer des campagnes Performance Max

Dans l'API Google Ads, les entités de 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
• Campagne
• Composants de campagne (uniquement pour les campagnes avec consignes relatives à la marque activées)
• Groupes de composants
• Composants des groupes de composants
• Assets

Pour les campagnes pour lesquelles les consignes relatives à la marque sont activées, les opérations permettant de créer des Campaign et les ressources CampaignAsset requises doivent être incluses dans une même requête. De plus, les ressources CampaignAsset doivent respecter les exigences et les spécifications minimales concernant les composants.

Il est important de noter que les opérations de création des entités AssetGroup et AssetGroupAsset doivent être incluses ensemble dans une même requête. De plus, les ressources AssetGroupAsset doivent être combinées pour répondre à toutes les exigences minimales concernant les composants et les spécifications. Découvrez les différences pour les campagnes commerciales. Les requêtes visant à créer un AssetGroup sans toutes les entités AssetGroupAsset requises génèrent une erreur. Pour en savoir plus, consultez État non valide et requêtes non valides.

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

• Créez les ressources CampaignBudget, Campaign, Asset et CampaignAsset dans des requêtes distinctes avant de créer les ressources AssetGroup et AssetGroupAsset. (Pour les campagnes avec des consignes relatives à la marque activées, les ressources Campaign et CampaignAsset requises doivent être incluses ensemble dans une seule demande.)
• Incluez toutes ces ressources dans une seule requête mutate.

Bien que vous puissiez créer les ressources CampaignBudget, Campaign, Asset et CampaignAsset dans des requêtes précédentes distinctes, la campagne Performance Max ne pourra pas être diffusée tant que les ressources AssetGroup et AssetGroupAsset n'auront pas été créées.

Exigences minimales pour qu'une campagne Performance Max soit diffusée

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

• Signaux de groupe de composants
• Objectifs de conversion de la campagne
• Critères de campagne

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

Campagne Performance Max avec options supplémentaires

Campagnes Performance Max pour le commerce

Les campagnes pour le commerce sont uniques, car il existe deux façons distinctes de créer des groupes de composants qui permettent de diffuser une campagne valide :

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

Lorsque vous choisissez d'exclure des composants de groupes de composants, Google utilise automatiquement les composants 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 être diffusées, les campagnes Performance Max pour le secteur du commerce de détail nécessitent au minimum les ressources suivantes.

• CampaignBudget
• Campaign (avec ShoppingSettings renseigné)
• AssetGroup
• AssetGroupListingGroupFilter

Il est important de noter que le champ Campaign.shopping_settings doit être renseigné dans les campagnes pour les marchands. 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é à un arbre de groupes de fiches produit valide composé d'une ou plusieurs ressources AssetGroupListingGroupFilter. Vous devez au minimum créer un arbre de nœuds unique pour tenir compte de tous les produits de votre flux Merchant Center spécifié.

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

Exigences minimales pour qu'une campagne Performance Max retail soit diffusée

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 composants à un AssetGroup lorsque vous créez la ressource AssetGroup, votre AssetGroup est soumis aux exigences minimales concernant les composants. En d'autres termes, vous pouvez soit n'inclure aucun composant, soit inclure tous les composants requis.

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

État non valide et demandes non valides

Lorsque vous utilisez des campagnes Performance Max dans l'API Google Ads, il est important de faire la distinction entre les états non valides et les demandes non valides.

État non valide

La campagne n'est pas éligible à la diffusion en raison de sa configuration. Par exemple, vous pouvez créer une ressource Campaign autonome avec un advertising_channel_type de PERFORMANCE_MAX. Bien que la requête de création de la campagne aboutisse, elle n'est pas éligible à la diffusion tant que vous n'y avez pas ajouté au moins un AssetGroup. Si vos demandes aboutissent, mais que vos groupes de campagnes ou 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

 Requête qui n'aboutirait pas, car elle placerait la campagne ou la ressource dans un état non valide. Par exemple, l'API Google Ads génère une erreur si vous essayez de créer un AssetGroup pour une campagne non commerciale sans inclure les composants minimaux 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 respecter les spécifications correctes pour un field_type donné afin d'éviter l'échec de l'ensemble de la requête.

Regrouper les opérations avec les requêtes mutate

Les campagnes Performance Max sont composées de plusieurs ressources. Vous pouvez créer ces ressources distinctes dans des requêtes uniques ou dans une seule requête de mutation groupée. Toutefois, comme indiqué précédemment, les AssetGroups et les AssetGroupAssets associés 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 émettez 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 groupées 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 requête de mutation groupée pour créer une campagne Performance Max, vous devez ordonner vos requêtes et opérations de sorte à ne jamais faire référence à une ressource avant sa création. Dans le cas des requêtes de mutation groupée, cela signifie que les opérations doivent être ordonnées de manière à ce que les ressources référencées soient listées avant les ressources qui les référencent.

Si vous choisissez de créer des ressources Asset dans la même requête de mutation groupée qui crée un AssetGroup et ses ressources AssetGroupAsset, tous les AssetOperations doivent précéder tous les AssetGroupAssetOperations, comme illustré dans le diagramme.

Le serveur Google Ads regroupe les AssetGroupAssetOperations consécutifs et évalue si un AssetGroup répond aux exigences minimales concernant les composants après la dernière opération de ce groupe. Si vous alternez entre AssetOperations et AssetGroupAssetOperations dans votre requête, le serveur API évaluera les exigences minimales concernant les composants après le premier AssetGroupAssetOperation et renverra une erreur sans poursuivre le reste des 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 aucune des ressources AssetGroupAsset associées ne seraient créés.

Modifier des groupes de composants

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

Cela est particulièrement important pour les groupes de composants des campagnes retail créés sans aucun composant associé. Les requêtes ultérieures visant à ajouter des composants au AssetGroup en créant des ressources AssetGroupAsset ne réussiraient que si la requête répondait à toutes les exigences concernant les composants. En d'autres termes, vous ne pouvez pas ajouter de composants à ces groupes de composants de manière incrémentielle.