Show Menu
TOPICS×

whitelistParentDomain e whitelistIframeDomains

Essas configurações permitem que diferentes instâncias do código do serviço de ID que foram implementados em um iFrame e na página principal comuniquem-se 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 sendo carregado no iFrame de um domínio sob seu controle. Elas estão disponíveis no código da versão 2.2 ou posterior de VisitorAPI.js.
Conteúdo:

Sintaxe

Os elementos de configuração são necessários ao usar esse código.
Sintaxe da configuração
Descrição
whitelistParentDomain: "
Nome do domínio da página principal
"
Aceita um único nome de domínio passado como uma sequência de caracteres.
whitelistIframeDomains: [
"Domínio do iFrame","Domínio do iFrame", "Domínio do iFrame"
]
Aceita um ou mais nomes de domínio do iFrame passados como um array.

Amostra de código

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

Essas configurações ajudam a solucionar o problema de configuração de um cookie do serviço de ID e atribuir uma ID de visitante quando os navegadores bloqueiam os cookies de terceiros, bem como quando uma destas condições se aplicar:
  • Você controla ou não a página/domínio principal.
  • O código do serviço de ID não é instalado na página principal, mas é implementado em um iFrame.
You may also want to implement these configurations when you're serving video in an iFrame with Video Heartbeat . A Pulsação de vídeo exige que a ID do serviço de ID (a MID) funcione adequadamente.
Caso de uso 1: o navegador bloqueia os cookies de terceiros e o serviço de ID é implementado no iFrame e na página principal
Elemento do caso de uso
Descrição
Condições
Esse caso de uso inclui as seguintes condições:
  • A empresa A implementa o serviço de ID em sua home page.
  • A empresa A implementa o serviço de ID no iFrame da sua home page.
  • A Empresa A é proprietária da página principal e do iFrame, além de ter implementado o serviço de ID em ambos.
  • Um cliente carrega a página principal em um navegador que bloqueia cookies de terceiros.
Resultados
Considerando essas condições, o serviço de ID:
  • Funciona adequadamente na página principal. Solicita e define o cookie AMCV e atribui uma ID exclusiva 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.
Soluçã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.
Caso de uso 2: solicitar uma ID de um iFrame incorporado em uma página principal que você não controla ou que não use o serviço de ID
Elemento do caso de uso
Descrição
Condições
Esse 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. Esse iFrame é de propriedade da empresa B e é carregado em um domínio separado da empresa A.
  • O navegador bloqueia os cookies de terceiros.
Resultados
Considerando 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, pois a Empresa A não usa esse serviço.
Soluçã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

É possível implementar essas configurações com segurança porque:
  • O serviço de ID implementado em um domínio principal e o domínio do iFrame devem usar a mesma ID da organização. Essas configurações de lista de permissões não funcionam quando as IDs da empresa no principal e no iFrame são diferentes.
  • Essas configurações se comunicam somente com o domínio e os iFrames especificados no código.
  • A comunicação entre o iFrame e a página principal segue um formato específico. Se o serviço de ID na página principal não recebe uma solicitação no formato esperado, ocorre falha no processo de compartilhamento.

Métodos de API do visitante suportados

O serviço de ID oferece suporte a um conjunto limitado de métodos de API pública ao implementar essas configurações de lista de permissões. Os métodos suportados variam de acordo com os cenários de caso de uso descritos acima.
Caso de uso
Métodos suportados
Caso 1
  • getMarketingCloudID
  • getAudienceManagerLocationHint
  • getAudienceManagerBlob
  • getSupplementalDataID
  • getCustomerIDs
Caso 2
  • getSupplementalDataID
  • getMarketingCloudVisitorID