Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The tracking proxy is an intermediate server that listens to requests that clients such as browsers send to a public tracking domain such as fuchsia.example.com. The task of the tracking proxy is to forward requests to the Ingenious tracking server.

...

The Ingenious tracking server domain (not the tracking proxy domain!) is the endpoint that the tracking proxy forwards requests to:

proxy.ingenious.cloud

The Ingenious tracking server domain must not be created in the platform, it is maintained by Ingenious so that the Ingenious tracking services are available under that domain.

...

In HTTP, the HTTP header “Cookie” transmits cookies from clients to servers. You need to make sure that specific cookies are forwarded to the Ingenious tracking server.
The following cookies of incoming HTTP requests of the client must be forwarded to the tracking server.

  • tsc

  • tsv

  • tse

  • trackingoptout

  • trackingoptout_* (All cookies starting with "trackingoptout_".)

Proxy headers

In HTTP, multiple HTTP headers exist that are specifically designed for situations in which proxies are in use. To enable accurate tracking, the tracking server requires specific proxy headers to be present in HTTP requests that are forwarded by a tracking proxy.
The following table lists the proxy headers that the proxy needs to include with a request that it forwards to the tracking server.

Key

Expected value

Proxy Behaviour

x-forwarded-for

IP Address list containing all IPs, including the IP address of the initial HTTP request.

Create or extend this header.

x-forwarded-host

Host of initial HTTP request.

Set to host of initial HTTP request.

x-forwarded-proto

Protocol of initial HTTP request.

Set to protocol of initial HTTP request.

...

In HTTP, the HTTP header “Set-Cookie” transmits cookies from clients to servers. You need to make sure that specific cookies are forwarded to the Ingenious tracking server.
The following cookies returned from the Ingenious tracking server must be forwarded back to the client.

  • tsc

  • tsv

  • tse

  • trackingoptout

  • trackingoptout_* (All cookies starting with "trackingoptout_".)

Advertiser configuration

...

 Advertiser tracking setting

Value

Example

Description

Tracking domain

{tracking-subdomain}.{advertiser-domain}.{top-level domain}

fuchsia.example.com

The domain that is used to track events of your Advertiser.
The tracking domain of the advertiser must be the domain of the tracking proxy.The domain is used for generating tracking URLs in the platform,
and will be used to validate incoming tracking requests.

Cookie domain

.{advertiser-domain}.{top-level domain}

.example.com

The cookie domain is an advanced setting and can be changed by Ingenious Administrators only. 
Please contact your customer success manager. They will help to define the cookie domain and change the setting for you.

...

If your proxy tracking domain is fuchsia.example.com, then the opt-out link will be

...