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 de la campagne et du groupe 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, il se peut que des problèmes affectent vos annonces, enchères, ciblage, suivi des conversions ou paramètres de campagne. Consultez les guides suivants pour connaître les étapes de dépannage :

Campagnes avec consignes relatives à la marque 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 pour lesquelles Campaign.brand_guidelines_enabled est défini sur true utilisent des composants de marque au niveau de la campagne (BUSINESS_NAME, LOGO et LANDSCAPE_LOGO), et doivent comporter :

  • Exactement un composant BUSINESS_NAME
  • Au moins un composant LOGO

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

Tenter d'associer des composants de marque au mauvais niveau générera également des erreurs, que vous pouvez corriger comme suit :

Dépannage des groupes de composants

Utilisez les asset_group.primary_status et asset_group.primary_status_reasons champs pour obtenir 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 asset_group_asset.primary_status, asset_group_asset.primary_status_details, et asset_group_asset.primary_status_reasons champs 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 liées aux groupes de composants

Si votre requête de création d'un AssetGroup échoue avec une 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 en matière de composants et n'a pas été créé.

Par exemple, une erreur AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET suggère que la requête de création d'un AssetGroup a été envoyée sans le nombre minimal de MARKETING_IMAGES, une dans ce cas. Pour corriger cette erreur, renvoyez votre requête de création d'un AssetGroup en tant que requête de mutation groupée à l'aide de la méthode GoogleAdsService.mutate contenant une asset_group_operation et toutes les asset_group_asset_operations manquantes, comme illustré dans Associer des groupes de composants à 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. Le composant référencé par AssetGroupAsset doit également répondre aux spécifications d'une MARKETING_IMAGE.

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

Consultez Erreurs courantes pour obtenir la liste des erreurs courantes et découvrir comment les corriger.

Trouver la source des composants 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 asset_group_asset.source champ 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 signalé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 les 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 via l'interface Web Google Ads.

Si vous devez calculer les valeurs de conversion en omettant la valeur vie de tous les nouveaux clients, reportez-vous au pseudo-code suivant. La valeur vie de tous les nouveaux clients peut être téléchargée à partir de 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;
  }
}