método DIL create

Criar DIL

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

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

elementos initConfig

IMPORTANTE

A propriedade visitorService é always 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 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 em 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 .
  • Tanto DIL quanto 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 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

declaredId é usado para passar em:

  • dpid : ID do parceiro de dados atribuída a você por 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, difere todas as solicitações (IFRAME, chamadas de evento, sincronização de ID e destino) da execução até que o evento Page Load seja acionado. O padrão é false .

disableDeclaredUUIDCookie

Booleano

Falso por padrão, o que significa que Audience Manager define um cookie no domínio do parceiro (define um cookie primário).

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 , não anexará o IFRAME de publicação de destino ao DOM ou acionará destinos. 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 do 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órios de erro para todas as instâncias DIL na página. Funciona somente com Boolean 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 de chave para outras chaves . Lançado com v2.4.

namespace

String

Obrigatório.

O par namespace key-value contém a sua ID de empresa Experience Cloud . Se você 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 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 por Audience Manager .

removeFinishedScriptsAndCallbacks

Booleano

Remove scripts e retornos de chamada. O padrão é False . Aplica-se somente à instância atual DIL . Lançado com v3.3.

uuidCookie

Objeto

Define um cookie com a ID de usuário exclusiva retornada de Audience Manager . Consulte Propriedades 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 transferir IDs declaradas para Audience Manager . Consulte IDs do cliente e Estados de autenticação para obter mais informações.

Código de exemplo

Uma chamada de amostra DIL poderia 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 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 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' ( / é o padrão).
domain O domínio no qual 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 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 De Experience Cloud. Isso é necessário para a funcionalidade do serviço Experience Cloud Core. 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" 
    } 
});

Nesta página