Surveiller les diagnostics de données hors connexion

Utilisez l'API Google Ads pour récupérer les diagnostics des données hors ligne, 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 ligne de 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 distinctes OfflineConversionUploadClientSummary pour chaque type de client utilisé dans les importations récentes. Par exemple, si vous avez récemment effectué une importation à 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 de l'action 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_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 = < INSERT 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 effectué une importation à 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.

Interpréter ces récapitulatifs

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)
  • Champ alerts qui fournit un récapitulatif des erreurs, regroupées par OfflineConversionError

Tous ces champs contiennent des informations provenant du jour calendaire complet le plus récent des importations. Utilisez ces informations pour évaluer l'état actuel de vos importations.

De plus, chaque OfflineConversionUploadClientSummary ou OfflineConversionUploadConversionActionSummary contient deux types de rapports différents :

daily_summaries
A 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. Le 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 tâche généré par le système à votre requête. Quelle que soit l'option que vous choisissez, le UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse renvoie le job_id.

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

Utiliser les récapitulatifs

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 status d'un récapitulatif n'est pas 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 partie importante de vos opérations d'importation a échoué. Consultez les erreurs sous alerts et modifiez votre processus d'importation pour réduire ou éliminer ces erreurs.

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

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

  • Pour déterminer si une date ou une tâche d'importation spécifique a envoyé un grand nombre d'événements qui n'ont pas pu être traités, vérifiez les valeurs successful_count, failed_count et pending_count de daily_summaries et job_summaries. Le traitement des événements en attente peut prendre jusqu'à 24 heures.

Pour en savoir plus sur l'amélioration des diagnostics des données hors ligne, 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 des diagnostics des données hors ligne que si le customer_id de la requête searchStream ou search correspond au client 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 des diagnostics en envoyant une requête dans laquelle le customer_id correspond au customer_id du compte administrateur que vous utilisez dans les importations.

  • Google Ads traite les erreurs CLICK_NOT_FOUND des importations du suivi avancé des conversions pour les leads 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 ayant abouti et sont incluses dans le successful_event_count.

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