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

WARNING
A partir de julho de 2023, a Adobe interrompeu o desenvolvimento do Data Integration Library (DIL) e a variável DIL extensão.
Os clientes existentes podem continuar usando seus DIL execução. No entanto, o Adobe não estará em desenvolvimento DIL além deste ponto. Os clientes são incentivados a avaliar Experience Platform Web SDK para a sua estratégia de recolha de dados a longo prazo.
Os clientes que desejam implementar novas integrações de coleta de dados após julho de 2023 devem usar Experience Platform Web SDK em vez disso.

Criar DIL dil-create-new

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

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

Elementos initConfig

IMPORTANT
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çãono 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çãono 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çãono 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 produtoe 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 uuidcookie-props

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 visitor-service-props

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"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695