método de criação DIL dil-create
criar DIL dil-create-new
Cria uma instância DIL específica do parceiro.
Assinatura da Função: DIL.create: function (initConfig) {}
Elementos initConfig
visitorService
é sempre necessária. Outras propriedades listadas aqui são opcionais, a menos que indicado de outra forma.initConfig
aceita os seguintes elementos:
containerNSID
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:
- - Para cada site, defina as mesmas IDs de contêiner em
containerNSID
eidSyncContainerID
.- 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
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
Page Load
ser disparado. O padrão é false
.disableDeclaredUUIDCookie
disableDestinationPublishingIframe
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
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.
enableErrorReporting
true
para habilitar o relatório de erros para todas as instâncias do DIL na página. Funciona somente com true
booleano.iframeAkamaiHTTPS
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.
mappings
namespace
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
Obrigatório.
Nome do parceiro fornecido por Audience Manager .
removeFinishedScriptsAndCallbacks
False
. Aplica-se somente à instância do DIL atual. Lançado com a v3.3.uuidCookie
visitorService
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:
name
aam_did
é padrão).days
path
'/test'
( /
é padrão).domain
'adobe.com'
( '.'+document.domain
é o padrão).secure
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:
namespace
Amostra de código:
var vDil = DIL.create({
partner: 'demofirst',
visitorService: {
namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
}
});