Conector de dados do Facebook

Documento

Adicionar o conetor de dados

  1. Em Configurações > Conectores de dados, clique em Adicionar conetor de dados e digite e selecione "Facebook".
  2. Faça login usando suas credenciais do Facebook. Talvez seja necessário navegar novamente para o Singular e abrir o Conector de dados novamente.
    facebook_edit.png
  3. Abra o Conector de dados adicionado, ative a conta da qual você deseja extrair dados e clique em Enviar.
    facebook_account.png

Detalhes rápidos

Tecnologia do conetor de dados API(API do Facebook Graph e API de marketing v13.0)
Detalhamento de dados (segmentação)

O Facebook fornece seus dados divididos por todos os itens a seguir (consulte Mapeamento de dados abaixo para obter a terminologia e mais detalhes):

  • Account
  • Campaign
  • Sub-Campaign
  • Creative

Além disso, o Facebook oferece uma das seguintes divisões:

  • Country (Padrão)
  • Sub Ad Network (Plataforma do editor) + Placement (Posição da plataforma): Plataforma do editor é a propriedade do Facebook em que o anúncio apareceu, por exemplo, Facebook, Instagram, Messenger ou Facebook Audience Network. A Posição da plataforma fornece mais detalhes sobre onde o anúncio foi exibido, por exemplo, o feed de notícias do site do Facebook ou o feed de notícias móvel do Instagram.
  • Platform (Dispositivo de impressão): Por exemplo, iOS, Android ou iPhone.
  • Region Informações no nível da região (você também obtém o País).
  • DMA Informações a nível de DMA (também obtém o país). Disponível apenas nos EUA.
  • Idade e género: Desagregações demográficas (por exemplo, Feminino/Masculino, 20-29, etc.)

A predefinição é Country. Se, em vez disso, pretender uma das outras subdivisões, contacte o seu Customer Success Manager ou o suporte da Singular para configurar a integração para si. Pode escolher a desagregação para cada ID de conta separadamente.

Qual o intervalo de tempo em que extraímos dados

Todos os dias, a Singular extrai dados de 7 dias atrás. Uma vez por semana, às segundas-feiras, Singular extrai dados de 30 dias atrás.

Fuso horário O fuso horário configurado para a conta no Facebook.
Os dados estão disponíveis no nível criativo (anúncio)?

Sim.

O Singular mostra seus ativos criativos?

Sim, incluindo os vários recursos dentro de um criativo dinâmico. Observe que o Singular não pode extrair vídeos de uma página do Facebook para um usuário que não seja o administrador da página.

Limitações/ problemas conhecidos Se você ativar a autenticação de dois fatores em uma conta do Facebook, deverá autenticar novamente o conetor de dados do Facebook no Singular.

Mapeamento de dados

Notas sobre a terminologia:

  • "Campaign" em Singular corresponde a "Ad Campaign" no Facebook
  • "Sub-Campaign" corresponde a "Ad Set"do Facebook
  • "Creative" corresponde a "Ad"do Facebook
  • "Asset" é um novo nível na hierarquia abaixo do Creative que corresponde ao "Asset" do Facebook. É usado em Criativos dinâmicos, por exemplo, em campanhas Automated App Ads [AAA]).

Para obter descrições de todos os campos, consulte o Glossário de métricas e dimensões singulares.

Para obter mais dicas sobre como executar relatórios de criativos no Meta, consulte Como executar relatórios de criativos no Meta e no Google Ads?

