Visão geral: A AppsFlyer descodifica e transforma o valor de conversão definido por você em eventos. Os eventos são usados para preencher o painel do SKAN, os dados brutos e os postbacks para os parceiros.
Descodificar o valor de conversão SKAN
Os anunciantes utilizam a descodificação do valor de conversão como uma alternativa à utilização das opções disponíveis no Conversion Studio. Se você usa Decodificação, significa que você é responsável por definir updatePostbackConversionValue de acordo com a lógica do seu aplicativo.
Além da definição do valor de conversão (CV) no aplicativo, as restantes opções de fluxo, funcionalidades e relatórios são as mesmas que as descritas no guia de soluções SKAN. Isto significa que, ao expirar a janela de atividade (controlada por você), o iOS envia o postback para a ad network, que o reencaminha para a AppsFlyer. A AppsFlyer descodifica o CV de acordo com o seu mapeamento em eventos processados tal como os CVs descodificados definidos pelo SDK.
Valor de conversão personalizado-Decodificação
A implementação da decodificação de CV personalizada requer o carregamento de um arquivo CSV contendo o seu mapeamento de CV para a plataforma AppsFlyer.
Descodificar os princípios de mapeamento
- Forneça mapeamento de decodificação para valores de conversão precisa (1-63) e valores de conversão bruta (baixa, média e alta) para as janelas 1-3. Não é obrigatório mapear toda a gama de valores. Por exemplo, é possível mapear os valores 1, 2, 10 e 43.
- CV 0 é sempre mapeado para instalar. Não é possível defini-lo.
- A tabela de mapeamento é carregada para a AppsFlyer em um arquivo CSV. Você pode carregar uma tabela de mapeamento atualizada, se necessário.
- Ao receber um postback do iOS, o CV é decodificado em eventos, tal como ilustrado nos exemplos.
- O tempo de instalação é derivado usando o tempo de chegada do postback.
- Os eventos têm a mesma hora que a hora de instalação.
- Para compreender melhor como preparar o esquema, confira os cenários de mapeamento a seguir:
-
Nomes de eventos in-app personalizados são permitidos.
- O que significa que você envia novos nomes de eventos, mesmo que eles nunca tenham sido enviados pelo SDK.
- Você pode mapear os eventos in-app para eventos in-app da ad network.
- O mesmo se aplica à integração do Meta Ads, sujeita às regras específicas do Meta Ads descritas na seção seguinte.
Decodificar as regras do cenário de mapeamento
Considere o seguinte:
- Gama de valores de conversão precisa: 1-63
- Intervalo de valores de conversão bruta: Baixa, média e alta
- Um determinado valor de conversão é mapeado para um ou mais eventos in-app especificados por você. Os eventos in-app têm parâmetros opcionais.
- Para os exemplos: Suponha que a data de instalação é 1 de fevereiro às 08:00.
- A tabela que se segue é um exemplo de tabela de mapeamento de descodificação. A sua estrutura é semelhante à do arquivo CSV necessário. Depois da tabela estão os eventos gerados como resultado do processo de decodificação.
- É sempre gerado um evento de instalação, independentemente do seu mapeamento.
- Mensuração de receita
- As receitas são em USD.
- Um determinado valor de conversão tem um intervalo de receita delimitado por min_revenue e max_revenue.
- Nos relatórios e painéis agregados, a receita é calculada como a média do intervalo. Exemplo: min_revenue=4 e max_revenue=10. A receita calculada é de 7.
- Os relatórios de dados brutos incluem a receita calculada (skad_revenue), min_revenue e max_revenue.
Regras meta-específicas
Se você fizer a integração com Meta Ads, respeite as seguintes regras:
- Os valores mínimo e máximo de receita para um determinado valor de conversão devem ser diferentes. Ou seja eles não são iguais.
- Os valores não se devem sobrepor e devem estar por ordem consecutiva, como ilustrado para conversion_value 1-2 e 62 no quadro seguinte.
- event_counter: O Meta Ads não considera este valor. [Melhor prática] Preencha-o com um valor de 1.
Exemplo: Mapeamento de descodificação
| conversão_ value |
event_ name |
event_ value |
min_revenue (não -inclusivo) |
max_revenue (inclusivo) | event_ counter |
hours_from_ install |
|---|---|---|---|---|---|---|
| 1 | af_purchase | {abc} | 0 | 3 | 1 | 24 |
| 2 | af_purchase | {def} | 3 | 10 | 3 | 36 |
| 21 | event_a | 1 | 24 | |||
| 21 | event_b | 3 | 24 | |||
| 21 | event_c | {xyz} | 2 | 24 | ||
| 21 | event_d | 1 | 24 | |||
| 21 | event_e | 1 | 24 | |||
| 21 | event_f | 1 | 24 | |||
| 21 | event_g | 1 | 24 | |||
| 62 | af_purchase | {fgh) | 10 | 17 | 2 | 72 |
| 62 | event_a | {klm} | 3 | 72 |
Exemplo A: Valor de conversão preciso 1
| event_name | skad_revenue |
min_revenue |
max_revenue |
event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 1.5 | 0 | 3 | {abc} |
Exemplo B: Valor de conversão preciso 2
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 6,5 | 3 | 10 | {def} |
| af_purchase | 6,5 | 3 | 10 | {def} |
| af_purchase | 6,5 | 3 | 10 | {def} |
Exemplo C: Valor de conversão preciso 21
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| event_a | ||||
| event_b | ||||
| event_b | ||||
| event_b | ||||
| event_c | {xyz} | |||
| event_c | {xyz} | |||
| event_d | ||||
| event_e | ||||
| event_f | ||||
| event_g |
Exemplo D: Valor de conversão preciso 62
| event_name | skad_revenue | min_revenue | max_revenue | event_value |
|---|---|---|---|---|
| install | ||||
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| af_purchase | 13.5 | 10 | 17 | {fgh} |
| event_a | {klm} | |||
| event_a | {klm} | |||
| event_a | {klm} |
Decodificar a especificação do arquivo csv
Os valores de conversão são mapeados para um ou mais eventos in-app.
Regras do arquivo
- Formato: Arquivo CSV
- Número máximo de linhas: 640 + linha de cabeçalho; total 641.
- A linha de cabeçalho deve incluir todos os nomes das colunas exatamente como são apresentados aqui. Prática recomendada: Use o arquivo de exemplo em anexo como template. Ver exemplos de ficheiros CSV de decodificação para SKAN 3 e SKAN 4.
- Não use os seguintes caracteres como o primeiro carácter de uma coluna:
=,+,-, e@(editado).
Decodificar a especificação do arquivo csv
| Coluna | Valor obrigatório | Conteúdo | Informações |
|---|---|---|---|
| conversion_value |
Sim, para:
|
Valor inteiro 1-63 |
O mesmo valor de conversão preciso pode ser listado mais de uma vez. Confira os exemplos para mais explicações. |
| coarse_conversion_value |
Relevante apenas para o SKAN 4 |
String:
|
O mesmo valor de conversão bruto pode ser listado mais de uma vez. |
| event_name | Sim | Sequência de caracteres |
Evento in-app: Não tem que ser um evento que já existe na AppsFlyer. Atenção! Os nomes dos eventos in-app diferenciam entre maiúsculas e minúsculas. [Prática recomendada]: Nome do evento para a receita af_skad_revenue. |
| event_value | Não | Sequência de caracteres | String definido pelo desenvolvedor que contém dados a decodificar pelo anunciante nos seus sistemas. Normalmente, ele tem o formato de um JSON. |
| min_revenue |
Não
|
Inteiro ou flutuante |
Use os valores min_revenue e max_revenue para definir um intervalo de receitas em USD.
Atenção! Se você gerar o arquivo usando Excel, antes de guardar, altere o formato da coluna para vírgula e não para moeda para evitar que o Excel incorpore um símbolo $ no arquivo CSV. |
| max_revenue | Não |
Se você preencher min_revenue: max_revenue deve ter um valor superior a 0. Confira min_revenue para a explicação. |
|
| Não |
Descontinuado a partir de 7 de julho de 2021. Use min_revenue e max_revenue
|
||
| event_counter | Sim |
Inteiro
|
Exemplo: Se o usuário realizou um determinado evento 5 vezes, são gerados 5 eventos. Considerações: Se você enviar receitas, o valor total em USD comunicado é multiplicado pelo valor em event_counter. Ou seja, se min_revenue = 0, max_revenue = 3 e event_counter = 4, a receita total registrada é 1,5 X 4 = 6. Confira os exemplos. |
| hours_from_install | Sim | Inteiro |
A AppsFlyer usa isso para derivar e definir a data de instalação da seguinte forma:
|
| postback_sequence_index |
Sim, mas apenas relevante para o SKAN 4 |
Inteiro
|
Para o valor preciso, só pode ser recebido o valor 0. |
Carregar arquivo de esquema de valores de conversão
Antes de começar:
- Prepare o arquivo CSV do esquema de valores de conversão.
- Se você integrar o Meta Ads e medir as receitas, verifique se o seu esquema está em conformidade com as regras relativas ao Meta. Se não o fizer, os Meta Ads não conseguem interpretar o esquema.
Para ativar a mensuração do SKAN usando a mensuração por decodificação:
- Na AppsFlyer, acesse configurações > SKAN Conversion Studio.
- Clique em opções(⋮), selecione Carregar arquivo de mapeamento de decodificação.
- Se ainda não fez upgrade para o SKAN 4, escolha carregar um arquivo para o SKAN 4 ou pré SKAN 4. Depois de fazer upgrade para o SKAN 4, a escolha de outras versões fica indisponível.
- Siga um dos procedimentos abaixo:
- Clique em Arrastar e largar arquivo.
- Carregar arquivo de mapeamento atualizado
- Siga as instruções na interface do usuário para carregar o arquivo.
- Ative Mensuração do SKAN.
- Clique em Salvar alterações.
Observação: Durante as seguintes 48-72 horas, os dados no painel ficam ambíguos. Ou seja, devido a problemas com o temporizador do iOS, não podemos ter a certeza se o mapeamento de descodificação corresponde ao mapeamento de codificação usado por você. - Certifique-se de que você mapeou os seus eventos in-app para os usados pelos parceiros, de modo que esses possam consumir corretamente os postbacks.
Resolução de problemas no upload de arquivo CSV
Mensagens de erro de upload
Um ou mais valores no arquivo não correspondem ao formato exigido: O formato do arquivo foi alterado a partir de 7 de junho de 2021. Verifique se o formato do arquivo corresponde ao exemplo deste artigo.
Usar o Excel para formatar a coluna event_revenue_usd
Ao usar o Excel/Planilhas Google para criar um arquivo CSV, as colunas event_revenue_usd precisam ser formatadas corretamente antes de salvar o arquivo como um arquivo CSV.
Após salvar o arquivo CSV, verifique se o conteúdo está formatado corretamente. Observação: Não use o Excel para fazer a verificação, use um editor.
Formatação de células event_revenue_usd no Excel
O Excel geralmente formata células de valor com vírgula para separar os milhares, conforme mostrado na figura. Este formato não é adequado para carregar arquivos CSV. Também é necessário remover o símbolo $.
Você pode corrigir isso formatando as células no Excel.
Para formatar os valores de gastos sem uma vírgula 1000 ou o símbolo $:
- Selecione as células a serem formatadas.
- Clique com o botão direito e selecione Formatar células.
A janela formatar células é aberta. - Selecione Número.
- Desmarque Usar separador de 1000 (,).
- (Opcional) Defina o número de Casas decimais. O padrão é 2. O máximo permitido é 5.
- Clique em OK.
As células estão formatadas corretamente.
Inspeção visual do arquivo CSV sem Excel
Para examinar o conteúdo do arquivo CSV, use um editor para visualizar o arquivo.
- Windows: Notepad, Notepad++
- macOS: TextEdit
Veja a captura de tela abaixo com um exemplo de arquivo CSV exibido em um editor.
Visualização do editor
Usando um editor, examine o arquivo CSV. Preste atenção em:
- Espaços em branco: certifique-se de que não há espaços em branco à esquerda ou à direita antes ou depois das vírgulas que separam os campos. No Excel, use o comando @trim para remover espaços em branco.
-
event_revenue_usd: Certifique-se de que não há vírgula nem o símbolo $ na coluna event_revenue_usd.
Arquivos CSV gerados pelo Excel não possuem vírgulas como delimitadores
Se o Excel criar um arquivo CSV com ponto e vírgula ";" ou outro caracteres como delimitador, mas não como vírgula:
- Isso ocorre quando as configurações regionais do seu computador estão definidas para um idioma/região que não é o inglês.
- Esse problema é particularmente prevalente quando o alemão é selecionado nos contextos regionais.
- A solução difere dependendo do sistema operacional do seu computador (macOS ou Windows).
- Para resolver esse problema, procure as orientações mais recentes da Microsoft ou de outros fóruns. Use os seguintes termos de pesquisa: Operating system (macOS or Windows) Excel change delimiter for CSV files.