Antes de começar
Para se integrar com o anunciante na AppsFlyer, registre-se como um parceiro do Ad Integrated.
Se você já tem uma integração com a AppsFlyer, entre em contato com a equipe deles em [email protected].
Integração geral
Para iniciar a integração, você precisa enviar à AppsFlyer o URL de rastreamento e o URL de postback para fins de relatório.
URL de rastreamento da AppsFlyer
Na AppsFlyer, vá para Configuração > Integrações ativas > Link de atribuição.
Prepare um URL de rastreamento da AppsFlyer para a integração usando os parâmetros obrigatórios.
Parâmetros obrigatórios do link de rastreamento:
clickid | {clickid} | Um identificador de clique exclusivo |
af_siteid | {pid} | Um ID exclusivo que identifica o editor |
af_c_id | {offer_id} | A ID da oferta |
c | {offer_name} | O título da oferta |
⚠️ Você não precisa preencher o pid=medianame_int, a equipe da AppsFlyer faz isso.
O exemplo de URL de rastreamento da AppsFlyer:
http://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}&c={offer_name}
2. No Affise, insira o link no campo Tracking URL em Offers > a certain Offer > Tracking.
Chave criptografada
Pode haver casos em que você precise passar a receita para seu anunciante em um URL de rastreamento da AppsFlyer. Você indica essa receita em Ofertas > uma determinada oferta > Pagamentos.
Se não quiser revelar o valor real do custo, você pode criptografá-lo em um URL de rastreamento da AppsFlyer usando a chave af_cost_value={max_income}.
O sistema Affise conta todos os pagamentos na oferta: tanto gerais quanto pessoais.
Para tornar o parâmetro disponível, faça o seguinte:
Obtenha sua chave de criptografia da AppsFlyer.
No painel de administração do Affise > Configurações > Appsflyer, insira essa chave de criptografia no campo Chave de criptografia.
Depois de executar a integração de criptografia de custo com a AppsFlyer, você terá acesso à lista de redes de anúncios com suporte de custo.
Quando a integração de custo estiver pronta, atualize seu URL de rastreamento da AppsFlyer com af_cost_value={max_income} e use-o em sua oferta do Affise.
O URL tem a seguinte aparência:
https://app.appsflyer.com/id554782625?&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}&af_cost_model=CPI&af_cost_value={max_income}&af_cost_currency=USDLeia mais sobre o custo criptografado aqui.
URL de postback da Affise
Para receber conversões no Affise, você precisa obter um link de postback no Affise e configurá-lo na AppsFlyer.
Você pode configurar dois tipos de URLs de postback do Affise com base em suas necessidades: postback de instalação global e postback de evento in-app.
Na AppsFlyer, vá para Perfil > Gerenciamento de postback > Postbacks padrão.
Configure seu postback nos campos URL de postback de instalação e URL de postback de evento in-app.
Adicione os campos obrigatórios. Você precisa usar os parâmetros de postback do Affise e as macros da AppsFlyer.
Os parâmetros e macros obrigatórios são:
pid | {af_siteid} | ID do editor. Verifique tanto na instalação quanto no aplicativo. |
offer_id | {af_c_id} | ID da oferta no Affise. Verifique tanto na instalação quanto no aplicativo. |
clickid | {clickid} | ID do clique. Verifique tanto na instalação quanto no aplicativo. |
objetivo | {partner_event_id} | Valor da meta do Affise correspondente ao nome do evento da AppsFlyer. Marque apenas In-app. |
4. Opcional. Adicione campos personalizados, se necessário, para passar informações adicionais.
Um link de postback do Affise para o exemplo da AppsFlyer:
https://offers-rocketcompany.affise.com/postback?pid={af_siteid}&offer_id={af_c_id}&clickid={clickid}&goal={partner_event_id}&custom_field1={oaid}5. Opcional. Se você trabalha com campanhas de aplicativos iOS, é necessário fazer a mesma configuração em Profile > Postback management > Advanced privacy. A única diferença é que você não precisa usar o ID de clique e precisa de mais parâmetros adicionais para uma melhor correspondência de cliques e conversões.
Leia mais sobre a atribuição probabilística aqui.
Postback de evento in-app
Para receber postbacks de eventos in-app, configure metas em Ofertas > uma determinada oferta > Pagamentos.
⚠️ O valor da meta"1" no sistema Affise sempre se refere ao evento de instalação . Se a meta não for especificada no URL do Postback, a conversão terá o valor de meta"1" por padrão.
O valor da meta se refere ao valor do evento da AppsFlyer:
Postback de instalação de fraude
Quando você recebe postbacks da AppsFlyer, o sistema Affise não diferencia automaticamente entre postbacks reais e fraudulentos. Como resultado, você recebe todas as conversões registradas como reais e precisa pagar por elas.
Para resolver o problema, você pode configurar pagamentos zero e um postback separado para que as conversões fraudulentas sejam recusadas.
Para configurar pagamentos zero, faça o seguinte:
Em Offers (Ofertas) > a certain offer (uma determinada oferta) > Payouts (Pagamentos), adicione um novo pagamento.
Defina a receita e os pagamentos como 0.
Adicione uma nova meta a esse pagamento.
Para recusar conversões com base em postbacks de fraude, você precisa configurar um URL de postback separado para conversões de fraude:
Adicione o parâmetro de comentário com as macros da AppsFlyer {blocked-reason}, {blocked-reason-value}, {blocked-sub-reason} para definir dados de fraude ao URL de postback do Affise.
Adicione o parâmetro status=3 ao URL de postback do Affise para recusar automaticamente as conversões por fraude.
Adicione a meta que você definiu para pagamentos zero.
Exemplo de URL de postback de instalação de fraude:
http://offers.rocketcompany.affise.com/postback?clickid={clickid}&custom_field1={af_siteid}&comment={blocked-reason}_{blocked-reason-value}_{blocked-sub-reason}_blockedbyAF&status=3&goal=4Atribuição probabilística
Quando você trabalha com atribuição probabilística, não é possível passar o valor do ID do clique. Os URLs para a integração exigem alguns outros parâmetros e macros obrigatórios.
URL de rastreamento probabilístico da AppsFlyer
Atualize um URL de rastreamento da AppsFlyer com as macros obrigatórias {pid} e {offer_id} .
Adicione mais parâmetros e macros, se necessário.
O exemplo de URL de rastreamento da AppsFlyer:
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&af_siteid={pid}&af_c_id={offer_id}Dados do agente do usuário para navegadores baseados no Chrome 110
Há uma peculiaridade para configurar a atribuição probabilística (tanto para cliques quanto para impressões) para dispositivos Android ou desktop iniciados a partir de navegadores baseados em cromo (Chrome, Edge, Opera e outros). Esse tráfego inclui dados reduzidos do cabeçalho do agente do usuário. Nesse sentido, é necessário transmitir as informações sobre a versão do sistema operacional e o modelo do dispositivo juntamente com os dados do agente do usuário.
Para transmitir os dados corretamente, além das macros obrigatórias {pid} e {offer_id} para cliques e das macros {oid} e {aid} para impressões, use as seguintes macros do Affise:
{device_ua} para passar os dados do agente do usuário.
{os_version} para passar os dados da versão do sistema operacional.
{device_model} para passar dados do modelo do dispositivo.
Encontre os parâmetros da AppsFlyer aqui.
O exemplo de URL de rastreamento da AppsFlyer:
https://app.appsflyer.com/com.appsflyer?pid=mediaName_int&af_siteid={pid}&af_c_id={offer_id}&af_ua={device_ua}&af_os_version={os_version}&af_model={device_model}URL de postback probabilístico do Affise
A amostra recomendada do link de postback probabilístico para a Appsflyer:
https://offers-rocketcompany.affise.com/probattribution?action_id={postback_id}&goal={partner_event_id}&offer_id={af_c_id}&pid={af_siteid}&country={country_code}×tamp={attributed_touch_hour}&sub2={af_sub_siteid}&action_timestamp={event_hour}&platform={platform}🔎 Encontre mais parâmetros aqui.
Se você quiser usar as opções de duração da sessão Click&Impression ou Minimal click&Impression, adicione os parâmetros timestamp e action_timestamp ao seu link de postback. Mais detalhes estão aqui.
⚠️ A Appsflyer envia postbacks com um atraso de até 24 horas. Por exemplo, uma conversão ocorreu às 14:30, mas o postback veio às 19:45. O tempo para enviar um postback é aleatório.
Esse atraso causa várias limitações:
Não há oportunidade de usar o relatório Time to Action (CTIT) no Affise.
Não há oportunidade de usar a automação de CR, clique e KPI em um período inferior a 24 horas.
Entre em contato com a equipe de Suporte ao Cliente da Affise sobre todas as questões levantadas por meio do e-mail: [email protected].