Hosts
Organize your sites and pre-production environments for easy management and separated reporting in ÃÛ¶¹ÊÓƵ Target.
The primary goal of host management is to ensure that no inactive content accidentally appears on websites. Host management also lets you separate report data by environment.
A host is any domain from which a Target request is made. On a website, it is usually the location.hostname property of the URL making the Target request.
By default, Target does not limit a host that can make Target requests and receive Target responses. When new hosts make requests, they automatically work. This process also enables testing on different domains you don’t know or can’t anticipate. If you want to override this default behavior, you can set up an allowlist or blocklist to limit which hosts work with Target.
To manage hosts, click Administration > Hosts.
Recognizing hosts concept_0D4B43E23AA9408F8B28A57ED754BF65
To recognize a host and add it to the Hosts list, the following conditions must be met:
-
At least one Target request must exist on the host
-
A page on the host must have the following:
- An accurate at.js reference
- A Target request or an auto-generated global Target request
-
The page with the Target request must be viewed in a browser
After the page is viewed, the host is listed in the Hosts list, allowing you to manage it in an environment, and preview and launch activities and tests.
After a host is added to the Host list, make sure that the host is recognized.
-
Click Administration > Hosts.
-
If your host is not listed, refresh your browser.
By default, a newly recognized host is placed in the Production environment. The Production environment is the safest environment because it does not allow inactive activities to be viewed from these hosts.
-
(Conditional) Click the Move icon (
Sort or search the Hosts list section_068B23C9D8224EB78BC3B7C8580251B0
To sort the Hosts list, click any column header (Name, Environment, or Last Requested) to sort the list in ascending or descending order.
To search the Hosts list, type a search term in the Search Hosts box.
Create allowlists that specify hosts that are authorized to send Target requests to Target. allowlist
You can create an allowlist that specifies hosts (domains) that are authorized to send Target requests to Target. All other hosts generating requests get a commented-out authorization error response. By default, any host that contains a Target request registers with Target in the Production environment and has access to all active and approved activities. If this approach is not desired, you can instead use the allowlist to record specific hosts that are eligible to make Target requests and receive Target content. All hosts continue to display in the Hosts list, and environments can still be used to group these hosts and assign different levels to each, such as whether the host can see active and/or inactive activities.
To create an allowlist:
-
From the Hosts list, click Authorize Hosts.
-
Enable the Enable Authorized Hosts for content delivery toggle.
-
Add the desired hosts in the Host contains box, as desired.
Multiple hosts can be listed, each on its own line.
-
Add the desired hosts in the Host does not contains box, as desired.
Multiple hosts can be listed, each on its own line.
-
Click Save.
If a Target request is made on an unauthorized host, the call responds with /* no display - unauthorized mbox host */.
Sometimes domains from other sites appear in your environments. A domain appears in the list if the domain calls at.js. For example, if somebody copies one of your web pages to their server, that domain appears in your environment. You might also see domains from spider engines, language translator sites, or local disk drives.
In cases where mboxHost is passed in an API call, conversion is recorded for the environment that is passed in. If no environment is passed, the host in the call defaults to Production.
You can also create a denylist that specifies hosts (domains) that cannot send Target requests to Target by adding the desired hosts in the Host Does Not Contain box.
Delete a host section_F56355BA4BC54B078A1A8179BC954632
You can delete a host when it is no longer needed.
- From the Hosts list, click the Delete icon.
- Click Delete to confirm the deletion.
Troubleshooting hosts concept_B3D7583FA4BB480382CC7453529FE1B7
Try the following troubleshooting tips if you experience problems with your hosts:
Host does not appear in the list for your account.
- Refresh the Hosts page in your browser.
- Confirm that the Target request is correct, including the at.js reference.
- Try browsing to one of the Target requests on the host. It’s possible that no Target request on the host was ever rendered in a browser.
Random or unknown domains appear in the Host list.
A domain appears in this list if a request to Target is made from the domain. Often, you could see domains from spider engines, language translator sites, or local disk drives. If the listed domain is not one your team uses, you can click Delete to remove it.
My Target request returns /* no display - unauthorized mbox host */.
If a Target request is made on an unauthorized host, the request responds with /* no display - unauthorized mbox host */.