método DIL create

Criar DIL

Cria uma instância DIL específica do parceiro.

Assinatura da função: DIL.create: function (initConfig) {}

Elementos de initConfig

IMPORTANTE

A propriedade visitorService é sempre necessá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 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 1 site, a ID do contêiner é 0 por padrão e não é necessário definir isso corretamente. Entre em contato com seu consultor para obter uma lista dos sites e as IDs do contêiner.

No Adobe Experience Platform Identity Service , a propriedade idSyncContainerID corresponde a containerNSID no DIL . Observe o seguinte se estiver usando DIL e o serviço de ID em vários sites:

  • Para cada site, defina as mesmas IDs de contêiner em containerNSID e idSyncContainerID .
  • Tanto o DIL quanto o serviço de ID tentarão enviar sincronizações de ID para nosso iFrame de coleta de dados. No entanto, o iFrame garante que DIL não acione 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

declaredId é usado para transmitir qualquer um dos seguintes itens:

  • 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 Adobe Experience Platform Identity Service , defina as IDs do cliente com o método setCustomerIDs em vez de DIL . Consulte IDs do cliente e Estados de autenticação .

delayAllUntilWindowLoad

Booleano

Se verdadeiro, adia a execução de todas as solicitações (IFRAME, chamadas de evento, sincronização de ID e destino) até que o evento Page Load seja acionado. O padrão é false .

disableDeclaredUUIDCookie

Booleano

Falso por padrão, o que significa Audience Manager define um cookie no domínio do parceiro (define um cookie próprio).

disableDestinationPublishingIframe

Booleano

Importante: Este elemento foi descontinuado com DIL versão 8.0 (lançado em agosto de 2018). Em vez disso, use a função visitor.disableIdSyncs no Adobe Experience Platform Identity Service.

Se true , o não anexará o IFRAME de publicação de destino aos destinos DOM ou fire. O padrão é false .

disableIDSyncs

Booleano

Importante: Este elemento foi descontinuado com DIL versão 8.0 (lançado em agosto de 2018). Em vez disso, use a função visitor.disableIdSyncs 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 função visitorService (consulte o código de amostra 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 Booleano true .

iframeAkamaiHTTPS

Booleano

Importante: Este elemento foi descontinuado com DIL versão 8.0 (lançado em agosto de 2018). Em vez disso, use a função visitor.idSyncSSLUseAkamai 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 valor da chave namespace contém a ID da organização Experience Cloud . Se não tiver essa ID, poderá encontrá-la na seção Administração do painel Experience Cloud . 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 .

partner

String

Obrigatório.

Nome do parceiro, conforme fornecido por Audience Manager .

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 de Audience Manager . Consulte Propriedades do uuidCookie .

visitorService

Objeto

Obrigatório com DIL 6.2 ou superior.

O DIL depende da função setCustomerIDs no Adobe Experience Platform Identity Service para transmitir IDs declaradas para Audience Manager . Consulte IDs do cliente e Estados de autenticação para obter mais informações.

Código de exemplo

Um exemplo de chamada DIL 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 instância DIL. Uma tentativa malsucedida retorna um objeto de erro (não lançado) se o código for configurado incorretamente ou sempre que um erro for encontrado.

Propriedades de uuidCookie

Define as propriedades usadas pela variável uuidCookie. Essa variável faz parte do método DIL.create.

uuidCookie tem as seguintes propriedades:

Nome Descrição
name O nome do cookie ( aam_did é padrão).
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 é 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 variável visitorService. Essa variável faz parte do método DIL.create.

visitorService tem as seguintes propriedades:

Nome Tipo Descrição
namespace String Obrigatório. Representa A ID De Organização Do Experience Cloud. Isso é necessário para a funcionalidade do Experience Cloud Core Service. O mesmo parâmetro usado para instanciar a funcionalidade da ID de visitante.

Amostra de código:

var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});

Nesta página