Passer au contenu principal

​
Où Trouver les Journaux

Naviguez vers l’onglet Outils de Développement dans votre Plateforme Publicitaire Topsort pour accéder aux journaux en temps réel de votre clé API.

​
Disponibilité des Journaux

EnvironnementCe Qui est EnregistréRétention
StagingToutes les requêtes et réponses de l’API30 jours
ProductionErreurs et requêtes échouées uniquement30 jours
À mesure que votre utilisation de l’API de production augmente, les requêtes réussies peuvent être filtrées des journaux pour améliorer les performances. Les erreurs et les informations de débogage seront toujours disponibles.

​
Comprendre les Entrées de Journal

​
Requêtes Réussies

Capture d'écran de notification du validateur de schéma Les appels API réussis affichent :
  • Statut : Codes de statut HTTP 200/201/204
  • Horodatage : Quand la requête a été effectuée
  • Endpoint : Quel endpoint de l’API a été appelé
  • Temps de réponse : Combien de temps la requête a pris
  • Taille de la requête : Taille des données de requête/réponse

​
Entrées d’Erreur

Capture d'écran d'erreur du validateur de schéma Les requêtes échouées incluent des informations de débogage supplémentaires :
  • Statut : Code d’erreur HTTP (400, 401, 403, etc.)
  • Détails de l’erreur : Code d’erreur spécifique et message
  • Corps de la requête : Quelles données ont été envoyées (pour le débogage)
  • Stack trace : Détails internes de l’erreur (lorsque disponible)

​
Modèles Courants de Journal

​
Problèmes d’Authentification

401 Unauthorized - invalid_api_key
Missing Authorization header
Solution : Ajoutez l’en-tête Authorization: Bearer VOTRE_CLE_API

​
Erreurs de Validation

422 Unprocessable Entity - invalid_product_id
Product 'sku_123' not found in catalog
Solution : Vérifiez que le produit existe et est correctement orthographié

​
Limitation de Débit

429 Too Many Requests - rate_limited
X-RateLimit-Remaining: 0
Solution : Implémentez une logique de nouvelle tentative avec backoff exponentiel

​
Utiliser les Journaux pour le Débogage

​
1. Événements N’apparaissant Pas dans le Tableau de Bord

Recherchez :
  • Statut 200 sur les appels /events
  • Erreurs de validation dans le payload de l’événement
  • Problèmes d’horodatage (occurredAt dans le futur ou trop ancien)

​
2. Résultats d’Enchères Vides

Vérifiez :
  • Statut du budget de campagne
  • Disponibilité du produit dans le catalogue
  • Format de la requête d’enchère

​
3. Problèmes d’Attribution

Examinez les journaux d’événements pour :
  • Utilisation cohérente de l’ID utilisateur
  • resolvedBidId approprié des enchères
  • Timing des événements de clic/achat

​
Meilleures Pratiques

​
Surveillance des Journaux

  • Vérifiez les journaux après avoir déployé un nouveau code d’intégration
  • Surveillez les taux d’erreur pendant les périodes de trafic élevé
  • Configurez des alertes pour les modèles d’erreur récurrents

​
Flux de Travail de Dépannage

  1. Reproduisez le problème dans l’environnement de staging
  2. Vérifiez les journaux récents pour les modèles d’erreur
  3. Vérifiez le format de la requête par rapport à la documentation de l’API
  4. Testez avec un payload minimal pour isoler le problème
  5. Contactez le support avec les horodatages des journaux pour les problèmes complexes

​
Confidentialité et Traitement des Données

  • Les journaux peuvent contenir des données sensibles de vos requêtes
  • Les journaux de production expirent automatiquement après 30 jours
  • L’accès aux journaux est réservé uniquement aux utilisateurs administrateurs
  • Les données personnelles dans les journaux suivent les politiques standard de rétention des données

​
Besoin d’Aide ?

Si vous constatez des erreurs persistantes dans vos journaux :
  1. Notez l’horodatage des requêtes problématiques
  2. Copiez le message d’erreur exact et les détails de la requête
  3. Contactez le support avec ces informations pour une résolution plus rapide
Notre équipe peut accéder aux journaux détaillés côté serveur pour aider à diagnostiquer les problèmes d’intégration complexes.