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 la procédure 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 des assets de marque au niveau de la campagne (BUSINESS_NAME, LOGO et LANDSCAPE_LOGO).

  • Un seul asset BUSINESS_NAME
  • Au moins un composant LOGO

Si vous ne parvenez pas à associer ces ressources CampaignAsset lorsque cela est nécessaire, vous pouvez recevoir une erreur CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED ou CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, selon le type d'élément 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 :

  • Créer un Campaign sans fournir à la fois BUSINESS_NAME et LOGO en tant que ressources CampaignAsset dans la même requête.
  • Suppression d'une ou de plusieurs ressources CampaignAsset qui empêcherait la campagne de respecter les exigences minimales concernant les assets de marque.
  • Associer les composants personnalisés requis au niveau du groupe de composants à une campagne Performance Max pour le retail sans composants sans fournir toutes les ressources CampaignAsset requises dans la même requête. (Pour associer uniquement des composants personnalisés facultatifs tels que YOUTUBE_VIDEO, vous devez également respecter les exigences minimales concernant les groupes de composants et les liens de marque CampaignAsset requis afin que le groupe de composants n'entre pas dans un état non compatible qui bloque les modifications dans l'interface utilisateur de Google Ads.)

Si vous essayez d'associer des assets de marque au mauvais niveau, des erreurs seront également générées. 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 non, et pourquoi.

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 demande de création d'un AssetGroup ou de mise à jour de ses ressources AssetGroupAsset associées échoue avec un NOT_ENOUGH_*_ASSET AssetGroupError (tel que AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET), votre AssetGroup ne répond pas aux exigences minimales concernant les composants. Cette erreur se produit lorsque vous créez un AssetGroup standard sans les assets requis, que vous associez des assets personnalisés requis à un AssetGroup de vente au détail sans asset sans fournir tous les assets requis, ou que vous supprimez des assets requis sans dissocier tous les assets personnalisés dans une même requête de vente au détail. (Si vous n'associez que des composants personnalisés facultatifs tels que YOUTUBE_VIDEO, vous devez également inclure tous les composants obligatoires pour que le groupe de composants n'entre pas dans un état non compatible qui bloque les modifications dans l'interface utilisateur de Google Ads.)

Par exemple, une erreur AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET indique que la requête a été envoyée sans le nombre minimal d'assets MARKETING_IMAGE (un dans ce cas). Pour corriger cette erreur, envoyez votre requête en tant que requête de modification groupée à l'aide de la méthode GoogleAdsService.Mutate contenant asset_group_operation (lors de la création d'un groupe de composants) et toutes les entrées asset_group_asset_operation requises, comme indiqué dans Associer des groupes de composants à des composants.

Dans cet exemple, la liste des opérations de modification dans la requête de modification 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'un AssetGroup échoue avec une erreur AssetGroupError.SHORT_DESCRIPTION_REQUIRED, cela signifie qu'il manquait un asset TEXT de 60 caractères ou moins et un field_type de DESCRIPTION dans votre AssetGroup. La procédure à suivre pour résoudre ce problème est la même que celle présentée 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 le AssetGroupAsset doit comporter 60 caractères ou moins.

Consultez la section Erreurs courantes pour obtenir la liste des erreurs courantes et savoir comment les corriger.

Trouver la source d'un asset 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 enregistré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érir plus), 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 dans l'interface Web de 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. 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;
  }
}
Précédent
Optimisations
Suivant
Erreurs courantes lorsque vous utilisez Performance Max