How can we help?

Mapeamento de evento in-app do Meta Ads

  • Atualizado

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

Os postbacks seguem o

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 Android
Fb_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

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.


Share article: