Configurar o conetor de dados
Adicionar o conetor de dados
- Em Configurações > Conectores de dados, clique em Adicionar conetor de dados e digite e selecione "Facebook".
- Faça login usando suas credenciais do Facebook. Talvez seja necessário navegar novamente para o Singular e abrir o Conector de dados novamente.
- Abra o Conector de dados adicionado, ative a conta da qual você deseja extrair dados e clique em Enviar.
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):
Além disso, o Facebook oferece uma das seguintes divisões:
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 |
|
Public Id | site_public_id |
|
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
|
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
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.
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.
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:
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.
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ê.
Para começar a extrair dados do Facebook para o Singular:
- Na plataforma Singular, vá para Settings > Data Connectors.
- Passe o mouse sobre o botão Add New Connector e comece a digitar "Facebook". Na lista que aparece, escolha Facebook.
-
Clique em Connect with Facebook e inicie sessão num utilizador do Facebook que tenha acesso às contas de anúncios necessárias.
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).
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.
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.
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".
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.
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.