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 você tivesse DIL implantado em vários sites. Cada um desses sites terá sua própria ID de contêiner e sincronizações de ID. Quando você tem apenas um site, a ID do contêiner é 0 por padrão e não é necessário defini-la corretamente. Entre em contato com o seu consultor para obter uma lista dos seus sites e as IDs do contêiner.
No serviço da Experience Cloud ID , 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 do contêiner 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 .
declaradaId
Objeto
delcareId é usado para passar em:
  • dpid : ID do parceiro de dados atribuída a você pelo Audience Manager .
  • 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 Serviço da Experience Cloud ID , defina as IDs do cliente com o método setCustomerIDs em vez de DIL . See Customer IDs and Authentication States .
delayAllThroughWindowLoad
Booleano
Se verdadeiro, difere a execução de todas as solicitações (IFRAME, chamadas de evento, sincronização de ID e destino) até que o evento Carregamento de página seja acionado. Default is false .
disableDeclarredUIDCookie
Booleano
Falso por padrão, o que significa que o Audience Manager 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 função visitor.disableIdSyncs no serviço da Experience Cloud ID mcvid-disableidsync.html .
Se verdadeiro , não anexará a IFRAME de publicação de destino ao DOM ou acionará destinos. Default is 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 função visitor.disableIdSyncs no serviço da Experience Cloud ID mcvid-disableidsync.html .
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 função visitorService (consulte a amostra de código abaixo) cuida dessa operação.
enableErrorReporting
Booleano
Defina como true para ativar o relatório de erros para todas as instâncias DIL na página. Funciona somente com Boolean 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 função visitor.idSyncSSLUseAkamai no serviço da Experience Cloud ID mcvid-idSyncSSLUseAkamai.html .
Especifica se o modelo de publicação de destino deve usar Akamai para as conexões HTTPS. Ativado pelo parceiro.
mapeamentos
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 valores-chave do namespace contém sua Experience Cloud Organization ID. Se você não tiver essa ID, poderá encontrá-la na seção Administração do Experience Cloud ashboard. Você precisa de permissões de administrador para exibir este painel. Consulte as Perguntas frequentes sobre recursos e funções do produto e Administração - Gerenciamento de usuários e perguntas frequentes .
sócio
String
Obrigatório.
Nome do parceiro, conforme fornecido pelo Audience Manager .
removeFinishedScriptsAndCallbacks
Booleano
Remove scripts e retornos de chamada. Default is False . Aplica-se somente à instância DIL atual . Lançado com v3.3.
uidCookie
Objeto
Define um cookie com a ID de usuário exclusiva retornada pelo Audience Manager . Consulte Propriedades uidCookie .
visitorService
Objeto
Obrigatório com DIL 6.2 ou superior.
O DIL depende da função setCustomerIDs no serviço da Experience Cloud ID para passar as IDs declaradas para o Audience 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" 
    } 
});