From Wiki

AppsFlyer App Tracking

Funcionalidades Chave e Limitações

• Os postbacks da AWIN no Appsflyer são GLOBAIS (não-customizáveis)

• Rastreamento de eventos, postbacks de INSTALL e IN-APP funcionais em iOS e Android.

• Suporta deep-linking e deferred deep-linking

• Link de rastreamento Appsflyer – O Onelink é capaz de detectar o tipo de dispositivo (Android, iOS, desktop etc.) quando registra um click e direciona os usuários ao destino respectivo.

Como integrar o tracking Awin via Appsflyer

1. Antes de tudo, é NECESSÁRIO, que o anunciante tenha integrado o SDK com seu app, esta etapa deve ser feita com o suporte da Appsflyer caso necessário.

De qualquer forma, o tracking Awin precisa que os seguintes parâmetros sejam enviados pelo evento In-App

• af_revenue -> Deve ser populado com o TOTAL pago pelo usuário. Se for um evento lead, deve ser populado com o valor "1.00".
• af_order_id -> Deve ser populado com o ID do pedido, ou um número único identificador de leads se for um evento lead.
• af_currency -> Deve ser preenchido com moeda usada na compra
• af_class -> (OPCIONAL) Deve ser populado com o grupo de comissão do pedido (não suporta múltiplos valores).
• awin_cg -> Deve ser preenchido com o detalhamento de grupo de comissões (a ser introduzido apenas para detalhamento de grupo de comissões)
• af_coupon_code -> Deve ser preenchido com o código do cupom (opcional)

