• Os parâmetros de payload consistem em um ou mais identificadores de dispositivo (dependendo do sistema operacional).
• E se eu não conseguir enviar um identificador de dispositivo?
  • É possível que você não consiga enviar o identificador por um motivo fora de seu controle, como, por exemplo, porque o usuário tem rastreamento limitado de anúncios (LAT) ou usa o iOS 14 e não deu seu consentimento à ATT. Se o IDFV estiver disponível, envie-o. 
  • Não enviar um ID de publicidade/dispositivo pode causar: 
    • Problemas de postback: a fonte de mídia receberá o postback, mas sem um identificador de dispositivo. Consequentemente, a fonte de mídia não consegue associá-lo a um usuário. 
    • Segmentação de públicos e falha de regra. Os conjuntos de regras para audiências exigem identificadores.É sempre uma boa prática enviar um ID de dispositivo ou ID de usuário do cliente de acordo com o tipo de ID que seu conjunto de regras usa, para cada evento S2S. Entretanto, se os identificadores da AppsFlyer tiverem sido enviados por outros meios (SDK ou evento S2S passado), novos eventos em EPS serão combinados com os usuários corretos, mesmo que nenhum identificador seja enviado com os eventos.       

"custom_data" : {"key_group" : { 
"key_a1" : "value a1", 
"key_a2" : "value a2" 
},
"key_b" : "value b"
}

curl --location --request POST 'https://api2.appsflyer.com/inappevent/' \
--header 'authentication: <dev_key_placeholder>
' \
--header 'Content-Type: application/json' \
--data-raw '{
  "appsflyer_id": "9999999999999-9999999999999999999",
	"advertising_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
	"customer_user_id" : "example_customer_id_123",
	"ip": "199.0.2.1",
	"app_version_name" : "example_version_name",
	"eventTime" : "2020-02-25 12:00.000",
	"eventName": "af_purchase",
	"eventCurrency": "ZAR",
        "os" : "14.6",
        "att" : 3,
	"eventValue": 
	"{
		\"af_revenue\": \"1006\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }"
}
'

Considere: 

• Para testar, use a IDA da AppsFlyer de uma instalação não orgânica para que o evento teste seja atribuído em tempo real. Eventos orgânicos são atribuídos com um atraso de algumas horas.
• Alguns campos de eventos são preenchidos usando o evento de atribuição de instalação do usuário. Por exemplo, hora de instalação e a fonte de mídia. 

Para atribuir o dispositivo de teste como uma instalação não orgânica:

1. Prepare um link de atribuição personalizado para testar mensagens S2S.  Defina o parâmetro de fonte de mídia no link como s2s_test e defina o id de anúncio (GAID, IDFA, etc) no link, conforme ilustrado nos trechos de link de atribuição de exemplo. 
2. Registre o dispositivo de teste
3. Desinstale o aplicativo do dispositivo de teste.
4. Envie o link para o dispositivo de teste.
5. Clique no link.
6. Instale e inicie o aplicativo.
7. No painel, verifique se a instalação está atribuída.
8. Busque a ID da AppsFlyer para usar na sua mensagem S2S.

Para enviar a mensagem S2S de teste:

