Content Identifier

Content Identifier is a capability provided by Tencent Cloud EdgeOne (EdgeOne) to label request data. With Content Identifier, you can configure a unique identifier for each request, enabling more detailed statistics, analysis, and monitoring of your business distribution content through metric analysis and billing usage statistics.
Note:
The Content Identifier feature is only available to the allowlist. If you need to use it, please Contact Us.

Feature Overview

EdgeOne configures content identifiers for requests that meet specific matching conditions through the Rule Engine. During the response, it identifies the request with the Content-Identifier header. Requests that meet this matching condition will be counted under the corresponding Content Identifier. In Metric Analysis and Billing Usage Statistics, data can be filtered and viewed through this Content Identifier.




Applicable scenario

1. Applicable for labeling and grouping requests that meet specific matching conditions for data analysis.
2. Applicable for labeling and grouping requests that meet specific matching conditions and querying billing usage statistics.

Best Practices

The following will introduce how to create and configure content identifiers for statistical analysis and usage queries in Metric Analysis and Billing Usage.

Sample Scenario

Assuming you have already integrated the acceleration domain www.example.com, you want all requests to www.example.com/image to be tagged by the content identifier and use this content identifier to filter, count, and analyze access requests.

Step One: Creating a Content Identifier

1. Log in to the EdgeOne Console, in the left menu bar, click Content Identifier to enter the content identifier list page.
2. On the content identifier list page, click Add Content Identifier.
3. To add a content identifier, you need to fill in the description and bind a package. Tags can be selected as needed. The configuration items are described as follows:
Configuration Item
Description
Description
Used to record the purpose of the content identifier, you can enter 1-128 characters.
Package
Only supports binding to purchased Enterprise Edition packages. If you currently do not have an Enterprise Edition package to bind, please complete the purchase through the process of adding a new site.
Note:
1. Content identifiers can be used to collect billing data, which is strongly associated with the package. Therefore, each content identifier needs to be bound to a package when created.
2. To use a content identifier in a site, ensure that the package bound to the site matches the package bound to the corresponding content identifier.
Tag
Optional parameter for permission control and billing. You need to first go to the Tag Console to create the corresponding tags before you can pass in the corresponding tag key and tag value here.
4. After creation, EdgeOne automatically generates an ID for the content identifier for you. For example: eocontent-35jh1wm93khk




Step Two: Configuring a Content Identifier

1. Log in to the TencentCloud EdgeOne console, enter Service Overview in the left menu bar, and click the site to be configured under Website Security Acceleration.
2. On the site details page, click Site Acceleration to enter the global configuration page, then click the Rule Engine tab.
3. On the rule engine management page, click Create Rule and select Add Blank Rule.
4. On the rule editing page, set the matching conditions that trigger the rule to HOST = 'www.example.com' and URL Path = '/image'.
5. Click Operation > Selection Box, in the pop-up operation list, select the operation as Set Content Identifier, and choose the content identifier with the ID eocontent-35jh1wm93khk created in Step One.



Note:
The content identifier drop-down list only displays content identifiers bound to the current site package and does not support cross-package configuration of content identifiers.
6. Click on Save and Publish to complete the configuration of this rule.

Step Three: Analyzing Data Using a Content Identifier

If you currently need to view request access data of a specified type through a content identifier, you can refer to the following steps:
1. Log in EdgeOne console, in the left menu bar, click Indicator Analysis, to enter the Indicator Analysis page.
2. Click Add Filter, select the specified content identifier as the filter condition, and click OK to apply the filter.



Note:
1. Currently, only querying L7 access data by content identifier is supported.
2. Content identifier filter conditions and site filter conditions cannot be added simultaneously.
3. To add other filter conditions, refer to How to Use Filter Conditions to add other filter conditions such as status code, cache status, etc. To adjust the query time range, refer to How to Modify the Query Time Range.
4. Requests are counted under the site or content identifier based on a mutually exclusive logic. In the example scenario, requests to www.example.com/image can be queried under the filter condition "Content identifier is in eocontent-35jh1wm93khk", while requests to all other paths of www.example.com can be queried under the filter condition "Site is in example.com". They will not be counted twice.The site overview page only displays data belonging to the current site, and does not display data belonging to the content identifier.
5. If you want to directly query all request usage for the domain www.example.com in a scenario configured with a content identifier, you can set the filter condition to "Host is in www.example.com".

Step Four: Querying Billing Usage by Content Identifier

1. Log in to the TencentCloud EdgeOne console, click Billing Management > Billing Usage in the left sidebar to enter the Billing Usage page.
2. Click All Content Identifiers, select the specified content identifier as the filter condition, and click OK to apply the filter.



Note:
1. Currently, only the following billing usage data can be queried by content identifier: content acceleration traffic, intelligent acceleration traffic, L7 independent protection traffic, L7 Chinese mainland network optimization traffic, HTTP/HTTPS requests, intelligent acceleration requests, QUIC requests, Bot requests;
2. Content identifier filter conditions and site filter conditions cannot be added simultaneously.
3. Requests are counted under the site or content identifier based on a mutually exclusive logic. In the example scenario, requests to www.example.com/image can be queried under the filter condition "Content identifier is in eocontent-35jh1wm93khk", while requests to all other paths of www.example.com can be queried under the filter condition "Site is in example.com". They will not be counted twice.
4. If you want to directly query all request usage for the domain www.example.com in a scenario configured with a content identifier, you can set the filter condition to "Host is in www.example.com".

Related API Reference

Note:
When calling the API to query related usage by content identifier, please pass the content identifier (e.g., eocontent-35jh1wm93khk) into the ZoneId parameter for use.