失敗するドメインスコア確認呼び出し：401、402、および空の行

診断の順序

ステータスコードから始めましょう。401はアイデンティティに関するもので、402は金銭に関するものです。これらは異なる箇所で解決されます。

次にokを確認します。すべてのレスポンスにはこれが含まれます。認証済み呼び出しでは、_creditsがコストと残高残高を示すため、402が発生する前に残高が枯渇していることが確認できます。

この順序をランブックに固定してください。データに飛びつく人は、ステータスコードが瞬時に特定するはずの問題に午前中を費やすことになります。

その後でデータに疑いを持ちましょう。新しいサイトはDRが低いことがよくあります。その原因はバグであることは稀で、リンクよりも前の月次スナップショットが原因である可能性が高いです。作業例付きのDR計算式で数値を比較してください。

主要な問題と残高の問題を分離する

401と402はスクリプトでは似て見えます。どちらも同じループを停止するためです。原因が異なるため、何か変更する前にこれらを区別してください。

同じドメインで無料のアクションから始めましょう。無料アクションが応答し、有料呼び出しが応答しない場合、ドメインは正常であり、問題はキーまたは残高にあります。

コピー後に401が発生した場合

末尾にスペースが含まれているキーや、途中で切れたキーは、401の一般的な原因です。キーはsk_で始まるため、このプレフィックスを確認し、アカウントページのコピーと文字列全体を比較してください。

キーを1か所だけ置き換え、同じ単一の呼び出しを再実行してください。複数の変更を同時に行うと、結果の解釈が困難になります。

チャージ後に402が発生した場合

402は、有料アクションにクレジットが残っていないことを意味します。他のことをする前に、次の認証済みレスポンスの_creditsで残高残高を確認してください。

その残高が正しいように見える場合、失敗した呼び出しのコストと比較してください。数値から、呼び出しが単に残高よりも大きいだけかどうかを確認できます。

チャージした時刻をメモしておき、後でログと残高を比較できるようにしてください。

各チャージ前後の残高の短いメモを残しておくと、次の402の解釈が容易になります。

エラーがないのにスコアが正しく見えない理由

すべてのフィールドが正常に取得された場合でも、数値が予想外になることがあります。レスポンスはスナップショットに対して正しいため、真の問題はそのスナップショットに何が含まれているかです。

これらのケースの大部分は、以下の3つの状況で説明できます。

新しく立ち上げたドメイン

最近立ち上げたサイトでは、スナップショットがリンクより前に作成されているため、DR 0が表示されることがあります。ここでの「ゼロ」はリンク先ドメインが見つからなかったことを意味し、サイト自体に対する評価ではありません。

サイトの評価として数値を読み取る前に、次の更新を待ってください。

アクションを起こす前に、ドメインの年齢と更新サイクルを比較してください。新しいドメインとリンクを獲得したことがない古いドメインは、同じスナップショットでは似通って見えます。

今月取得されたリンク

最新の更新後に追加されたリンクは、数値に反映されません。次の更新が行われるまで、再呼び出ししても同じ結果が返されます。

リンクの日付とスナップショットの日付を記録しておくと、レポートを読む人に対してそのギャップを簡単に説明できます。

消失したリンク

リンク先ページが削除された場合や、リンク元サイトが閉鎖された場合、リンクが消失することがあります。この場合、貴方側に変更がなくてもカウントは減少します。

エンドポイントを責める前に、数ヶ月前のスナップショットと比較してください。

合計値だけでなく、移動（変化）したドメインの数もカウントしてください。多くのサイトでの小さな損失は、単一のサイトからの大きな損失とは異なる印象を与えます。

自動リトライを行わない理由

402でループすると時間だけが消費され、何も得られません。401でループすると、弊社やGoogleなどのプロバイダで不正検知がトリガーされる可能性があります。

リトライはネットワークエラーに限定し、各リトライ間の待機時間を徐々に長くしてください。夜間ジョブの場合、3回が適切な上限です。

例えば、夜間ジョブが午前2時に402エラーに遭遇した場合、朝食まで5分ごとにリトライすると、約100回の同一失敗が発生し、それぞれが後で誰かが読む必要があるログ行になります。

ネットワークリトライにも固定の上限を設定し、各試行をログに記録してください。1文で説明できる上限であれば、ジョブが停止した際に説明しやすいです。

無人で実行されるジョブのアラート

夜間のチェックドメインスコアジョブは、停止した際に誰かに通知し、その理由も示すべきです。2つのコードは異なるアラートが必要なので、メッセージ内で区別してください。

最初の401でアラート

401は通常キーの問題を意味するため、単一の失敗でもメッセージを送る価値があります。100回の同一失敗を待つと、修正が遅れます。

アラートにはキー全体ではなく、キーの先頭と末尾の文字を含めてください。これにより、メッセージを同僚と共有しても安全です。

402は独自のメッセージを送る価値があります。その解決策はキーの変更ではなくチャージであるためです。

静かなジョブが必ずしも健全とは限りません。失敗した実行数だけでなく、完了した実行数をカウントし、1サイクル全体でどちらのカウントも動かない場合にアラートを出してください。

残高の減少でアラート

警告はゼロではなく、残りの実行をカバーできるレベルに設定してください。ジョブ開始時に残高がほぼ空の場合、リトライの余地がなくなります。

各認証済みレスポンスから_creditsの値を読み取り、警告に追加の要求が必要ないようにしてください。