ドキュメントExperience Platformデータストリームガイド

データストリームのボット検出の設定

Last update: Wed Mar 25 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 開発者

自動化されたプログラム、web スクレイパー、クモ、スクリプトスキャナーなどからの人間ではないトラフィックは、人間の訪問者からのイベントを識別することを困難にする可能性があります。 この種類のトラフィックは、重要なビジネス指標に悪影響を与え、誤ったトラフィックレポートにつながる可能性があります。

ボット検出を使用すると、Web SDK、​ モバイル SDKおよびEdge Network APIによって生成されたイベントを、既知のクモやボットによって生成されたものとして識別できます。

データストリームのボット検出を設定することで、特定のIP アドレス、IP範囲、およびボットイベントとして分類するリクエストヘッダーを特定できます。 これにより、web サイトやモバイルアプリケーションにおける利用者のアクティビティをより正確に測定できるようになります。

Edge Networkへのリクエストがボット検出ルールのいずれかに一致すると、XDM スキーマは次に示すようにボットスコア（常に1に設定）で更新されます。

{
  "botDetection": {
    "score": 1
  }
}

このボットスコアリングは、リクエストを受け取ったソリューションがボットトラフィックを正しく識別するのに役立ちます。

IMPORTANT
ボット検出はボットリクエストをドロップしません。 ボットスコアリングを使用してXDM スキーマのみを更新し、設定した​ データストリームサービス ​にイベントを転送します。
Adobeのソリューションは、さまざまな方法でボットスコアリングに対応できます。 例えば、Adobe Analyticsは独自の​ ボットフィルタリングサービス ​を使用し、Edge Networkによって設定されたスコアは使用しません。 2つのサービスで同じIAB ボットリスト ​を使用しているため、ボットスコアリングは同じです。

技術的な考慮事項 technical-considerations

データストリームでボット検出を有効にする前に、正確な結果とスムーズな実装を確実にするために留意すべきいくつかの重要なポイントを次に示します。

  • ボット検出は、edge.adobedc.netに送信された未認証のリクエストにのみ適用されます。
  • server.adobedc.netに送信された認証済み要求は、認証済みトラフィックが信頼できると見なされるため、ボットトラフィックでは評価されません。
  • ボット検出ルールは、作成後にEdge Network全体に反映されるまでに最大15分かかる場合があります。

前提条件 prerequisites

ボット検出がデータストリームで機能するには、スキーマに​Bot Detection Information フィールドグループを追加する必要があります。 スキーマにフィールドグループを追加する方法については、XDM スキーマ ​のドキュメントを参照してください。

データストリームのボット検出の設定 configure

データストリーム設定を作成した後で、ボット検出を設定できます。 データストリームを作成および設定する方法に関するドキュメント ​を参照し、次の手順に従ってボット検出機能をデータストリームに追加します。

データストリーム リストに移動し、ボット検出を追加するデータストリームを選択します。

データストリームのリストを表示するデータストリームのユーザーインターフェイス。

データストリームの詳細ページで、右側のパネルの「Bot Detection」オプションを選択します。

データストリーム ユーザーインターフェイスでハイライト表示された ボット検出オプション。

Bot Detection Rules ページが表示されます。

データストリーム設定ページの ボット検出設定。

ボット検出ルール ページでは、次の機能を使用してボット検出を設定できます。

IAB/ABC International Spiders and Bots Listを使用する iab-list

IAB/ABC International Spiders and Bots Listは、業界標準のサードパーティのインターネットスパイダーとボットのリストです。 このリストは、検索エンジンのweb クローラー、モニタリングツール、分析数に含めたくない可能性のあるその他の人間ではないトラフィックなどの、自動化されたトラフィックを特定するのに役立ちます。

IAB/ABC International Spiders and Bots Listを使用するようにデータストリームを設定するには：

  1. Use IAB/ABC International Spiders and Bots List for bot detection on this datastream オプションを切り替えます。
  2. Save​を選択して、ボット検出設定をデータストリームに適用します。

IAB スパイダーとボット リストが有効になっています。

ボット検出ルールの作成 rules

IAB/ABC International Spiders and Bots Listを使用することに加えて、各データストリームに独自のボット検出ルールを定義できます。

IP アドレス​および​ IP アドレス範囲 ​に基づいてボット検出ルールを作成できます。

より詳細なボット検出ルールが必要な場合は、IP条件とリクエストヘッダー条件を組み合わせることができます。 ボット検出ルールでは、次のヘッダーを使用できます。

