whitelistParentDomain e whitelistIframeDomains whitelistparentdomain-and-whitelistiframedomains
Essas configurações permitem que diferentes instâncias do código do Serviço de ID de visitante implementado em um iFrame e na página pai se comuniquem entre si. Foram projetadas para ajudar a resolver problemas com 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 do visitante sendo carregado no iFrame de um domínio sob seu controle. Eles estão disponíveis na versão 2.2 ou superior do código VisitorAPI.js.
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 Visitor ID Service código configurado é semelhante ao deste exemplo.
//Instantiate Visitor
var visitor = Visitor.getInstance("INSERT-IMS-ORG-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 do Serviço de ID de visitante 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 de visitante não está instalado na página principal, mas é implementado em um iFrame.
Caso de uso 1: o navegador bloqueia cookies de terceiros e o serviço de ID de visitante é 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 de visitante em suas home pages.
- A Empresa A implementa o Serviço de ID de visitante 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 de visitante 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 de visitante:
- 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 do visitante defina o cookie AMCV.
Modifique a função Visitor.getInstance do Serviço de ID do visitante 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 de visitante no iFrame verifique o código do Serviço de ID de visitante na página pai de uma ID de visitante.
Se o código do Serviço de ID de visitante 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 de Visitante
Este caso de uso inclui as seguintes condições:
- A Empresa A não usa o Serviço de ID de visitante.
- 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 de visitante:
- 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 do visitante 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 do visitante 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 de visitante no iFrame verifique o código do Serviço de ID de visitante na página pai de uma ID de visitante.
Se o código do Serviço de ID de visitante 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 de visitante implementado no domínio pai e o domínio iFrame devem usar a mesma ID da organização IMS. Essas configurações de lista branca não funcionarão quando as IDs da organização IMS 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 de visitante 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 de visitante 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