Cloud Service コンテンツリクエストについて

はじめに introduction

コンテンツリクエストには、AEM Sites に送信されるリクエストが含まれます。 これらのリクエストは、Edge Delivery Services またはコンテンツ配信ネットワーク（CDN）などの顧客提供のキャッシュシステムを通じてルーティングされる場合があります。 これらのリクエストは、構造化データを HTML 形式または JSON 形式で配信し、ページビュー（ページやエクスペリエンスフラグメントなど）または JSON 戻り値をヘッドレス方式で API を通じてサポートします。

ユーザーが HTML または JSON を使用してページを表示すると、コンテンツリクエストがカウントされます。 最初のキャッシュシステムがリクエストを受信した時点でこのリクエストを測定します。 コンテンツリクエストをカウントする目的で、特定の HTTP リクエストが含められたり除外されたりします。 HTTP の含まれるコンテンツリクエストと除外されるコンテンツリクエストの完全なリストを参照してください。

Cloud Service コンテンツリクエストについて understanding-cloud-service-content-requests

ページリクエスト​とは、メインページエクスペリエンスをレンダリングするのに必要なコア構造化コンテンツ（HTML や JSON など）を取得する HTTP リクエストを指します。 画像やスクリプトなどのアセットのリクエストは含まれません。

標準の CDN を使用しているお客様の場合、AEM as a Cloud Service では、サーバーサイドレベルで測定されたコンテンツリクエストがカウントされます。 この測定は自動的に行われ、クライアントサイドの分析トラッキングに依存しません。

AEM（Adobe Experience Manager）as a Cloud Service は、AEM インスタンスによって生成され、CDN で受信された応答タイプに基づいてコンテンツリクエストを識別します。 特に、HTML（text/html）または JSON（application/json）を返すリクエストがカウントされます。 これらの形式は通常、従来のサイトレンダリングまたはヘッドレス配信のいずれかでプライマリページコンテンツを配信します。

JavaScript ファイル、CSS スタイルシート、画像などの静的アセットのリクエストは、コンテンツリクエストとしてカウントされません。

コンテンツリクエストは、応答が CDN キャッシュから提供されたか、元の AEM 環境に転送されたかに関係なく測定されます。

Cloud Service コンテンツリクエストの相違 content-requests-variances

コンテンツリクエストは、次の表にまとめられているように、組織の分析レポートツール内で差異が生じる場合があります。 一般に、サイトのコンテンツリクエスト数のレポートにクライアントサイドのインストルメンテーションに依存する分析ツールを使用しないでください。 これらのツールは、アクティブ化するユーザーの同意に依存しているため、多くの場合、トラフィックの大部分が見逃されることがあります。 AEM as a Cloud Service の上に独自の CDN を追加するお客様向けに、ログファイルのサーバーサイドでデータを収集する Analytics ツール、または CDN レポートを使用すると、精度が向上します。

ライセンス制限に対するコンテンツリクエストの使用状況の表示とトラッキングについて詳しくは、ライセンスダッシュボードを参照してください。

サーバーサイドのコレクションルール serverside-collection

AEM as a Cloud Serviceでは、コンテンツリクエストのカウントにサーバーサイドのコレクションルールを適用します。 これらのルールでは、AIやLLMのweb クローラーが認識されるなどの既知のボット（検索エンジンweb クローラーなど）や、サイトに定期的にpingを送信する一連のモニタリングサービスは除外されます。 この除外リストに含まれていないその他の合成、自動、または監視タイプのトラフィックは、請求可能なコンテンツリクエストとしてカウントされます。

次の表に、含まれるコンテンツリクエストと除外されるコンテンツリクエストのタイプと、それぞれの簡単な説明を示します。

含まれるコンテンツリクエストのタイプ included-content-requests

ライセンスダッシュボードも参照してください。

除外されたコンテンツリクエストのタイプ excluded-content-request

コンテンツリクエストの管理 managing-content-requests

上記のセクション Cloud Service コンテンツリクエストの分散で説明したように、コンテンツリクエストは、多くの理由により予想よりも高くなる可能性があります。一般的なスレッドはCDNにトラフィックが達している可能性があります。 AEMのお客様にとって、ライセンスの予算内に収まるようにコンテンツリクエストを監視および管理することは有益です。 コンテンツ要求の管理は、通常、実装技術と​ トラフィックフィルタールール ​を組み合わせて行います。

コンテンツリクエストを管理するための実装手法 implementation-techniques-to-manage-crs

コンテンツリクエストを管理するためのトラフィックフィルタールール traffic-filter-rules-to-manage-crs

コンテンツリクエストをより適切に制御するには、フィルタールールを定義する前にCDN トラフィックを分析します。 CDN ログ分析ツール ​を使用すると、CDNのパフォーマンスとリクエスト パターンに関するインサイトを得ることができます。 まず、トラフィックの送信元と、予期しないシグナリングパターンが存在するかどうかを確認します（一般的なボットパターンは、空のユーザーエージェントを使用することです）。

監視およびログに記録する項目：

リクエスト変換を使用して、リクエストログにプロパティを追加し、CDN ログとダッシュボードに表示できます。 例えば、分析のためにボット名とクライアントネットワーク（AS名）をログに記録するには、次の手順を実行します。

requestTransformations:
  rules:
    - name: log-on-request
      when: "*"
      actions:
        - type: set
          logProperty: bot_name
          value: { reqProperty: botName }
        - type: set
          logProperty: cli_network
          value: { reqProperty: clientAsName }

不要なトラフィック（国、ネットワーク、ボット、またはその他のシグナル）を特定したら、トラフィックフィルタールールでブロックできます。 クライアントの国、ネットワーク、またはボット名でブロックするルールの例：

trafficFilters:
  rules:
    - name: block-bad-client-traffic
      when:
        anyOf:
          - { reqProperty: clientCountry, equals: "XX" }
          - { reqProperty: clientAsName, equals: "UnwantedClientNetwork" }
          - { reqProperty: botName, equals: "UnwantedBot" }
          - { reqHeader: user-agent, exists: false }
          - { reqHeader: user-agent, equals: '' }
      action: block

サンプル値を、ブロックする国コード、ネットワークまたはボット名に置き換えます。 その他のオプションについては、​ トラフィックフィルタールールの構文および条件構造を参照してください。