whitelistParentDomain e whitelistIframeDomains whitelistparentdomain-and-whitelistiframedomains
Queste configurazioni consentono a diverse istanze del codice del servizio Visitor ID implementato in un iFrame e sulla pagina padre di comunicare tra loro. Sono state progettate per aiutare a risolvere i problemi relativi a 2 casi d’uso specifici in cui potresti controllare o meno la pagina padre o il dominio e avere il codice del servizio ID visitatore caricato nell’iFrame di un dominio che controlli. Sono disponibili in VisitorAPI.js codice versione 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 Visitor ID Servicecodice, potrebbe assomigliare a questo esempio.
//Instantiate Visitor
var visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE",{
...
//Add parent page domain name and iFrame domain names
whitelistParentDomain: "parentpageA.com",
whitelistIframeDomains: ["iFrameDomain1.com","iFrameDomain2.com"],
...
}
);
Casi d’uso section-fc2eeb93546b406fae3b102dbcd11de7
Queste configurazioni aiutano a risolvere il problema di impostazione di un cookie del servizio ID visitatore e di 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 visitatore 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 visitatore è implementato nell’iFrame e nella pagina padre
Questo caso d’uso include le seguenti condizioni:
- La società A implementa il servizio ID visitatore sulla propria home page.
- La società A implementa il servizio ID visitatore in iFrame sulla propria home page.
- La società A è proprietaria della pagina padre e dell’iFrame e ha implementato il servizio ID visitatore in entrambi.
- Un cliente carica la pagina padre in un browser che blocca i cookie di terze parti.
Considerate queste condizioni, il Servizio ID visitatore:
- 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 terze parti e impedisce al servizio ID visitatore di impostare il cookie AMCV.
Modifica la funzione Visitor ID Service Visitor.getInstance nell'iFrame con queste configurazioni della whitelist. Specifica i domini principale e secondario nel codice. Queste configurazioni consentono al codice del servizio ID visitatore nell’iFrame di controllare il codice del servizio ID visitatore nella pagina padre per individuare un ID visitatore.
Se il codice del servizio ID visitatore 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 visitatori
Questo caso d’uso include le seguenti condizioni:
- La società A non utilizza il servizio ID visitatore.
- 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 visitatore:
- Non funziona nell'iFrame. Questo perché il browser vede l’iFrame come un dominio di terze parti e impedisce al servizio ID visitatore 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 ID Service Visitor.getInstance nell'iFrame con queste configurazioni della whitelist. Specifica i domini principale e secondario nel codice. Queste configurazioni consentono al codice del servizio ID visitatore nell’iFrame di controllare il codice del servizio ID visitatore nella pagina padre per individuare un ID visitatore.
Se il codice del servizio ID visitatore 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 visitatore implementato sul dominio principale e sul dominio iFrame deve utilizzare lo stesso ID organizzazione IMS. Queste configurazioni della whitelist non funzioneranno se gli ID organizzazione IMS 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 visitatore 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 visitatore 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