whitelistParentDomain och whitelistIframeDomains

Senaste uppdatering: 2023-05-26
  • Skapat för:
  • Developer
    User
    Admin
    Leader

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

Båda konfigurationselementen krävs när du använder den här koden.

Konfigurationssyntax Beskrivning

whitelistParentDomain: " Domännamn för överordnad sida "

Accepterar ett domännamn som skickas som en sträng.

whitelistIframeDomains: [ "iFrame domain","iFrame domain","iFrame domain" ]

Accepterar ett eller flera iFrame-domännamn som skickas som en array.

Exempel på kod

Din 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ändningsexempel

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.
TIPS

Du kanske också vill implementera dessa konfigurationer när du visar video i en iFrame med Videopulsslag. Videopulsen behöver ett ID-tjänst-ID (MID) för att fungera korrekt.

Användningsfall 1: Webbläsaren blockerar cookies från tredje part och ID-tjänsten implementeras på iFrame- och överordnad sida

Element i användningsexempel Beskrivning

Villkor

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.

Resultat

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.

Lösning

Ändra ID-tjänsten Visitor.getInstance 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ändningsfall 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

Element i användningsexempel Beskrivning

Villkor

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.

Resultat

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.

Lösning

Ändra ID-tjänsten Visitor.getInstance 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

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

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.

Användningsfall Metoder som stöds

Fall 1

  • getMarketingCloudID
  • getAudienceManagerLocationHint
  • getAudienceManagerBlob
  • getSupplementalDataID
  • getCustomerIDs

Fall 2

  • getSupplementalDataID
  • getMarketingCloudVisitorID

På denna sida