1. Prepare uma mensagem S2S usando a ID da AppsFlyer designada. Veja exemplos de código a seguir.
2. Envie a mensagem.
3. Siga um destes procedimentos para ver como a mensagem é gravada na AppsFlyer:
   • Faça o download do relatório de dados brutos de eventos in-app. Aguarde até 15 minutos após o envio do evento para que ele apareça no relatório de dados brutos. 
   • Push API (Considere usar ferramentas como Postman e o Webhook site.
4. Verifique e veja que:
   • Os valores enviados na mensagem S2S preenchem corretamente o relatório. Preste especial atenção aos campos Data do evento, Moeda do evento, Receita do evento e Valor do evento.
   • A fonte de atribuição e o tempo de instalação são preenchidos pela AppsFlyer.
   • Os valores fornecidos pelo próprio SDK, como a versão do SDK, não são preenchidos.

Android

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&advertising_id=<GAID>

iOS

https://app.appsflyer.com/<app_id>?pid=s2s_test&c=test&idfa=<IDFA>

• A ID de publicidade/identificador do dispositivo é obrigatória para garantir postbacks para SRNs, como Facebook e Google Ads. Se você não conseguir enviar a ID, leve em consideração que os postbacks não podem ser enviados.
• Se você enviar apenas a ID da AppsFlyer, os eventos in-app serão gravados e atribuídos corretamente.

Quando a AppsFlyer processa eventos in-app S2S, os campos de atribuição são preenchidos usando a ID da AppsFlyer para identificar o evento de instalação associado que precedeu os eventos in-app.

O que isso significa é que alguns dados que a AppsFlyer associa a eventos in-app S2S não orgânicos não estão associados a eventos in-app S2S orgânicos.

A lógica do back-end é necessária para obter valores para preencher o parâmetro. Veja a seguir como você pode obter a ID da AppsFlyer:

• A ID da AppsFlyer é obrigatória e é usada para atribuir eventos.
• É gerada quando um usuário instala o aplicativo móvel pela primeira vez.
• Para que você possa mapear seu CUID para o ID da AppsFlyer, é necessário definir o CUID no aplicativo. 

Para que seja mais fácil saber qual usuário executou qual evento, implemente o fluxo abaixo:

• Defina a ID de usuário cliente quando o usuário instalar o aplicativo.
• Os relatórios de dados brutos da AppsFlyer contêm a CUID e a ID da AppsFlyer. Use uma das ferramentas de entrega de dados para obter essa API ou a Push API da AppsFlyer. 
• Use os relatórios de dados brutos para combinar a CUID com a ID da AppsFlyer. 
• O ID da AppsFlyer está disponível no SDK integrado ao seu aplicativo (Android/iOS).
• Mapeie a ID da AppsFlyer para a ID de usuário cliente em seus sistemas internos (importante para uso futuro).

Depois de mapear a ID da AppsFlyer com sua CUID, você pode associar o usuário aos eventos realizados. Você pode obter os outros valores (valor do evento, moeda do evento, horário do evento etc.) e enviar o evento in-app servidor para servidor.  

{
  "appsflyer_id": "1415211453000-6513894",
	"advertising_id": "38412345-8cf0-aa78-b23e-10b96e40000d",
	"eventName": "af_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"6\",
                \"af_currency\" \"USD"\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	"ip": "1.2.3.4",
	"eventTime": "2014-05-15 12:17:00.000"
}

appsflyer_id é um parâmetro obrigatório em mensagens de evento de servidor para servidor. A AppsFlyer usa esse parâmetro para atribuir o evento ao dispositivo original e à fonte de mídia atribuída. Você pode obter a ID usando um dos seguintes métodos:

• No dispositivo móvel chamando a API do SDK da AppsFlyer: Android, iOS.
• Na plataforma da AppsFlyer, use um dos seguintes: Pull API Push API,Exportar instalação de dados brutos.

Eventos com um valor negativo de receita podem ser enviados. Por exemplo, se uma compra foi cancelada. O parâmetro af_revenue pode ter valores negativos para registrar isso. 

Se você preencher uma af_quantity, poderá preenchê-la com um valor negativo, dependendo da lógica do sistema. A AppsFlyer não utiliza af_quantity .

Exemplo com receita negativa

{
	"eventName": "cancel_purchase",
	"eventValue": 
	"{
		\"af_revenue\": \"-6\",
		\"af_content_type\": \"wallets\",
		\"af_content_id\": \"15854\",
		\"af_quantity\" :\"1\"
   }",
	"eventCurrency": "USD",
	
}

• Ponto final: verifique se o ponto final usado está correto.
• Verifique se o payload contém os parâmetros obrigatórios. Veja aqui.
• Certifique-se de que a ID da AppsFlyer que você está usando para disparar o evento é uma appsflyer_id real e que está realmente instalada no aplicativo específico. Não é uma ID de teste fornecida na documentação. Veja aqui.
• Os eventos S2S não oferecem suporte a vários eventos em uma solicitação S2S. Cada evento deve ser enviado como um evento separado.
  • Os eventos podem ser enviados com método assíncrono para facilitar o tempo de resposta.
• No painel de visão geral, o período está relacionado à data de instalação do aplicativo (LTV) e não à data do evento.
  • Certifique-se de selecionar o período correto.
  • Certifique-se de que o período do painel corresponde à data de instalação do dispositivo (appsflyer_id) e não à data do evento.
• Relatórios de dados brutos do evento: o período está relacionado à data do evento e não à data da instalação.

Se você enviar eventos S2S, mas sua receita não for registrada: certifique-se de que o JSON que você envia está em formato de sequência. A parte mais importante é o parâmetro do valor do evento no JSON. Deve estar em sequência como mostrado no exemplo a seguir.

"{\"af_revenue\":\"6\" ,\"af_content_type\":\"wallets\"}"

Se não estiver em sequência, o valor do evento não será processado corretamente e a receita não será gravada.

Os valores da receita não devem ser formatados. Eles podem conter um ponto decimal. Não inclua sinais de moeda ou códigos, nem delimitadores como ,. A receita pode ser precedida por um -

• Os exemplos de valores válidos são: 123, -123.45, 123.456 
• Exemplo de valores ilegais: 1,234.56, 1,234

Os campos de dados brutos são preenchidos usando o valor enviado na chamada S2S e alguns campos são preenchidos usando o evento de instalação. Comportamento semelhante, mas não idêntico, é observado para eventos no aplicativo relatados usando o SDK da AppsFlyer. Existem algumas diferenças, como os seguintes campos, que não são preenchidos para eventos S2S:

• WiFi
• Operator
• language
• Tipo do dispositivo
• Categoria de dispositivo
• Versão do aplicativo: você pode usar app_version_name
• Nome do aplicativo