Scenarios

Synchronization can be initiated by one or both systems. The cookie matching database can be hosted in one or both systems. Methods must be agreed upon offline.

Third-party initiation

A third-party system can initiate the synchronization process by calling the Hybrid pixel, for example:

https://hybridai_domain/match?id=<SYSTEM_ID>&vid=<VISITOR_ID>

where <SYSTEM_ID> is the third-party system ID assigned by Hybrid (integer), <VISITOR_ID> is the third-party system visitor ID (string).

Hybrid will store this ID. The vid parameter can be omitted if the database is not hosted on Hybrid side.

Back redirection

The system can provide its own URL, to which the visitor ID will be passed, or use a back redirect via the burl parameter, if a third-party system wants to receive the Hybrid visitor ID, for example:

https://hybridai_domain/match?id=<SYSTEM_ID>&vid=<VISITOR_ID>&burl=https://example.com?params&vid=${VID}

where the macro ${VID} will be replaced with the Hybrid visitor ID. The burl parameter must be at the end of the URL, and its value may or may not be encoded.

GDPR

Hybrid supports GDPR data parameters: gdpr (indicated if GDPR applies to this sync), gdpr_consent (consent string) and gdpr_pd (specifies whether the sync contains personal data).

https://hybridai_domain/match?id=<SYSTEM_ID>&vid=<VISITOR_ID>&gdpr=<GDPR>&gdpr_consent=<GDPR_CONSENT_XXX>&gdpr_pd=<GDPR_PD>

Hybrid initiation

Hybrid can initiate the synchronization process by calling a third-party pixel, for example:

https://thirdparty_domain/cookie_sync?visitor_id=<VISITOR_ID>

where <VISITOR_ID> will be replaced with the Hybrid visitor ID (string). The third-party system will store this ID. The visitor ID parameter can be omitted if the database in not hosted on the third-party side.

Redirection

A third-party system can set up a redirect to the Hybrid URL and, if necessary, pass its own visitor ID to the URL. The same methods as above can be used.

GDPR

Hybrid supports macros ${GDPR}, ${GDPR_CONSENT_XXX} (where XXX is GVL ID of a third-party system) and ${GDPR_PD}.