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
etfailed_count
des requêtes d'importation des sept derniers jours, regroupées pardate
d'importation.job_summaries
successful_count
etfailed_count
des sept requêtes d'importation les plus récentes, regroupées parjob_id
.job_id
est un champ facultatif deUploadClickConversionsRequest
etUploadConversionAdjustmentsRequest
. Vous pouvez définirjob_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
ouUploadConversionAdjustmentsResponse
renvoiejob_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éfinissezjob_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 dejob_summaries
. Si vous laissez l'API Google Ads attribuer une valeur générée par le système à l'élémentjob_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 sousalerts
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 pourclient
. Si ce comportement est inattendu, examinez les processus qui effectuent des importations à l'aide de ce client.Par exemple, si
status
pourGOOGLE_ADS_API
estNO_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
etfailed_count
dedaily_summaries
etjob_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êtesearchStream
ousearch
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, sialerts
contient une entrée pour cette erreur, les opérations correspondantes sont toujours considérées comme réussies et sont incluses danssuccessful_event_count
.