SDK example: {"af_order_id":"7423732","af_revenue":31.72, "af_currency":"EUR", "af_class": "NEW", "awin_cg": "NEW_NV:10|MP_PRODUCTS:19.99", "af_coupon_code: "FREE20"}

2. Escolher a Awin da lista de parceiros integrados.

3. Configurações gerais:

4. Configurações de eventos In-App

• Popular "merchant" com seu merchant ID Awin. (é seu ID de anunciante, ou ID de conta)
• Ativar os postbacks de eventos In-App
• Configurar "Sending Option" para: "Only events attributed to this partner"
• Selecionar os eventos (SDK Event Name) que deseja rastrear
• Inserir o grupo de comissão do evento em "Partner Event Identifier", converse com seu account manager para entender qual grupo de comissão usar, mas geralmente, podemos utilizar "APP_PURCHASE"

• Configurar "Send Revenue" para: "Values & Revenue"

5. Gere um tracking link

• Popular o valor do parâmetro de nome
• Ativar Re-targeting (Re-attribution)
• Definir a janela de loopback (default 7 days) – É o tempo a partir de click até uma instalação - Se não houver parâmetro loopback no tracking link, este será por padrão 7 dias, porém, a Awin pode adicionar o parâmetro com o tempo desejado (ex. 30 dias).

Tracking Link

Estrutura do Tracking Link

• O parâmetro cks deve ser populado com o click checksum da seguinte forma: !!!awc!!!

• Para que o tracking link seja elegível para atribuição, o parâmetro "af_siteid" deve ser populado com "!!!id!!!" (sem aspas).

Aqui um exemplo de como o seu OneLink deve estar no final:

https://empower.onelink.me/GQnh/?pid=affiliatewindow_int&af_click_lookback=7d&cks=!!!awc!!!&af_siteid=!!!id!!!&is_retargeting=true&af_reengagement_window=30d

Para ficar mais fácil, uma lista dos parâmetros necessários e opcionais de um OneLink:

Link de Rastreio iOS

https://app.appsflyer.com/id1136397354?pid=affiliatewindow_int&af_click_lookback=7d&cks=!!!awc!!!&af_siteid=!!!id!!!

Link de Rastreio Android

https://app.appsflyer.com/finance.empower?pid=affiliatewindow_int&af_click_lookback=7d&cks=!!!awc!!!&af_siteid=!!!id!!!

OneLink Deeplinking

O OneLink capacita marketeiros a criar um deep link único que direciona o usuário à página correta dentro do app mesmo que originem de quaisquer SO's possíveis, canais e plataformas.

OneLink™ é um tracking link único da Appsflyer, onde os anunciantes podem utilizar de 3 funções principais com um único click:

• Detecção de dispositivo e Redirecionamento: O OneLink é capaz de detectar o tipo de dispositivo (Android, iOS, desktop etc.) quando registra um click e pode redirecionar o usuário para o destino respectivo a plataforma.
• Deep Linking: Se o app já estiver instalado, o OneLink é capaz de abrir o aplicativo após o click e/ou servir ao usuário conteúdo personalizado (como redirecionar o usuário para uma página específica dentro do app)
• Deferred Deep Linking: Se o app não estiver instalado, o OneLink pode redirecionar o usuário para uma página específica dentro do app, após a instalação do app!

Sobre os deeplinks:

• AWIN oferece suporte a um esquema de URI, mas não ao tratamento de links universais para iOS e métodos de deeplinks para aplicativos Android. Isso se deve ao empacotamento do link. Aplica-se a qualquer link usado na AWIN. Para criar um deeplinks com o OneLink via AWIN, você precisará configurar o URL do OneLink com um esquema de URI. De preferência, o desenvolvedor do seu aplicativo deve configurar o SDK para oferecer suporte a URL HTTP como um valor de link direto. Para aplicativos iOS, use o parâmetro af_force_deeplink=true no URL do OneLink para ativar o esquema de URI de deeplinks .

• Se o esquema URI for preenchido no parâmetro af_dp, o usuário será direcionado consistentemente para a página estática dentro do aplicativo. No entanto, nos casos em que o aplicativo não estiver instalado, o Safari exibirá um erro de endereço inválido. Este método não oferece suporte a links diretos dinâmicos. Como alternativa, se o desenvolvedor do aplicativo implementar o tratamento de URLs HTTP convertendo-os em esquemas de URI que o aplicativo possa entender (por exemplo, tornando-os destinos de produtos legíveis pelo aplicativo), os usuários serão direcionados para a página do produto relevante no aplicativo. Notavelmente, esta abordagem evita a exibição de um erro de endereço inválido no Safari quando o aplicativo não está instalado.

Postbacks de exemplo

Install postback - iOS e Android

https://www.awin1.com/sread.php?tt=ss&tv=2&type=ai&merchant=$$mfn(coalesce,$$click(awinmid),$$dashboard(merchant))&amount=1.00&ref=(transaction-id)&parts=download:1.00&cks=(coalesce,(awc),(cks))&p1=(platform)&p2=(os-version)&p3=(device-type)&p4=(appsflyer-device-id)&p5=re-engagement:(is-reengage)&p6=re-attribution:(is-reattr)&p30=appsflyer

In-app postback

https://www.awin1.com/sread.php?tt=ss&tv=2&type=ap&merchant=$$mfn(coalesce,$$click(awinmid),$$dashboard(merchant))&amount=$$mfn(if,$$mfn(equals,$$sdk(af_revenue),N%2FA),1.00,$$sdk(af_revenue),false)&ref=$$mfn(coalesce,$$sdk(af_order_id),$$mfn(str,$$sdk(appsflyer-device-id),$$sdk(unix-ts)))&parts=$$mfn(coalesce,$$sdk(af_class),$$sdk(mappediae)):$$mfn(if,$$mfn(equals,$$sdk(af_revenue),N%2FA),1.00,$$sdk(af_revenue),false)&cks=$$mfn(coalesce,$$click(awc),$$click(cks))&cr=$$mfn(coalesce,$$sdk(af_currency),$$sdk(currency))&p1=$$sdk(platform)&p2=$$sdk(os-version)&p3=$$sdk(device-type)&p5=re-engagement:$$sdk(is-reengage)&p6=re-attribution:$$sdk(is-reattr)&p4=$$sdk(country-code)&p7=$$sdk(event-name)&p8=$$sdk(appsflyer-device-id)&p30=appsflyer