whitelistParentDomain och whitelistIframeDomains whitelistparentdomain-and-whitelistiframedomains
Med dessa konfigurationer kan olika instanser av ID-tjänstkod som implementeras i en iFrame och på den överordnade sidan kommunicera med varandra. De är utformade för att lösa problem med två specifika användningsfall där du kan styra den överordnade sidan/domänen eller inte, och där du har ID-tjänstkoden inläst i iFrame för en domän som du har kontroll över. De är tillgängliga i VisitorAPI.js-koden version 2.2 eller senare.
Innehåll:
Syntax section-f645198bbaba4fba8961acb6e88d1470
Båda konfigurationselementen krävs när du använder den här koden.
Kodexempel section-09d0049fe88a473baa69d404c50bf8ae
Den konfigurerade ID service-koden kan se ut ungefär som i det här exemplet.
//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"],
...
}
);
Användningsfall section-fc2eeb93546b406fae3b102dbcd11de7
Dessa konfigurationer hjälper dig att lösa problemet med att ställa in en cookie för en ID-tjänst och tilldela ett besökar-ID när webbläsare blockerar cookies från tredje part och om något av dessa villkor gäller:
- Du kontrollerar eller kontrollerar inte den överordnade sidan/domänen.
- ID-tjänstkoden är inte installerad på den överordnade sidan, men implementeras i en iFrame.
Användningsfall 1: Webbläsaren blockerar cookies från tredje part och ID-tjänsten implementeras på iFrame- och överordnad sida
Detta användningsexempel omfattar följande villkor:
- Företag A implementerar ID-tjänsten på sin hemsida.
- Företag A implementerar ID-tjänsten i iFrame på sin hemsida.
- Företag A äger den överordnade sidan och iFrame och har implementerat ID-tjänsten på båda platserna.
- En kund läser in den överordnade sidan i en webbläsare som blockerar cookies från tredje part.
Med tanke på dessa villkor kan ID-tjänsten:
- Fungerar korrekt på den överordnade sidan. Den begär och ställer in AMCV-cookien och tilldelar ett unikt ID till besökaren.
- Fungerar inte i iFrame. Detta beror på att webbläsaren ser iFrame som en tredjepartsdomän och förhindrar att ID-tjänsten ställer in AMCV-cookien.
Ändra ID-tjänstens Visitor.getInstance -funktion i iFrame med dessa vita listkonfigurationer. Ange de överordnade och underordnade domänerna i koden. Dessa konfigurationer gör att ID-tjänstkoden i iFrame kan kontrollera ID-tjänstkoden på den överordnade sidan för ett besökar-ID.
Om ID-tjänstkoden i iFrame inte får någon överordnad svarssida genererar dessa konfigurationer ett lokalt besökar-ID.
Använd fall 2: Begär ett ID från en iFrame som är inbäddad i en överordnad sida som du inte kontrollerar eller som inte använder ID-tjänsten
Detta användningsexempel omfattar följande villkor:
- Företag A använder inte ID-tjänsten.
- Företag A läser in en iFrame på sidan. Den här iFrame ägs av företag B och läses in i en separat domän än som företag A.
- Webbläsaren blockerar cookies från tredje part.
Med tanke på dessa villkor kan ID-tjänsten:
- Fungerar inte i iFrame. Detta beror på att webbläsaren ser iFrame som en tredjepartsdomän och förhindrar att ID-tjänsten ställer in AMCV-cookien.
- Det går inte att hämta ett besökar-ID från den överordnade sidan eftersom företag A inte använder den här tjänsten.
Ändra ID-tjänstens Visitor.getInstance -funktion i iFrame med dessa vita listkonfigurationer. Ange de överordnade och underordnade domänerna i koden. Dessa konfigurationer gör att ID-tjänstkoden i iFrame kan kontrollera ID-tjänstkoden på den överordnade sidan för ett besökar-ID.
Om ID-tjänstkoden i iFrame inte får någon överordnad svarssida genererar dessa konfigurationer ett lokalt besökar-ID.
Säkerhet och säkerhet för konfiguration section-2b1ce31fab034e1ca0f6b1c3cc57a6e2
Du kan implementera dessa konfigurationer på ett säkert sätt eftersom:
- ID-tjänsten som implementeras på den överordnade domänen och iFrame-domänen måste använda samma organisations-ID. De här konfigurationerna för vit lista fungerar inte när organisations-ID:n på den överordnade eller iFrame är olika.
- Dessa konfigurationer kommunicerar bara med den domän och iFrames som anges i koden.
- Kommunikationen mellan iFrame och den överordnade sidan har ett visst format. Om ID-tjänsten på den överordnade sidan inte tar emot någon begäran i det förväntade formatet kommer denna delningsprocess att misslyckas.
API-metoder för besökare som stöds section-30c6a9f4dcdc4265a1149260b97cc057
ID-tjänsten har stöd för en begränsad uppsättning publika API-metoder när du implementerar dessa konfigurationer för vit lista. Vilka metoder som stöds varierar beroende på vilka scenarier för användningsfall som beskrivs ovan.
- getMarketingCloudID
- getAudienceManagerLocationHint
- getAudienceManagerBlob
- getSupplementalDataID
- getCustomerID:n
- getSupplementalDataID
- getMarketingCloudVisitorID