Surveiller les diagnostics de données hors connexion

Utilisez l'API Google Ads pour récupérer diagnostics des données hors ligne, qui contiennent des informations sur la santé globale de l'importation des conversions. d'ajustement des enchères.

Pour récupérer les derniers diagnostics de données hors ligne pour 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 le code suivant : Requête GAQL:

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 données OfflineConversionUploadClientSummary des lignes pour chaque type de client utilisé dans les importations récentes. Par exemple, si vous récemment importé à l'aide de l'API 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 OfflineConversionUploadConversionActionSummary des lignes pour chaque type de client utilisé dans les importations récentes. Par exemple, si vous récemment importé à l'aide de l'API 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ésumés

Chaque OfflineConversionUploadClientSummary ou OfflineConversionUploadConversionActionSummary comporte un champ status, qui reflète les état général de mises en ligne pour 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 encore en cours de traitement).
  • Un champ alerts qui fournit un résumé des erreurs, regroupées par OfflineConversionError

Tous ces champs contiennent des informations pour le jour calendaire complet le plus récent de mises en ligne. Ces informations vous permettent d'évaluer l'état actuel de vos importations.

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

daily_summaries
successful_count, failed_count et pending_count de requêtes d'importation des sept derniers jours, regroupés par importation date.
job_summaries

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

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

Utiliser les résumés

Pour vous assurer que vos processus d'importation enregistrent les conversions et les améliorations vous pouvez récupérer régulièrement les récapitulatifs de chacun de vos comptes. Si le status de n'importe quel résumé ne correspond pas à EXCELLENT, utilisez la liste des erreurs sous alerts pour modifier votre processus de mise en ligne afin de réduire ou et d'éliminer ces erreurs.

Exemple :

  • Si l'état est NEEDS_ATTENTION, une part importante échec des opérations d'importation. Examinez les erreurs sous alerts et modifiez votre d'importation afin de réduire ou d'éliminer ces erreurs.

  • Si l'état est NO_RECENT_UPLOADS, cela signifie que Google Ads n'a reçu aucune récente pour client. S'il s'agit d'une erreur inattendue, 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, cette peut indiquer que votre processus d'importation utilisant l'API Google Ads a cessé de fonctionner récemment.

  • Pour déterminer si une date de mise en ligne ou un job spécifique a entraîné l'envoi le nombre d'événements qui n'ont pas pu être traités, vérifiez le successful_count, failed_count, et pending_count sur daily_summaries et job_summaries. Les événements en attente peuvent prendre jusqu'à 24 heures pour terminer.

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 ligne que si le customer_id sur 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 contiennent 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 gestionnaire que vous utilisez pour les importations.

  • Google Ads traite CLICK_NOT_FOUND erreurs du suivi avancé des conversions pour de prospects en tant qu'avertissements. En tant que un résultat, si alerts contient une entrée pour cette erreur, l'erreur correspondante sont toujours considérées comme réussies et sont incluses dans le successful_event_count