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.

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 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.
TIP
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 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.
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 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.

Caso de uso
Métodos suportados
Caso 1
  • getMarketingCloudID
  • getAudienceManagerLocationHint
  • getAudienceManagerBlob
  • getSupplementalDataID
  • getCustomerIDs
Caso 2
  • getSupplementalDataID
  • getMarketingCloudVisitorID
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a