Skip to main content
Skip table of contents

Cross-domain Ident

The Cross-domain Ident enables you to link the identity across multiple domains using browser redirects.

This cross-domain solution is not affected by ITP and other browser restrictions as its operated as a true first party service.

What domains and how many are included in the Cross-domain Ident can be defined in the pipeline configuration.

The consent required to start a cross-domain identity link is configurable through a CDN rule. Teavaro will provide the required script for CDNs including AWS CloudFront, Fastly, and Akamai.

Based on cookie consent, the CDN redirects the user one time to the Cross-domain Ident service. This redirect rule looks at the cookie consent as specified as well as any preceding redirects.

If a cross-domain redirect has already taken place, it will not take place again, until that rule check is satisfied.

The initial CDN redirect URL consists of the following:

  1. Cross-domain Ident endpoint: https://fc.{your website domain}/op/{pipeline}/-/

  2. Target page set by the CDN script based on the user request, including the full target URL with all query string parameters. For example: www.brand-demo.com/product/absolute-organic-cashews/?test=test&test1=test1

The cross-domain service can also be used with page links, for example using it within menu links, which does not require a CDN setup.

Request

The following interface URL would be returned by the CDN script:

NONE
https://fc.{your website domain}/op/{pipeline}/-/{user requested page with all query string parameters}

HTTPOnly Cookie

The API sets a umdid cookie, which is used as lookup identifier.

CODE
umdid=OTBlNjgxZDAtZTEzZi00NTYwLTllYzEtY2Y5NzJlMTlkZjcyfDE1ZDI2NTY4LWVmMzgtNGRiMy05Y2NkLTJmY2YzODI1ODE5Mnwy; Max-Age=31536000; Expires=Thu, 19 Feb 2026 12:18:26 GMT; SameSite=None; Path=/; Domain={your wibsite domain}; Secure; HTTPOnly

The umdid cookie value is a base 64 encoded string consisting of the following values delimitered by pipe:

umdid|umid|type

Name

Type

Description

umdid

UUID

The Unified Marketing Device Identifier, specific to a device.

umid

UUID

The Unified Marketing Identifier, specific to a profile.

type

Digit

A number between 0 and 2 describing the current profile identified method.

0 = anonymous visistor profile
1 = login identified customer profile
2 = network identifier customer profile

Sample:

CODE
OTBlNjgxZDAtZTEzZi00NTYwLTllYzEtY2Y5NzJlMTlkZjcyfDE1ZDI2NTY4LWVmMzgtNGRiMy05Y2NkLTJmY2YzODI1ODE5Mnwy

Decoded:

CODE
90e681d0-e13f-4560-9ec1-cf972e19df72|15d26568-ef38-4db3-9ccd-2fcf38258192|2

Response

The response of the Cross-domain Ident is a 302 with the location URL of the next cross-domain endpoint or destination page.

The FunnelConnect cross-domain service sets the following cookie to stop further redirects as its a condition checked in the CDN:

NONE
set-cookie: tv-cd-done=true; Max-Age=86400; Expires=Wed, 08 Jan 2025 13:46:35 GMT; SameSite=None; Path=/; Domain=brand-demo.com; Secure; HTTPOnly

Sample call flow

Using demo environment with tv-consent=dHJ1ZQ== cookie as qualifying redirect trigger.

NONE
curl -L -s -D - -o /dev/null 'https://funnelconnect.brand-demo.com/op/demo-cd/-/www.brand-demo.com/product/absolute-organic-cashews/?test=test&test1=test1' \
-H 'Cookie: umdid=NmVhNTIxMmItZDk1Ny00M2VhLTkxNGUtZDU5ZGNkNzE0ZDcxfDVkN2ViZjUwLTEwMzAtNGVjZi1hZjhjLTFhMjAwZWQxNjJiY3ww; tv-consent=dHJ1ZQ=='

