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

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

DIL create 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 define a ID de contêiner usada pelo 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 Serviço de Identidade do Adobe Experience Platform , a propriedade idSyncContainerID corresponde a containerNSID em DIL . Observe o seguinte se você estiver usando o 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 .
  • O DIL e 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 o DIL não acione uma sincronização de ID. Isso evita a duplicação.
  • Somente o DIL envia dados para um destino de 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 criará identificadores com codificação dupla.

Observação: se você usar o Adobe Experience Platform Identity Service, defina 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 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 visitor.disableIdSyncs de 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 visitor.disableIdSyncs de 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 visitor.idSyncSSLUseAkamai de 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 do 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 ID de usuário exclusiva retornada do 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 da 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