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 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 OfflineConversionUploadClientSummary distinctes pour chaque type de client utilisé dans les importations récentes. Par exemple, si vous avez récemment importé des données à la fois à 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 à la fois à 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 possède 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ésumé des erreurs, regroupées par OfflineConversionError.

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

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

daily_summaries
successful_count, failed_count et pending_count de demandes d'importation au cours des sept derniers jours, regroupées par importation date.
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 requête. Quelle que soit l'option choisie, UploadClickConversionsResponse ou UploadConversionAdjustmentsResponse renvoie job_id.

L'attribution de votre propre job_id est utile dans un scénario où une seule tâche ou un seul processus importe un grand nombre de conversions à l'aide de plusieurs requêtes. Si vous définissez job_id sur chacune de ces requêtes sur la même valeur, vous pouvez récupérer une seule entrée pour la tâche à partir de job_summaries. Si vous laissez plutôt 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 rendre l'analyse de l'état général de votre tâche plus difficile.

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 status d'un récapitulatif n'est pas EXCELLENT, utilisez la liste des erreurs sous alerts pour vous guider dans la modification de 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, Google Ads n'a reçu aucune importation récente pour le client. Si ce n'est pas le cas, examinez les processus qui effectuent des importations à l'aide de ce client.

    Par exemple, si 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 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.

Restrictions

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

  • L'API Google Ads ne renvoie des diagnostics de 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 pas contenir de diagnostics. 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 pour les importations.

  • Google Ads traite les erreurs CLICK_NOT_FOUND provenant 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 réussies et sont incluses dans successful_event_count.

Précédent
Règles de valeur de conversion
Suivant
Reporting