Com o Daily Activity Stream (Fluxo Diário de Atividades), você pode exportar os dados brutos da Dynamic Yield e importá-los na sua própria plataforma de análise. Isso permite que você conecte os dados da Dynamic Yield a fontes de dados adicionais do seu banco de dados e crie relatórios customizados feitos sob medida para as suas necessidades únicas de negócio.
A exportação consiste em dois conjuntos de dados:
- Dados brutos: inclui interações brutas com variações, eventos e visualizações de página na Dynamic Yield.
- Dados de atribuição: inclui o relacionamento entre os eventos e as variações às quais eles foram atribuídos, de acordo com as configurações da sua experiência.
Os dados são exportados diariamente para um bucket do Amazon S3, onde ficam armazenados por 30 dias.
Os dados são exportados como arquivos Apache Parquet, um formato otimizado para grandes conjuntos de dados.
Conjuntos de dados
Dados brutos
Esses conjuntos de dados contêm todas as interações dos seguintes tipos:
- Interação com variações: cliques e impressões das variações.
- Eventos: como compras ou assinaturas.
- Visualizações de página.
Por exemplo, se um usuário visualizar 3 páginas, disparar 2 eventos e tiver 1 impressão de uma variação, a exportação conterá 6 linhas.
Cada interação, descrita como eventType no conjunto de dados, carrega propriedades específicas. Por exemplo:
| eventType | Descrição | Atributos adicionais (exemplos) |
|---|---|---|
| UIA | Visualização de página | URL, contexto da página |
| DPX | Hit de evento | Propriedades do evento, valor do evento |
| VARIATION_ENGAGEMENT | Impressão ou clique na variação | Nome da campanha, nome da variação |
As tabelas a seguir incluem a lista completa de atributos disponíveis para cada eventType.
Representa uma página visualizada pelo usuário.
| Atributo | Descrição | Exemplo |
|---|---|---|
| eventType String |
O tipo de atividade. Para visualização de página, o valor é UIA (em vez de VARIATION_ENGAGEMENT ou DPX). | "UIA" |
|
interactionId |
O identificador da interação (para um evento específico; por exemplo, uma compra específica). Pode ser usado para juntar esse conjunto de dados ao conjunto de dados de atribuição. |
1234567890 |
| contextType String |
O tipo de página, de acordo com o contexto da página. | "HOMEPAGE" |
| contextData String array |
Dados sobre o tipo de página.
|
["Women","Shoes"] |
| dyId Long |
O identificador interno que a Dynamic Yield atribui a cada visitante do site ou do aplicativo (único por dispositivo). | 123456789012345678 |
| timestamp Long |
A hora em que a atividade ocorreu, em milissegundos, a partir da era UNIX. | 1621798861400 |
| sessionId Integer |
O identificador interno que a Dynamic Yield atribui à sessão de um visitante. | 1234567890 |
| url String |
A URL a partir da qual o evento foi iniciado. | "https://www.example.com/?url_params=123" |
| urlClean String |
A URL a partir da qual o evento foi iniciado, após remover todos os parâmetros da URL. | "https://www.example.com/" |
| audiences Integer array |
A lista de identificadores dos públicos do qual o usuário é membro no momento que o evento é iniciado. | [1234567, 9876543] |
| browser String |
O tipo de navegador no qual o evento foi iniciado. | "Safari" |
| device String |
O tipo de dispositivo que disparou o evento. | "Tablet" |
| operatingSystem String |
O sistema operacional do dispositivo que iniciou o evento. | "Mac OS X" |
| screenResolution String |
A resolução de tela do dispositivo que iniciou o evento. | "Low (1024px and below)" |
| reqTimestamp Long |
Carimbo de data/hora da solicitação interna para o pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
| procTimestamp Long |
Carimbo de data/hora do processamento interno do pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
| resTimestamp Long |
Carimbo de data/hora da resolução interna do pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
Representa uma evento da Dynamic Yield disparado pelo usuário.
| Atributo | Descrição | Exemplo |
|---|---|---|
| eventType String |
O tipo de atividade. Para um hit de evento, o valor é DPX (em vez de VARIATION_ENGAGEMENT ou UIA). | "DPX" |
|
interactionId |
O identificador da interação (para um evento específico; por exemplo, uma compra específica). Pode ser usado para juntar esse conjunto de dados ao conjunto de dados de atribuição. |
1234567890 |
| eventId Integer |
Um identificador único para cada evento iniciado explicitamente no site. | 12345 |
| eventName String |
O nome do evento que consta na API do evento. | "Purchase" |
| eventProperties String (JSON) |
As propriedades do evento que constam na API do evento. Elas podem ser diferentes dependendo do valor em eventType. | { "transaction_id": "ABC123456", "value": 100.0, "currency": "USD", "dyType": "purchase-v1", "Brands": "Nike", "Categories": "Sneakers", "Number_of_items": 1.0, "cart": [{ "productId": "AIR-123", "quantity": 1.0, "itemPrice": 100.0 }] } |
| eventValue Long |
O valor total de todos os itens no carrinho, como consta no atributo eventProperties. O valor é em centavos. |
10000 |
| uniqueTransactionId String |
A ID da transação, como consta no atributo eventProperties de um evento de compra. |
ABC123456 |
|
productIds |
A lista de IDs de produtos nos quais uma ação foi realizada. |
[“12345”] |
| dyId Long |
O identificador interno que a Dynamic Yield atribui a cada visitante do site ou do aplicativo (único por dispositivo). | 123456789012345678 |
| timestamp Long |
A hora em que a atividade ocorreu, em milissegundos, a partir da era UNIX. | 1621798861400 |
| sessionId Integer |
O identificador interno que a Dynamic Yield atribui à sessão de um visitante. | 1234567890 |
| url String |
A URL a partir da qual o evento foi iniciado. | "https://www.example.com/?url_params=123" |
| urlClean String |
A URL a partir da qual o evento foi iniciado, após remover todos os parâmetros da URL. | "https://www.example.com/" |
| audiences Integer array |
A lista de identificadores dos públicos do qual o usuário é membro no momento que o evento é iniciado. | [1234567, 9876543] |
| browser String |
O tipo de navegador no qual o evento foi iniciado. | "Safari" |
| device String |
O tipo de dispositivo que disparou o evento. | "Tablet" |
| operatingSystem String |
O sistema operacional do dispositivo que disparou o evento. | "Mac OS X" |
| screenResolution String |
A resolução de tela do dispositivo que iniciou o evento. | "Low (1024px and below)" |
| reqTimestamp Long |
Carimbo de data/hora da solicitação interna para o pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
| procTimestamp Long |
Carimbo de data/hora do processamento interno do pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
| resTimestamp Long |
Carimbo de data/hora da resolução interna do pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
Representa uma impressão de uma variação ou um clique em uma variação.
| Atributo | Descrição | Exemplo |
|---|---|---|
| eventType String |
O tipo de atividade. Para clique ou impressão de uma variação, o valor é VARIATION_ENGAGEMENT (em vez de UIA ou DPX). | "VARIATION_ENGAGEMENT" |
|
interactionId |
O identificador da interação (para um evento específico; por exemplo, uma compra específica). Pode ser usado para juntar esse conjunto de dados ao conjunto de dados de atribuição. |
1234567890 |
| engagementType String |
O tipo de interação com a variação. Valores possíveis:
|
"IMPRESSION" |
| campaignId Integer |
A ID da campanha da qual essa variação faz parte. Para interação com blocos do Experience Email, isso representa a ID do bloco, enquanto parentCampaignId contém a ID da campanha no Experience Email. | 123456 |
| campaignName String |
O nome da campanha da qual essa variação faz parte. Para interação com blocos do Experience Email, isso representa o nome do bloco, enquanto parentCampaignName contém o nome da campanha no Experience Email. | "Homepage Banner" |
| experienceId Integer |
A ID da experiência da qual essa variação faz parte. | 123456 |
| experienceName String |
O nome da experiência da qual essa variação faz parte. | "Summer Promo" |
| experimentId Integer |
O identificador único do teste. | 123456 |
| versionId Integer |
O identificador único da versão do teste. Um teste A/B pode ter várias versões. | 245467 |
| variationIds Integer array |
A ID da variação que o usuário recebeu (se o tipo for IMPRESSION) ou clicou (se o tipo for CLICK). Geralmente, a lista contém uma única ID, mas, se o tipo de campanha for "Dynamic Content Item List" (Lista de Itens de Conteúdo Dinâmico), ela contém uma lista de variações separadas por vírgula. |
[1234567, 9876543] |
| attributionVariationIds Integer array |
A ID da variação no conjunto de dados de atribuição. Esse identificador deve ser usado para juntar os conjuntos de dados de atribuição ao conjunto de dados bruto, onde raw.attributionVariationIds = attribution.variations. Geralmente, a lista contém uma única ID, mas, se o tipo de campanha for "Dynamic Content Item List", ela contém uma lista de variações separadas por vírgula. |
[1234567, 9876543] |
| variationNames String array |
O nome da variação que o usuário recebeu (se o tipo for IMPRESSION) ou clicou (se o tipo for CLICK). Geralmente, a lista contém uma única ID, mas, se o tipo de campanha for "Dynamic Content Item List", ela contém uma lista de variações separadas por vírgula. |
["Blue Button", "Red Button"] |
| sku String array |
Se o evento for uma visualização ou um clique em um widget de recomendações (por exemplo, o engagementType for "CLICK" ou "STRATEGY_IMPRESSION"), o atributo é a lista de SKUs que foram recomendados ou o SKU que foi clicado. |
["1234", "9876"] |
| strategyId Integer array |
Se o evento for uma visualização ou um clique em um widget de recomendações, o atributo é a ID da estratégia que foi servida. Uma única variação pode incluir vários widgets com várias estratégias. |
[126651,426356] |
|
strategyName |
Se o evento for uma visualização ou um clique em um widget de recomendações, o atributo é o nome da estratégia que foi servida. Uma única variação pode incluir vários widgets com várias estratégias. |
["Most Popular","Affinity"] |
| touchpointId Integer |
Somente em pontos de contato: a ID do ponto de contato. | 245467 |
|
touchpointName |
Somente em pontos de contato: o nome do ponto de contato. | ["Hero Banner"] |
| parentVariationId Integer |
Somente em pontos de contato: a ID da variação que serve esse ponto de contato na campanha multitoque. | [9876543] |
|
parentVariationName |
Somente em pontos de contato: o nome da variação que serve esse ponto de contato na campanha multitoque. | "Blue Design" |
|
parentCampaignId |
Se a interação for com um bloco do Experience Email, esse campo contém a ID da campanha do Experience Email. | 123456 |
|
parentCampaignName |
Se a interação for com um bloco do Experience Email, esse campo contém o nome da campanha do Experience Email. | "Experience Email Campaign 1" |
| dyId Long |
O identificador interno que a Dynamic Yield atribui a cada visitante do site ou do aplicativo (único por dispositivo). | 123456789012345678 |
| timestamp Long |
A hora em que a atividade ocorreu, em milissegundos, a partir da era UNIX. | 1621798861400 |
| sessionId Integer |
O identificador interno que a Dynamic Yield atribui à sessão de um visitante. | 1234567890 |
| url String |
A URL a partir da qual o evento foi iniciado. | "https://www.example.com/?url_params=123" |
| urlClean String |
A URL a partir da qual o evento foi iniciado, após remover todos os parâmetros da URL. | "https://www.example.com/" |
| audiences Integer array |
A lista de identificadores dos públicos do qual o usuário é membro no momento que o evento é iniciado. | [1234567, 9876543] |
| reqTimestamp Long |
Carimbo de data/hora da solicitação interna para o pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
| procTimestamp Long |
Carimbo de data/hora do processamento interno do pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
| resTimestamp Long |
Carimbo de data/hora da resolução interna do pipeline de análise, em milissegundos, a partir da era UNIX. | 1621798861400 |
Dados de atribuição
Esse conjunto de dados contém o relacionamento entre uma variação e os eventos atribuídos a ela de acordo com as configurações da experiência.
Cada registro do conjunto de dados representa uma combinação distinta de evento e variação.
Note que geralmente há um relacionamento de 1 para N entre os eventos e as variações. Por exemplo, se 1 compra foi atribuída a 2 variações (controle do teste A, variação do teste B), o conjunto de dados contém 2 linhas.
| Campo | Descrição |
|---|---|
| interactionId (int) |
O identificador da interação (para um evento específico; por exemplo, uma compra específica). Pode ser usado para juntar esse conjunto de dados ao conjunto de dados de atribuição. |
| eventType (varchar) |
O tipo de evento sendo atribuído a uma variação. Atualmente, somente eventos DPX são exportados. |
| dyid (int) |
O identificador do usuário que disparou o evento atribuído. |
| experimentId (int) |
A ID do experimento ao qual o evento foi atribuído. |
| versionId (int) |
A ID da versão à qual o evento foi atribuído. |
| variations (array) |
A matriz de IDs de variação à qual o evento foi atribuído. Essa matriz geralmente contém um único valor, mas pode conter múltiplos valores se a experiência for uma lista de itens. Este identificador corresponde a attributionVariationIds no conjunto de dados brutos. |
| eventId (int) |
A ID do evento DPX atribuído à variação. Por exemplo, para compra, essa seria a ID do evento de compra. |
| eventValue (int) |
O valor do evento DPX atribuído à variação. Por exemplo, para uma compra, ele representaria a receita conectada ao evento de compra.
O valor é em centavos. |
Ativando o Daily Activity Stream
Para ativar o Daily Activity Stream:
- Acesse Settings (Configurações) › General Settings (Configurações Gerais) › Daily Activity Stream (Fluxo Diário de Atividades).
- Clique em Turn on daily export (Ativar exportação diária).
- Copie o caminho e as credenciais do bucket do S3 em um local seguro. Note que eles são exibidos somente uma vez.
Perdeu suas credenciais?
Clique no ícone de opções adicionaise, depois, em Generate New Credentials (Gerar Novas Credenciais). Tenha em mente que você só pode gerar novas credenciais uma vez.
- Pronto! O primeiro conjunto de dados será exportado após a meia-noite, depois disso, novos dados serão adicionados diariamente.
Observação: caso uma seção não tenha tráfego em um determinado dia, não haverá exportação de dados ou pasta desse dia no bucket do AWS S3.
Depois de ativar o Daily Activity Stream (ativar o botão liga/desliga), a página também exibe o status da exportação.
Você pode sempre desabilitar a exportação no menu de opções. Se desabilitar a exportação e depois habilitá-la novamente, seu bucket do S3 permanece o mesmo, mas você receberá novas credenciais.
Acessando seu bucket do S3
Depois de ativar o Daily Activity Stream, você receberá acesso a um bucket do S3 com o seguinte caminho:
- s3://dy-raw-data-export/sectionId=1234567, para o datacenter dos EUA
- s3://dy-raw-data-export-eu/sectionId=1234567, para o datacenter da UE
Nesse caminho, você encontra subpastas para cada data, onde os arquivos Parquet ficam armazenados.
Por exemplo, este caminho contém todos os dados coletados em 01/01/2022, conforme o fuso horário definido nas suas Configurações Gerais:
s3://dy-raw-data-export-eu/sectionId=1234567/date=2022-01-01
Nesse caminho, você encontrará subpastas para cada tipo de relatório
-
Este caminho inclui os dados brutos exportados atuais:
s3://dy-raw-data-export/sectionId=1234567/date=2023-01-01/reportType=raw
-
Este caminho inclui os novos dados de atribuição:
s3://dy-raw-data-export/sectionId=1234567/date=2023-01-01/reportType=attribution
Baixar os arquivos localmente através do Terminal
- Crie uma pasta no seu computador para guardar os arquivos salvos.
- Abra o Terminal e procure a pasta que você criou.
- Insira o comando aws configure.
- Quando solicitadas, insira sua chave de acesso e sua chave secreta, que foram geradas na sincronização do seu feed.
- Quando solicitados, insira a região do seu datacenter: eu-central-1 ou us-east-1, conforme apropriado.
- Na solicitação seguinte (saída padrão), basta pressionar Enter.
- Quando solicitados, insira aws s3 sync e o caminho relevante do S3 (veja Acessando seu bucket do S3). Por exemplo:
aws s3 sync s3://dy-raw-data-export-eu/sectionId=SECTIONID/date=2023-05-05/reportType=raw/ - Os arquivos serão baixados. Você poderá vê-los no Terminal e, assim que concluído o download, verá os arquivos na pasta que criou no 1º passo.
Importar dados para a sua plataforma de análise
Para integrar os dados do Daily Activity Stream aos seus sistemas automaticamente, você pode criar uma tarefa para extrair os arquivos Parquet do S3 e carregá-los para o banco de dados de sua escolha. Aqui estão alguns links de artigos relevantes com soluções populares: