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, 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 importé vos 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.

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

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

daily_summaries

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

job_summaries

successful_count et failed_count des sept 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 définir job_id sur une valeur non négative inférieure à 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, par exemple, lorsqu'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 la même valeur 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 à l'élément 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 de 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 ce comportement est inattendu, 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 utilisant 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 date d'importation ou une tâche spécifique a envoyé un grand nombre d'événements n'ayant pas été correctement traités.

Restrictions

Tenez compte des points suivants lorsque vous récupérez les récapitulatifs des importations:

• 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 vous avez utilisé récemment pour importer des 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 le customer_id correspond à l'customer_id du compte administrateur que vous utilisez dans les importations.

• Google Ads traite les erreurs CLICK_NOT_FOUND liées à l'importation 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.