サイトのSEO指標に独自のAhrefsキーを使用する

連携によって有効になる機能

ご自身の Ahrefs キーを連携すると、お客様のサイト用に取得するSEOデータが、弊社の Ahrefs アカウントではなくお客様の Ahrefs アカウントを使用して取得されるようになります。ダッシュボードには、お客様ご自身のサブスクリプションから抽出された同じ指標が表示されます。

事前準備

APIアクセスを含む Ahrefs のプラン、および Ahrefs ワークスペースの所有者または管理者権限が必要です — APIキーを作成できるのはこれらの権限を持つユーザーのみです。

1. Ahrefs でキーを作成する

Ahrefs でAccount settings（アカウント設定）→ API keys（APIキー）を開き、キーを作成します。各キーの有効期間は1年間で、その後は機能しなくなります。ページには各キーの有効期限が表示されます。また、同じページでキーが1ヶ月に使用できるAPIユニット数の上限を設定することもできます。

2. ここで連携する

ダッシュボードで連携を開き、アカウントを連携を選択します。グループとして独自のSEOデータを、アカウントとして Ahrefs を選択し、APIキーを入力してアカウントを連携を押します。

入力された内容は保存前にテストされます。動作しないキーが保存されることはなく、エラー応答に問題の原因が表示されます。正常に動作するキーは、弊社のデータベースではなく、暗号化されたシークレット保管庫に保持され、お客様に対しても二度と表示されません。

次のステップ

• お客様のサイトに対して実行されるオーソリティおよびバックリンクのチェックは、お客様のキーとプランのクォータ（割り当て）を使用し、弊社のキーの使用を停止します。お客様のキーで実行されるチェックに対して、弊社が料金を請求することはありません。
• お客様のキーが失効した場合やクォータを使い果たした場合は、静かに弊社のアカウントに戻すのではなく、指標が表示される画面上で処理を停止してお知らせします。ベンダー側でキーを修正するか、連携を解除してプランに含まれる標準状態に戻してください。
• チェックは通常のスケジュールで実行されます。キーを連携しても、クォータに対して大量の呼び出しが一時的に発生することはありません。

連携できない場合

1年後に動作しなくなった場合。 Ahrefs のキーは12ヶ月で有効期限が切れます。新しいキーを作成して連携してください。

制限メッセージが表示されてチェックが停止する場合。 キーの月間APIユニット上限、またはご利用プランの割り当てを使い果たしています。Account settings（アカウント設定）→ API keys（APIキー）で上限を引き上げるか、更新をお待ちください。

キーが拒否されたと表示される場合。 ほとんどの場合、次の3つのいずれかが原因です：スペースや改行が一緒にコピーされた、キーの有効期限が切れている、またはコピー後にキーが失効・再生成された。新しいキーを作成し、再度貼り付けてください。

連携はできるが、その後の処理が失敗する場合。 キーの認証は成功していますが、アクションに必要な権限が不足しています。上記の権限を持つ新しいキーを作成し、古い連携を解除してから新しいキーを連携してください。

連携解除

連携を開き、該当のアカウントを見つけて連携解除を押します。これにより、保存されているキーが即座に削除されます。そのキーを使用していた処理は次のアクションで停止し、依存していた画面にはサイレントエラーになることなくその旨が表示されます。

連携解除を行っても、すでに実行された処理（記録、デプロイ、またはお客様のアカウントで変更された設定）が元に戻ることはありません。キー自体が漏洩した可能性がある場合は、ベンダー側でも失効手続きを行ってください。連携解除によって削除されるのは弊社のコピーであり、ベンダー側のキーではありません。