API de plateforme numérique - Résolution des problèmes de chargement BSS

Vous pouvez utiliser les méthodes de cette rubrique pour diagnostiquer les problèmes liés au chargement de vos données de segment.

Différentes phases du service de segment de lots

Cette section décrit les phases de chargement, afin que vous puissiez comprendre où les problèmes peuvent se produire.

Démarrage : URL de chargement de la demande et ID de travail

Dans cette phase, les clients demandent une URL de chargement et un ID de travail. Cette étape expire en 5 minutes. Si les travaux sont bloqués dans cette phase, cela indique que les clients ont demandé l’URL mais n’ont pas pu charger quoi que ce soit dans le délai imparti.

Téléchargement

Dans cette phase, les clients chargent le fichier dans l’URL donnée. Il est recommandé de ne pas dépasser un chargement par minute. Si les clients ont plus de 200 travaux en attente d’être traités à un moment donné, il leur sera interdit de charger des travaux supplémentaires.

Validation et traitement

Une fois que les clients ont chargé le fichier, le traitement du fichier a lieu dans la phase suivante où la validation des ID de segment et des ID utilisateur est effectuée. Si un enregistrement contient des ID d’utilisateur ou de segment non valides, la plateforme ne traite pas l’enregistrement. Lorsque les clients case activée le travail status, ils peuvent afficher des statistiques concernant le nombre d’utilisateurs non valides.

Achèvement

Au cours de cette phase, les données du fichier sont correctement chargées sur la plateforme et sont disponibles pour le ciblage.

Erreurs de chargement possibles

Tentative de chargement d’un fichier supérieur à 0,5 Go

{"response":{"status":"ERROR","error_code":"FILESIZE_LIMIT_EXCEEDED","errors":["Member exceeds maximum byte size allowed for a file"]}}

Code d’erreur dans le travail de chargement de segment de lot

""batch_segment_upload_job": {
      "phase": "error",
      "start_time": "2015-08-13 18:40:32",
      "uploaded_time": null,
      "validated_time": null,
      "completed_time": null,
      "error_code": "uploading-error",
      "time_to_process": "0.00",
      "percent_complete": 0,
      "num_valid": 0,
      "num_invalid_format": 0,
      "num_valid_user": 0,
      "num_invalid_user": 0,
      "num_invalid_segment": 0,
      "num_invalid_timestamp": 0,
      "num_unauth_segment": 0,
      "num_past_expiration": 0,
      "num_inactive_segment": 0,
      "num_other_error": 0,
      "error_log_lines": null,
      "segment_log_lines": null,
      "id": 11661553,
      "job_id": "Pm3oCUf5CSVKIOt4mAqOzdt6K3qInj1431542432",
      "member_id": 958,
      "created_on": "2015-05-13 18:40:32",
      "last_modified": "2015-05-13 18:40:33"
    }

Les erreurs suivantes peuvent se produire dans les cas suivants :

