whitelistParentDomain e whitelistIframeDomains whitelistparentdomain-and-whitelistiframedomains
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:
Sintassi section-f645198bbaba4fba8961acb6e88d1470
Entrambi gli elementi di configurazione sono richiesti quando si utilizza questo codice.
Esempio di codice section-09d0049fe88a473baa69d404c50bf8ae
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"],
...
}
);
Casi di utilizzo section-fc2eeb93546b406fae3b102dbcd11de7
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:
- È possibile controllare o meno la pagina padre o il dominio.
- Il codice del servizio ID non è installato nella pagina padre, ma è implementato in un iFrame.
Caso d’uso 1: il browser blocca i cookie di terze parti e il servizio ID è implementato nell’iFrame e nella pagina padre
Questo caso d’uso include le seguenti condizioni:
- La società A implementa il servizio ID sulla propria homepage.
- La società A implementa il servizio ID in iFrame sulla propria homepage.
- La società A è proprietaria della pagina padre e dell’iFrame e ha implementato il servizio ID in entrambi.
- Un cliente carica la pagina padre in un browser che blocca i cookie di terze parti.
Considerate queste condizioni, il servizio ID:
- Funziona correttamente nella pagina padre. Richiede e imposta il cookie AMCV e assegna un ID univoco al visitatore del sito.
- Non funziona nell'iFrame. Questo perché il browser vede l’iFrame come un dominio di terza parte e impedisce al servizio ID di impostare il cookie AMCV.
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
Questo caso d’uso include le seguenti condizioni:
- La società A non utilizza il servizio ID.
- La società A carica un iFrame sulla pagina. Questo iFrame è di proprietà della società B e si carica in un dominio separato rispetto alla società A.
- Il browser blocca i cookie di terze parti.
Considerate queste condizioni, il servizio ID:
- Non funziona nell'iFrame. Questo perché il browser vede l’iFrame come un dominio di terza parte e impedisce al servizio ID di impostare il cookie AMCV.
- Impossibile ottenere un ID visitatore dalla pagina padre perché la società A non utilizza questo servizio.
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.
Sicurezza della configurazione section-2b1ce31fab034e1ca0f6b1c3cc57a6e2
Puoi implementare queste configurazioni in modo sicuro perché:
- Il servizio ID implementato sul dominio padre e sul dominio iFrame deve usare lo stesso ID organizzazione. Queste configurazioni della whitelist non funzioneranno se gli ID organizzazione nell’iFrame o nell’elemento padre sono diversi.
- Queste configurazioni comunicano solo con il dominio e gli iFrame specificati nel codice.
- La comunicazione tra l'iFrame e la pagina padre segue un formato specifico. Se il servizio ID sulla pagina padre non riceve una richiesta nel formato previsto, il processo di condivisione non riuscirà.
Metodi API del visitatore supportati section-30c6a9f4dcdc4265a1149260b97cc057
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.
- getMarketingCloudID
- getAudienceManagerLocationHint
- getAudienceManagerBlob
- getSupplementalDataID
- getCustomerIDs
- getSupplementalDataID
- getMarketingCloudVisitorID