método de criação DIL dil-create

WARNING
A partir de julho de 2023, o Adobe descontinuou o desenvolvimento da extensão Data Integration Library (DIL) e DIL.
Os clientes existentes podem continuar usando a implementação DIL. Entretanto, o Adobe não desenvolverá DIL além deste ponto. Os clientes são incentivados a avaliar o SDK da Web do Experience Platform para sua estratégia de coleta de dados de longo prazo.
Os clientes que desejam implementar novas integrações de coleção de dados após julho de 2023 devem usar o SDK da Web do Experience Platform.

criar DIL dil-create-new

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

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

Elementos initConfig

IMPORTANT
A propriedade visitorService é sempre necessária. Outras propriedades listadas aqui são opcionais, a menos que indicado de outra forma.

initConfig aceita os seguintes elementos:

Nome
Tipo
Descrição
containerNSID
Número inteiro

Esta propriedade configura a ID de contêiner usada por Audience Manager para sincronizações de ID. Você definiria containerNSID se tiver o 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 Adobe Experience Platform Identity Service do , a propriedade idSyncContainerID corresponde a containerNSID no DIL . Observe o seguinte se estiver usando o DIL e o serviço de ID em vários sites:

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 criará identificadores com codificação dupla.

Observação: se você usar o Serviço de Identidade Adobe Experience Platform, defina IDs do cliente com o método setCustomerIDs em vez do DIL . Consulte IDs do cliente e Estados de autenticação.

delayAllUntilWindowLoad
Booleano
Se verdadeiro, adia todas as solicitações (IFRAME, chamadas de evento, sincronização de ID e destino) da execução até o evento Page Load ser disparado. O padrão é false .
disableDeclaredUUIDCookie
Booleano
Falso por padrão, o que significa que o Audience Manager define um cookie no domínio do parceiro (define um cookie próprio).
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 de visitor.disableIdSyncs 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 o DIL versão 8.0 (lançado em agosto de 2018). Em vez disso, use a função de visitor.disableIdSyncs 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 função visitorService (veja o código de exemplo abaixo) controla essa operação.

enableErrorReporting
Booleano
Defina como true para habilitar o relatório de erros para todas as instâncias do DIL na página. Funciona somente com true booleano.
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 de visitor.idSyncSSLUseAkamai no Serviço de Identidade da Adobe Experience Platform.

Especifica se o modelo de publicação de destino deve usar Akamai para 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.

O par de valor-chave namespace contém sua ID da organização de 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 visualizar este painel. Consulte as Perguntas Frequentes sobre Recursos e Funções do Produto e Administração do - Gerenciamento de Usuários e Perguntas Frequentes.

partner
String

Obrigatório.

Nome do parceiro fornecido por Audience Manager .

removeFinishedScriptsAndCallbacks
Booleano
Remove scripts e retornos de chamada. O padrão é False . Aplica-se somente à instância do DIL atual. Lançado com a v3.3.
uuidCookie
Objeto
Define um cookie com a identificação de usuário exclusiva retornada de Audience Manager . Consulte Propriedades de uuidCookie.
visitorService
Objeto

Exigido com DIL 6.2 ou superior.

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

Código de exemplo

Uma chamada de exemplo 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 uuidcookie-props

Define as propriedades usadas pela variável uuidCookie. Esta 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
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 é o padrão).
secure
Define um sinalizador para enviar dados somente por uma conexão HTTPS.

Propriedades do visitorService visitor-service-props

Define as propriedades usadas pela variável visitorService. Esta 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 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"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695