1. Vous avez atteint l’une de ses quatre limites de chargement :

   • octets quotidiens,
   • octets horaires,
   • lignes quotidiennes, ou
   • lignes horaires

   Tentative de dépassement de la limite quotidienne de chargement d’octets

   {"response":{"status":"ERROR","error_code":"RATE_LIMIT_EXCEEDED","errors":["Member
                     exceeds maximum allowed bytes per day"]}}
   

   Tentative de dépassement de la limite de chargement d’octets horaire

   {"response":{"status":"ERROR","error_code":"RATE_LIMIT_EXCEEDED","errors":["Member
                     exceeds maximum allowed bytes per hour"]}}
   

   Tentative de dépassement de la limite de chargement de lignes quotidiennes

   {"response":{"status":"ERROR","error_code":"RATE_LIMIT_EXCEEDED","errors":["Member
                     exceeds maximum allowed number of lines per day"]}} 
   

   Tentative de dépassement de la limite de chargement de lignes horaires

   {"response":{"status":"ERROR","error_code":"RATE_LIMIT_EXCEEDED","errors":["Member
                     exceeds maximum allowed number of lines per hour"]}}
   

2. Vous avez annulé le chargement.

3. La phase de chargement dépasse 90 minutes. Dépassement de la durée maximale de chargement

   {"response":{"status":"ERROR","error_code":"RATE_LIMIT_EXCEEDED","errors":["Maximum
                     upload time exceeded"]}}
   

Erreurs de traitement possibles

Format non valide

Si la valeur du num_invalid_format champ est supérieure "0"à , case activée les valeurs du error_log_lines champ.

Dans l’exemple ci-dessous, le num_invalid_format champ affiche la valeur "1", avec les détails fournis dans le error_log_lines champ.

Dans le error_log_lines champ :

• num_invalid_format indique qu’un problème s’est produit lors de l’analyse d’une ligne dans le fichier chargé.
• "failed with an illegal number of fields" indique que le nombre de champs d’un segment_fields bloc ne correspond pas à ce qui a été défini dans la configuration du segment de lot (pour plus d’informations, consultez Configuration initiale du compte BSS).

Dans ce cas, la configuration s’attend à ce que trois champs soient définis dans le bloc : SEG_ID, VALUE, EXPIRATION, mais l’analyseur n’a trouvé que deux champs - SEG_ID et , affichant VALUEainsi une erreur.

num_invalid_format et error_log_lines exemple

"batch_segment_upload_job": {
phase": "completed",
"error_code": null,
"time_to_process": "0.01",
"percent_complete": 100,
"num_valid": 0,
"num_invalid_format": 1,
"num_valid_user": 0,
"num_invalid_user": 0,
"num_invalid_segment": 0,
"num_invalid_timestamp": 0,
"num_unauth_segment": 0,
"num_past_expiration": 0,
"num_inactive_segment": 0,
"num_other_error": 0,
"error_log_lines": "num_invalid_format-WINDOWSADID-USER-ID;SEG_ID:VALUE~9 failed with an illegal number of fields",
"segment_log_lines": null,
"start_time": "2015-08-13 18:40:32",
"uploaded_time": "2015-08-13 18:42:32",
"validated_time": "2015-08-13 18:42:32",
"completed_time": "2015-08-13 18:42:33",
"id": 123412341234,
"job_id": "Pm3oCUf5CSVKIOt4mAqOzdt6K3qInj1431542432",
"member_id": 958,
"created_on": "2015-08-13 18:40:32",
"last_modified": "2015-08-13 18:42:33"
}

Afficher votre historique de chargement de fichiers

Pour afficher les métadonnées relatives à tous les chargements de fichiers de segments au cours des 30 derniers jours, effectuez un GET appel au service avec votre member_id spécifié dans la chaîne de requête. La réponse JSON inclut un tableau d’objets batch_segment_upload_job .

Pour plus d’informations sur les champs spécifiques de l’objet batch_segment_upload_job , consultez Champs JSON.

$ curl -b cookies 'https://api.appnexus.com/batch-segment?member_id=456'

{
   "response" : {
      "batch_segment_upload_job" : [
         {
           "phase": "completed",
            "start_time": "2012-05-22 16:48:55",
            "uploaded_time": "2012-05-22 16:48:56",
            "validated_time": "2012-05-22 16:49:01",
            "completed_time": "2012-05-22 16:49:01",
            "error_code": null,
            "time_to_process": "0.04",
            "percent_complete": 100,
            "num_valid": 0,
            "num_invalid_format": 0,
            "num_invalid_user": 2,
            "num_invalid_segment": 0,
            "num_unauth_segment": 1,
            "num_past_expiration": 0,
            "num_inactive_segment": 0,
            "num_other_error": 0,
            "error_log_lines": " \n\nnum_unauth_segment-4013681496264948522;5013:0,5014:1550\nnum_invalid_user-7652266028043224430;5848:0,5849:1440,5850:1440\nnum_invalid_user-8802117132500293405;5851:0,5847:-1",
            "id": 98,
            "job_id": "T1v98eIOlCZndeLGSXD0nrs57L8ES11337705335",
            "member_id": 456,
            "created_on": "2012-05-22 16:48:55",
            "last_modified": "2012-05-22 16:49:01"
         },
     ...
    }
  }
}

Champs JSON

Tâche de chargement de segment batch

Lorsque vous demandez la status de votre travail de traitement, le système retourne un batch_segment_upload_job objet (si vous êtes un fournisseur de données, il s’agit d’un tableau contenant un seul objet). Selon la demande que vous adressez au service, elle contient tout ou partie des métadonnées suivantes.

Voir aussi

• Format de fichier BSS hérité
• Meilleures pratiques pour le service de segment de lots