Field in Singular UI Field in Singular API Field in Facebook
Dimensions
Account ID adn_account_id 'id' from me/adaccounts
Account Name adn_account_name 'name' from me/adaccounts
Asset ID asset_id asset_id
Campaign URL adn_campaign_url Taken from one of the Creative URLs.
Country country_field Country from Insights URL
Date date_field Given as a parameter when querying Facebook
DMA ID dma_id_field targeting[geo_locations][data][key]
DMA Name dma_name_field dma
Network Campaign ID adn_campaign_id campaign_id
Network Campaign Name adn_campaign_name 'Name' from the campaign-level endpoint
Network Creative ID adn_creative_id ad_id
Network Creative Name adn_creative_name 'Name' from ad level
Network Sub Campaign ID adn_sub_campaign_id adset_id
Network Sub Campaign Name adn_sub_campaign_name 'Name' from the sub-campaign (ad set) level endpoint
Placement
placement
Mapped from one of the following fields: device_platforms/ publisher_platforms/ facebook_positions/ instagram_positions/ audience_network_positions/ messenger_positions
Possible values: mobile, desktop, facebook, instagram, messenger, audience_network, feed, right_hand_column, instant_article, marketplace, video_feeds, search stream, story, explore, classic, instream_video, rewarded_video, messenger_home, sponsored_messages
Platform platform
  1. If all the ads are of the same platform (see Creative Platform), Singular gives that platform to the sub-campaign.
  2. Otherwise, estimated based on the ad-set targeting: targeting[‘user_os’], targeting[‘user_device’], targeting[‘device_platforms’]
  3. If that's not possible, estimated based on the campaign objective:
  • LINK_CLICKS, CONVERSIONS → Platform WEB
  • CANVAS_APP_INSTALL, CANVAS_APP_ENGAGEMENT → Platform CANVAS
Public Id site_public_id
  1. Derived from our Campaign URL and Platform dimensions if possible.
  2. Otherwise derived from the Creative URL and Platform.
Region
region_field
region
Source source For Sub Ad Network ("Publisher Platform") breakdown - this field contains the sub ad network, i.e. Facebook Advertising Network, Instagram, Whatsapp, etc.
Sub Ad Network adn_subadnetwork publisher_platform
Sub Campaign ID sub_campaign_id adset_id
Sub Campaign Name sub_campaign_name ‘Name’ from sub campaign level insights
Target Countries target_countries_str targeting[‘geo_locations’]
Text creative_text Get creative(ad) data by id
  • ad[‘body’]
  • ad[‘message’] if is story or video
  • ad[‘description’] if is event or page
  • asset_feed_spec[‘title’] & asset_feed_spec[bodies] & asset_feed_spec[‘descriptions’] if asset_feed_spec in ad
Timezone adn_timezone From Account.timezone_utc_offset
UTC Offset adn_utc_offset From Account.timezone_utc_offset
Age age age
Gender gender gender
Facebook Attribution Type
campaign_attribution_type
A field for FB app ads campaign, which directly indicates the chosen attribution type for an app install campaign (e.g., SKAN or AEM) while creating it on FB

Metrics
Average Frequency
frequency frequency
Comments
adn_comments Post comments
Likes
adn_likes Post reactions
Network Clicks adn_clicks Clicks (default) or inline_link_clicks (if specifically requested by Singular customer)
Network Impressions adn_impressions impressions
Network Installs adn_installs Mobile_installs / canvas_installs. Note that if you set up your campaign with Facebook to optimize on AEM installs, this metric will reflect AEM installs.
Original Cost adn_original_cost spend
Original Currency adn_original_currency 'currency' from me/adaccounts endpoint
Posts saved
posts_saved Post saves
Reach
reach
reach
Shares
adn_shares Post shares
Video Views 25% video_views_25pct video_p25_watched_actions
Video Views 50% video_views_50pct video_p50_watched_actions
Video Views 75% video_views_75pct video_p75_watched_actions
Completed Video Views completed_video_views video_p100_watched_actions

O Singular também suporta a extração de propriedades de campanha para este parceiro - veja mais detalhes aqui.

FAQ e resolução de problemas

Que métricas é que a Singular extrai do Facebook?

Das várias métricas fornecidas pelo Facebook, a integração Singular reúne as métricas relevantes para o marketing móvel:

  • Impressões
  • Cliques
  • Instalações - observe que essa métrica refletirá as instalações do AEM se você tiver configurado sua campanha do Facebook para otimizar as instalações do AEM.
  • Custo

Além disso, o Singular pode obter estatísticas sobre as ações do usuário, que são conhecidas no Singular como eventos de conversão. Consulte Configuração de eventos personalizados abaixo para obter informações sobre como configurar o Singular para obter esses dados do Facebook.

