Show Menu
TÓPICOS×

Método de criação DIL

Criar DIL

Cria uma DIL instância específica do parceiro.
Assinatura da função: DIL.create: function (initConfig) {}
elementos initConfig
A visitorService propriedade é sempre obrigatória. Outras propriedades listadas aqui são opcionais, salvo indicação em contrário.
initConfig aceita os seguintes elementos:
Nome Tipo Descrição
containerNSID
Número inteiro
Essa propriedade configura a ID de contêiner usada pelo Audience Manager para sincronizações de ID. Você definiria containerNSID se tiver DIL implantado em vários sites. Cada um desses sites terá suas próprias sincronizações de ID e ID de container. Quando você tem apenas um site, a ID do container é 0 por padrão e não é necessário defini-la corretamente. Entre em contato com seu consultor para obter uma lista dos seus sites e suas IDs de container.
No Adobe Experience Platform Identity Service , a propriedade idSyncContainerID corresponde a containerNSID no DIL . Observe o seguinte se você estiver usando DIL e o serviço de ID em vários sites :
  • Para cada site, defina as mesmas IDs de container em containerNSID e idSyncContainerID .
  • O DIL e o serviço de ID tentarão enviar sincronizações de ID para o iFrame da coleção de dados. No entanto, o iFrame garante que o DIL não dispare uma sincronização de ID. Isso evita a duplicação.
  • Somente DIL envia dados para um destino de URL .
Consulte também idSyncContainerID .
declaredId
Objeto
delcaredId é usado para passar em:
  • dpid : ID do parceiro de dados atribuída a você pelo Gerenciador de Audiências .
  • dpuuid : Sua ID exclusiva para um usuário.
Importante: Use apenas valores não codificados para suas IDs. A codificação das cria identificadores duplamente codificados.
Observação: Se você usar o Adobe Experience Platform Identity Service , defina as IDs do cliente com o setCustomerIDs método em vez de DIL . See Customer IDs and Authentication States .
delayAllUntilWindowLoad
Booleano
Se verdadeiro, difere todas as solicitações (IFRAME, chamadas de evento, sincronização de ID e destino) da execução até que o Page Load evento seja acionado. O padrão é false .
disableDeclaredUUIDCookie
Booleano
Falso por padrão, o que significa que o Gerenciador de Audiências define um cookie no domínio do parceiro (define um cookie primário).
disableDestinationPublishingIframe
Booleano
Importante: Este elemento foi descontinuado com o DIL versão 8.0 (lançado em agosto de 2018). Em vez disso, use a visitor.disableIdSyncs função disableidsync.html no Adobe Experience Platform Identity Service.
Se true , não anexará a IFRAME de publicação de destino ao DOM ou acionará destinos. O padrão é false .
disableIDSyncs
Booleano
Importante: Este elemento foi descontinuado com o DIL versão 8.0 (lançado em agosto de 2018). Em vez disso, use a visitor.disableIdSyncs função disableidsync.html no Adobe Experience Platform Identity Service.
Desativa a sincronização de ID. Você deve desativar as sincronizações de ID ao usar o DIL v6.2+ e o Serviço de ID de Visitante. A visitorService função (consulte o código de amostra abaixo) cuida dessa operação.
enableErrorReporting
Booleano
Defina como true para ativar o relatórios de erro para todas as instâncias DIL na página. Funciona somente com Booleano true .
iframeAkamaiHTTPS
Booleano
Importante: Este elemento foi descontinuado com o DIL versão 8.0 (lançado em agosto de 2018). Em vez disso, use a visitor.idSyncSSLUseAkamai função idsyncssluseakamai.html no Adobe Experience Platform Identity Service.
Especifica se o modelo de publicação de destino deve usar Akamai para as conexões HTTPS. Ativado pelo parceiro.
mappings
Objeto
Associa o valor de um par de valores chave a outro. Consulte Mapear valores principais para outras chaves . Lançado com v2.4.
namespace
String
Obrigatório.
O par de namespace chave-valor contém a ID de empresa da Experience Cloud . Se você não tiver essa ID, poderá encontrá-la na seção Administração do painel da Experience Cloud . Você precisa de permissões de administrador para visualização deste painel. Consulte as Perguntas frequentes sobre recursos e funções do produto e Administração - Gerenciamento de usuários e perguntas frequentes .
partner
String
Obrigatório.
Nome do parceiro, conforme fornecido pelo gerente de Audiências .
removeFinishedScriptsAndCallbacks
Booleano
Remove scripts e retornos de chamada. O padrão é False . Aplica-se somente à instância DIL atual . Lançado com v3.3.
uuidCookie
Objeto
Define um cookie com a ID de usuário exclusiva retornada pelo Gerenciador de Audiências . Consulte Propriedades uidCookie .
visitorService
Objeto
Obrigatório com DIL 6.2 ou superior.
O DIL depende da setCustomerIDs função no Adobe Experience Platform Identity Service para passar as IDs declaradas para o Audiência Manager . Consulte IDs do cliente e Estados de autenticação para obter mais informações.
Código de exemplo
Uma DIL chamada de amostra pode ser semelhante ao seguinte:
var partnerObject1 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-ORGANIZATION-ID-HERE" 
  }, 
  containerNSID: 3, 
  uuidCookie:{ 
    name:'ad_uuid', 
    days:200, 
    path:'/test', 
    domain:'adobe.com', 
    secure:true 
  } 
}); 
 
var partnerObject2 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-MCORG-ID-HERE" 
  }, 
  containerNSID: 3 
}); 

Uma resposta bem-sucedida retorna a DIL instância. Uma tentativa malsucedida retornará um objeto de erro (não lançado) se o código estiver configurado incorretamente ou sempre que um erro for encontrado.

Propriedades do uidCookie

Define as propriedades usadas pela uuidCookie variável. Essa variável faz parte do DIL.create método.
uuidCookie tem as seguintes propriedades:
Nome
Descrição
name
The cookie name ( aam_did is default).
days
Duração do cookie (100 dias é padrão).
path
Caminho do cookie, por exemplo, '/test' ( / é padrão).
domain
O domínio em que o cookie está definido, por exemplo, 'adobe.com' ( '.'+document.domain é padrão).
secure
Define um sinalizador para enviar dados somente por uma conexão HTTPS.

propriedades do visitorService

Define as propriedades usadas pela visitorService variável. Essa variável faz parte do DIL.create método.
visitorService tem as seguintes propriedades:
Nome
Tipo
Descrição
namespace
String
Obrigatório. Representa A Experience Cloud Org ID. Isso é necessário para a funcionalidade do serviço principal da Experience Cloud. O mesmo parâmetro usado para instanciar a funcionalidade da ID do Visitante.
Amostra de código:
var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});