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 ligne pour votre compte, envoyez la requête suivante pour les ressources offline_conversion_upload_client_summary à l'aide de GoogleAdsService:

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.resource_name,
  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

La requête ci-dessus renvoie un OfflineConversionUploadClientSummary distinct 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'UI Google Ads, les résultats contiennent des entrées distinctes pour les valeurs client de GOOGLE_ADS_API et GOOGLE_ADS_WEB_CLIENT.

Chaque OfflineConversionUploadClientSummary comporte un champ status qui reflète l'état général des importations du client. Il contient également le nombre total d'événements reçus, le nombre d'événements traités correctement et un champ alerts qui fournit un résumé des erreurs, regroupés par OfflineConversionError. Tous ces champs contiennent les informations correspondant au jour calendaire complet le plus récent d'importations. Ces informations vous permettent d'évaluer l'état actuel de vos importations.

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

daily_summaries

successful_count et failed_count de requêtes d'importation au cours des sept derniers jours, regroupées par date d'importation.

job_summaries

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

L'attribution de votre propre job_id est utile si une seule tâche ou un seul processus importe un grand nombre de conversions à l'aide de plusieurs requêtes. Si vous définissez le paramètre job_id de 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 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 compliquer l'analyse de l'état général de votre tâche.

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 le status d'un résumé 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, cela signifie qu'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 les importations à l'aide de ce client.

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

• Vérifiez les valeurs successful_count et failed_count de daily_summaries et job_summaries pour déterminer si une tâche ou une date d'importation spécifique ont envoyé un grand nombre d'événements qui n'ont pas été traités correctement.

Restrictions

Tenez compte des points suivants lorsque vous récupérez des résumés 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 est le même client que celui que vous avez utilisé récemment pour importer les conversions.

  Par exemple, un compte client qui utilise le suivi des conversions multicomptes ne peut contenir aucun diagnostic. Toutefois, vous pouvez récupérer les diagnostics en envoyant une requête dans laquelle customer_id correspond à l'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 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.