Onde posso ver as instalações do AEM?
Se você configurou sua campanha para otimizar para o AEM, nós puxaremos a instalação do AEM para a dimensão de instalações da rede
Por que algumas linhas no meu relatório dizem "Os dados são censurados devido aos requisitos de privacidade do Meta/Facebook"?

Screen_Shot_2022-10-19_at_14.18.04.png

Para proteger a privacidade dos utilizadores finais, o Facebook não permite mostrar medições para segmentos de utilizadores que tenham menos de 1000 impressões. Se vires esta mensagem numa linha do teu relatório, significa que a linha tem um número reduzido de impressões. Para obter os dados que procura, tente executar um relatório menos granular, ou seja, inclua menos dimensões ou selecione um intervalo de datas mais amplo.

Quais dados o Singular exibe por ativo em Criativos dinâmicos?

As Criativas dinâmicas são um tipo especial de criativas no Facebook que incluem vários ativos criativos. O Singular agora pode mostrar esses ativos criativos em seus relatórios, bem como mostrar estatísticas no nível do ativo.

O Facebook considera os recursos como uma divisão separada e não oferece dados de nível de recurso com qualquer outra divisão permitida (por exemplo, país ou sub-rede de anúncios). Para mostrar os dados do ativo por país (ou qualquer outra discriminação que veja nos seus outros relatórios do Facebook), a Singular executa o passo extra de obter os dados por criativo e, em seguida, interpolar os dados para dar uma parte proporcional das métricas a cada ativo.

Por exemplo, se a discriminação do Facebook escolhida for país:

Screen_Shot_2021-02-23_at_16.04.21.png

Por que às vezes eu vejo dados de País ou Plataforma no relatório, mesmo se eu estiver usando uma divisão diferente?

Como a API do Facebook fornece apenas o país OU a rede de sub-ads OU a plataforma, o Singular tenta descobrir as outras duas dimensões de outra forma - verificando as configurações de segmentação da campanha, subcampanha ou criativo.

Por exemplo, se estiver a dividir os dados por Campanha e País, os dados extraídos do Facebook não incluem a Plataforma. O Singular procura as definições de segmentação de cada campanha e, se uma campanha estiver a segmentar uma única plataforma específica, como o iPhone, o Singular utiliza as informações de segmentação para preencher o campo Plataforma dessa campanha com o valor "iPhone".

Por outro lado, se uma campanha tem como alvo várias plataformas, por exemplo, iOS e Android, o Singular não pode usar isso para preencher o campo Plataforma.

Isto significa que pode obter dados mais ricos nos seus relatórios definindo as suas campanhas ou sub-campanhas (no Facebook: campanhas publicitárias ou conjuntos de anúncios) de modo a que cada uma vise um país e/ou um dispositivo.

Nota: Se os dados da plataforma forem derivados das definições de direcionamento, os relatórios podem, por vezes, apresentar a plataforma como "iPhone" ou "iPad" e, outras vezes, apenas "iOS" ou nada. Isto baseia-se no nível de segmentação em cada caso.

Qual é a janela de atribuição utilizada para contar as instalações? Posso alterá-la?

Por padrão, o Facebook usa uma janela de atribuição de 7 dias para cliques e 1 dia para visualizações.

Se você quiser usar valores diferentes em seus relatórios de análise do Singular, entre em contato com o Suporte do Singular para que as janelas sejam alteradas para você.

Como faço para configurar um conetor de dados do Facebook?

Para começar a extrair dados do Facebook para o Singular:

  1. Na plataforma Singular, vá para Settings > Data Connectors.
  2. Passe o mouse sobre o botão Add New Connector e comece a digitar "Facebook". Na lista que aparece, escolha Facebook.
  3. Clique em Connect with Facebook e inicie sessão num utilizador do Facebook que tenha acesso às contas de anúncios necessárias.

    image3.png

    Nota: Antes de clicar no botão, certifique-se de que não está ligado ao Facebook com uma conta não relacionada (como a sua conta pessoal).

Como é que trabalho com contas de anúncios do Facebook de agências?

