> For the complete documentation index, see [llms.txt](https://docs.adsecure.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adsecure.com/features/custom-referrer.md).

# Set a Custom Referrer

## What is a referring domain?

A referring domain is the website that directs users to your web page with a backlink or hyperlink. In other words, the referring domain is where the user was before landing on your site. Referring domains are considered important in SEO as they help the website owners identify the sources of their web traffic, for either promotional or statistical purposes.

![referringdomain](https://1597915041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPFKZe65DxLiZWt9eUQJw%2Fuploads%2FkCaiCK4K64IAuCqBs7Ll%2Fcustom-referrer-img1.png?alt=media)

## Why use a Custom Referrer?

Setting a custom Referrer is a very practical and functional feature for publishers and website owners who want to scan the websites that are exposed to the users directed from specific webpages or sources. The reason behind it is that sometimes the publisher’s partners use a list of referring domains to set custom parameters for their advertising. When this happens, with the help of the referrer feature, AdSecure users have the capacity to set an extra parameter - a custom referrer to their scans when creating analysis or projects, which makes it possible to scan the traffic sent from certain referring domains, instead of scanning only non-referrer traffic.

Another upside of the feature is that publishers or marketers can perform A/B testing together with the website scanning. It provides a scientific method for analysing the campaign conversion performance as well as insights on the quality of the ad content exposed to the users coming from both referrer traffic and non-referrer traffic.

## How does it work?

* You can enable the Referrer feature on a quick analysis or projects.

When creating the quick analysis or project in the application, you will see the option to input the referrer URL in the quick view. If you wish AdSecure to scan and analyse all ads found on the page, don't forget to enable the Ad Discovery feature.

![analysisreferrer](https://1597915041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPFKZe65DxLiZWt9eUQJw%2Fuploads%2Fip4BdsLhtiEDfCFecnjR%2Fcustom-referrer-img2.png?alt=media)

* The referrer feature can also be applied to any API analysis.

**Query**

```bash
mutation {
  createAnalysis(input: {
    content: "https://examples.adsecure.com/simple",
    referer: "https://www.refererURL.com"
  }) {
    id
  }
}
```

When analysis is done, you will be able to see the referrer URL in the report details.

![reportreferrer](https://1597915041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPFKZe65DxLiZWt9eUQJw%2Fuploads%2Fg79pwjsjnq1XPL9cs043%2Fcustom-referrer-img3.png?alt=media)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adsecure.com/features/custom-referrer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.