Structurer les requêtes

Ce guide détaille de nombreuses subtilités de la structuration des requêtes qui créent et mettent à jour des campagnes Performance Max. Il peut s'avérer 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.

Pour les campagnes pour lesquelles les consignes relatives aux marques sont activées, les opérations de création de Campaign et les ressources CampaignAsset requises doivent être incluses dans une seule requête. Les ressources CampaignAsset doivent également 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 seule requête, et que les ressources AssetGroupAsset doivent se combiner pour répondre à toutes les exigences minimales concernant les composants et 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 génèrent une erreur. Pour en savoir plus, consultez la section État incorrect par rapport aux requêtes incorrectes.

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 CampaignAsset requises doivent être incluses ensemble dans une seule demande.)
  • 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 préalables distinctes, la campagne Performance Max ne pourra pas être diffusée tant que les ressources AssetGroup et AssetGroupAsset ne seront pas créées également.

Exigences minimales pour diffuser une campagne Performance Max valide

image

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

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

Campagne Performance Max avec options supplémentaires

image

Campagnes Performance Max pour le commerce

Les campagnes retail sont uniques en ce sens qu'il existe deux façons distinctes de créer des groupes de composants qui génèrent une campagne de diffusion valide:

  • Groupes de composants sans composants
  • 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. Les campagnes Performance Max pour le retail nécessitent l'ensemble minimal de ressources suivant pour être diffusées.

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

Notez que le champ Campaign.shopping_settings doit être renseigné dans les campagnes retail. De plus, les final_urls listées 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 groupe de fiches produit valide composé d'une ou de plusieurs ressources AssetGroupListingGroupFilter. Vous devez créer au moins une arborescence de nœuds pour 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 diffuser une campagne Performance Max retail valide

image

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 n'inclure aucun composant ou tous les composants requis.

Campagne Performance Max pour le retail avec options supplémentaires

image

État non valide par rapport aux requêtes non valides

Lorsque vous travaillez avec 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 de PERFORMANCE_MAX. Bien que la requête de création de la campagne aboutisse, elle 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 d'assets ne sont pas diffusés, vous pouvez utiliser CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus et AssetGroupPrimaryStatusReason pour déterminer la raison, comme indiqué dans le guide de dépannage.
Requête non valide
Requête qui ne réussirait pas, car elle mettrait 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 appropriées pour un field_type donné afin d'éviter que l'ensemble de la requête échoue.

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, comme indiqué précédemment, 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 indiqué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 ultérieures. Lorsque vous envoyez des requêtes de modification groupées contenant plusieurs opérations, utilisez des noms de ressources créés à l'aide d'ID temporaires.

Ordre de priorité des opérations

Que vous utilisiez une requête de modification groupée pour créer une campagne Performance Max ou non, vous devez organiser vos requêtes et vos opérations de sorte à ne jamais faire référence à une ressource avant sa création. Dans le cas des requêtes de modification groupée, cela signifie que les opérations doivent être triées de sorte 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 un AssetGroup et ses ressources AssetGroupAsset, tous les AssetOperations doivent précéder tous les AssetGroupAssetOperations, comme illustré dans le diagramme.

image

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 de l'API évaluera les exigences minimales en termes d'assets 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 AssetGroup ni aucune des ressources AssetGroupAsset associées ne seront créées.

Modifier les groupes d'assets

Une fois que vous avez créé un AssetGroup valide, vous ne pouvez plus 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. Ces requêtes génèrent une erreur. Par exemple, si vous créez une AssetGroup avec un seul MARKETING_IMAGE (exigence minimale), toutes les requêtes visant à supprimer le AssetGroupAsset associé à ce MARKETING_IMAGE renvoient une erreur.

Cela est particulièrement important dans le cas des groupes de composants dans les campagnes retail créées sans composants associés. Les requêtes ultérieures visant à ajouter des composants à 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 des composants à ces groupes de composants de manière incrémentielle.

Précédent
Rapports
Suivant
Traitement par lot