Exportações automatizadas

Prev Next

Quando é necessária uma exportação regular, geralmente para processos como exportar perfis de usuário para uma plataforma terceirizada, então o Xtremepush Automations é o lugar certo.

Esse recurso permite que os usuários configurem cronogramas de exportação por hora (disponível apenas para alguns tipos de exportação), diários, semanais ou mensais via SFTP ou e-mail.

Exportações

Navegue até Automações de Dados > e selecione a aba Exportações .

Este menu mostra a lista completa de exportações do projeto e, especificamente, seu Alvo, Frequência e Status. Também é possível ver quando eles foram lançados pela última vez e se essa exportação foi bem-sucedida.

Clicar no carimbo de tempo da última execução mostra detalhes e quaisquer erros dessa exportação.

Ações que podem ser realizadas em uma automação existente podem ser encontradas em > mais. Exportações podem ser ativadas/desativadas e executadas agora se uma exportação imediata for necessária.

Criar exportação

Clique no botão Criar Exportar para ser direcionado ao processo de configuração guiado por assistente.

Tipo de Exportação

Depois de dar um nome à nova exportação, o primeiro passo é definir para onde você quer que a exportação vá e o tipo de dados que deseja que ela contha.

  1. Configurações de Destino. Defina para onde os dados devem ser enviados no momento da exportação. Existem várias opções disponíveis:

  • Exporte para um e-mail. Digite um endereço de e-mail e pressione enter. Múltiplos endereços podem ser adicionados para que a exportação seja enviada para várias pessoas. Quando a exportação estiver concluída, uma mensagem será enviada para a lista de e-mails fornecidos contendo um link para uma página segura onde a exportação pode ser baixada.

  • Exportar para o SFTP do cliente. Selecione uma conta SFTP que tenha sido configurada previamente pelo Marketplace de Integrações do projeto.

  • Exporte um público para uma plataforma de retargeting. Essa opção só aparecerá se você tiver retargeting de anúncios integrado pelo Integrations Marketplace. Confira nossa página dedicada ao Retargeting de Anúncios para mais detalhes.

  1. Tipo de Dados.Selecione se deseja exportar dados de perfil, dispositivo ou engajamento de campanha.

  • O Profiles gera um relatório onde cada item contém o registro do perfil junto com quaisquer dados de atributos associados.

  • Dispositivos exporta um relatório onde cada linha é um único dispositivo. Campos disponíveis:

Campo

Descrição

id

ID de dispositivo (identificador Xtremepush)

profile_id

ID de perfil (identificador Xtremepush)

user_id

ID de usuário (se fornecida)

subscription

Push status de assinatura (1, 0)

last_subscription_change

Carimbo de data em formato Unix para quando este status foi atualizado pela última vez

addressable

Empurrar status endereçável (1, 0)

last_addressable_change

Carimbo de data em formato Unix para quando este status foi atualizado pela última vez

  • Preferências de Consentimento gera um relatório que inclui detalhes sobre preferências de consentimento do usuário. Esse tipo de relatório só está disponível se o recurso de Gerenciamento de Consentimento estiver ativado no projeto. Campos disponíveis:

    Campo

    ID de dispositivo (identificador Xtremepush)

    user_id

    ID de usuário (se fornecida)

    name

    O nome da preferência de consentimento.

    type

    O tipo de preferência de consentimento (por exemplo, Marketing, Interesse Legítimo).

    channel

    O canal de comunicação associado à preferência (por exemplo, E-mail, SMS).

    update_time

    Da última vez, a preferência foi atualizada, no Y-m-d H:i formato.

    status

    O status da preferência (1, 0)

  • O engajamento da campanha produz um relatório onde cada linha é uma ação de engajamento em relação a uma campanha. Campos disponíveis:

Campo

Descrição

campaign_id

ID de campanha

campaign_name

Nome da campanha

category_id

ID da categoria de engajamento (se aplicável)

category_name

Nome da categoria de engajamento (se aplicável)

user_id

ID de usuário (se disponível)

profile_id

ID de Perfil (identificador XP)

