Configurar o conector de dados
Adicionar o conector de dados
- Em Settings > Data Connectors( Configurações > Conectores de dados), clique em Add Data Connector (Adicionar conector de dados ), digite e selecione "Facebook".
- Faça login usando suas credenciais do Facebook. Talvez seja necessário navegar novamente até a Singular e abrir seu Data Connector novamente.
- Abra o conector de dados adicionado, ative a conta da qual você deseja extrair dados e clique em Submit (Enviar).
Detalhes rápidos
| Tecnologia do conector de dados | API(API do Facebook Graphe API de marketingv13.0) |
| Detalhamento de dados (segmentação) |
O Facebook fornece seus dados divididos de acordo com todos os itens a seguir (consulte Mapeamento de dados abaixo para obter a terminologia e mais detalhes):
Além disso, o Facebook oferece um dos seguintes detalhamentos:
O padrão é Country. Se, em vez disso, você quiser um dos outros detalhamentos, entre em contato com seu Customer Success Manager ou com o suporte da Singular para configurar a integração para você. Você pode escolher o detalhamento para cada ID de conta separadamente. |
| Com que antecedência extraímos os dados |
Todos os dias, a Singular extrai dados de 7 dias atrás. Uma vez por semana, às segundas-feiras, a 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 do criativo (anúncio)? |
Sim. |
| A Singular mostra seus ativos criativos? |
Sim, incluindo os vários ativos em um Dynamic Creative. 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 conector de dados do Facebook no Singular. |
Mapeamento de dados
Notas sobre 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. Ele é usado em criativos dinâmicos, por exemplo, em campanhas de anúncios de aplicativos automatizados [AAA]).
Para obter descrições de todos os campos, consulte o Glossário de métricas e dimensões singulares.
| 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 |
| 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 |
Perguntas frequentes e solução de problemas
Dentre as várias métricas fornecidas pelo Facebook, a integração da 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, a Singular pode obter estatísticas sobre as ações do usuário, que são conhecidas na 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 usuários finais, o Facebook não permite mostrar medições para segmentos de usuários que tenham menos de 1.000 impressões. Se você vir essa mensagem em uma linha do seu relatório, isso significa que a linha tem um número baixo de impressões. Para obter os dados que está procurando, tente executar um relatório menos granular, ou seja, inclua menos dimensões ou selecione um intervalo de datas mais amplo.
Os criativos dinâmicos são um tipo especial de criativos no Facebook que incluem vários ativos criativos. A 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 ativos como um detalhamento separado e não oferece dados em nível de ativo com qualquer outro detalhamento permitido (por exemplo, país ou sub-rede de anúncios). Para mostrar os dados de ativos por país (ou qualquer outra divisão que você veja em seus outros relatórios do Facebook), a Singular executa a etapa adicional de extrair os dados por criativo e, em seguida, interpolar os dados para fornecer uma parte proporcional das métricas para cada ativo.
Por exemplo, se o detalhamento do Facebook escolhido for país:
Como a API do Facebook fornece apenas o país OU a rede de subadjacência OU a plataforma, a Singular tenta descobrir as outras duas dimensões de outra forma - verificando as configurações de segmentação da campanha, da subcampanha ou do criativo.
Por exemplo, se você estiver dividindo os dados por Campanha e País, os dados extraídos do Facebook não incluem a Plataforma. O Singular procura as configurações de segmentação de cada campanha e, se uma campanha estiver segmentando uma única plataforma específica, como o iPhone, o Singular usará as informações de segmentação para preencher o campo Plataforma dessa campanha com o valor "iPhone".
Por outro lado, se uma campanha estiver direcionada a várias plataformas, por exemplo, iOS e Android, o Singular não poderá usar isso para preencher o campo Platform (Plataforma).
Isso significa que você pode obter dados mais ricos em seus relatórios definindo suas campanhas ou subcampanhas (no Facebook: campanhas de anúncios ou conjuntos de anúncios) de modo que cada uma tenha como alvo um país e/ou um dispositivo.
Observação: Se os dados da plataforma forem derivados das configurações de segmentação, seus relatórios poderão, às vezes, exibir a plataforma como "iPhone" ou "iPad" e, outras vezes, apenas "iOS" ou nada. Isso se baseia no nível de direcionamento 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 quiser usar valores diferentes nos seus relatórios de análise da Singular, entre em contato com o Suporte da Singular para que as janelas sejam alteradas para você.
Para começar a extrair dados do Facebook para a 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 faça login em um usuário do Facebook que tenha acesso às contas de anúncios necessárias.
Observação: antes de clicar no botão, certifique-se de que não esteja conectado ao Facebook com uma conta não relacionada (como sua conta pessoal).
Para executar campanhas por meio de sua conta do Facebook Ads da agência, vá para Settings > Data Connectors e 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 do parceiro.
Em seguida, você poderá obter dados de campanha como impressões, cliques e custo usando 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 a Singular adicione essas taxas aos custos mostrados em seus relatórios em Settings > Partner Fees. Consulte Perguntas frequentes sobre taxas de parceiros.
Você também pode optar por visualizar seus dados como uma agência. Acesse Settings > Data Connectors, abra sua configuração do Facebook e use o menu suspenso View This Source As .
O Singular exibe todas as contas que podem ser acessadas pelo usuário com o qual você fez login. Selecione as contas que você deseja conectar ao Singular. Por exemplo, se você tiver contas de teste com dados fictícios, talvez queira deixá-las de fora.
Observação: Se uma das contas selecionadas for inválida, você não poderá salvar. Isso pode acontecer se uma conta no Facebook não estiver mais ativa ou se o usuário conectado não tiver mais acesso a uma conta.
A coluna Fonte permite que você dê um nome a cada conta. Esse é o nome sob o qual os dados aparecerão nos 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 do Singular somarão os dados dessas contas e os exibirão em seus relatórios com o nome de origem "Nanigans".
Por padrão, todas as contas recebem o nome de origem "Facebook".
A Singular pode analisar dados sobre os eventos pós-instalação dos usuários, como o registro ou a primeira compra. Normalmente, é 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 usuário são conhecidos como ações.
Para começar a rastrear um evento personalizado do Facebook, siga as instruções em Configuração de eventos personalizados para adicionar um novo evento personalizado. Se você tiver campanhas do Facebook configuradas, a caixa Novo evento personalizado incluirá uma lista suspensa 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.