Show Menu
TOPICS×

whitelistParentDomain e 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

Ambos os elementos de configuração são necessários ao usar esse código.
Sintaxe de 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 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.
Você também pode implementar essas configurações quando estiver disponibilizando vídeo em um iFrame com o Video Heartbeat . O Video Heartbeat precisa de uma ID de serviço de ID (a MID) para funcionar corretamente.
Caso de uso 1: O navegador bloqueia cookies de terceiros e o serviço de ID é implementado no iFrame e na página pai
Elemento de caso de uso
Descrição
Condições
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.
Resultados
Dadas essas condições, o serviço de ID:
  • Funciona corretamente na página principal. Ele 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: 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
Elemento de caso de uso
Descrição
Condições
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.
Resultados
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.
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 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

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.
Caso de uso
Métodos suportados
Caso 1
  • getMarketingCloudID
  • getAudienceManagerLocationHint
  • getAudienceManagerBlob
  • getSupplementalDataID
  • getCustomerIDs
Caso 2
  • getSupplementalDataID
  • getMarketingCloudVisitorID