Résoudre les problèmes liés à Performance Max

Comme pour les rapports Performance Max, utilisez GoogleAdsService.SearchStream pour récupérer les métadonnées des campagnes et des groupes de composants afin de résoudre les problèmes courants.

Dépannage des campagnes

Si votre campagne Performance Max n'est pas aussi performante que prévu, cela peut être dû à des problèmes au niveau de vos annonces, de vos enchères, de votre ciblage, du suivi des conversions ou des paramètres de votre campagne. Consultez les guides suivants pour connaître les étapes de dépannage :

Campagnes pour lesquelles les consignes relatives à la marque sont activées

Utilisez les consignes relatives à la marque pour contrôler la représentation de votre marque dans les campagnes Performance Max. Vous pouvez utiliser Campaign.brand_guidelines_enabled pour vérifier que les consignes relatives à la marque ont été activées pour une campagne.

Les campagnes Performance Max dont le paramètre Campaign.brand_guidelines_enabled est défini sur true utilisent les composants de marque au niveau de la campagne (BUSINESS_NAME, LOGO et LANDSCAPE_LOGO) et doivent comporter

  • Un seul élément BUSINESS_NAME
  • Au moins un composant LOGO

Si vous ne parvenez pas à associer correctement ces ressources CampaignAsset, vous recevrez une erreur CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED ou CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, selon le type d'asset manquant. Ces erreurs peuvent être déclenchées pour les campagnes pour lesquelles les consignes relatives à la marque sont activées par l'une des actions suivantes :

Si vous essayez d'associer des composants de marque au mauvais niveau, des erreurs se produiront également. Vous pouvez les corriger comme suit :

Résoudre les problèmes liés aux groupes de composants

Utilisez les champs asset_group.primary_status et asset_group.primary_status_reasons pour fournir des insights sur les performances d'un groupe de composants.

SELECT
  asset_group.resource_name,
  asset_group.primary_status,
  asset_group.primary_status_reasons
FROM asset_group
WHERE asset_group.resource_name = "customers/CUSTOMER_ID/assetGroups/ASSET_GROUP_ID"

De même, utilisez les champs asset_group_asset.primary_status, asset_group_asset.primary_status_details et asset_group_asset.primary_status_reasons pour indiquer si un composant de groupe de composants est diffusé ou les raisons pour lesquelles il ne l'est pas.

SELECT
  asset_group_asset.resource_name,
  asset_group_asset.primary_status,
  asset_group_asset.primary_status_reasons,
  asset_group_asset.primary_status_details
FROM asset_group_asset
WHERE asset_group_asset.resource_name = "customers/CUSTOMER/assetGroupAssets/ASSET_GROUP_ID~ASSET_ID~FIELD_TYPE"

Erreurs courantes concernant les groupes de composants

Si votre demande de création d'un AssetGroup échoue avec un AssetGroupError et une valeur d'énumération commençant par NOT_ENOUGH, comme AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET, cela signifie que votre AssetGroup ne répond pas aux exigences minimales concernant les composants et n'a pas été créé.

Par exemple, une erreur AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET suggère que la demande de création d'un AssetGroup a été envoyée sans le nombre minimal de MARKETING_IMAGES, soit un dans ce cas. Pour corriger cette erreur, renvoyez votre demande de création d'un AssetGroup en tant que requête de mutation groupée à l'aide de la méthode GoogleAdsService.mutate contenant un asset_group_operation et tout asset_group_asset_operations manquant, comme indiqué dans Associer des groupes d'assets à des composants.

Dans cet exemple, la liste des opérations de mutation dans la requête de mutation groupée doit inclure au moins un AssetGroupAsset avec un field_type de MARKETING_IMAGE. L'élément référencé par AssetGroupAsset doit également respecter les spécifications d'un MARKETING_IMAGE.

De même, si votre demande de création d'AssetGroup échoue avec un AssetGroupError.SHORT_DESCRIPTION_REQUIRED, cela signifie que votre AssetGroup ne comportait pas de TEXT de 60 caractères ou moins et qu'il manquait un field_type de DESCRIPTION. Les étapes à suivre pour résoudre ce problème sont les mêmes que celles indiquées dans l'exemple NOT_ENOUGH_MARKETING_IMAGE_ASSET. Toutefois, la demande doit inclure au moins un AssetGroupAsset avec un field_type de DESCRIPTION, et le composant référencé par le AssetGroupAsset doit comporter 60 caractères ou moins.

Consultez Erreurs courantes pour obtenir la liste des erreurs courantes et savoir comment les résoudre.

Trouver la source d'un composant pour le dépannage

Performance Max est unique, car il diffuse des annonces contenant des composants importés par les annonceurs et générés automatiquement par Google. En tant qu'annonceur, il peut être utile de connaître la source du composant pour résoudre les problèmes ou évaluer les performances. Dans ce cas, vous pouvez utiliser le champ asset_group_asset.source comme suit :

SELECT
  asset.id,
  asset.name,
  asset_group.id,
  asset_group_asset.source
FROM asset_group_asset
WHERE campaign.id = CAMPAIGN_ID

Valeurs de conversion de l'objectif d'acquisition de nouveaux clients

Les valeurs de conversion indiquées peuvent être supérieures à celles que vous importez manuellement si vous avez configuré l'acquisition de nouveaux clients dans vos campagnes Performance Max ou sur le Réseau de Recherche. Si vous avez sélectionné le mode Valeur d'un nouveau client (enchère plus élevée), la valeur vie de tous vos nouveaux clients est ajoutée à la valeur de conversion de votre action de conversion. La valeur vie de tous les nouveaux clients n'est disponible que dans l'interface Web Google Ads.

Si vous devez calculer les valeurs de conversion en omettant la valeur vie de tous les nouveaux clients, consultez le pseudo-code suivant. Vous pouvez télécharger la valeur vie de tous les nouveaux clients depuis l'interface Web Google Ads.

nonNewCustomerAcquisitionConversionValueTotal = 0;
// For each campaign that has that conversion...
for (campaign in campaigns) {
  // If the new customer acquisition value is 'Bid higher', then subtract.
  if (bidHigher == true) {
    nonNewCustomerAcquisitionConversionValueTotal +=
        campaign.allConversionsValue - campaign.allNewCustomerLifetimeValue;
  }
  // If the new customer acquisition value is 'Only bid' or not set, then don't subtract.
  else {
    nonNewCustomerAcquisitionConversionValueTotal += campaign.allConversionsValue;
  }
}