API de eventos Servidor para servidor para PBA (Web-S2S)

A implementação da API requer as seguintes credenciais disponíveis no painel:

• ID do agrupamento (também conhecida como ID do agrupamento da marca)
• Chave do desenvolvedor web 

Para obter as credenciais: 

1. Na AppsFlyer, no menu superior, selecione Meus aplicativos > Exibir agrupamentos de marca.
   A lista de agrupamentos é exibida.
2. Copie e registre:
   • ID do agrupamento de marca
   • Chave do desenvolvedor web

Noções básicas da API Web S2S

 Exemplo de Curl setCuId

curl --location --request POST 'https://webs2s.appsflyer.com/v1/bundleId/setcuid' \
--header 'Accept-Encoding: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customerUserId": "1234567890abcdef",
	"afUserId":"9999999-f848-4963-a091-568f0bf9a361",
        "webDevKey" : "99999999-9999-9999-9999-999999999999"}

Os parâmetros de carga útil são divididos em identificadores de usuário e parâmetros de evento. 

• ID do usuário: você deve enviar pelo menos um parâmetro de ID de usuário.
• Evento: envie os parâmetros obrigatórios e opcionais conforme necessário.

Parâmetros do identificador do usuário (enviar pelo menos um parâmetro)

Parâmetros do evento

curl --location --request POST 'https://webs2s.appsflyer.com/v1/bundleId/event' \
--header 'Accept-Encoding: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customerUserId": "1234567890abcdef",
	"afUserId":"9999999-f848-4963-a091-568f0bf9a361",
    "webDevKey" : "99999999-9999-9999-9999-999999999999",
    "ip" : "192.0.2.1",
	"eventType":"EVENT",
	"timestamp" : 1234567890123,
	"eventName":"my_web_event",
	"eventRevenueCurrency" : "EUR",
	"eventRevenue" : 1234.56,
	
		"eventValue": {
		"purchase":{
		 "shoes": "color",
		 "quantity" : "3",
		 "Revenue" : "1234.56",
		 "Currency" : "ZAR"
		}
	}

}'

''' using the requests python package, install using pip install requests  '''
import requests
url = "https://webs2s.appsflyer.com/v1/bundleId/event"
payload = {
    "customerUserId": "1234567890abcdef",
    "afUserId": "9999999-f848-4963-a091-568f0bf9a361",
    "webDevKey": "99999999-9999-9999-9999-999999999999",
    "ip": "192.0.2.1",
    "eventType": "EVENT",
    "timestamp": 1234567890123,
    "eventName": "my_web_event",
    "eventRevenenuCurrency": "EUR",
    "eventRevenue": 1234.56,
    "eventValue":
        {
            "purchase":
            {
                "shoes": "color",
                "quantity": "3",
                "Revenue": "1234.56",
                "Currency": "ZAR"
            }
        }
    }
headers = {
    'Accept-Encoding': 'application/json',
    'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text.encode('utf8'))

Para fins de teste, envie vários eventos da seguinte maneira:

1. Envie um evento.
2. Certifique-se de obter um código de retorno 200 OK. Caso contrário, execute uma ação corretiva usando os códigos de retorno e as mensagens de erro.
3. Aguarde várias horas após a meia-noite UTC para ver o evento relatado nos dados brutos do PBA. Você deve aguardar porque os dados do PBA são processados uma vez por dia. 

 Para obter a chave do desenvolvedor web:

1. Na AppsFlyer, vá para a aba Meus Aplicativos.
2. Clique em Visualizar agrupamentos de marca.

   

3. Copie a chave do desenvolvedor web necessária. 

• O afUserId é um identificador exclusivo definido pelo Web SDK quando um usuário visita seu site pela primeira vez.
• Se você precisar afUserIduse um dos métodos a seguir.

Obtenha afUserId do cabeçalho do cookie HTTP

• O afUserId é enviado pelo navegador de visitantes em chamadas para o seu site.
•  Extraia-o do cabeçalho do cookie HTTP, se necessário.

Visualizando afUserId no navegador do visitante

•  Visualize oafUserId no navegador do visitante, para fins de solução de problemas e depuração.
• Para que ele esteja disponível, o visitante precisa ter visitado primeiro uma página com o Web SDK pelo menos uma vez. 
• O cookie que contém afUserId é um cookie primário em relação ao seu domínio.
• O procedimento a seguir foi preparado usando o Chrome 81. Pode haver algumas diferenças entre vários navegadores e sistemas operacionais.

Para obter o afUserId do navegador do visitante:

1. No seu navegador, acesse seu site.
2. Clique com o botão direito do mouse, selecione Inspecionar
   A janela do elemento de inspeção do navegador é aberta.

   

3. Vá para a aba (A) Aplicativo.
4. No menu lateral (B), expanda Cookies.
5. Selecione seu site. Se ele não for exibido, atualize o navegador.
6. No campo de filtro (C), insira afUserId
   O valor de afUserID é exibido. 

• Sintoma: Os códigos de retorno HTTP não retornam
  Solução: Incluir servidores da AppsFlyer na lista de permissões