Queste configurazioni consentono a diverse istanze del codice del servizio ID implementate in un iFrame e sulla pagina padre di comunicare tra di loro. Risolvono problemi rilevati per 2 casi d'uso specifici in cui si può controllare o meno la pagina padre o il dominio e si carica il codice del servizio ID nell'iFrame di un dominio controllato. Sono disponibili in VisitorAPI.js per la versione del codice 2.2 o successiva.
Sommario:
Entrambi gli elementi di configurazione sono richiesti quando si utilizza questo codice.
Sintassi di configurazione | Descrizione |
---|---|
whitelistParentDomain: " Nome di dominio della pagina padre " |
Accetta un nome di dominio singolo trasmesso come stringa. |
whitelistIframeDomains: [ "dominio iFrame","dominio iFrame","dominio iFrame" ] |
Accetta uno o più nomi di dominio iFrame trasmessi come array. |
Una volta configurato, il tuo codice del servizio ID potrebbe assomigliare a questo esempio.
//Instantiate Visitor
var visitor = Visitor.getInstance("Insert Experience Cloud Organization ID here",{
...
//Add parent page domain name and iFrame domain names
whitelistParentDomain: "parentpageA.com",
whitelistIframeDomains: ["iFrameDomain1.com","iFrameDomain2.com"],
...
}
);
Queste configurazioni aiutano a risolvere il problema dell’impostazione di un cookie del servizio ID e dell’assegnazione di un ID visitatore quando i browser bloccano i cookie di terze parti e se si applica una delle seguenti condizioni:
Puoi anche implementare queste configurazioni durante il serving di un video in un iFrame con Video Heartbeat. Video Heartbeat richiede un ID del servizio ID (il MID) per funzionare correttamente.
Caso d’uso 1: il browser blocca i cookie di terze parti e il servizio ID è implementato nell’iFrame e nella pagina padre
Elemento del caso d’uso | Descrizione |
---|---|
Condizioni |
Questo caso d’uso include le seguenti condizioni:
|
Risultati |
Considerate queste condizioni, il servizio ID:
|
Soluzione |
Modifica la funzione Visitor.getInstance del servizio ID nell'iFrame con queste configurazioni della whitelist. Specifica i domini padre e figlio nel codice. Queste configurazioni consentono al codice del servizio ID nell’iFrame di controllare il codice del servizio ID sulla pagina padre per un ID visitatore. Se il codice del servizio ID nell’iFrame non riceve una pagina padre di risposta, queste configurazioni generano un ID visitatore locale. |
Caso d’uso 2: richiesta di un ID da un iFrame incorporato in una pagina padre di cui non si ha il controllo o che non utilizza il servizio ID
Elemento del caso d’uso | Descrizione |
---|---|
Condizioni |
Questo caso d’uso include le seguenti condizioni:
|
Risultati |
Considerate queste condizioni, il servizio ID:
|
Soluzione |
Modifica la funzione Visitor.getInstance del servizio ID nell'iFrame con queste configurazioni della whitelist. Specifica i domini padre e figlio nel codice. Queste configurazioni consentono al codice del servizio ID nell’iFrame di controllare il codice del servizio ID sulla pagina padre per un ID visitatore. Se il codice del servizio ID nell’iFrame non riceve una pagina padre di risposta, queste configurazioni generano un ID visitatore locale. |
Puoi implementare queste configurazioni in modo sicuro perché:
Il servizio ID supporta un set limitato di metodi API pubblici quando si implementano queste configurazioni della whitelist. I metodi supportati variano a seconda degli scenari di casi d’uso descritti in precedenza.
Caso d'uso | Metodi supportati |
---|---|
Caso 1 |
|
Caso 2 |
|