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 de données hors connexion pour votre compte, utilisez l'une des ressources suivantes :

• offline_conversion_upload_client_summary agrège les diagnostics d'importation au niveau du compte.
• offline_conversion_upload_conversion_action_summary agrège les diagnostics d'importation au niveau de l'action de conversion.

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'UI 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_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 importé des données à l'aide de l'API Google Ads et de l'UI 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é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).
• Champ alerts qui fournit un récapitulatif des erreurs, regroupées par OfflineConversionError.

Tous ces champs contiennent des informations provenant des importations du jour calendaire complet le plus récent. 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

successful_count, failed_count et pending_count 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 tâche généré par le système à votre demande. Quelle que soit l'option choisie, UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse renvoie job_id.

L'attribution de votre propre job_id est utile dans le cas où vous avez un seul job ou processus qui importe un grand nombre de conversions à l'aide de plusieurs requêtes. Si vous définissez la même valeur pour job_id dans chacune de ces requêtes, vous pouvez récupérer une seule entrée pour le job à 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, le job_summaries contient une entrée distincte pour chaque requête. Il peut donc être plus difficile d'analyser 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 pour chacun de vos comptes. Si la valeur 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, cela signifie qu'une partie importante de vos opérations d'importation a échoué. Examinez les erreurs sous alerts et modifiez votre processus d'importation pour les réduire ou les éliminer.

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

  Par exemple, si la valeur 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 champs 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 savoir comment améliorer les 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 de diagnostics de données hors connexion 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 les diagnostics en envoyant une requête dans laquelle customer_id correspond à customer_id du compte administrateur que vous utilisez dans les importations.

• Google Ads traite les erreurs CLICK_NOT_FOUND des importations de 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 ayant abouti et sont incluses dans successful_event_count.