device_id

ID do dispositivo (identificador XP)

message_type

Canal de mensagens (e-mail, jornada, SMS, push, etc)

message_variant

Variante de teste dividido (se aplicável)

message_variant_name

Nome da variante do teste dividido (se aplicável)

language_variant

Variante de idioma (se aplicável)

campaign_schedule_type

Tipo de cronograma da campanha (recorrente, acionado, tempo)

email

Endereço de e-mail do perfil (se disponível)

mobile_number

Número de celular do perfil (se disponível)

from_name

Nome do nome (aplicável apenas para campanhas de e-mail e SMS)

subject_line

Assunto (aplicável apenas para campanhas de e-mail)

title

Título do Push (aplicável apenas para campanhas push no iOS, Android e web)

interaction_type

Tipo de interação (enviada, entregue, aberta, clique, fechada, falhada, etc.)

interaction_value

Informações adicionais sobre a interação (motivo da falha, URL de redirecionamento do clique, motivo do resclique, etc.)

workflow_action_id

ID de nó de workflow (aplicável apenas para campanhas de workflow)

workflow_action_name

Nome do nó do fluxo de trabalho (aplicável apenas para campanhas de workflow)

timestamp

Carimbo de tempo Unix da interação (em UTC)

interaction_id

ID de ação da mensagem (aplicável apenas para campanhas de fluxo de trabalho)

trigger_id

ID que identifica cada lote de usuários que entram em um fluxo de trabalho. Se os usuários entrarem na mesma campanha de fluxo de trabalho mais de uma vez, um ID de gatilho diferente aparecerá contra eles

external_message_id

ID passado pelo cliente junto com o gatilho original

labels

Uma lista separada por vírgulas de rótulos armazenada contra a campanha

Não consegue ver essa opção?

Automatizar um relatório de engajamento de campanha é uma novidade. Entre em contato conosco se quiser usá-lo.

Selecionar a opção Delta Report garantirá que a exportação contenha apenas registros que foram criados ou alterados desde a última execução, em vez de ser uma exportação de todos os dados do projeto. Para relatórios de engajamento de campanha, a opção de relatório delta é obrigatória.

Gerenciamento do tamanho do arquivo

Quando você seleciona Engajamento de Campanha como tipo de dado, pode usar o Limite de Linhas para gerenciar tamanhos de arquivo.

Use o campo Limite de Linhas para especificar o número máximo de linhas por arquivo exportado. O limite máximo é de 1.000.000 de carreiras e o mínimo é de 100.000. Recomenda-se especificar um limite de linhas se seu projeto tiver um alto volume de atividade de usuários.

Se o número total de registros exceder o limite especificado, arquivos adicionais são criados para acomodar os dados restantes.

Primeiro relatório de exportação do engajamento do Delta

A primeira execução do relatório de engajamento delta fornece os registros desde o momento em que a exportação é configurada no projeto até o momento da execução. Exportações subsequentes gerarão registros criados ou alterados desde a última vez que o relatório foi rodado.

Estrutura de Dados

  1. Configurações de Segmento
    A exportação incluirá apenas dados de perfis de usuário ou dispositivos que correspondam ao segmento determinado.

  2. Exportar AtributosSelecione quais atributos devem ser incluídos na lista de perfis de usuário na exportação. Você pode reorganizar os atributos selecionados para ordená-los no arquivo CSV. Isso pode ser útil se a exportação estiver sendo captada por uma plataforma externa que os exija em uma ordem específica.

Só é possível adicionar atributos ao arquivo exportado para exportações de perfil.

Essa medida não se aplica às exportações de engajamento de campanha.

Cronograma

Por fim, uma frequência para exportação pode ser definida na etapa de agendamento. Após salvar o cronograma, ele será executado no próximo horário disponível mais próximo do horário atual. Observe o fuso horário definido no seu projeto e considere qualquer ajuste necessário no seu processo para evitar problemas, como um arquivo sendo atualizado no SFTP por um sistema rodando em um fuso horário diferente daquele definido no cronograma de automação.