Route data collection through a CDN
Some organizations route data collection requests through their content delivery network (CDN) instead of sending them directly to Adobe. Common reasons include web application firewall (WAF) protection, corporate policies that require all website traffic to pass through a CDN, and the ability to inspect traffic sent to Adobe. The CDN receives requests on a hostname that your organization owns, then forwards them to an Adobe data collection hostname, called the origin.
Choose an origin type origin-type
data.adobedc.net, such as example.data.adobedc.netdata.example.comRequirements for all CDN implementations requirements
Adobe data collection libraries, such as AppMeasurement and the Web SDK, include everything that Adobe needs in each request. Configure your CDN to forward these requests to Adobe without changing them.
Your CDN configuration must:
- Forward the request method, URL path, query string, and body without changes.
- Leave the
Hostheader unchanged. - Leave the domain that Adobe cookies are set on unchanged.
- Keep all cookies listed in the cookies section of this guide.
- Add the
X-Forwarded-Forheader containing the visitor’s IP address. Adobe uses this header for geolocation. Without it, geolocation data reflects the location of your CDN’s servers instead of your visitors. - Return Adobe’s responses to the browser without changes.
Your CDN configuration can:
- Remove cookies that Adobe doesn’t use, such as cookies from other systems on your site. Unrelated cookies add overhead to every request.
- Use WAF, bot filtering, or personal data removal services, as long as they don’t change anything listed above. Test these services with a development report suite or datastream before applying them to production traffic. Overly aggressive filtering can remove enough data to make reports unusable.
Your CDN configuration must not:
- Cache data collection requests or responses. Every request must reach Adobe.
- Point to an origin hostname that doesn’t exist.
- Accept expired certificates or pin a specific certificate from the origin. Adobe doesn’t support serving expired certificates and can remove them at any time.
Configure a CDN with a third-party origin third-party-origin
A third-party origin uses Adobe’s own certificate, so your organization doesn’t need to maintain a certificate on Adobe servers.
- Find your organization’s tenant ID. See Find your tenant ID.
- In your CDN configuration, set the origin hostname to your tenant ID subdomain of
data.adobedc.net. For example,example.data.adobedc.net. - Enable Server Name Indication (SNI) for the origin. Set the SNI hostname to the origin hostname (for example,
example.data.adobedc.net), not your website’s hostname. - Configure your CDN to meet the requirements for all CDN implementations above.
- If the hostname that your implementation sends data to changes, update your implementation. If you keep the same hostname, no implementation changes are needed.
hiodsibxvip01.data.adobedc.net. That hostname is tied to your first-party certificate and can stop working when the certificate is removed.Third-party origins always use the default RDC type, so data can be collected at any Adobe data collection location.
Configure a CDN with a first-party origin first-party-origin
Use a first-party origin only if your organization requires it. Common reasons include:
- Your security policy requires direct control of the origin certificate. For example, your organization must be able to revoke the certificate through its own certificate authority.
- Your organization requires a region-locked RDC type.
- Contact Adobe Customer Care to set up a customer-managed certificate for your first-party hostname, such as
data.example.com. If your organization requires a region-locked RDC type, specify it in your request. - In your CDN configuration, set the origin hostname to your first-party hostname.
- Enable Server Name Indication (SNI) for the origin. Set the SNI hostname to your first-party hostname, and configure your CDN to expect your first-party certificate from the origin.
- Configure your CDN to meet the requirements for all CDN implementations above.
- If the hostname that your implementation sends data to changes, update your implementation. If you keep the same hostname, no implementation changes are needed.
Move an existing first-party implementation to a CDN migrate
If your organization currently sends data directly to a first-party hostname with a certificate hosted by Adobe, use the following steps to move to a CDN:
- Identify every implementation that sends data to your first-party hostname, across all Adobe products. Other products, such as Adobe Target or Adobe Journey Optimizer, might use the same hostname, and a single certificate can cover many hostnames.
- Choose an origin type. If you choose a first-party origin, contact Adobe Customer Care to convert your certificate to a customer-managed certificate before it expires.
- Configure your CDN. Keep your existing hostname so that you don’t need to update your implementations.
- Before your certificate expires, point your hostname to your CDN and switch all implementations to use it.
- Check your data.
- If you chose a third-party origin, contact Adobe Customer Care to mark your first-party certificate for removal.
Once your hostname points to your CDN, Adobe can’t renew your first-party certificate. If any implementation still relies on the certificate when it expires, data from that implementation is lost. Contacting Adobe Customer Care lets your organization control when the certificate is removed.
Check your data check
Adobe can’t validate your CDN configuration. After you route data collection through your CDN, compare your data before and after the change:
- Data continues to arrive in the expected report suites, datastreams, or datasets at the usual volume.
- Geolocation reports show your visitors’ locations, not a small number of cities where your CDN’s servers are located.
- Unique visitor counts don’t increase unexpectedly.
- In your browser’s developer tools, data collection requests to your hostname succeed, and Adobe cookies are set on the same domain as before.
Common misconfigurations
The following issues are known to cause data quality issues or data loss. This list is not exhaustive.
X-Forwarded-For headerHost header, or changes the cookie domain