whitelistParentDomain 和 whitelistIframeDomains whitelistparentdomain-and-whitelistiframedomains
通过这些配置，在 iFrame 中和父页面上实施的 ID 服务代码的不同实例可以相互通信。它们旨在帮助解决以下两种特定用例中出现的问题：您可能会（也可能不会）控制父页面/域，以及您在自己控制的域的 iFrame 中加载 ID 服务代码。它们在 VisitorAPI.js 代码版本 2.2 或更高版本中可用。
目录：
语法 section-f645198bbaba4fba8961acb6e88d1470
使用此代码时，需要两个配置元素。
代码示例 section-09d0049fe88a473baa69d404c50bf8ae
您配置的 ID 服务代码可能与以下示例类似。
//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"],
...
}
);
用例 section-fc2eeb93546b406fae3b102dbcd11de7
这些配置有助于解决当浏览器阻止第三方 Cookie 并且满足以下任一条件时，设置 ID 服务 Cookie 和分配访客 ID 的问题：
- 您控制或不控制父页面/域。
- ID 服务代码不是安装在父页面上，而是在 iFrame 中实施。
用例 1：浏览器阻止第三方 Cookie，并且在 iFrame 和父页面上实施 ID 服务
此用例包括以下条件：
- 公司 A 在其主页上实施 ID 服务。
- 公司 A 在其主页上的 iFrame 中实施 ID 服务。
- 公司 A 拥有父页面和 iFrame，并已同时在这两个位置实施 ID 服务。
- 客户在浏览器中加载父页面，该浏览器会阻止第三方 Cookie。
在这些条件下，ID 服务：
- 在父页面上可正常运行。它会请求和设置 AMCV Cookie，并为网站访客分配唯一 ID。
- 在 iFrame 中无法运行。这是因为浏览器将 iFrame 视为第三方域并阻止 ID 服务设置 AMCV Cookie。
使用这些白名单配置，修改 iFrame 中的 ID 服务 Visitor.getInstance 函数。在代码中指定父域和子域。通过这些配置，iFrame 中的 ID 服务代码可在父页面上的 ID 服务代码中检查访客 ID。
如果 iFrame 中的 ID 服务代码未收到响应父页面，则这些配置将生成本地访客 ID。
用例 2：从不由您控制或不使用 ID 服务的父页面中嵌入的 iFrame 请求 ID
此用例包括以下条件：
- 公司 A 不使用 ID 服务。
- 公司 A 在页面上加载 iFrame。此 iFrame 由公司 B 拥有，并加载到与公司 A 不同的域中。
- 浏览器阻止第三方 Cookie。
在这些条件下，ID 服务：
- 在 iFrame 中无法运行。这是因为浏览器将 iFrame 视为第三方域并阻止 ID 服务设置 AMCV Cookie。
- 无法从父页面获取访客 ID，因为公司 A 不使用此服务。
使用这些白名单配置，修改 iFrame 中的 ID 服务 Visitor.getInstance 函数。在代码中指定父域和子域。通过这些配置，iFrame 中的 ID 服务代码可在父页面上的 ID 服务代码中检查访客 ID。
如果 iFrame 中的 ID 服务代码未收到响应父页面，则这些配置将生成本地访客 ID。
配置安全性 section-2b1ce31fab034e1ca0f6b1c3cc57a6e2
您可以安全地实施这些配置，因为：
- 在父域和 iFrame 域上实施的 ID 服务必须使用相同的组织 ID。当父域或 iFrame 域中的组织 ID 不同时，这些白名单配置将不起作用。
- 这些配置仅与代码中指定的域和 iFrame 通信。
- iFrame 与父页面之间的通信遵循特定格式。如果父页面上的 ID 服务未收到使用预期格式发送的请求，则此共享过程将失败。
支持的访客 API 方法 section-30c6a9f4dcdc4265a1149260b97cc057
在您实施这些白名单配置时，ID 服务支持一组有限的公共 API 方法。支持的方法因上文所述的用例情景而异。
- getMarketingCloudID
- getAudienceManagerLocationHint
- getAudienceManagerBlob
- getSupplementalDataID
- getCustomerIDs
- getSupplementalDataID
- getMarketingCloudVisitorID