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 |
| Dois pontos (:) | 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 |
Adimpression—para AndroidFb_mobile_purchase—para iOS |
Otimiza a receita de anúncios na plataforma de anúncios da Meta. Veja os detalhes abaixo. | af_ad_revenue |
Mapeamento de dados de receita de anúncios para otimização de campanhas
Os anúncios da Meta podem otimizar suas campanhas com base em seus dados de receita de anúncios. Isso é feito mapeando o evento af_ad_revenue para o seguinte evento de anúncios da Meta:
| Nome do evento na AppsFlyer | Platform | Mapeado para eventos de parceiros | Otimização de anúncios da Meta com base em: |
|---|---|---|---|
|
af_ad_revenue |
com o Android | Adimpression | Receita de anúncios específica |
| https://support.appsflyer.com/hc/en-us/articles/4404083608849 | fb_mobile_purchase | In-app purchases |
Limitações de disponibilidade
- Atualmente, a otimização por meio do evento Adimpression está disponível apenas para:
- Apps Android. Aplicativos iOS podem continuar enviando dados de receita de anúncios usando o evento fb_mobile_purchase.
- Contas selecionadas de anúncios da Meta, de acordo com os critérios da Meta. Quando indisponível, os critérios de elegibilidade podem não ser atendidos.
- O evento af_ad_revenue está disponível apenas para planos com uma assinatura avançada do ROI360. Além disso, você precisa do tipo de integração de receita de anúncios via SDK no nível de impressão.
- Planos sem o ROI360 podem enviar dados de receita de anúncios usando outros nomes de eventos.
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 | fb_content |
| 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_preço | 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 |
Mapeamento automático de eventos predefinidos para o parâmetro _valueToSum
Para eventos predefinidos, o parâmetro _valueToSum da Meta é mapeado para os parâmetros af_price ou af_revenue.
A tabela a seguir detalha esse mapeamento para todos os eventos predefinidos da Meta com o parâmetro _valueToSum:
| Ponto final (.) | _valueToSum mapeado para |
|---|---|
| fb_mobile_level_achieved | none |
| fb_mobile_add_payment_info | none |
| fb_mobile_add_to_cart | af_preço |
| fb_mobile_add_to_wishlist | af_preço |
| fb_mobile_complete_registration | none |
| fb_mobile_tutorial_completion | none |
| fb_mobile_initiated_checkout | af_preço |
| fb_mobile_purchase | af_revenue |
| fb_mobile_rate | af_rating_value |
| fb_mobile_search | af_revenue |
| fb_mobile_spent_credits | af_preço |
| fb_mobile_achievement_unlocked | none |
| fb_mobile_content_view | af_preço |
| Iniciar avaliação | af_preço |
| Enviar inscrição | af_revenue |
Enviar eventos in-app complexos para anúncios da Meta
Para enviar eventos in-app complexos, ou seja, eventos com vários itens, para a Meta, use uma matriz estruturada af_content. Cada objeto na matriz deve incluir id e quantity para garantir o tratamento adequado do postback.
af_content_list é opcional. Quando ele está ausente, a Meta recorre ao campo fb_content (mapeado a partir de af_content) para identificar IDs de produto. Desde que o JSON af_content inclua um campo id em cada objeto, a Meta pode analisá-lo e extrair dele os IDs de conteúdo.
Se você incluir af_content_list, não inclua também af_content_id no mesmo evento. Ambos os parâmetros são mapeados para fb_content_id, e apenas um deles deve ser preenchido para evitar conflitos.
Atenção
fb_content_id é importante para casos de uso no nível do produto, como a correspondência de eventos com itens do catálogo para Advantage+ Catalog Ads e Dynamic Ads, relatórios de performance no nível do produto e sinais de otimização baseados no produto. Para a otimização geral de conversão com base na contagem e no valor dos eventos, as campanhas funcionam sem ele.
Exemplo: formato unificado compatível com Meta e TikTok
{
"af_revenue": 4.99,
"af_currency": "USD",
"af_order_id": "12345",
"af_content": "[{\"id\":\"ID1\",\"quantity\":\"1\"},{\"id\":\"ID2\",\"quantity\":\"1\"},{\"id\":\"ID3\",\"quantity\":\"2\"}]"
}
Esse formato funciona tanto para Meta quanto para TikTok. O TikTok também lê os valores de id do campo af_content, portanto uma única carga útil é suficiente ao enviar postbacks para ambas as networks.
Importante!
Se o parâmetro af_content exceder 1.000 caracteres, a AppsFlyer poderá enviar o evento para a Meta sem o parâmetro fb_content. Se af_content_list também estiver ausente nesse cenário, a Meta não receberá dados de identificação do produto. Mantenha af_content abaixo de 1.000 caracteres para eventos que incluam muitos itens.
Para mais detalhes sobre como estruturar eventos in-app complexos, consulte o artigo Eventos in-app: Visão geral.
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 (.)
- 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.
- Comprimento máximo do parâmetro af_content: 1000 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.
Importante!
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.
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.