whitelistParentDomain e whitelistIframeDomains whitelistparentdomain-and-whitelistiframedomains
Essas configurações permitem que diferentes instâncias do código do serviço de ID implementado em um iFrame e na página pai se comuniquem entre si. Foram projetadas para ajudar a resolver problemas com 2 casos de uso específicos onde pode-se ou não controlar a página ou o domínio principal e onde há código do serviço de ID sendo carregado no iFrame de um domínio sob seu controle. Eles estão disponíveis no código VisitorAPI.js versão 2.2 ou superior.
Conteúdo:
Sintaxe section-f645198bbaba4fba8961acb6e88d1470
Ambos os elementos de configuração são necessários ao usar esse código.
Amostra de código section-09d0049fe88a473baa69d404c50bf8ae
O código do serviço de ID configurado é semelhante ao deste exemplo.
//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"],
...
}
);
Casos de uso section-fc2eeb93546b406fae3b102dbcd11de7
Essas configurações ajudam a resolver o problema de configuração de um cookie de serviço de ID e atribuição de uma ID de visitante quando os navegadores bloqueiam cookies de terceiros e se qualquer uma dessas condições se aplicar:
- Você controla ou não a página/domínio pai.
- O código do serviço de ID não está instalado na página pai, mas é implementado em um iFrame.
Caso de uso 1: O navegador bloqueia cookies de terceiros e o serviço de ID é implementado no iFrame e na página pai
Este caso de uso inclui as seguintes condições:
- A Empresa A implementa o serviço de ID em suas home pages.
- A Empresa A implementa o serviço de ID no iFrame na sua home page.
- A Empresa A é proprietária da página pai e do iFrame e implementou o serviço de ID em ambos os locais.
- Um cliente carrega a página pai em um navegador que bloqueia cookies de terceiros.
Dadas essas condições, o serviço de ID:
- Funciona corretamente na página principal. Ele solicita e define o cookie AMCV e atribui um identificador exclusivo ao visitante do site.
- Não funciona no iFrame. Isso ocorre porque o navegador vê o iFrame como um domínio de terceiros e impede que o serviço de ID defina o cookie AMCV.
Modifique a função Visitor.getInstance do serviço de ID no iFrame com essas configurações de lista de permissões. Especifique os domínios pai e filho no código. Essas configurações permitem que o código do serviço de ID no iFrame verifique o código do serviço de ID na página pai de uma ID de visitante.
Se o código do serviço de ID no iFrame não receber uma página pai de resposta, essas configurações geram uma ID de visitante local.
Caso de uso 2: Solicitação de uma ID de um iFrame incorporado em uma página pai que você não controla ou que não usa o serviço de ID
Este caso de uso inclui as seguintes condições:
- A Empresa A não usa o serviço de ID.
- A Empresa A carrega um iFrame na página. Este iFrame pertence à Empresa B e é carregado em um domínio diferente da Empresa A.
- O navegador bloqueia cookies de terceiros.
Dadas essas condições, o serviço de ID:
- Não funciona no iFrame. Isso ocorre porque o navegador vê o iFrame como um domínio de terceiros e impede que o serviço de ID defina o cookie AMCV.
- Não é possível obter uma ID de visitante da página principal porque a Empresa A não usa esse serviço.
Modifique a função Visitor.getInstance do serviço de ID no iFrame com essas configurações de lista de permissões. Especifique os domínios pai e filho no código. Essas configurações permitem que o código do serviço de ID no iFrame verifique o código do serviço de ID na página pai de uma ID de visitante.
Se o código do serviço de ID no iFrame não receber uma página pai de resposta, essas configurações geram uma ID de visitante local.
Segurança e proteção da configuração section-2b1ce31fab034e1ca0f6b1c3cc57a6e2
É possível implementar essas configurações com segurança porque:
- O serviço de ID implementado no domínio pai e o domínio iFrame devem usar a mesma ID da organização. Essas configurações de lista branca não funcionarão quando as IDs da organização no pai ou no iFrame forem diferentes.
- Essas configurações só se comunicam com o domínio e os iFrames especificados no código.
- A comunicação entre o iFrame e a página pai segue um formato específico. Se o serviço de ID na página pai não receber uma solicitação no formato esperado, esse processo de compartilhamento falhará.
Métodos de API do visitante suportados section-30c6a9f4dcdc4265a1149260b97cc057
O serviço de ID oferece suporte a um conjunto limitado de métodos de API públicos ao implementar essas configurações de lista branca. Os métodos suportados variam de acordo com os cenários de caso de uso descritos acima.
- getMarketingCloudID
- getAudienceManagerLocationHint
- getAudienceManagerBlob
- getSupplementalDataID
- getCustomerIDs
- getSupplementalDataID
- getMarketingCloudVisitorID