Awin Branch PT
From Wiki
Contents |
Branch App Tracking
Principais Características e Limitações
- Os templates de postback são globais por padrão mas podem ser customizados no painel de integração
- A atribuição é baseada no last click e as janelas de atribuição podem ser alteradas em Ad Partners
- Os Grupos de Comissão podem ser configurados dinamicamente ou em breakdown
- Order reference e sale amount estão disponíveis no SDK por default
- O deeplinking para páginas específicas é suportado via parâmetro canonical URL
- O deeplinking app to app em iOS requer um parâmetro adicional uri_redirect_mode que força a abertura do app
- O Awin Merchant ID pode ser passado no Branch tracking URL via parâmetro awin_merchant_id. Ele terá prioridade sobre o Merchant ID configurado no painel
Etapas da Integração
1. Anunciante faz a integração no SDK
2. Grupos de comissão dinâmicos ou em breakdown podem ser integrados no SDK
let event = BranchEvent.standardEvent(.purchase)
event.cg = "NEW:34.00“
Nota: O parâmetro parts dentro do postback deve ser ajustado de acordo &parts=${ (event_data.cg)!}
3. Anunciante deve habilitar as configurações de Ad Partners no painel Partner Management
4. Popular o Account ID com o Awin Merchant ID em ACCOUNT SETTINGS
5. Definir métricas em ATTRIBUTION WINDOWS
- Install (período default é de 7 dias)
- Purchase (o período de atribuição deve ser o mesmo setado na plataforma da Awin – geralmente 30 dias)
6. Habilitar (selecionar ENABLE) os postbacks para os eventos Install e Purchase
Nota: NÃO selecione ALL EVENTS, isso fará com que todos postbacks sejam enviados (incluindo os não atribuídos) à Awin
7. Customize o evento de compra em Postback Config
8. Crie o tracking link
Install Postback
https://www.awin1.com/sread.php?tt=ss&tv=2&type=ai&merchant=${(ad_network.credentials.awin_advertiser_id)!} &amount=1&ref=${(timestamp)!}&parts=INSTALL:1&testmode=0&cks=${(last_attributed_touch_data.~click_id)!} &p1=${(user_data.os)!}
Purchase Postback
https://www.awin1.com/sread.php?tt=ss&tv=2&type=ap&merchant=${(ad_network.credentials.awin_advertiser_id)!} &amount=${(event_data.revenue)!}&ref=${(event_data.transaction_id)!}&parts=INAPP-SALE:${(event_data.revenue)!} &cks=${ (last_attributed_touch_data.~click_id)!}&cr=${(event_data.currency)! }&p1=${(user_data.os)!}
Deeplinking
- Quando o app NÃO está instalado usuários vão ser redirecionados ao App Store
- Quando o app ESTÁ instalado e suporta Deeplinking usuários vão ser redirecionados ao app
- Para dispositivos IOS o Branch pode forçar a abertura do app, basta adicionar $uri_redirect_mode=1 para abrir o pop up perguntando se o usuário deseja abrir o app
$uri_redirect_mode=0
Modo de conservação default.
- Por default o Branch não vai tentar abrir o app se o usuário se deparar com um erro
$uri_redirect_mode=1
Modo de redirecionamento inteligente.
- O Branch identifica que o usuário tem o app instalado então força a abertura do app
$uri_redirect_mode=2
Modo de redirecionamento forçado.
- Sempre forçará a abertura do app, mesmo com o risco de mostrar uma mensagem de erro quando o app não está instalado
Gerando um Branch Tracking Link
Criando um Ad Link
Selecionando Ad Format
Dentro do painel Branch, clique no botão Create no canto superior direito.
Um Create Ad Link vai aparecer. Selecione um dos seguintes ad formats:
App Only
- App Install ou Engagement
Cross-Platform Display
- Create Display Link
- Create Search Link
Diferença Entre Tipos de Formatos
Para campanhas de App Install ou App Engagement você deve selecionar formato "App Only". Para campanhas Search ou Display onde o usuário deve ir para web caso não possua o app você deve selecionar Cross-Platform Search ou Cross-Platform Display. Product Links são para campanhas de venda ou re-marketing dinâmico.
Definindo Ad Link Domain & Ad Partner
O tracking link URL pode ser habilitado como Mobile Prefix para Mobile ou tráfego non-Mobile
Parâmetros necessários no Branch Tracking Link
Parâmetro | Requisitos |
%243p=a_awin | Mandatório - Identificador que atribui o evento à Awin |
~click_id=!!!awc!!! | Mandatório - Awin click ID a ser populado com o awc |
$uri_redirect_mode=1 | Mandatório – Força a abertura do app no iOS |
~campaign=!!!companyname!!! | Mandatório – Retorna o nome do afiliado |
$fallback_url=!!!redirectURL!!! | Mandatório – Direciona para uma URL específica quando o app não está instalado e redireciona usuários para destinos diferentes do app store |
$canonical_url=!!!merchantURLcm!!! | Permite o deeplink a uma página específica no app. URL deve ser codificada |
$deeplink_path | Configura o caminho do deep link para todas plataformas – para que você não precise habilitar na plataforma. Quando o SDK do Branch recebe um link com esse parâmetro configurado ele irá carregar automaticamente o caminho URI customizado |