Reference

MethodDescription

Activates the tag with an identity. Needed when authentication is enabled.

Getters

Event listeners

Displays a list of available commands in the console

Removes an identity, effectively stopping the tag when authentication is enabled.

navigate

Changes the current screen and restart the tag, allowing a new targeting run

Records a transaction

Setters

iAdvize.activate / iAdvize.logout

These methods are used for authentication. Please see the dedicated Help Center article : https://help.iadvize.com/hc/articles/6043078724626

iAdvize.get

iAdvize.get takes a single property argument, and returns the associated value. Properties are keys that reference values that can change over time. These values can be accessed :

  • directly, using iAdvize.get (ex: iAdvize.get('visitor:cookiesConsent'))

  • when they change, using iAdvize.on (ex: iAdvize.on('visitor:cookiesConsentChange', callback))

PropertyDescriptionValues

tag:version

The tag version

"LIGHT", "FULL"

visitor:cookiesConsent

Whether the visitor consented to cookies or not

true, false, null (default)

visitor:GDPRConsent

Whether the visitor consented to GDPR or not

true, false, null (default)

chatbox:status

The status of the chatbox

OPENED, REDUCED, CLOSED (default)

Example :

window.iAdvizeInterface = window.iAdvizeInterface || [];
window.iAdvizeInterface.push(function(iAdvize) {
  const visitorCookiesConsent = iAdvize.get('visitor:cookiesConsent');
});

iAdvize.on / iAdvize.off

iAdvize.on takes two arguments :

  • The name of an event,

  • A callback that takes the associated event value as parameter.

Every property available on iAdvize.get also has a corresponding event (iAdvize.on('{property}Change', (value) => {...})). iAdvize.off takes the same arguments to remove the event listener.

Example :

window.iAdvizeInterface = window.iAdvizeInterface || [];
window.iAdvizeInterface.push(function(iAdvize) {
  iAdvize.on('visitor:cookiesConsentChange', function(visitorCookiesConsent) {
console.log(visitorCookiesConsent);
  });
});

iAdvize.set

Set editable properties.

PropertyDescriptionValues

visitor:cookiesConsent

Whether the visitor consented to cookies or not

true, false

visitor:GDPRConsent

Whether the visitor consented to GDPR or not

true, false

Example :

window.iAdvizeInterface = window.iAdvizeInterface || [];
window.iAdvizeInterface.push(function(iAdvize) {
  iAdvize.set('visitor:GDPRConsent', true);
});

iAdvize.help

  • Lists all the available methods,

  • Lists all the available properties on get and set,

  • Lists all the available events on on and off.

iAdvize.recordTransaction

Allows to record transactions. See the dedicated article on the Help Center: https://help.iadvize.com/hc/en-gb/articles/206375538

Example :

window.iAdvizeInterface = window.iAdvizeInterface || [];
window.iAdvizeInterface.push(function(iAdvize) {
  iAdvize.recordTransaction({
id: 'unique-id',amount: 49.95,
  });
});

Last updated

#147: HFE - Authenticated Messaging

Change request updated