método de criação DIL

Criar DIL

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

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

Elementos initConfig

IMPORTANTE

A variável visitorService propriedade é sempre obrigatório. Outras propriedades listadas aqui são opcionais, a menos que indicado de outra forma.

initConfig O 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ê tiver 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 você não precisa defini-lo corretamente. Entre em contato com seu consultor da para obter uma lista dos sites e suas IDs de contêiner.

No Serviço de identidade da Adobe Experience Platform , a propriedade idSyncContainerID corresponde a containerNSID in 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 .
  • Ambos DIL e o serviço de ID tentará enviar sincronizações de ID para nosso iFrame de coleta de dados. No entanto, o iFrame garante que DIL não acionará uma sincronização de ID. Isso evita a duplicação.
  • Somente DIL envia dados a um Destino do URL .

Consulte também, idSyncContainerID .

declaredId

Objeto

declaredId é usado para transmitir:

  • dpid : ID do parceiro de dados atribuída a você por Audience Manager .
  • dpuuid : seu identificador exclusivo 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 a variável Serviço de identidade da Adobe Experience Platform , defina as IDs do cliente com o setCustomerIDs método em vez de DIL . Consulte Estados de autenticação e IDs do cliente .

delayAllUntilWindowLoad

Booleano

Se verdadeiro, adia todas as solicitações (IFRAME, chamadas de evento, sincronização de ID e destino) da execução até a variável Page Load evento é 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 primário).

disableDestinationPublishingIframe

Booleano

Importante: este elemento foi descontinuado com DIL versão 8.0 (lançada em agosto de 2018). Use o visitor.disableIdSyncs função no Serviço de identidade da Adobe Experience Platform.

Se true , 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çada em agosto de 2018). Use o visitor.disableIdSyncs função no Serviço de identidade da Adobe Experience Platform.

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 variável visitorService A função (consulte código de amostra abaixo) cuida dessa operação.

enableErrorReporting

Booleano

Defina como true para ativar o relatório de erros para todos DIL instâncias na página. Funciona com booleano true somente.

iframeAkamaiHTTPS

Booleano

Importante: este elemento foi descontinuado com DIL versão 8.0 (lançada em agosto de 2018). Use o visitor.idSyncSSLUseAkamai função no Serviço de identidade da Adobe Experience Platform.

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 valor-chave a outro. Consulte Mapear valores de chave para outras chaves . Lançado com a v2.4.

namespace

String

Obrigatório.

A variável namespace O par de valor-chave contém o Experience Cloud ID da organização. Se você não tiver essa ID, poderá encontrá-la na Administração seção do Experience Cloud painel. Você precisa de permissões de administrador para visualizar este painel. Consulte a 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 ao atual DIL somente instância. Lançado com a v3.3.

uuidCookie

Objeto

Define um cookie com a ID de usuário exclusiva retornada de Audience Manager . Consulte Propriedades de uuidCookie .

visitorService

Objeto

Obrigatório com DIL 6.2 ou superior.

O DIL depende do setCustomerIDs na caixa Serviço de identidade da Adobe Experience Platform para transmitir 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 amostra DIL A chamada do 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 variável DIL instância. 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 variável. Essa variável faz parte da variável DIL.create método.

uuidCookie tem as seguintes propriedades:

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

visitorService tem as seguintes propriedades:

Nome Tipo Descrição
namespace String Obrigatório. Representa A ID Da Organização Experience Cloud. Isso é necessário para a funcionalidade do Serviço principal de Experience Cloud. Mesmo parâmetro usado para instanciar a funcionalidade ID de visitante.

Amostra de código:

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

Nesta página