HTTP ヘッダー
説明
user-agent
サーバーとネットワークピアが、リクエスト側のユーザーエージェントのアプリケーション、オペレーティングシステム、ベンダー、および/またはバージョンを識別できるヘッダー。
content-type
リソースの元のメディアタイプを示します（送信用に適用されたコンテンツエンコーディングの前）。
referer
リソースが要求されたweb ページのアドレスを識別します。
sec-ch-ua
ブラウザーに関連付けられている各ブランドのブランドと重要なバージョンをコンマ区切りのリストで提供します。
sec-ch-ua-mobile
ブラウザーがモバイルデバイス上にあるかどうかを示します。 また、デスクトップブラウザーでモバイルユーザーエクスペリエンスの環境設定を示すために使用することもできます。
sec-ch-ua-platform
ユーザーエージェントが実行されているプラットフォームまたはオペレーティングシステムを提供します。 例えば、「Windows」または「Android」と入力します。
sec-ch-ua-platform-version
ユーザーエージェントが実行されているオペレーティングシステムのバージョンを提供します。
sec-ch-ua-arch
ARMやx86など、user-agentの基盤となるCPU アーキテクチャを提供します。
sec-ch-ua-model
ブラウザーが実行されているデバイスモデルを示します。
sec-ch-ua-bitness
ユーザーエージェントの基盤となるCPU アーキテクチャの「ビット数」を提供します。 これは、整数アドレスまたはメモリアドレスのビット単位のサイズ（通常は64または32 ビット）です。
sec-ch-ua-wow64
64 ビット Windowsでユーザーエージェントバイナリが32 ビットモードで実行されているかどうかを示します。

ボット検出ルールを作成するには、次の手順に従います。

  1. Add New Rule を選択します。

    新しいルールを追加ボタンが強調表示されたボット検出設定画面。

  2. ルールの名前を​Rule Name フィールドに入力します。

    ルール名が強調表示された ボット検出ルール画面。

  3. Add new IP condition​を選択して、新しいIP ベースのルールを追加します。 ルールは、IP アドレスまたはIP アドレス範囲で定義できます。

    IP アドレスフィールドがハイライト表示された ボット検出ルール画面。

    IP範囲フィールドがハイライト表示された ボット検出ルール画面。

    note tip
    TIP
    IP条件は、論理OR操作に基づいています。 定義したIP条件のいずれかと一致する場合、リクエストはボットからのリクエストとしてマークされます。

  4. ルールにヘッダー条件を追加する場合は、Add header conditions group​を選択し、ルールで使用するヘッダーを選択します。

    ヘッダー条件がハイライト表示された ボット検出ルール画面。

    次に、選択したヘッダーに使用する条件を追加します。

    ヘッダー条件がハイライト表示された ボット検出ルール画面。

  5. 目的のボット検出ルールを設定した後、Save​を選択して、データストリームにルールを適用します。

    ヘッダー条件がハイライト表示された ボット検出ルール画面。

ボット検出ルールの例 examples

ボット検出を開始するには、以下の例を使用してボット検出ルールを作成します。

1つのIP アドレスに基づくボット検出 one-ip

特定のIP アドレスから送信されたすべてのリクエストをボットトラフィックとしてマークするには、次の画像に示すように、単一のIP アドレスを評価する新しいボット検出ルールを作成します。

1つのIP アドレスに基づく ボット検出ルール。

2つのIP アドレスに基づくボット検出 two-ip

2つの特定のIP アドレスのいずれかから発生するすべてのリクエストをボットトラフィックとしてマークするには、次の画像に示すように、2つのIP アドレスを評価する新しいボット検出ルールを作成します。

2つのIP アドレスに基づくボット検出ルール。

IP アドレスの範囲に基づくボット検出 range

特定の範囲の任意のIP アドレスから発生するすべてのリクエストをボットトラフィックとしてマークするには、次の画像に示すように、IP アドレス範囲全体を評価する新しいボット検出ルールを作成します。

IP範囲に基づくボット検出ルール。

IP アドレスとリクエストヘッダーに基づくボット検出 ip-header

特定のIP アドレスから送信され、特定のリクエストヘッダーを含むすべてのリクエストをボットトラフィックとしてマークするには、次の画像に示すように、新しいボット検出ルールを作成します。

このルールは、リクエストが特定のIP アドレスから発生しているか、およびreferer リクエストヘッダーがwww.adobe.comで始まるかどうかをチェックします。

IP アドレスとリクエストヘッダーに基づくボット検出ルール。

複数の条件に基づくボット検出 multiple-conditions

以下に基づいてボット検出ルールを作成できます。

  • 複数の異なる条件：異なる条件が論理的なAND操作として評価されます。つまり、リクエストをボットから発信したものとして識別するには、条件を同時に満たす必要があります。
  • 同じタイプの複数の条件：同じタイプの条件は、論理的なOR操作として評価されます。つまり、いずれかの条件が満たされた場合、リクエストはボットから送信されたものとして識別されます。

以下の画像に示すルールは、次の条件が満たされた場合にボット発信要求を識別します。

リクエストは、2つのIP アドレスのいずれかから送信されます。referer ヘッダーはwww.adobe.comで始まり、sec-ch-ua-mobile ヘッダーは、リクエストがデスクトップブラウザーから送信されたものであると識別します。

複数の条件に基づくボット検出ルール。

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac