Surveiller les diagnostics de données hors connexion

Utilisez l'API Google Ads pour récupérer les diagnostics des données hors connexion, qui contiennent des informations sur l'état général de vos processus d'importation et d'ajustement des conversions.

Pour récupérer les derniers diagnostics des données hors connexion pour votre compte, utilisez l'une des ressources suivantes :

Diagnostics au niveau du compte

Pour récupérer les diagnostics d'importation des conversions au niveau du compte, utilisez la requête GAQL suivante :

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary

Cette requête renvoie des lignes OfflineConversionUploadClientSummary distinctes pour chaque type de client utilisé dans les importations récentes. Par exemple, si vous avez récemment importé des données à l'aide de l'API Google Ads et de l'interface utilisateur Google Ads, les résultats contiennent des entrées distinctes pour les valeurs client de GOOGLE_ADS_API et GOOGLE_ADS_WEB_CLIENT.

Diagnostics au niveau des actions de conversion

Pour récupérer les diagnostics d'importation des conversions au niveau de l'action de conversion, utilisez la requête GAQL suivante :

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = <CONVERSION_ACTION_ID>

Comme pour les diagnostics au niveau du compte, cette requête renvoie des lignes OfflineConversionUploadConversionActionSummary distinctes pour chaque type de client utilisé dans les importations récentes. Par exemple, si vous avez récemment importé des données à l'aide de l'API Google Ads et de l'interface utilisateur Google Ads, les résultats contiennent des entrées distinctes pour les valeurs client de GOOGLE_ADS_API et GOOGLE_ADS_WEB_CLIENT.

Comment interpréter ces résumés ?

Chaque OfflineConversionUploadClientSummary ou OfflineConversionUploadConversionActionSummary comporte un champ status qui reflète l'état général des importations pour le client. Il contient également les informations suivantes :

  • Nombre total d'événements reçus.
  • Nombre d'événements traités avec succès.
  • Nombre d'événements en attente (événements en cours de traitement).
  • Un champ alerts qui fournit un résumé des erreurs, regroupées par OfflineConversionError.

Tous ces champs contiennent des informations sur le dernier jour calendaire complet d'importations. Utilisez ces informations pour évaluer l'état actuel de vos importations.

En outre, chaque OfflineConversionUploadClientSummary ou OfflineConversionUploadConversionActionSummary contient deux types de rapports différents :

daily_summaries
successful_count, failed_count et pending_count des demandes d'importation des sept derniers jours, regroupées par date d'importation.
job_summaries

successful_count, failed_count et pending_count des sept demandes d'importation les plus récentes, regroupées par job_id. job_id est un champ facultatif de UploadClickConversionsRequest et UploadConversionAdjustmentsRequest. Vous pouvez définir job_id sur un nombre non négatif inférieur à 2^31 ou laisser l'API Google Ads attribuer un ID de job généré par le système à votre requête. Quelle que soit l'option choisie, UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse renvoie job_id.

Il peut être utile d'attribuer votre propre job_id lorsque vous avez un seul job ou processus qui importe un grand nombre de conversions à l'aide de plusieurs requêtes. Si vous définissez le job_id sur la même valeur pour chacune de ces requêtes, vous pouvez récupérer une seule entrée pour le job à partir de job_summaries. Si, au lieu de cela, vous laissez l'API Google Ads attribuer une valeur générée par le système au job_id de chaque requête, le job_summaries contient une entrée distincte pour chaque requête, ce qui peut compliquer l'analyse de l'état général de votre job.

Utiliser les résumés

Pour vous assurer que vos processus d'importation enregistrent les conversions et les améliorations comme prévu, récupérez régulièrement les récapitulatifs de chacun de vos comptes. Si le champ status d'un récapitulatif n'est pas défini sur EXCELLENT, utilisez la liste des erreurs sous alerts pour vous aider à modifier votre processus d'importation afin de réduire ou d'éliminer ces erreurs.

Exemple :

  • Si l'état est NEEDS_ATTENTION, une grande partie de vos opérations d'importation ont échoué. Examinez les erreurs sous alerts et modifiez votre processus d'importation pour réduire ou éliminer ces erreurs.

  • Si l'état est NO_RECENT_UPLOADS, cela signifie que Google Ads n'a reçu aucune importation récente pour client. Si cela est inattendu, examinez les processus qui effectuent des importations à l'aide de ce client.

    Par exemple, si la valeur de status pour GOOGLE_ADS_API est NO_RECENT_UPLOADS, cela peut indiquer que votre processus d'importation qui utilise l'API Google Ads a récemment cessé de s'exécuter.

  • Pour déterminer si une date ou un job d'importation spécifique a envoyé un grand nombre d'événements dont le traitement a échoué, vérifiez les éléments successful_count, failed_count et pending_count de daily_summaries et job_summaries. L'exécution des événements en attente peut prendre jusqu'à 24 heures.

Pour en savoir plus sur l'amélioration des diagnostics des données hors connexion, consultez le Centre d'aide.

Restrictions

Tenez compte des points suivants lorsque vous récupérez des récapitulatifs d'importation :

  • L'API Google Ads ne renvoie les diagnostics des données hors connexion que si le customer_id de la requête searchStream ou search correspond au même client que celui que vous avez utilisé récemment pour importer des conversions.

    Par exemple, un compte client qui utilise le suivi des conversions multicomptes peut ne contenir aucun diagnostic. Toutefois, vous pouvez récupérer les diagnostics en envoyant une requête dans laquelle le customer_id correspond au customer_id du compte administrateur que vous utilisez pour les importations.

  • Google Ads traite les erreurs CLICK_NOT_FOUND des importations du suivi avancé des conversions pour les prospects comme des avertissements. Par conséquent, si alerts contient une entrée pour cette erreur, les opérations correspondantes sont toujours considérées comme réussies et sont incluses dans successful_event_count.

Précédent
Variables de conversion personnalisées
Suivant
Rapports