Upload Bot rules | Import File Feature

[UjjwalChandra]

Hi Team,
I need to update the Bot Rules in my RSuite. The Documentation - Upload Bot Rule says to fill the .csv file with the headers as shown in yellow in the pic. My query is where will I find this information. Can someone help me with a stepwise process to update the Bot information. Thanks!

[Euros]

Hi @UjjwalChandra,

You don't need to fill in all the rows. All you need to do is 'Export Bot Rules', this will give you a blank template that you can use (if you already have Bot rules created they may be shown here). Simply add in the IP addresses you want excluded (or a range), then save it as a CSV, then upload it again. Make sure to either tick 'overwrite existing rules' if you have added to existing, or leave it unticked if you are uploading only the new values. The only cells that need filling in are the begin & end IP address cells, the others are optional. 

[pradnya_balvir]

Hi @UjjwalChandra ,

• You must have Admin access to Adobe Analytics

• You must know which Report Suite(s) to update

• Bot rules are case-sensitive and need accurate input

Go to Bot Rules in Admin Console

1. Log in to Adobe Analytics: https://experience.adobe.com

2. Go to Admin > Report Suites

3. Select your report suite

4. Navigate to General > Bot Rules

5. Click on “Import File”

Download a Sample Export (Best Practice)

Before creating your own .csv, do this:

• Click on "Export File"

• This gives you a CSV in the exact format Adobe expects

• It includes column headers like:

    IP, UserAgent, ISP, IAB, Description

Fill Your CSV with Bot Rules

IP,UserAgent,ISP,IAB,Description
66.249.66.1,Googlebot,,FALSE,Googlebot (manual)
,Slackbot,,FALSE,Slack Crawler
,,TestISP Inc.,FALSE,Internal traffic via TestISP

Don't use quotes around values unless the field contains commas.

Upload the File

1. Return to Admin > Report Suite > Bot Rules

2. Click Import File

3. Select your .csv file and upload

4. Review the preview to confirm formatting

5. Click Save

Validate the Rules

• After saving, you'll see the updated list

• Click "Download File" again to confirm if rules were correctly applied

• Wait for a day to validate if bot traffic is excluded properly

I hope this help you.

Thanks.

Pradnya

[Vinay_Chauhan · Accepted solution]

Hi @UjjwalChandra 

Yep, you’re on the right track, updating Bot Rules through the CSV is actually pretty straightforward once you’ve done it once.

Here’s a quick step-by-step to make it easier:

1. Go to Admin > Report Suites in Adobe Analytics and select your report suite.

2. Navigate to General > Bot Rules.

3. Click “Export File” — this gives you the exact CSV format Adobe expects (with sample headers like IP, UserAgent, ISP, etc.).

4. Use that as your template — just fill in the values you need (you don’t need to populate every column unless required).

5. Save the file and go back to “Import File”.

6. Upload your updated CSV and choose whether to overwrite existing rules or add new ones.

7. Save and download again to confirm the upload worked.

Give it about 24 hours and then check if your updated bot traffic is getting filtered out as expected.

Let me know if you run into any snags — happy to help!

[UjjwalChandra]

Hi @Vinay_Chauhan ,
Thank You for the reply. I still have a doubt in Point No. 4.
How do I fill in the values and from where can I get the values of -
IP, User Agents, ISP, Description etc.

Is it from the Bot Report in Adobe Analytics or anywhere in the internet if its available?
Thanks!

[AkankshaBh]

Hi Ujjwal,

Here's a clarification on where you can get the values to fill in the Bot Rule CSV (like IP, User Agent, ISP, and Description):

• Bot Reports in Adobe Analytics show data that is already being excluded by existing bot rules. So they won’t help in identifying new bot traffic.

• If you suspect certain traffic in your report suite might be bot-related, the best approach is to analyze the data and identify patterns—such as unusual frequency, repeated user agents, or specific pages being hit. You can refer to the documentation on Common Bot Signatures for guidance.

• Once you observe a suspicious pattern, try to isolate it by creating a segment in Workspace and apply it to your data. Then, extract the data using Data Warehouse, which includes the IP dimension (unlike Workspace).

• Additionally, Data Feeds also provide raw data where you can extract IP addresses and User Agent strings directly for deeper analysis.

These two tools—Data Warehouse and Data Feeds—are your best options for identifying bot signatures and collecting the required values to populate the bot rule CSV.

Let me know if you need further help here!

[UjjwalChandra]

Thank You @AkankshaBh @pradnya_balvir, @Vinay_Chauhan & @Euros for detailed answers.