Definições de configuração da coleta de dados data-collection
Esta seção de configuração permite determinar como os dados são coletados na extensão.
- Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.
- Navegue até Data Collection > Tags.
- Selecione a propriedade de tag desejada.
- Navegue até Extensions e selecione Configure no cartão Adobe Experience Platform Web SDK.
- Role até a seção Data collection.
As opções disponíveis são as seguintes:
On before event send callback
Uma função de retorno de chamada para avaliar e modificar o payload enviado para o Adobe. No editor de código, você tem acesso às seguintes variáveis:
content.xdm: a carga XDM para o evento.content.data: a carga do objeto de dados para o evento.return true: saia imediatamente do retorno de chamada e envie dados para a Adobe com os valores atuais no objetocontent.return false: saia imediatamente do retorno de chamada e interrompa o envio de dados para a Adobe.
Qualquer variável definida fora de content pode ser usada, mas não está incluída na carga enviada para o Adobe.
// Use nullish coalescing assignments to add objects if they don't yet exist
content.xdm.commerce ??= {};
content.xdm.commerce.order ??= {};
// Then add the purchase ID
content.xdm.commerce.order.purchaseID = "12345";
// Use optional chaining to prevent undefined errors when setting tracking code to lower case
if(content.xdm.marketing?.trackingCode) content.xdm.marketing.trackingCode = content.xdm.marketing.trackingCode.toLowerCase();
// Delete operating system version
if(content.xdm.environment) delete content.xdm.environment.operatingSystemVersion;
// Immediately end onBeforeEventSend logic and send the data to Adobe for this event type
if (content.xdm.eventType === "web.webInteraction.linkClicks") {
return true;
}
// Cancel sending data if it is a known bot
if (myBotDetector.isABot()) {
return false;
}
false no primeiro evento da página. Retornar false no primeiro evento pode afetar negativamente a personalização.Este retorno de chamada é a marca equivalente a onBeforeEventSend na biblioteca JavaScript.
Collect internal link clicks
Uma caixa de seleção que permite a coleta de dados de rastreamento de links internos no site ou na propriedade. Esta caixa de seleção é a marca equivalente a clickCollection.internalLinkEnabled na biblioteca do JavaScript. Quando você ativa essa caixa de seleção, as opções de agrupamento de eventos são exibidas:
- No event grouping: Os dados de rastreamento de link são enviados ao Adobe em eventos separados. Os cliques em links enviados em eventos separados podem aumentar o uso contratual dos dados enviados para o Adobe Experience Platform.
- Event grouping using session storage: armazena dados de rastreamento de link no armazenamento da sessão até o próximo evento "exibição de página". No próximo evento considerado uma "exibição de página", os dados de rastreamento do link armazenados são mesclados com a carga do evento "exibição de página". A Adobe recomenda ativar essa configuração ao rastrear links internos.
- Event grouping using local object: armazena dados de rastreamento de link em um objeto local até o próximo evento "exibição de página". Se um visitante navega para uma nova página do navegador, os dados de rastreamento de link são perdidos. Essa configuração é mais benéfica no contexto de aplicativos de página única.
A biblioteca de tags considera um determinado evento como uma "visualização de página" quando os seguintes elementos são incluídos na carga:
xdm.web.webPageDetails.namecontém um valor de cadeia de caracteresxdm.web.webPageDetails.pageViews.valueé maior que0
Collect external link clicks
Uma caixa de seleção que permite a coleta de links externos. Esta caixa de seleção é a marca equivalente a clickCollection.externalLinkEnabled na biblioteca do JavaScript.
Collect download link clicks
Uma caixa de seleção que permite a coleção de links de download. Esta caixa de seleção é a marca equivalente a clickCollection.downloadLinkEnabled na biblioteca do JavaScript.
Download link qualifier
Uma expressão regular que qualifica um URL de link como um link de download. Esta cadeia de caracteres é a marca equivalente a downloadLinkQualifier na biblioteca JavaScript.
Filter click properties
Uma função de retorno de chamada para avaliar e modificar propriedades relacionadas a cliques antes da coleção. Esta função é executada antes de On before event send callback e é a marca equivalente a clickCollection.filterClickDetails na biblioteca JavaScript. No editor de código, você tem acesso às seguintes variáveis:
content.clickedElement: o elemento DOM que foi clicado.content.pageName: O nome da página quando o clique ocorreu.content.linkName: o nome do link clicado.content.linkRegion: A região do link clicado.content.linkType: O tipo de link (saída, download ou outro).content.linkURL: a URL de destino do link clicado.return true: Saia imediatamente do retorno de chamada com os valores de variável atuais.return false: Saia imediatamente do retorno de chamada e cancele a coleta de dados.- Qualquer variável definida fora de
contentpode ser usada, mas não está incluída na carga enviada para o Adobe.
onBeforeLinkClickSend na biblioteca JavaScript. Use o retorno de chamada Filter click properties para filtrar ou ajustar os dados de cliques, ou use On before event send callback para filtrar ou ajustar a carga geral enviada para o Adobe. Se o retorno de chamada Filter click properties e o retorno de chamada On before link click send estiverem definidos, somente o retorno de chamada Filter click properties será executado.Configurações de contexto
Colete automaticamente as informações do visitante, que preenchem campos XDM específicos para você. Escolha All default context information ou Specific context information. É a marca equivalente a context na biblioteca JavaScript.
- Web: Coleta informações sobre a página atual.
- Device: Coleta informações sobre o dispositivo do usuário.
- Environment: coleta informações sobre o navegador do usuário.
- Place context: Coleta informações sobre a localização do usuário.
- High entropy user-agent hints: coleta informações mais detalhadas sobre o dispositivo do usuário.
- Send referrer to Adobe Analytics only once per page view: Impedir que dados duplicados do referenciador sejam enviados ao Adobe Analytics.