Structurer les requêtes

Ce guide détaille de nombreuses subtilités de la structuration des requêtes qui créent et mettre à jour les campagnes Performance Max. Cela peut être une ressource utile lors de la conception votre intégration. Ce guide explique comment les demandes qui modifient Performance Max sont traitées et peuvent servir de ressource Performance Max guide de dépannage Guide sur le 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 sous la forme d'un combinaison de plusieurs ressources uniques.

Campagnes Performance Max standards

Les campagnes Performance Max standards nécessitent un ensemble minimal de ressources à diffuser.

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

Il est important de noter que les opérations permettant de créer AssetGroup et Les entités AssetGroupAsset doivent être incluses ensemble dans une même requête. les ressources AssetGroupAsset doivent être combinées pour respecter tous les minimum de ressources les exigences et les spécifications ; voyez en quoi cela diffère pour Campagnes retail : Demandes de création un AssetGroup sans toutes les entités AssetGroupAsset requises génère une error; voir Comparaison entre les états non valides et les requêtes non valides pour plus de contexte.

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

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

Bien que vous puissiez créer correctement les éléments CampaignBudget, Campaign et Asset ressources dans des demandes précédentes distinctes, la campagne Performance Max pouvant être diffusées jusqu'à ce que les ressources AssetGroup et AssetGroupAsset sont également créés.

Conditions minimales requises pour une campagne Performance Max valide

Vous pouvez personnaliser davantage vos campagnes Performance Max en créant comme illustré dans le schéma.

• 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 le même 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, car elles comportent deux méthodes distinctes pour créer des groupes d'assets qui aboutissent à une diffusion valide campagne:

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

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

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

Il est important de noter que le champ Campaign.shopping_settings doit être renseignées dans les campagnes retail. De plus, les final_urls listés dans chaque AssetGroup doit correspondre aux URL associées à l'ID de compte Merchant Center. spécifié dans Campaign.shopping_settings. Enfin, chaque AssetGroup doit sont associés à une arborescence de groupes de fiches produit valide, composée d'un ou de plusieurs AssetGroupListingGroupFilter ressources. Vous devez au moins créer un seul 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 via une seule requête. Toutefois, la campagne ne pourra être diffusée que lorsque toutes ces ressources seront remplies. ont é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 Les campagnes Performance Max, y compris en créant des signaux de groupe d'assets, des campagnes objectifs de conversion et critères de campagne. Si vous choisissez d'ajouter des composants à un AssetGroup lorsque vous créez la ressource AssetGroup, votre AssetGroup est vous devez respecter les exigences minimales concernant le nombre d'assets. En d'autres termes, vous pouvez soit n'inclut aucun composant ou tous les composants requis.

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, 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. Pour Par exemple, vous pouvez créer une ressource Campaign autonome avec une advertising_channel_type sur PERFORMANCE_MAX. Bien que la demande de création si la campagne est réussie, elle ne peut pas être diffusée tant que vous n'avez pas ajouté au moins un AssetGroup à la campagne. Si vos demandes aboutissent, mais que votre campagne ou ne s'affichent pas, vous pouvez utiliser CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus et AssetGroupPrimaryStatusReason pour en déterminer la raison, comme indiqué dans dépannage guide.

Requête non valide

Il s'agit d'une demande qui n'aboutirait pas, car la campagne ou ressource dans un état non valide. Par exemple, l'API Google Ads génère une erreur essayez de créer un AssetGroup pour une campagne non axée sur la vente au détail sans inclure le nombre minimal de composants requis. C'est pourquoi vous devez inclure un AssetGroup et ses ressources AssetGroupAsset dans même demande. Cela signifie également que toutes vos ressources AssetGroupAsset doivent aux spécifications correctes pour un field_type donné, afin d'empêcher toute d'échec de la requête.

Regrouper des opérations avec des requêtes mutate

Les campagnes Performance Max sont composées de plusieurs ressources. permettant de créer ces ressources distinctes dans des requêtes uniques ou dans un demande de mutation multiple. Toutefois, AssetGroups et les AssetGroupAssets associés dans les campagnes Performance Max standards doivent être dans une seule requête atomique.

Votre campagne ne peut pas être diffusée tant que vous n'avez pas créé les ressources requises mentionnées dans ce guide. Lors de l'émission d'un , utilisez les noms de ressources réels des ressources référencées dans les requêtes. Lors de l'envoi de demandes de mutation en masse contenant plusieurs opérations, utilisez 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 campagne, vous devez organiser vos demandes et opérations de telle sorte que référencer une ressource avant sa création. Dans le cas d'une opération "mutate" en masse, de requête, cela signifie que les opérations doivent être ordonnées les ressources sont listées avant les ressources qui les référencent.

Si vous choisissez de créer des ressources de composant dans la même demande de mutation multiple crée un AssetGroup et ses ressources AssetGroupAsset, toutes les AssetOperations doit précéder tous les AssetGroupAssetOperations, car illustré dans le diagramme.

Le serveur Google Ads regroupe les AssetGroupAssetOperations consécutifs et évalue si une AssetGroup respecte les exigences minimales concernant les composants 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 concernant les composants après les AssetGroupAssetOperation premières et renvoient une erreur sans effectuer les autres opérations dans le requête. Par conséquent, aucun des composants de la demande n'a été ajouté à votre compte Google Ads. De plus, ni les AssetGroup, ni aucun des AssetGroupAsset ressources seront créées.

Modifier les groupes de composants

Une fois que vous avez créé un AssetGroup valide, vous ne pouvez plus émettre de requêtes Cela entraînerait un état incorrect ne sont plus satisfaites. Toute requête de ce type génère une erreur. Par exemple, si vous créer un AssetGroup avec un seul MARKETING_IMAGE ; (minimum requis), toute demande de suppression de AssetGroupAsset associé à ce MARKETING_IMAGE renverra une erreur.

C'est particulièrement important pour les groupes d'assets des campagnes retail. créées sans aucun élément associé. Demandes ultérieures d'ajout d'éléments au AssetGroup en créant des ressources AssetGroupAsset ne réussirait que si a rempli toutes les exigences concernant les éléments. En d'autres termes, vous ne pouvez pas ajouter de composants ces groupes d'assets de manière progressive.