Exportar o relatório de uplift

Exporta o relatório de uplift, ou seja, as métricas de holdout de uma campanha ou de uma journey, para um arquivo CSV, pelo mesmo ciclo de vida de tarefa da exportação de estatísticas de mensagens: chame export, consulte status, chame result e, em seguida, faça o download.

Não é a exportação do grupo de controle

TASK_TYPE_EXPORT_CONTROL_GROUP exporta a lista de membros de um grupo de controle: dispositivos e contagens de usuários. TASK_TYPE_EXPORT_CONTROL_GROUP_ANALYTICS, documentado aqui, exporta em vez disso as métricas do relatório de uplift: sem lista de membros, sem dados de dispositivos. São tipos de tarefa separados, com argumentos separados.

Solicitação

POST https://api.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/export

Use "type": "TASK_TYPE_EXPORT_CONTROL_GROUP_ANALYTICS" e um objeto export_control_group_analytics em vez de export_messages_v2. A autenticação e o restante do ciclo de vida (status, result, lastTasks, delete, download) funcionam exatamente como descrito em exportação de estatísticas de mensagens.

export_control_group_analytics aceita:

Nome	Obrigatório	Tipo	Descrição
application_code	Sim	String	Código do aplicativo.
date_from	Sim	String	Início da janela, sobre o próprio timestamp do relatório, YYYY-MM-DD ou YYYY-MM-DD HH:MM:SS. Um valor só com a data é expandido para o início daquele dia.
date_to	Sim	String	Fim da janela, mesmo formato. Um valor só com a data é expandido para o fim daquele dia.
campaign	Não	String	Código da campanha; exporta apenas o holdout dessa campanha. Mutuamente exclusivo com journey.
journey	Não	String	UUID da journey; exporta apenas os pontos Holdout Split dessa journey. Mutuamente exclusivo com campaign.

Deixe campaign e journey vazios para exportar todas as campanhas e todas as journeys para as quais o aplicativo tem um relatório.

Importante

A janela não pode exceder 90 dias. Uma janela maior não é cortada: a solicitação falha com 400 e a mensagem exceeded the maximum date interval. Max interval: 90 days. O próprio relatório de uplift mantém 90 dias de linhas, então uma solicitação maior não poderia retornar nada além disso de qualquer forma.

Exemplo de solicitação

{
  "type": "TASK_TYPE_EXPORT_CONTROL_GROUP_ANALYTICS",
  "export_control_group_analytics": {
    "application_code": "XXXXX-XXXXX",
    "date_from": "2026-08-01",
    "date_to": "2026-08-31"
  }
}

result retorna export_control_group_analytics_result.file e .file_url, no mesmo formato do result da exportação de estatísticas de mensagens.

O que há no arquivo

Uma linha por campanha ou por ponto de holdout da journey, por evento de meta. O relatório subjacente grava uma linha nova todos os dias para o mesmo par, e a exportação mantém apenas a mais recente, então você obtém os números atuais, e não um histórico de cada execução anterior.

Coluna	Descrição
timestamp	Quando esta linha foi calculada.
owner_type	TYPE_CAMPAIGN ou TYPE_JOURNEY.
owner_id	O código da campanha ou da mensagem para uma linha de campanha, o UUID da journey para uma linha de journey.
point_uuid	O UUID do ponto Holdout Split para uma linha de journey. Vazio para uma linha de campanha.
event_name	O evento de meta que esta linha mede.
attribution_window_seconds	A janela de atribuição aplicada, em segundos.
treatment_users, control_users, treatment_conversions, control_conversions, treatment_events, control_events	Contagens brutas por trás das métricas abaixo.
uplift_pct, incremental_events, percent_of_treatment, z_score, p_value, confidence_pct	As mesmas métricas do relatório de uplift.
significance	TYPE_SIGNIFICANT, TYPE_NOT_SIGNIFICANT ou TYPE_NOT_ENOUGH_DATA.
revenue_tracked	1 se a fonte de receita do evento de meta foi configurada, 0 se a linha está apenas estimando a partir de um fallback legado. Consulte Receita no relatório.
treatment_revenue_<currency>, control_revenue_<currency>, incremental_revenue_<currency>	Três colunas por moeda, com o código da moeda em minúsculas (por exemplo, treatment_revenue_usd). O arquivo só recebe colunas para as moedas que realmente aparecem nas linhas exportadas.

Nota

Quando revenue_tracked é 0, todas as células de receita dessa linha ficam vazias, e não 0.00. Uma célula em branco significa que a fonte não foi configurada, e não que o envio não gerou receita.