デジタル プラットフォーム API - BSS アップロードのトラブルシューティング

このトピックの方法を使用して、セグメント データのアップロードに関する問題を診断できます。

バッチ セグメント サービスのさまざまなフェーズ

このセクションではアップロードのフェーズについて説明するので、問題が発生している可能性のある場所を理解できます。

開始 - アップロード URL とジョブ ID の要求

このフェーズでは、クライアントはアップロード URL とジョブ ID を要求します。 このステージは 5 分でタイムアウトします。 このフェーズでジョブが停止している場合は、クライアントが URL を要求したが、割り当てられた時間内に何もアップロードできなかったことを示します。

アップロード

このフェーズでは、クライアントは指定された URL にファイルをアップロードします。 1 分あたりアップロードが 1 回を超えないようにすることをお勧めします。 クライアントに 200 を超えるジョブが待機しているときに任意の時点で処理された場合、追加のジョブのアップロードは禁止されます。

検証と処理

クライアントがファイルをアップロードすると、次のフェーズでファイルの処理が行われ、セグメント ID とユーザー ID の検証が実行されます。レコードに無効なセグメント ID またはユーザー ID が含まれている場合、プラットフォームはレコードを処理しません。 クライアントがジョブ ステータスをチェックすると、無効なユーザーの数に関する統計情報を表示できます。

完了

このフェーズでは、ファイルのデータがプラットフォームに正常にアップロードされ、ターゲットに使用できるようになります。

考えられるアップロード エラー

0.5 GB を超えるファイルをアップロードしようとしています

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

バッチ セグメント アップロード ジョブのエラー コード

""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"
    }

次のエラーは、次の場合に発生する可能性があります。

1. 4 つのアップロード制限のうちの 1 つに達しました。

   • 毎日のバイト数、
   • 時間単位のバイト、
   • 毎日の行、または
   • 時間単位の明細行

   1 日のバイト アップロード制限を超えようとする

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

   1 時間あたりのバイト アップロード制限を超えようとしています

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

   1 日あたりの行のアップロード制限を超えようとする

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

   時間単位の行のアップロード制限を超えようとする

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

2. アップロードをキャンセルしました。

3. アップロード フェーズが 90 分を超えています。 アップロードに最大時間を超過する

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

考えられる処理エラー

無効な形式

num_invalid_format フィールドの値が "0" より大きい場合は、[error_log_lines] フィールドの値をチェックします。

次の例では、[ num_invalid_format ] フィールドに "1" の値が表示され、詳細が [ error_log_lines ] フィールドに表示されます。

[ error_log_lines ] フィールドで、次の操作を行います。

• num_invalid_format アップロードされたファイルの行の解析に問題があることを示します。
• "failed with an illegal number of fields" segment_fields ブロック内のフィールドの数が、バッチ セグメント構成で定義されたものと一致しなかったことを示します (詳細については、「BSS アカウントの初期設定」を参照してください)。

この場合、構成では SEG_ID、 VALUE、 EXPIRATION の 3 つのフィールドがブロックで定義されることを想定していますが、パーサーは SEG_ID と VALUE の 2 つのフィールドしか見つからなかったため、エラーが表示されます。

num_invalid_format および error_log_lines 例

"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"
}

ファイルのアップロード履歴を表示する

過去 30 日間にアップロードされたすべてのセグメント ファイルに関するメタデータを表示するには、クエリ文字列に指定したmember_idを使用してサービスをGET呼び出します。 JSON 応答には、 batch_segment_upload_job オブジェクトの配列が含まれます。

batch_segment_upload_job オブジェクトの特定のフィールドの詳細については、「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"
         },
     ...
    }
  }
}

JSON フィールド

セグメントのバッチ アップロード ジョブ

処理ジョブのステータスを要求すると、システムは batch_segment_upload_job オブジェクトを返します (データ プロバイダの場合、これは 1 つのオブジェクトを含む配列です)。 サービスに対して行う要求に応じて、次のメタデータの一部またはすべてが含まれます。

関連トピック

• 従来の BSS ファイル形式
• バッチ セグメント サービスのベスト プラクティス