Para executar campanhas através da tua conta de Agência de Anúncios do Facebook, vai a Settings > Data Connectorse adicione a conta do Facebook da sua agência. Não é necessário fazer nenhuma atualização na integração do SDK ou na Configuração de parceiro.

Poderá então obter dados de campanha como impressões, cliques e custos utilizando as nossas ferramentas de relatório. Use as dimensões Account ID e Account Name ao executar relatórios.

Se os custos de sua campanha incluírem uma taxa adicional, como uma taxa de agência, você pode fazer com que o Singular adicione essas taxas aos custos mostrados em seus relatórios em Configurações > Taxas de parceiros. Consulte Perguntas frequentes sobre taxas de parceiros.

Também podes optar por visualizar os teus dados como uma agência. Vá para Settings > Data Connectors, abra sua configuração do Facebook e use o menu suspenso View This Source As.

facebook_agency.png

Qual é a lista de contas que aparece quando eu crio o novo conetor? Quais contas eu devo escolher?

image1.png

O Singular apresenta todas as contas que podem ser acedidas pelo utilizador com o qual iniciou sessão. Selecione as contas que você deseja conectar ao Singular. Por exemplo, se você tiver contas de teste com dados fictícios, convém deixá-las de fora.

Nota: Se uma das contas selecionadas for inválida, não será possível guardar. Isto pode acontecer se uma conta no Facebook já não estiver ativa ou se o utilizador que iniciou sessão já não tiver acesso a uma conta.

O que devo introduzir na coluna "Fonte" para cada conta?

A coluna Fonte permite-lhe dar um nome a cada conta. Este é o nome sob o qual os dados aparecerão nos seus relatórios. Pode utilizar o mesmo nome de origem para várias contas.

Por exemplo, se tiver uma ou mais contas do Facebook para campanhas publicitárias geridas por um Preferred Marketing Developer (PMD) ou Facebook Marketing Partner (FMP), como a Nanigans, especifique "Nanigans" para essas contas. Os relatórios Singular somam os dados destas contas e apresentam-nos nos seus relatórios com o nome de origem "Nanigans".

Por defeito, todas as contas recebem o nome de origem "Facebook".

Como posso começar a acompanhar os eventos do utilizador (eventos pós-conversão)?

Para obter informações gerais sobre eventos personalizados no Singular, consulte Configurando eventos personalizados

O Singular pode analisar dados sobre os eventos pós-instalação dos utilizadores, como o registo ou a primeira compra. Geralmente, é preferível extrair dados sobre esses eventos do seu provedor de atribuição, mas se você não rastrear a atividade do Facebook por meio de um provedor de atribuição ou se quiser rastrear o tráfego não móvel, poderá ingerir dados provenientes do próprio Facebook. No Facebook, os eventos do utilizador são conhecidos como acções.

Para começar a rastrear um evento personalizado do Facebook, siga as instruções em Configurando eventos personalizados para adicionar um novo evento personalizado. Se tiveres campanhas do Facebook configuradas, a caixa Novo evento personalizado inclui uma lista pendente do Facebook. Clique na lista para exibir todas as ações do Facebook disponíveis e selecione uma ação para mapear o evento personalizado.

image2.png

Porque é que o meu relatório iOS mostra "N/A" para os números de instalação?

Se o seu relatório do iOS não estiver a apresentar números de instalações, certifique-se de que está a visualizar o relatório correto. O relatório SKAN mostrará o valor das instalações SKAN; os relatórios mostrarão as instalações de rede e MMP.

Tenha em mente que:

  • Relatórios SKAN: Entenda que os relatórios SKAN combinam dados de rede e instalações SKAN. Os dados de rede são detalhados, enquanto os dados de SKAN estão normalmente no nível da campanha devido às limitações de SKAdNetwork.
  • Detalhamento do relatório: Ao dividir por subcampanha, as instalações da SKAN podem estar em "N/A" se os parceiros só passarem dados ao nível da campanha. Os outros dados estarão nas respectivas subcampanhas.
Por que o Singular está mostrando dados diferentes do meu painel do Facebook?