As you can see from this sample and below trace, the following calls are fired:

  1. Redirect from CDN to Cross-domain Ident API: https://funnelconnect.brand-demo.com/op/demo-cd/-/www.brand-demo.com/product/absolute-organic-cashews/?test=test&test1=test1.

  2. Cross-domain Ident redirect: https://funnelconnect.publisher-demo.media/op/demo-cd/yntj1yCCf6AS1lDctNfYCbknMN5f3-IU6Y52DPU5jrsadMHxoFkkRPiwDrniN3LMcesR0xxaD0f12ZILyul8CcY2kEJEJ3FalziLlR9RKgD4ZiZHWwfijQyL_iaazmPuYgb5zjUv/www.brand-demo.com/product/absolute-organic-cashews/?test=test&test1=test1.

  3. Target page redirect: https://www.brand-demo.com/product/absolute-organic-cashews/?test=test&test1=test1.

NONE
HTTP/1.1 307 Temporary Redirect
vary: Origin
location: https://funnelconnect.publisher-demo.media/op/demo-cd/yntj1yCCf6AS1lDctNfYCbknMN5f3-IU6Y52DPU5jrsadMHxoFkkRPiwDrniN3LMcesR0xxaD0f12ZILyul8CcY2kEJEJ3FalziLlR9RKgD4ZiZHWwfijQyL_iaazmPuYgb5zjUv/www.brand-demo.com/product/absolute-organic-cashews/?test=test&test1=test1
set-cookie: umdid=MzFhZmMxYmItNjMxMi00ODY5LWJhZGMtYTY0ZGJhYjBmNTBkfDlkYjBjNmRlLWNhYTMtNDZjNS1hMGRjLTg1M2I5M2NiYjRlMHww; Max-Age=31536000; Expires=Thu, 19 Feb 2026 16:01:45 GMT; SameSite=None; Path=/op/; Domain=brand-demo.com; Secure; HTTPOnly
set-cookie: tv-cd-done=true; Max-Age=86400; Expires=Thu, 20 Feb 2025 16:01:45 GMT; SameSite=None; Path=/; Domain=brand-demo.com; Secure; HTTPOnly
date: Wed, 19 Feb 2025 16:01:45 GMT
content-length: 0
strict-transport-security: max-age=31536000; includeSubDomains; preload

HTTP/1.1 307 Temporary Redirect
vary: Origin
location: https://www.brand-demo.com/product/absolute-organic-cashews/?test=test&test1=test1
set-cookie: umdid=Zjc4ODczMjYtYzU1OC00MWY1LWE5ZDctOTY3MDcwZjdlOTBmfDlkYjBjNmRlLWNhYTMtNDZjNS1hMGRjLTg1M2I5M2NiYjRlMHww; Max-Age=31536000; Expires=Thu, 19 Feb 2026 16:01:45 GMT; SameSite=None; Path=/op/; Domain=publisher-demo.media; Secure; HTTPOnly
date: Wed, 19 Feb 2025 16:01:45 GMT
content-length: 0
strict-transport-security: max-age=31536000; includeSubDomains; preload

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Date: Wed, 19 Feb 2025 16:01:45 GMT
Server: Apache
X-Powered-By: PHP/8.2.27
Link: <https://www.brand-demo.com/wp-json/>; rel="https://api.w.org/", <https://www.brand-demo.com/wp-json/wp/v2/product/4473>; rel="alternate"; title="JSON"; type="application/json", <https://www.brand-demo.com/?p=4473>; rel=shortlink
Vary: Accept-Encoding
X-Cache: Miss from cloudfront
Via: 1.1 c4d61fb97b2b6dd985813b847272e0d0.cloudfront.net (CloudFront)
X-Amz-Cf-Pop: LHR50-P2
X-Amz-Cf-Id: wAjltzmKOCEYit7HEZA_02KjUYgvcEzi1yaBJ03JSlJSi5mIuNA_CA==

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.