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.
O nível da instância DIL As APIs permitem criar e trabalhar programaticamente com objetos Audience Manager. Os métodos de nível de instância aprimoram a funcionalidade da API estabelecida pelos métodos de nível de classe.
Ao trabalhar com o nível de instância DIL APIs:
Adiciona mapeamentos de nível de cliente e plataforma à sequência de consulta de uma solicitação pendente.
Assinatura da Função: signals: function ({key1:value1, key2:value2},prefix){}
submit()
O aguarda a nuvem definir um cookie antes de enviar uma solicitação.Chaves de solicitação reservadas
As chaves de solicitação a seguir estão reservadas e não podem ser substituídas por este método:
sids
pdata
logdata
callback
postCallbackFn
useImageRequest
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
obj |
Objeto | Um objeto que representa os pares de valores chave para mapeamentos no nível da plataforma. O parâmetro aceita strings e matrizes como valores de propriedade no objeto. |
prefix |
String | Opcional. O valor da string prefixado para cada chave do objeto (substitui a chave original). |
return |
DIL.api | Retorna o objeto de API da instância de DIL atual. |
Resposta
Retorna o objeto de API do atual DIL instância.
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName'
containerNSID: containerNSID
});
// Method 1
var obj = { key1 : 1, key2 : 2 };
dataLib.api.signals(obj, 'c_').submit();
// Method 2
dataLib.api.signals({c_zdid: 54321}).submit();
// Method 3
// Will send 'c_key=a&c_key=2&c_key=3' to Audience Manager
var obj = { key : ['a', 'b', 'c'] };
dataLib.api.signals(obj, 'c_').submit();
Adiciona SIDs à sequência de consulta de uma solicitação pendente.
Assinatura da função: traits:function (sids){}
Você pode encadear outras chamadas de API a esse método.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sids |
Matriz | IDs de segmento de característica em uma matriz. |
Resposta
Retorna o objeto de API do atual DIL instância.
Código de exemplo
var partnerObject = DIL.create({
partner: 'partner name',
containerNSID: NSID
});
partnerObject.api.traits([123, 456, 789]);
Adicionar dados aos arquivos de log na solicitação pendente.
Assinatura da função: logs: function {key1:value1, key2:value2}
Resposta
Retorna o objeto de API do atual DIL instância.
Código de exemplo
var partnerObject = DIL.create({
partner: 'partner',
containerNSID: NSID
});
partnerObject.api.logs({
file: 'dil.js',
message: 'This is the first request'
});
Envia todos os dados pendentes para o Audience Manager para o DIL instância.
Assinatura da Função: submit: function () {}
Você pode encadear outras chamadas de API a esse método. Além disso, DIL grava dados codificados em um cookie de destino. Por exemplo, espaços são codificados como %20
e ponto e vírgula como %3B
.
Resposta
Retorna o objeto de API do atual DIL instância.
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName',
containerNSID: containerNSID
});
dataLib.api.traits([
123,456, 789]).logs({
file: 'dil.js',
message: 'This is the first request'
}).signals({
c_zdid: 1111
d_dma: 'default'
}).submit();
Uma função que é executada após o retorno de chamada de publicação de destino padrão.
Assinatura da Função: afterResult: function (fn) {}
Você pode encadear outras chamadas de API a esse método.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
fn |
Função | A função que você deseja executar depois que o JSON é processado pelo retorno de chamada padrão que lida com a publicação de destino. |
Resposta
Retorna um objeto de API do atual DIL instância.
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName',
containerNSID: containerNSID
});
dataLib.api.signals({
c_zdid: 54321
d_dma: 'default'
}).afterResult(function(json){
//Do something with the JSON data returned from the server.
}).submit();
Limpa todos os dados em uma solicitação pendente.
Assinatura da Função: clearData: function () {}
Você pode encadear outras chamadas de API a esse método.
Resposta
Retorna o objeto de API do atual DIL instância.
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName',
containerNSID: containerNSID
});
dataLib.api.traits([123,456, 789]).logs({
file: 'dil.js'
message: 'This is the first request'
}).signals({
c_zdid: 1111
d_dma: 'default'
});
//Reset the pending data
dataLib.clearData();
Adiciona parâmetros de consulta personalizados não definidos explicitamente pelo servidor de coleta de dados a uma solicitação pendente.
Assinatura da Função: customQueryParams: function (obj) {}
Você pode encadear outras chamadas de API a esse método.
Chaves de solicitação reservadas
As chaves de solicitação a seguir estão reservadas e não podem ser substituídas por este método:
sids
pdata
logdata
callback
postCallbackFn
useImageRequest
Resposta
Retorna o objeto de API da instância de DIL atual.
Código de exemplo
var partnerObject = DIL.create({
partner: 'partner',
containerNSID: NSID
});
partnerObject.api.customQueryParams({
nid: 54231,
ntype: 'default'
});
Retorna o valor do contêiner NSID para o DIL instância. Útil para depuração e solução de problemas.
Assinatura da Função: dil.api.getContainerNSID: function () {}
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName',
containerNSID: containerNSID
});
//Verify the container NSID
var nsid = dataLib.api.getContainerNSID();
Retorna dados do log de eventos classificados cronologicamente como uma matriz de cadeias de caracteres. Útil para depuração e solução de problemas.
Assinatura da Função: dil.api.getEventLog: function () {}
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName',
containerNSID: containerNSID
});
dataLib.api.traits([123, 456, 789]).logs({
file: 'dil.js',
message: 'This is the first request'
});.signals({
c_zdid: 1111
d_dma: 'default'
});.submit();
//Check log for messages
var log = dataLib.api.getEventLog();
if (log && log.length) {
alert(log.join('\n'));
}else{
alert('No log messages');
}
Retorna o nome do parceiro de um DIL instância. Útil para depuração e solução de problemas.
Assinatura da Função: dil.api.getPartner: function () {}
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName'
containerNSID: containerNSID
});
//Verify the partner name
var partner = dataLib.api.getPartner();
Retorna o estado do atual DIL instância. Útil para depuração e solução de problemas.
Assinatura da Função: dil.api.getState: function () {}
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName',
containerNSID: containerNSID
});
dataLib.api.traits([123, 456, 789]).logs({
file: 'dil.js',
message:'This is the first request'
});.signals({
c.zdid: 1111
d_dma: 'default'
});.submit();
var state = dataLib.api.getState();
/*Object outline of state
state = {
pendingRequest: {pending data for call to server},
otherRequestInfo:{
firingQueue: [],
fired: [],
firing: false,
errored: [],
reservedKeys: {
sids: true,
pdata: true,
logdata: true,
callback: true,
postCallbackFn: true,
useImageRequest: true,
},
firstRequestHasFired: false,
num_of_jsonp_responses: 0,
num_of_jsonp_errors: 0,
num_of_img_responses: 0,
num_of_img_errors: 0
},
destinationPublishingInfo: {
THROTTLE_START: 3000,
throttleTimerSet: false,
id: ''destination_publishing_iframe_' + partner + '_' + containerNSID,
url: (constants.isHTTPS ? 'https://' : 'https://fast.') + partner + '.demdex.net/dest3.html?d_nsid='
+ containerNSID + '#' + encodeURIComponent(document.location.href),
iframe: null,
iframeHasLoaded: false,
sendingMessages: false,
messages: [],
messageSendingInterval: constants.POST_MESSAGE_ENABLED ? 15: 100,
//Recommend 100ms for IE 6 & 7, 15ms for other browsers
jsonProcessed: []
}
}
*/
Consiste em duas funções que permitem aos parceiros de dados trocar e sincronizar IDs de usuário entre eles e o Audience Manager.
Assinatura da Função:
Funciona com DIL versões 2.10 e 3.1 ou superior.
Código | Sincroniza as IDs do usuário |
---|---|
dil.Instance.api.idSync(initConfig) |
Entre os diferentes parceiros de dados e o Audience Manager. Por exemplo, o parceiro x usaria essa opção para sincronizar uma ID de usuário com o parceiro y e enviá-la para o Audience Manager.
Importante: Este método está obsoleto. Use o |
dil.Instance.api.aamIdSync(initConfig) |
Quando você já conhece a ID de usuário e deseja enviá-la para o Audience Manager.
Importante: Este método está obsoleto. Use o |
Elementos idSync
idSync
podem consistir no seguinte:
Nome | Tipo | Descrição |
---|---|---|
dpid |
Sequência de caracteres | A ID do provedor de dados atribuída pelo Audience Manager. |
dpuuid |
Sequência de caracteres | A ID única do provedor de dados para o usuário. |
minutesToLive |
Número | (Opcional) Define o tempo de expiração do cookie. Deve ser um inteiro. O padrão é de 20160 minutos (14 dias). |
url |
Sequência de caracteres | URL de Destino. |
Macros
idSync
aceita as seguintes macros:
%TIMESTAMP%
: gera um carimbo de data e hora (em milissegundos). Usado para eliminação de cache.%DID%
: insere a ID do Audience Manager para o usuário.%HTTP_PROTO%
: Define o protocolo da página ( http
ou https
).Resposta
Ambas as funções retornam Successfully queued
se for bem-sucedido. Do contrário, elas retornam uma sequência de mensagem de erro.
Código de exemplo
dilInstance.api.idSync(initConfig)
// Fires url with macros replaced
dilInstance.api.idSync({
dpid: '23', // must be a string
url: '//su.addthis.com/red/usync?pid=16&puid=%DID%&url=%HTTP_PROTO%%3A%2F%2Fdpm.demdex.net
%2Fibs%3Adpid%3D420%26dpuuid%3D%7B%7Buid%7D%7D',
minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days)
});
dilInstance.api.aamIdSync(initConfig)
// Fires 'https:/https:' + '//dpm.demdex.net/ibs:dpid=<dpid>&dpuuid=<dpuuid>'
dilInstance.api.aamIdSync({
dpid: '23', // must be a string
dpuuid: '98765', // must be a string
minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days)
});
Adiciona um retorno de chamada (que recebe JSON) à solicitação pendente.
Assinatura da Função: result: function (callback) {}
Esse retorno de chamada substitui o retorno de chamada padrão que lida com a publicação de destino.
Você pode encadear outras chamadas de API a esse método.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
callback |
Função | Função JavaScript executada pelo retorno de chamada JSONP. |
Resposta
Retorna o objeto de API do atual DIL instância.
Código de exemplo
var dataLib = DIL.create({
partner: 'partnerName',
containerNSID: containerNSID
});
dataLib.api.traits([123, 456, 789]).result(function(json){
//Do something, possibly with the JSON data returned from the server.
});.submit();
secureDataCollection
é um parâmetro booleano que controla como DIL O faz chamadas para o Data Collection Servers (DCS) e Akamai.
Quando secureDataCollection= true
(padrão), DIL O sempre faz chamadas HTTPS seguras.
Quando secureDataCollection= false
, DIL O faz chamadas HTTP ou HTTPS seguindo o protocolo de segurança definido pela página.
Definir secureDataCollection= false
se você usar visitorAPI.js e DIL página. Consulte a amostra de código abaixo.
var dilInstance = DIL.create({
...
secureDataCollection: false
});
useCORSOnly
é um parâmetro booleano true/false que controla como o navegador solicita recursos de outros domínios.
Visão geral
useCORSOnly
é falso por padrão. Falso significa que o navegador pode executar verificações de recursos com CORS ou JSONP. No entanto, DIL O sempre tenta solicitar recursos com o CORS primeiro. Em seguida, reverte para JSONP em navegadores antigos sem suporte ao CORS. Se for necessário forçar o navegador para usar somente o CORS, como em sites com requisitos de alta segurança, defina useCORSOnly:true
.
Amostra de código
var dilInstance = DIL.create({
...
useCORSOnly: true
});
useCORSOnly: true
somente quando você tem certeza de que os visitantes do site têm navegadores compatíveis com esse recurso.useCORSOnly: true
, DIL O não fará chamadas de ID do Internet Explorer versão 9 ou posterior.Altera o tipo de solicitação para imagem <img>
do script <src>
.
Assinatura da Função: useImageRequest: function () {}
Você pode encadear outras chamadas de API a esse método.
Resposta
Retorna um objeto de API do atual DIL instância.
Código de exemplo
var dataLib = DIL.create({
partner:'partnerName',
containerNSID: containerNSID
});
dataLib.api.traits([123, 456, 789]).useImageRequest().submit();