whitelistParentDomain en whitelistIframeDomains whitelistparentdomain-and-whitelistiframedomains
Deze configuraties laten verschillende instanties van de de dienstcode van identiteitskaart die in een iFrame en op de ouderpagina wordt uitgevoerd met elkaar communiceren. Zij worden ontworpen helpen problemen met 2 specifieke gebruiksgevallen oplossen waar u of niet de ouderpagina/het domein kunt controleren en u hebt de dienstcode van identiteitskaart die in iFrame van een domein laadt dat u controle hebt. Ze zijn beschikbaar in VisitorAPI.js code versie 2.2 of hoger.
Inhoud:
Syntaxis section-f645198bbaba4fba8961acb6e88d1470
Beide configuratieelementen worden vereist wanneer u deze code gebruikt.
Codevoorbeeld section-09d0049fe88a473baa69d404c50bf8ae
Uw geconfigureerde ID service code kan er ongeveer als volgt uitzien.
//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"],
...
}
);
Gebruiksscenario’s section-fc2eeb93546b406fae3b102dbcd11de7
Deze configuraties helpen het probleem op te lossen van het plaatsen van een de dienstkoekje van identiteitskaart en het toewijzen van een bezoekersidentiteitskaart wanneer browsers derdekoekjes blokkeren en als één van beiden van deze voorwaarden van toepassing is:
- U bestuurt de bovenliggende pagina of het bovenliggende domein al dan niet.
- ID-servicecode is niet geïnstalleerd op de bovenliggende pagina, maar is geïmplementeerd in een iFrame.
Geval van het Gebruik 1: Browser Blokkeert de Derde Koekjes van de Partij en de Dienst van identiteitskaart wordt uitgevoerd op iFrame en de Ouderlijke Pagina
Dit gebruiksgeval omvat de volgende voorwaarden:
- Bedrijf A implementeert de dienst van identiteitskaart op hun homepage.
- Bedrijf A implementeert de id-service in iFrame op hun homepage.
- Bedrijf A bezit de ouderpagina en iFrame en heeft de dienst van identiteitskaart in beide plaatsen uitgevoerd.
- Een klant laadt de bovenliggende pagina in een browser die cookies van derden blokkeert.
Onder deze voorwaarden kan de id-service:
- Werkt goed op de bovenliggende pagina. Het vraagt en plaatst het koekje AMCV en wijst een unieke identiteitskaart aan de plaatsbezoeker toe.
- Werkt niet in het iFrame. De reden hiervoor is dat de browser het iFrame ziet als een derdedomein en dat de id-service het AMCV-cookie niet kan instellen.
Wijzig de functie Visitor.getInstance van de id-service in het iFrame met deze configuraties van witte lijsten. Geef de bovenliggende en onderliggende domeinen in de code op. Met deze configuraties kan de ID-servicecode in het iFrame de ID-servicecode op de bovenliggende pagina controleren op een bezoeker-id.
Als de ID-servicecode in het iFrame geen bovenliggende pagina voor reacties ontvangt, genereren deze configuraties een lokale bezoeker-id.
Geval van het Gebruik 2: Het verzoeken van identiteitskaart van een iFrame ingebed in een ouderpagina u controleert niet of die niet de dienst van identiteitskaart gebruikt
Dit gebruiksgeval omvat de volgende voorwaarden:
- Bedrijf A gebruikt de id-service niet.
- Bedrijf A laadt een iFrame op de pagina. Dit iFrame is eigendom van Bedrijf B en laadt in een afzonderlijk domein dan Bedrijf A.
- De browser blokkeert cookies van derden.
Onder deze voorwaarden kan de id-service:
- Werkt niet in het iFrame. De reden hiervoor is dat de browser het iFrame ziet als een derdedomein en dat de id-service het AMCV-cookie niet kan instellen.
- Kan geen bezoekersidentiteitskaart van de ouderpagina krijgen omdat Bedrijf A deze dienst niet gebruikt.
Wijzig de functie Visitor.getInstance van de id-service in het iFrame met deze configuraties van witte lijsten. Geef de bovenliggende en onderliggende domeinen in de code op. Met deze configuraties kan de ID-servicecode in het iFrame de ID-servicecode op de bovenliggende pagina controleren op een bezoeker-id.
Als de ID-servicecode in het iFrame geen bovenliggende pagina voor reacties ontvangt, genereren deze configuraties een lokale bezoeker-id.
Configuratieveiligheid en -beveiliging section-2b1ce31fab034e1ca0f6b1c3cc57a6e2
U kunt deze configuraties veilig implementeren omdat:
- De dienst van identiteitskaart die op ouderdomein en het iFrame domein wordt uitgevoerd moet de zelfde organisatieidentiteitskaart gebruiken Deze witte lijstconfiguraties zullen niet werken wanneer organisatie IDs op de ouder of in iFrame verschillend zijn.
- Deze configuraties communiceren alleen met het domein en de iFrames die in de code zijn opgegeven.
- De communicatie tussen iFrame en de bovenliggende pagina heeft een specifieke indeling. Als de id-service op de bovenliggende pagina geen aanvraag in de verwachte indeling ontvangt, mislukt dit deelproces.
Ondersteunde API-methoden voor bezoekers section-30c6a9f4dcdc4265a1149260b97cc057
De dienst van identiteitskaart steunt een beperkte reeks openbare API methodes wanneer u deze witte lijstconfiguraties implementeert. De ondersteunde methoden variëren afhankelijk van de hierboven beschreven gebruiksscenario's.
- getMarketingCloudID
- getAudienceManagerLocationHint
- getAudienceManagerBlob
- getSupplementalDataID
- getCustomerIDs
- getSupplementalDataID
- getMarketingCloudVisitorID