Visão geral: envie eventos avançados dentro do aplicativo pelo seu aplicativo da AppsFlyer para Meta ads.
Mapeamento de eventos in-app do Meta
Os anunciantes mapeiam seus eventos in-app, SDK ou de servidor para servidor para eventos do Meta predefinidos. Os anunciantes também podem enviar postbacks do Meta sobre cada inicialização de aplicativo ou qualquer desinstalação de aplicativo conhecidas.
Isso permite que os anunciantes utilizem os recursos avançados de otimização do Meta, bem como criem segmentos de público personalizado e semelhante.
Mapeamento de eventos predefinidos
Os anúncios do Meta oferecem uma ampla gama de eventos que já estão predefinidos e podem ser mapeados.
Encontre aqui a lista de eventos avançado dentro do aplicativo que podem ser enviados para o Meta com parâmetros adicionais que fornecem informações extras sobre a qualidade dos eventos.
Saiba mais sobre como mapear eventos no Meta.
Observe que não há evento predefinido para enviar desinstalações para anúncios do Meta. Para enviar desinstalações, use um evento personalizado.
Abaixo está a lista de outros eventos do Meta predefinidos que não possuem parâmetros adicionais:
| Identificador de evento do Meta |
Descrição |
Nome recomendado do SDK da AppsFlyer |
|---|---|---|
| Doar |
A doação de fundos para sua organização ou causa. |
af_donate |
| Agenda |
O agendamento de um horário para visitar um dos seus locais. |
af_schedule |
| Enviar inscrição |
O envio de uma inscrição para um produto, serviço ou programa que você oferece, como cartão de crédito, programa educacional ou emprego. |
af_submit_application |
| Encontrar local |
Quando uma pessoa encontra um dos seus locais via web ou aplicativo, com a intenção de visitá-lo. Por exemplo, pesquisando um produto e localizando-o em uma de suas lojas locais. |
af_find_location |
| Contato |
Um telefone ou SMS, e-mail, chat ou outro tipo de contato entre um cliente e sua empresa. |
af_contact |
| Personalizar produto |
A personalização de produtos por meio de uma ferramenta de configuração ou outro aplicativo da sua empresa. |
af_customize_product |
Mapeamento de eventos in-app personalizados
A AppsFlyer permite que você mapeie qualquer evento in-app personalizado para enviar ao Meta, usando a opção de evento PERSONALIZADO do Meta.
O nome do evento e o valor do evento (incluindo os parâmetros do evento) configurados no SDK são encaminhados para o Meta, da forma como estão, e exibidos sob o nome de evento original do SDK da AppsFlyer - não como "personalizado".
Observe que você pode usar esses eventos para otimizar suas campanhas.
Mapeamento automático de parâmetros com o evento PERSONALIZADO
Através da integração direta da AppsFlyer com o Meta, muitos dos parâmetros de eventos do SDK padrão são automaticamente mapeados para os parâmetros predefinidos do Meta. Por exemplo, o parâmetro af_revenue é convertido para o parâmetro _valueToSum no Meta, o que permite que você envie uma receita por evento que pode ser mensurada e otimizada para o Meta.
Observação
O mapeamento automático de parâmetros pode diferir entre eventos PERSONALIZADOS e predefinidos.
Para eventos predefinidos, af_price é mapeado para _valueToSum em alguns casos (por exemplo, fb_mobile_add_to_cart). Em outros casos, af_revenue é mapeado para _valueToSum (por exemplo, em fb_mobile_purchase).
Para eventos mapeados para PERSONALIZADO, af_price é sempre mapeado para fb_price e af_revenue para _valueToSum.
A tabela a seguir detalha todos os parâmetros de eventos da AppsFlyer que, quando mapeados através do evento PERSONALIZADO para o Meta, são automaticamente mapeados para os parâmetros do Meta.
| Parâmetro da AppsFlyer | Parâmetro do Meta |
|---|---|
| af_city | fb_city |
| af_class | fb_travel_class |
| af_content_id | fb_content_id |
| af_content_list | fb_content_id |
| af_content_type | fb_content_type |
| af_country | fb_country |
| af_currency | fb_currency |
| af_date_a | fb_checkin_date |
| af_date_b | fb_checkout_date |
| af_departing_arrival_date | fb_departing_arrival_date |
| af_departing_departure_date | fb_departing_departure_date |
| af_description | fb_description |
| af_destination_a | fb_origin_airport |
| af_destination_b | fb_destination_airport |
| af_destination_list | fb_destination_ids |
| af_hotel_score | fb_hotel_score |
| af_level | fb_level |
| af_max_rating_value | fb_max_rating_value |
| af_num_adults | fb_num_adults |
| af_num_children | fb_num_children |
| af_num_infants | fb_num_infants |
| af_order_id | fb_order_id |
| af_payment_info_available | fb_payment_info_available |
| af_preferred_neighborhoods | fb_preferred_neighborhoods |
| af_preferred_num_stops | fb_preferred_num_stops |
| af_preferred_price_range | fb_preferred_price_range |
| af_preferred_star_ratings | fb_preferred_star_ratings |
| af_price | fb_price |
| af_quantity | fb_num_items |
| af_region | fb_region |
| af_registration_method | fb_registration_method |
| af_returning_arrival_date | fb_returning_arrival_date |
| af_returning_departure_date | fb_returning_departure_date |
| af_revenue | _valueToSum |
| af_search_string | fb_search_string |
| af_success | fb_success |
| af_suggested_destinations | fb_suggested_destinations |
| af_suggested_hotels | fb_suggested_hotels |
| af_travel_end | fb_travel_end |
| af_travel_start | fb_travel_start |
| af_user_score | fb_user_score |
Limitações de eventos e parâmetros
Os limites a seguir se aplicam aos eventos que você envia para o Meta Ads:
-
Os seguintes caracteres não são permitidos:
- Dois pontos (:)
- Ponto final (.)
- Conjuntos de caracteres não latinos (inglês): desde o dia 12 de janeiro de 2020, o Meta rejeita caracteres chineses. A AppsFlyer não testou outros conjuntos de caracteres e você deve usá-los somente depois de verificar com o Meta se há suporte para esses conjuntos de caracteres em postbacks.
- Os nomes de eventos diferenciam letras maiúsculas e minúsculas. Para evitar discrepâncias, use o nome do evento correto para todas as fontes de mídia e versões de aplicativos.
- Número máximo de parâmetros: 25.
- Comprimento dos nomes e parâmetros de eventos: 2—40.
- Comprimento máximo do parâmetro: 100 caracteres.
- Caracteres permitidos: caracteres alfanuméricos, sublinhados, hifens ou espaços. Não use caracteres não latinos. O uso de letras não-latinas gera resultados inconsistentes.
Considerações sobre a nomeação de eventos in-app:
- Nomes de eventos na AppsFlyer podem ser nomeados igual aos nomes dos eventos do Meta (por exemplo, fb_price). No entanto, eles não devem ser enviados como eventos PERSONALIZADOS para o Meta.
Por questões de segurança, evite nomear os eventos igual aos nomes de eventos do Meta. - Para realizar o mapeamento de postback de eventos in-app com o Meta, obtenha dados de eventos de todas as fontes, incluindo orgânica.
Com exceção dos parâmetros acima, a AppsFlyer envia os dados dos eventos PERSONALIZADOS nas condições em que se encontram para o Meta. É responsabilidade do proprietário do aplicativo verificar se os dados de eventos estão de acordo com os requisitos do Meta, usando parâmetros válidos para o Meta (veja a tabela acima). Caso contrário, esses parâmetros não são enviados ao Meta.