Ce guide décrit en détail de nombreuses subtilités de la structuration des requêtes qui créent et mettent à jour des campagnes Performance Max. Elle peut s'avérer utile pour concevoir votre intégration. Ce guide explique comment les demandes qui modifient les campagnes Performance Max sont traitées et peut être une ressource associée au guide de dépannage de Performance Max.
Créer des campagnes Performance Max
Dans l'API Google Ads, les entités des campagnes 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.
Il est important de noter que les opérations permettant de créer des entités AssetGroup
et AssetGroupAsset
doivent être incluses dans une même requête, et que les ressources AssetGroupAsset
doivent être combinées pour répondre à toutes les exigences minimales en matière d'éléments et à toutes les spécifications. 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. Pour en savoir plus, consultez la section État non valide par rapport aux requêtes non valides.
Il existe différentes options pour structurer les demandes de création de campagnes Performance Max. La décision quant à la manière 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
etAsset
dans des requêtes distinctes avant de créer les ressourcesAssetGroup
etAssetGroupAsset
. - Incluez l'ensemble de 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
n'auront pas été créées.
Exigences minimales pour une campagne Performance Max de diffusion valide
Vous pouvez personnaliser davantage vos campagnes Performance Max en créant des ressources supplémentaires, comme illustré dans le schéma.
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 options supplémentaires
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 d'assets qui débouchent sur une campagne de diffusion valide:
- Groupes de composants sans aucun asset
- Groupes de composants contenant TOUS les composants requis (recommandé)
Lorsque vous choisissez d'exclure des éléments 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 assets à toucher sur l'ensemble de l'inventaire. Pour être diffusées, les campagnes Performance Max pour le commerce nécessitent l'ensemble minimal de ressources suivant.
CampaignBudget
Campaign
(avecShoppingSettings
renseigné)AssetGroup
AssetGroupListingGroupFilter
Notez que le champ Campaign.shopping_settings
doit être renseigné dans les campagnes pour le commerce. En outre, les final_urls
listés dans chaque AssetGroup
doivent correspondre aux URL associées à l'ID de compte Merchant Center spécifié dans l'Campaign.shopping_settings
. Enfin, chaque AssetGroup
doit être associée à 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 tenir compte de tous les produits du flux Merchant Center que vous avez spécifié.
Chacune de ces ressources peut être créée séparément ou via 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 Performance Max de diffusion de retail valide
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 soumise aux exigences minimales en matière d'éléments. En d'autres termes, vous pouvez n'inclure
aucun élément ou tous les éléments 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 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 unadvertising_channel_type
PERFORMANCE_MAX
. Bien que la demande de création de la campagne aboutisse, elle ne peut être diffusée que lorsque vous ajoutez au moins unAssetGroup
à la campagne. Si vos requêtes aboutissent, mais que votre campagne ou vos groupes d'assets ne sont pas diffusés, vous pouvez utiliserCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
etAssetGroupPrimaryStatusReason
pour déterminer la raison, comme indiqué dans le guide de dépannage. - Requête non valide
- Requête qui n'aboutit pas, car l'état de la campagne ou de la ressource serait incorrect. Par exemple, l'API Google Ads génère une erreur si vous essayez de créer un
AssetGroup
pour une campagne non liée à la vente au détail sans inclure le nombre minimal de composants requis. C'est pourquoi vous devez inclure un élémentAssetGroup
et ses ressourcesAssetGroupAsset
dans la même requête. Cela signifie également que toutes vos ressourcesAssetGroupAsset
doivent répondre aux spécifications appropriées pour unfield_type
donné afin d'éviter l'échec de l'ensemble de la requête.
Opérations groupées avec des demandes mutate
Les campagnes Performance Max sont composées de plusieurs ressources. Vous avez la possibilité de les créer dans des requêtes uniques ou dans une seule demande de mutation groupée. Toutefois, 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.
Pour que votre campagne puisse être diffusée, vous devez d'abord créer 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 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 groupée 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 groupée, 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 les ressources qui les référencent.
Si vous choisissez de créer des ressources d'élément 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 schéma.
Le serveur Google Ads regroupe des AssetGroupAssetOperations
consécutives et évalue si une AssetGroup
répond aux exigences minimales d'éléments à la suite de la dernière opération de ce groupe. Si vous alternez AssetOperations
et AssetGroupAssetOperations
dans votre requête, le serveur d'API évalue les exigences minimales en termes de composants après le premier AssetGroupAssetOperation
et renvoie une erreur sans poursuivre les autres opérations de la requête. Par conséquent, aucun des composants de la demande ne sera ajouté à votre compte Google Ads. En outre, 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 plus envoyer de requêtes ultérieures qui entraîneraient un état non valide dans lequel les exigences minimales d'é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
(l'exigence minimale), toute requête visant à supprimer le AssetGroupAsset
associé à ce MARKETING_IMAGE
renverrait une erreur.
Cela est particulièrement important dans le cas de groupes d'assets dans des campagnes retail créées sans aucun asset associé. Les requêtes ultérieures visant à ajouter des éléments à AssetGroup
en créant des ressources AssetGroupAsset
n'aboutiront que si elles répondent à toutes les exigences concernant les éléments. En d'autres termes, vous ne pouvez pas ajouter d'assets à ces groupes de manière incrémentielle.