Skip to content

Commit c14f466

Browse files
OxyjunCameronWhitesideMaddy-Cloudflare
authored andcommitted
[AI Audit] Minor docs enhancements (#23968)
* Initialising first round of edits * Implementing more feedback * Fixing broken link * Apply suggestions from code review Co-authored-by: Cameron Whiteside <[email protected]> * Update src/content/docs/ai-audit/features/manage-ai-crawlers.mdx Co-authored-by: Maddy <[email protected]> --------- Co-authored-by: Cameron Whiteside <[email protected]> Co-authored-by: Maddy <[email protected]>
1 parent 1b45b60 commit c14f466

File tree

8 files changed

+115
-51
lines changed

8 files changed

+115
-51
lines changed

public/__redirects

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,7 @@
143143
# ai-audit
144144
/ai-audit/features/detect-ai-crawlers/ /ai-audit/features/analyze-ai-crawlers/ 301
145145
/ai-audit/features/enforce-robots-txt/ /ai-audit/features/analyze-ai-crawlers/ 301
146+
/ai-audit/features/analyze-ai-crawlers/ /ai-audit/features/analyze-ai-traffic/ 301
146147

147148
# AI Gateway
148149
/ai-gateway/get-started/configuring-settings/ /ai-gateway/get-started/ 301

src/content/changelog/ai-audit/2025-07-01-refresh.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,4 +16,4 @@ We redesigned the AI Audit dashboard to provide more intuitive and granular cont
1616
To get started, explore:
1717

1818
- [Manage AI crawlers](/ai-audit/features/manage-ai-crawlers/).
19-
- [Analyze AI crawlers](/ai-audit/features/analyze-ai-crawlers/).
19+
- [Analyze AI traffic](/ai-audit/features/analyze-ai-traffic/).

src/content/docs/ai-audit/features/analyze-ai-crawlers.mdx renamed to src/content/docs/ai-audit/features/analyze-ai-traffic.mdx

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: Analyze AI crawlers
2+
title: Analyze AI traffic
33
pcx_content_type: concept
44
sidebar:
5-
order: 5
5+
order: 2
66
---
77

88
import { Steps, Tabs, TabItem } from "~/components";
@@ -13,22 +13,33 @@ To view AI Audit metrics:
1313

1414
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
1515
2. Go to **AI Audit**.
16-
3. Go to the **Metrics** tab.
16+
17+
You can find meaningful information across both **AI Crawlers** and **Metrics** tabs.
18+
19+
## View AI crawler activity
20+
21+
The **AI Crawlers** tab provides you with the following information:
22+
23+
- Complete list of detected AI crawlers and their operators
24+
- Number of requests made by each AI crawler
25+
- Number of `robots.txt` violations for each crawler
1726

1827
## View AI Audit metrics
1928

20-
AI Audit provides you with the following metrics to help you understand how AI crawlers are interacting with your website.
29+
The **Metrics** tab provides you with the following metrics to help you understand how AI crawlers are interacting with your website.
2130

2231
| Metric | Description |
2332
| ------------------------------------- | ----------------------------------------------------------------------------- |
2433
| Total requests | The total number of requests to crawl your website, from all AI crawlers |
2534
| Blocked requests | The number of requests you have blocked (by blocking AI crawlers) |
2635
| Allowed requests | The number of requests you have allowed (by allowing AI crawlers) |
27-
| Request by AI crawlers | A graph which displays the number of crawl requests from each AI crawler |
28-
| Most popular paths by AI crawlers | The most popular pages crawled by AI crawlers, for each AI crawler |
2936
| Hosts | The owner of the AI crawler |
3037
| Overall popular paths | The most popular pages crawled by AI crawlers, from all AI crawlers |
3138
| Most active AI crawlers by operators | The AI crawler owners with the highest number of requests to access your site |
39+
| Request by AI crawlers | A graph which displays the number of crawl requests from each AI crawler |
40+
| Most popular paths by AI crawlers | The most popular pages crawled by AI crawlers, for each AI crawler |
41+
| Referrals | A graph which displays the number of referrals from each AI operator |
42+
| Referers | The list of referers who directed traffic to your site |
3243

3344
:::note[Requests in AI Audit metrics]
3445
The number of requests in AI Audit metrics are specifically requests which were met with HTTP code 200 (the request was successfully served, with actual content).

src/content/docs/ai-audit/features/manage-ai-crawlers.mdx

Lines changed: 32 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Manage AI crawlers
33
pcx_content_type: concept
44
sidebar:
5-
order: 2
5+
order: 5
66
---
77

88
import { Steps, GlossaryTooltip, Tabs, TabItem, Example } from "~/components";
@@ -15,7 +15,7 @@ To manage AI crawlers:
1515
2. Go to **AI Audit**.
1616
3. Go to the **AI Crawlers** tab.
1717

18-
## View the list of AI crawlers
18+
## Review AI crawler activity
1919

2020
The **AI Crawlers** tab displays a table of AI crawlers that are requesting access to your content, and how they interact with your pages. The table provides the following information.
2121

@@ -47,6 +47,16 @@ On the free plan, AI Audit identifies AI crawlers based on their [user agent str
4747
Upgrade your plan to enable a more thorough detection using Cloudflare's [Bot Management detection ID](/bots/reference/bot-management-variables/#ruleset-engine-fields) field.
4848
:::
4949

50+
### Filter AI crawler data
51+
52+
You can use filters to narrow the scope of your result:
53+
54+
- **Name:** Search the name of the AI crawler.
55+
- **Operator:** Filter by the AI crawler operator.
56+
- **Category:** Filter by the category of the AI crawler (for example, AI crawler, AI assistant, or archiver).
57+
58+
The values of the table will update according to your filter.
59+
5060
## Take action for each AI crawler
5161

5262
<Tabs>
@@ -64,31 +74,30 @@ For each AI crawler, you can take one of three actions: allow, charge, or block.
6474

6575
<Example title="Allow access">
6676

67-
You can allow an AI crawler to scrape your content.
68-
69-
From the **Actions** column, select **Allow**.
70-
77+
- **Summary:** You can allow an AI crawler to scrape your content.
78+
- **When to use:** Allow AI crawlers that offer services which provide value through citations, referrals, or existing agreements.
79+
- **Implementation:** From the **Actions** column, select **Allow**.
7180
Note that you can still choose to [Enforce `robots.txt`](/ai-audit/features/manage-ai-crawlers/#take-action-for-each-ai-crawler).
7281

7382
For more details on how this rule interacts with other Cloudflare settings, refer to [How it works](/bots/concepts/bot/#how-it-works).
7483

7584
</Example>
7685

77-
<Example title="Charge for crawl (Enterprise only)">
78-
79-
You can charge the owner of the AI crawler for each crawl request.
80-
81-
From the **Actions** column, select **Charge**.
82-
83-
For more information, refer to [What is Pay Per Crawl?](/ai-audit/features/pay-per-crawl/what-is-pay-per-crawl/).
86+
<Example title="Block access">
8487

88+
- **Summary:** You can block an AI crawler to completely stop the AI crawler from scraping your webpage.
89+
- **When to use:** Block AI crawlers when their behavior do not align with your content strategy, or violate your policies.
90+
- **Implementation:** From the **Actions** column, select **Block**.
8591
</Example>
8692

87-
<Example title="Block access">
93+
<Example title="Charge for crawl (private beta)">
8894

89-
You can block an AI crawler to completely stop the AI crawler from scraping your webpage.
95+
- **Summary:** You can charge the owner of the AI crawler for each crawl request.
96+
- **When to use:** Charge AI crawlers when your content has training value, and you want to explore monetization options
97+
- **Implementation:** From the **Actions** column, select **Charge**.
98+
99+
For more information, refer to [What is Pay Per Crawl?](/ai-audit/features/pay-per-crawl/what-is-pay-per-crawl/).
90100

91-
From the **Actions** column, select **Block**.
92101
</Example>
93102

94103
</TabItem>
@@ -98,31 +107,21 @@ For each AI crawler, you can choose to allow or block access.
98107

99108
<Example title="Allow access">
100109

101-
You can allow an AI crawler to scrape your content. Note that you can still choose to [Enforce `robots.txt`](/ai-audit/features/manage-ai-crawlers/#take-action-for-each-ai-crawler).
102-
103-
For more details on how this rule interacts with other Cloudflare settings, refer to [How it works](/bots/concepts/bot/#how-it-works).
104-
110+
- **Summary:** You can allow an AI crawler to scrape your content.
111+
- **When to use:** Allow AI crawlers that offer services which provide value through citations, referrals, or existing agreements.
112+
- **Implementation:** From the **Actions** column, select **Allow**.
113+
Note that you can still choose to [Enforce `robots.txt`](/ai-audit/features/manage-ai-crawlers/#take-action-for-each-ai-crawler).
105114
</Example>
106115

107116
<Example title="Block access">
108-
You can block an AI crawler to completely stop the AI crawler from scraping your webpage.
109-
110-
Use the toggles in the **Block** column to block specific AI crawlers from accessing your content.
117+
- **Summary:** You can block an AI crawler to completely stop the AI crawler from scraping your webpage.
118+
- **When to use:** Block AI crawlers when their behavior do not align with your content strategy, or violate your policies.
119+
- **Implementation:** From the **Actions** column, select **Block**.
111120
</Example>
112121

113122
</TabItem>
114123
</Tabs>
115124

116-
## Filter AI crawler data
117-
118-
You can use filters to narrow the scope of your result.
119-
120-
- **Name:** Search the name of the AI crawler.
121-
- **Operator:** Filter by the AI crawler operator.
122-
- **Category:** Filter by the category of the AI crawler (for example, AI crawler, AI assistant, or archiver).
123-
124-
The values of the table will update according to your filter.
125-
126125
## Related resources
127126

128127
- Use [pay per crawl](/ai-audit/features/pay-per-crawl/what-is-pay-per-crawl/) to charge AI crawlers every time they access your content.

src/content/docs/ai-audit/features/pay-per-crawl/use-pay-per-crawl-as-site-owner/monitor-metrics.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Once you have confirmed the selection of AI crawlers to charge, monitor key metr
2121
{/* prettier-ignore */}
2222
<Steps>
2323
1. Go to the **Metrics** tab.
24-
2. [View AI Audit metrics](/ai-audit/features/analyze-ai-crawlers/#view-ai-audit-metrics). Understanding these metrics can help you better manage AI crawlers accessing your content.
24+
2. [View AI Audit metrics](/ai-audit/features/analyze-ai-traffic/#view-ai-audit-metrics). Understanding these metrics can help you better manage AI crawlers accessing your content.
2525
</Steps>
2626

2727
## Other considerations

src/content/docs/ai-audit/get-started.mdx

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ This guide instructs you on how to:
2727
## 1. Block specific AI crawlers
2828

2929
<Tabs syncKey="plans">
30-
<TabItem label="Free plan">
30+
<TabItem label="All plans">
3131

3232
To only block specific AI crawlers:
3333

@@ -83,6 +83,16 @@ Review the AI crawlers detected on your site.
8383

8484
Note that on free plans, the **Metrics** tab only displays metrics for the past 24 hours.
8585

86+
## Plan comparison
87+
88+
<Render file="plan-comparison" product="ai-audit" />
89+
90+
## Next steps
91+
92+
- [Manage AI crawlers](/ai-audit/features/manage-ai-crawlers/) with granular allow/block controls.
93+
- [Analyze AI traffic](/ai-audit/features/analyze-ai-traffic/) to understand crawler patterns and content popularity.
94+
- [Explore pay per crawl](/ai-audit/features/pay-per-crawl/what-is-pay-per-crawl/) to test content monetization options (private beta).
95+
8696
## Related resources
8797

8898
Refer to the following related resources:

src/content/docs/ai-audit/index.mdx

Lines changed: 42 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,27 +7,36 @@ sidebar:
77
head:
88
- tag: title
99
content: Overview
10-
description: AI Audit is a tool which allows you to analyze and control how third-party AI crawlers interact with your website.
10+
description: Monitor and control how AI services access your website content.
11+
1112
---
1213

13-
import { Description, Feature, FeatureTable, Plan, LinkButton, RelatedProduct } from "~/components";
14+
import { Description, Feature, FeatureTable, Plan, LinkButton, RelatedProduct, Card } from "~/components";
15+
16+
<Plan type="all" />
1417

1518
<Description>
1619

17-
Analyze and control how third-party AI crawlers access and interact with your website.
20+
Monitor and control how AI services access your website content.
1821

1922
</Description>
2023

21-
<Plan type="all" />
24+
AI companies are increasingly using web content to train their models and power AI applications. AI Audit gives you visibility into which AI services are accessing your content, and provides tools to manage access according to your preferences.
2225

23-
AI Audit helps manage AI crawlers on your website by providing visibility on which crawlers are accessing your pages, and allowing you to block unwanted crawlers.
26+
With AI Audit, you can:
2427

25-
<LinkButton href="/ai-audit/get-started/">Get started </LinkButton>
28+
- **See which AI services access your content** - Monitor the dashboard to see crawler activity and request patterns
29+
- **Control access with granular policies** - Set allow or block rules for individual crawlers
30+
- **Monitor robots.txt compliance** - Track which crawlers follow your directives and create enforcement rules
31+
- **Explore monetization options** - Set up pay per crawl pricing for content access [(private beta)](/ai-audit/features/pay-per-crawl/what-is-pay-per-crawl/)
32+
- **Deploy with zero configuration** - Works automatically on all Cloudflare plans
2633

2734
:::note[Beta phase]
2835
AI Audit is currently only available as a beta product.
2936
:::
3037

38+
<LinkButton href="/ai-audit/get-started/">Get started </LinkButton>
39+
3140
---
3241

3342
## Features
@@ -41,9 +50,9 @@ AI Audit is currently only available as a beta product.
4150
</Feature>
4251

4352
<Feature
44-
header="Analyze AI crawlers"
45-
href="/ai-audit/features/analyze-ai-crawlers/"
46-
cta="Analyze AI crawlers"
53+
header="Analyze AI traffic"
54+
href="/ai-audit/features/analyze-ai-traffic/"
55+
cta="Analyze AI traffic"
4756
>
4857
Gain insight into how AI crawlers are interacting with your pages.
4958
</Feature>
@@ -58,6 +67,22 @@ AI Audit is currently only available as a beta product.
5867

5968
---
6069

70+
## Use cases
71+
72+
<Card title="Publishers and content creators">
73+
Publishers and content creators can monitor which AI crawlers are accessing their articles and educational content. Set policies to allow beneficial crawlers while blocking others.
74+
</Card>
75+
76+
<Card title="E-commerce and business sites">
77+
E-commerce and business sites can identify AI crawler activity on product pages and business information. Control access to sensitive data like pricing and inventory.
78+
</Card>
79+
80+
<Card title="Documentation sites">
81+
Documentation sites can track how AI crawlers are accessing their technical documentation. Gain insight into how AI crawlers are engaging with your site.
82+
</Card>
83+
84+
---
85+
6186
## Related Products
6287

6388
<RelatedProduct
@@ -75,3 +100,11 @@ Identify and mitigate automated traffic to protect your domain from bad bots.
75100
>
76101
Get automatic protection from vulnerabilities and the flexibility to create custom rules.
77102
</RelatedProduct>
103+
104+
<RelatedProduct
105+
header="Analytics"
106+
href="/analytics/"
107+
product="analytics"
108+
>
109+
View and analyze traffic on your domain.
110+
</RelatedProduct>
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
{}
3+
4+
---
5+
6+
| All plans | Enterprise plans with Bot Management |
7+
| ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
8+
| AI crawler detection via [user agent strings](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/User-Agent) | Advanced AI crawler detection via [Bot Management detection ID](/bots/reference/bot-management-variables/#ruleset-engine-fields) |
9+
| Maximum 24-hour analytics window | Configurable analytics timeframes |
10+
| Allow/block controls | Allow/block controls, and the ability to charge AI crawlers using [pay per crawl](/ai-audit/features/pay-per-crawl/what-is-pay-per-crawl/) |

0 commit comments

Comments
 (0)