Structurer les requêtes

Ce guide décrit en détail les subtilités de la structuration des requêtes qui créent et mettent à jour des campagnes Performance Max. Il peut s'agir d'une ressource utile lorsque vous concevez votre intégration. Ce guide explique comment les requêtes qui modifient les campagnes Performance Max sont traitées. Il peut servir de ressource complémentaire au guide de dépannage Performance Max et au guide de 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 pour lesquelles les consignes relatives à la marque sont activées)
• Groupes de composants
• Composants d'un groupe de composants
• Assets

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

Il est important de noter que les opérations de création d'entités AssetGroup et AssetGroupAsset doivent être incluses ensemble dans une même requête, et que les ressources AssetGroupAsset doivent être combinées pour répondre à toutes les exigences minimales concernant les composants et à toutes les spécifications. Découvrez en quoi cela diffère pour les campagnes retail. Les requêtes de création d'un AssetGroup sans toutes les entités AssetGroupAsset requises entraînent une erreur. Pour en savoir plus, consultez État non valide et requêtes non valides.

Il existe différentes options pour structurer les requêtes 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, Asset et CampaignAsset dans des requêtes distinctes avant de créer les ressources AssetGroup et AssetGroupAsset. (Pour les campagnes pour lesquelles les consignes relatives à la marque sont activées, les ressources Campaign et les ressources CampaignAsset requises doivent être incluses ensemble dans une seule requête.)
• Incluez toutes ces ressources dans une seule requête de modification.

Bien que vous puissiez créer les ressources CampaignBudget, Campaign, Asset et CampaignAsset dans des requêtes distinctes préalables, 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 correctement

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

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

Vous pouvez inclure des opérations pour 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 la création de AssetGroup.

Campagne Performance Max avec options supplémentaires

Campagnes Performance Max pour le retail

Les campagnes retail sont uniques, car il existe deux façons distinctes de créer des groupes de composants qui aboutissent à une campagne de diffusion valide :

• Groupes de composants sans composants personnalisés (ou avec uniquement des composants HTML5 MEDIA_BUNDLE)
• Groupes de composants contenant tous les composants requis (recommandé)

Lorsque vous choisissez d'exclure des composants des 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. Les campagnes retail Performance Max nécessitent l'ensemble minimal de ressources suivant pour être diffusées :

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

Le champ Campaign.shopping_setting doit être renseigné dans les campagnes retail. De plus, tout final_urls listé dans un AssetGroup doit correspondre au domaine du site Web associé à l'ID de compte Merchant Center spécifié dans Campaign.shopping_setting. 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 arborescence à un seul nœud pour prendre en compte 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 une campagne retail Performance Max valide et diffusée

Les campagnes retail Performance Max peuvent utiliser toutes les options disponibles pour les campagnes Performance Max standards, y compris la création de signaux de groupe de composants, d'objectifs de conversion de campagne et de critères de campagne. Si vous choisissez d'ajouter des composants personnalisés (autres que des composants HTML5 MEDIA_BUNDLE) à un AssetGroup lors de la création de la ressource AssetGroup, votre requête doit respecter toutes les exigences minimales concernant les composants (y compris les composants de marque au niveau de la campagne si les consignes relatives à la marque sont activées). En d'autres termes, n'incluez aucun asset personnalisé ou incluez tous les assets requis.

Campagne Performance Max pour le commerce avec options supplémentaires

État non valide et requêtes non valides

Lorsque vous utilisez des campagnes Performance Max dans l'API Google Ads, il est important de distinguer les états non valides des requêtes 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. Même si la demande de création de la campagne aboutit, celle-ci ne peut pas être diffusée tant que vous n'avez pas ajouté au moins un AssetGroup à la campagne. Si vos requêtes aboutissent, mais que votre campagne ou vos groupes de composants 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

Une requête qui ne peut pas aboutir, 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 retail (autre que les campagnes Performance Max Local Services) sans inclure les composants minimum 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 appropriées pour un field_type donné afin d'éviter l'échec de l'ensemble de la requête.

Regrouper les opérations avec des requêtes de modification

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 modification groupée. Toutefois, les AssetGroups et les AssetGroupAssets associés dans les campagnes Performance Max standards doivent être créés dans une seule requête atomique, comme indiqué précédemment.

Votre campagne ne pourra pas être diffusée tant que vous n'aurez pas créé toutes les ressources requises indiqué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 modification 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 modification groupée pour créer une campagne Performance Max, vous devez ordonner 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 modification groupées, 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 modification groupée qui crée une ressource AssetGroup et ses ressources AssetGroupAsset, toutes les ressources AssetOperations doivent précéder toutes les ressources 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 d'API évaluera les exigences minimales concernant les composants après le premier AssetGroupAssetOperation et renverra une erreur sans poursuivre les autres opérations de la requête. Par conséquent, aucun des composants de la requête ne serait ajouté à votre compte Google Ads. De plus, ni le AssetGroup ni aucune des ressources AssetGroupAsset associées ne seraient créés.

Mettre à jour les groupes de composants

Une fois que vous avez créé un AssetGroup valide, vous ne pouvez pas émettre de requêtes ultérieures qui laisseraient un groupe de composants en dessous des exigences minimales concernant les composants. Toute requête de ce type génère une erreur. Par exemple, si vous créez un AssetGroup avec un seul MARKETING_IMAGE (le minimum requis), une requête visant à supprimer uniquement ce MARKETING_IMAGE AssetGroupAsset renvoie une erreur. Toutefois, dans les campagnes retail Performance Max, vous pouvez revenir à AssetGroup l'utilisation des composants générés automatiquement par Google Merchant Center en supprimant tous les liens AssetGroupAsset personnalisés dans une seule requête.

Pour les groupes de composants des campagnes retail Performance Max créés sans composants personnalisés associés, les requêtes ultérieures d'association de composants personnalisés (autres que les composants HTML5 MEDIA_BUNDLE) doivent s'assurer qu'au moins un final_urls est défini sur le AssetGroup (en le renseignant d'abord s'il a été omis à l'origine) et doivent fournir tous les composants minimaux requis (y compris les assets de marque au niveau de la campagne si les consignes relatives à la marque sont activées) dans une seule requête atomique. N'associez pas de composants d'annonce facultatifs tels que YOUTUBE_VIDEO seuls et n'ajoutez pas de composants d'annonce de manière incrémentielle dans des requêtes distinctes. Si vous n'associez que des composants personnalisés facultatifs, le groupe de composants se retrouve dans un état non compatible qui empêche les modifications dans l'UI Google Ads. Pour en savoir plus, consultez Associer des groupes de composants à des composants dans les campagnes retail Performance Max.