Adicionar o conector de dados
- Em Settings > Data Connectors, clique em Add Data Connector e digite e selecione “Facebook”.
- Faça login com suas credenciais do Facebook. Pode ser necessário voltar à Singular e abrir novamente o seu conector de dados.
- Abra o conector de dados adicionado, ative a conta da qual quer extrair dados e clique em Submit.
Detalhes rápidos
| Tecnologia do conetor de dados | API (Facebook Graph API e Marketing API v19.0) |
| Detalhamento de dados (segmentação) |
O Facebook fornece seus dados detalhados por todas as dimensões a seguir (consulte Mapeamento de dados abaixo para ver a terminologia e mais detalhes):
Além disso, o Facebook oferece um dos seguintes detalhamentos:
O padrão entre eles é País. Se preferir um dos outros detalhamentos, entre em contato com seu Customer Success Manager ou com o suporte da Singular para configurar a integração. Você pode escolher o detalhamento para cada Account ID separadamente. |
| Qual o intervalo de tempo em que extraímos dados | Todos os dias, a Singular extrai dados dos últimos 7 dias. Uma vez por semana, às segundas-feiras, a Singular extrai dados dos últimos 30 dias. |
| 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 múltiplos ativos dentro de um Dynamic Creative. Observe que a Singular não consegue extrair vídeos de uma página do Facebook se o usuário não for administrador da página. |
| Limitações/ problemas conhecidos | Se você ativar a autenticação de dois fatores em uma conta do Facebook, será necessário autenticar novamente o conector de dados do Facebook na Singular. |
Mapeamento de dados
Notas de terminologia:
- "Campaign" na Singular corresponde a "Ad Campaign" no Facebook
- "Sub-Campaign" corresponde ao "Ad Set"
- "Creative" corresponde ao "Ad"
- "Asset" é um novo nível da hierarquia abaixo de Creative que corresponde ao "Asset"do Facebook. É usado nos Dynamic Creatives, por exemplo, em campanhas Automated App Ads [AAA]).
Para ver a descrição de todos os campos, consulte o Glossário de métricas e dimensões da Singular.
Para 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 |
Call to Action Button |
call_to_action_button | A creative field with the call to action message if there is any |
| Metrics | ||
|
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 |
|
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 |
A Singular também oferece suporte à extração de propriedades de campanha para este parceiro: veja mais detalhes aqui.
FAQ e solução de problemas
Entre as diversas métricas fornecidas pelo Facebook, a integração da Singular reúne as métricas relevantes para o marketing mobile:
- Impressões
- Cliques
- Instalações: observe que essa métrica refletirá as instalações AEM se você tiver configurado sua campanha do Facebook para otimizar as instalações AEM.
- Custo
Além disso, a Singular pode obter estatísticas sobre as ações do usuário, que na Singular são conhecidas como eventos de conversão. Consulte Configurar eventos personalizados abaixo para saber como configurar a Singular para obter esses dados do Facebook.
Se você configurou sua campanha para otimizar para AEM, extrairemos as instalações AEM na dimensão de instalações de rede
Para proteger a privacidade dos usuários finais, o Facebook não permite exibir medições de segmentos de usuários com menos de 1.000 impressões. Se você vir essa mensagem em uma linha do seu relatório, significa que a linha tem um número baixo 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.
Os Dynamic Creatives são um tipo especial de criativo no Facebook que inclui vários ativos criativos. Agora a Singular pode exibir esses ativos criativos nos seus relatórios, além de estatísticas no nível do ativo.
O Facebook considera os ativos um detalhamento separado e não oferece dados no nível do ativo junto com nenhum outro detalhamento permitido (por exemplo, país ou sub-rede de anúncios). Para mostrar os dados de ativos por país (ou qualquer outro detalhamento que você use nos seus outros relatórios do Facebook), a Singular executa a etapa adicional de extrair os dados por criativo e depois interpolá-los para atribuir a cada ativo uma parte proporcional das métricas.
Por exemplo, se o detalhamento do Facebook que você escolheu for país:
Como a API do Facebook fornece apenas o país OU a sub-rede de anúncios OU a plataforma, a Singular tenta deduzir as outras duas dimensões de outra forma: consultando as configurações de segmentação da campanha, da subcampanha ou do criativo.
Por exemplo, se você detalhar os dados por Campanha e País, os dados extraídos do Facebook não incluem a Plataforma. A Singular consulta as configurações de segmentação de cada campanha e, se uma campanha segmentar uma única plataforma específica, como iPhone, a Singular usa as informações de segmentação para preencher o campo Plataforma dessa campanha com o valor "iPhone".
Por outro lado, se uma campanha segmentar várias plataformas, por exemplo iOS e Android, a Singular não pode usar isso para preencher o campo Plataforma.
Isso significa que você pode obter dados mais completos nos seus relatórios se definir suas campanhas ou subcampanhas (no Facebook: ad campaigns ou ad sets) de modo que cada uma segmente um país e/ou um dispositivo.
Observação: Se os dados de plataforma forem derivados das configurações de segmentação, seus relatórios podem exibir a plataforma às vezes como "iPhone" ou "iPad" e outras vezes apenas como "iOS", ou nada. Isso depende do 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 de 1 dia para visualizações.
Se quiser usar valores diferentes nos seus relatórios de analytics da Singular, entre em contato com o suporte da Singular para que as janelas sejam alteradas.
Para começar a extrair dados do Facebook para a Singular:
- Na plataforma da Singular, acesse Settings > Data Connectors.
- Passe o cursor sobre o botão Add New Connector e comece a digitar "Facebook". Na lista exibida, escolha Facebook.
-
Clique em Connect with Facebook e faça login com um usuário do Facebook que tenha acesso às contas de anúncios necessárias.
Observação: Antes de clicar no botão, verifique se você não está conectado ao Facebook com uma conta não relacionada (como sua conta pessoal).
Para veicular campanhas pela sua conta de agência do Facebook Ads, acesse Settings > Data Connectorse adicione sua conta de agência do Facebook. Não é necessário fazer nenhuma alteração na sua integração do SDK nem na configuração de parceiros.
Depois, você poderá obter dados de campanha como impressões, cliques e custo com nossas ferramentas de relatórios. Use as dimensões Account ID e Account Name ao executar relatórios.
Se os custos das suas campanhas incluírem uma taxa adicional, como uma comissão de agência, você pode fazer com que a Singular some essas taxas aos custos exibidos nos seus relatórios em Settings > Partner Fees. Consulte FAQ de taxas de parceiros.
Você também pode optar por ver seus dados como agência. Acesse Settings > Data Connectors, abra sua configuração do Facebook e use o menu suspenso View This Source As.
A Singular exibe todas as contas que podem ser acessadas pelo usuário com o qual você fez login. Selecione as contas que quer conectar à Singular. Por exemplo, se você tiver contas de teste com dados fictícios, talvez prefira deixá-las de fora.
Observação: Se uma das contas selecionadas for inválida, você não conseguirá salvar. Isso pode acontecer se uma conta do Facebook não estiver mais ativa ou se o usuário conectado não tiver mais acesso a uma conta.
A coluna Source permite dar um nome a cada conta. Esse é o nome sob o qual os dados aparecerão nos seus relatórios. Você pode usar o mesmo nome de fonte para várias contas.
Por exemplo, se você tiver uma ou mais contas do Facebook para campanhas publicitárias gerenciadas por um Preferred Marketing Developer (PMD) ou Facebook Marketing Partner (FMP) como a Nanigans, especifique "Nanigans" para essas contas. Os relatórios da Singular somarão os dados dessas contas e os exibirão sob o nome de fonte "Nanigans".
Por padrão, todas as contas recebem o nome de fonte "Facebook".
A Singular pode analisar dados sobre os eventos pós-instalação dos usuários, como cadastro ou primeira compra. Normalmente é preferível extrair os dados desses eventos do seu provedor de atribuição, mas se você não faz tracking da atividade do Facebook por um provedor de atribuição, ou se quer fazer tracking de tráfego não mobile, é possível ingerir os dados vindos do próprio Facebook. No Facebook, os eventos do usuário são conhecidos como actions.
Para começar a fazer tracking de um evento personalizado do Facebook, siga as instruções em Configurar eventos personalizados para adicionar um novo evento personalizado. Se você tiver campanhas do Facebook configuradas, a caixa New Custom Event incluirá uma lista suspensa do Facebook. Clique na lista para exibir todas as actions do Facebook disponíveis e selecione uma ação para mapear o evento personalizado.
Se o seu relatório de iOS não estiver exibindo os números de instalações, verifique se você está vendo o relatório correto. O relatório SKAN mostrará o valor de instalações SKAN; Reports mostrará tanto as instalações de rede quanto as de MMP.
Tenha em mente que:
- Relatórios SKAN: Os relatórios SKAN combinam dados de rede e instalações SKAN. Os dados de rede são detalhados, enquanto os dados SKAN normalmente ficam no nível da campanha devido às limitações do SKAdNetwork.
- Detalhamento do relatório: Ao detalhar por subcampanha, as instalações SKAN podem aparecer como 'N/A' se os parceiros enviarem dados apenas no nível da campanha. Os demais dados aparecerão em suas respectivas subcampanhas.
Um erro de permissão de criativo do Facebook geralmente significa que você não tem acesso à Página ou à Conta de anúncios, que o ativo (imagem/vídeo) não está disponível, ou que seu papel não é suficiente. Normalmente isso é resolvido verificando Business Settings > Accounts > Pages/Ad Accounts, garantindo direitos de administrador da Página, pedindo a um Administrador que atribua papéis (Admin/Advertiser) para a Conta de anúncios, ou solicitando acesso ao domínio se estiver vinculando. As soluções comuns incluem confirmar as permissões no Ads Manager, verificar o status da Página (não excluída/desativada) ou, às vezes, apenas duplicar o anúncio/criativo e republicá-lo rapidamente. Você pode ler mais na documentação do Facebook aqui