Bidders - BSS アップロードのトラブルシューティング

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

Batch Segment Service のさまざまなフェーズ

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

開始 - アップロード 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 日あたりのバイト アップロード制限を超えようとしている

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

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

   {"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 ファイル形式
• Batch Segment Service のベスト プラクティス