Agregar el conector de datos
- En Settings > Data Connectors, haz clic en Add Data Connector y escribe y selecciona “Facebook”.
- Inicia sesión con tus credenciales de Facebook. Es posible que tengas que volver a Singular y abrir de nuevo tu conector de datos.
- Abre el conector de datos que agregaste, activa la cuenta de la que quieres extraer datos y haz clic en Submit.
Detalles rápidos
| Tecnología del conector de datos | API (Facebook Graph API y Marketing API v19.0) |
| Desglose de datos (segmentación) |
Facebook proporciona tus datos desglosados por todas las siguientes dimensiones (consulta Mapeo de datos más abajo para ver la terminología y más detalles):
Además, Facebook ofrece uno de los siguientes desgloses:
El valor predeterminado de estos es País. Si prefieres uno de los otros desgloses, comunícate con tu Customer Success Manager o con el soporte de Singular para que configuren la integración. Puedes elegir el desglose para cada Account ID por separado. |
| Desde cuándo extraemos datos | Todos los días, Singular extrae datos de los últimos 7 días. Una vez por semana, los lunes, Singular extrae datos de los últimos 30 días. |
| Zona horaria | La zona horaria configurada para la cuenta en Facebook. |
| ¿Hay datos disponibles a nivel creativo (anuncio)? | Sí. |
| ¿Muestra Singular tus activos creativos? | Sí, incluidos los múltiples activos dentro de un Dynamic Creative. Ten en cuenta que Singular no puede extraer videos de una página de Facebook si el usuario no es administrador de la página. |
| Limitaciones y problemas conocidos | Si activas la autenticación en dos pasos en una cuenta de Facebook, deberás volver a autenticar el conector de datos de Facebook en Singular. |
Mapeo de datos
Notas de terminología:
- "Campaign" en Singular corresponde a "Ad Campaign" en Facebook
- "Sub-Campaign" corresponde al "Ad Set"
- "Creative" corresponde al "Ad"
- "Asset" es un nuevo nivel de la jerarquía por debajo de Creative que corresponde al "Asset"de Facebook. Se usa en los Dynamic Creatives, por ejemplo, en las campañas Automated App Ads [AAA]).
Para ver la descripción de todos los campos, consulta el Glosario de métricas y dimensiones de Singular.
Para ver más consejos sobre cómo ejecutar reportes de creativos en Meta, consulta ¿Cómo ejecutar reportes de creativos en Meta y 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 |
Singular también admite la extracción de propiedades de campaña para este partner: consulta más detalles aquí.
FAQ y solución de problemas
De las diversas métricas que proporciona Facebook, la integración de Singular recopila las métricas relevantes para el marketing móvil:
- Impresiones
- Clics
- Instalaciones: ten en cuenta que esta métrica reflejará las instalaciones AEM si configuraste tu campaña de Facebook para optimizar las instalaciones AEM.
- Costo
Además, Singular puede obtener estadísticas sobre las acciones de usuario, que en Singular se conocen como eventos de conversión. Consulta Configurar eventos personalizados más abajo para saber cómo configurar Singular para obtener esos datos de Facebook.
Si configuraste tu campaña para optimizar para AEM, extraeremos las instalaciones AEM en la dimensión de instalaciones de red
Para proteger la privacidad de los usuarios finales, Facebook no permite mostrar mediciones de segmentos de usuarios con menos de 1000 impresiones. Si ves este mensaje en una fila de tu reporte, significa que esa fila tiene pocas impresiones. Para obtener los datos que buscas, prueba a ejecutar un reporte menos granular, es decir, incluye menos dimensiones o selecciona un rango de fechas más amplio.
Los Dynamic Creatives son un tipo especial de creativos en Facebook que incluyen varios activos creativos. Ahora Singular puede mostrar estos activos creativos en tus reportes, además de estadísticas a nivel de activo.
Facebook considera los activos como un desglose independiente y no ofrece datos a nivel de activo junto con ningún otro desglose permitido (por ejemplo, país o subred publicitaria). Para mostrarte los datos de activos por país (o cualquier otro desglose que uses en tus demás reportes de Facebook), Singular da el paso adicional de extraer los datos por creativo y luego interpolarlos para asignar a cada activo una parte proporcional de las métricas.
Por ejemplo, si el desglose de Facebook que elegiste es país:
Como la API de Facebook solo proporciona el país O la subred publicitaria O la plataforma, Singular intenta deducir las otras dos dimensiones de otra manera: consultando la configuración de segmentación de la campaña, la subcampaña o el creativo.
Por ejemplo, si desglosas los datos por Campaña y País, los datos extraídos de Facebook no incluyen la Plataforma. Singular consulta la configuración de segmentación de cada campaña y, si una campaña segmenta una única plataforma específica, como iPhone, Singular usa la información de segmentación para completar el campo Plataforma de esa campaña con el valor "iPhone".
En cambio, si una campaña segmenta varias plataformas, por ejemplo iOS y Android, Singular no puede usar eso para completar el campo Plataforma.
Esto significa que puedes obtener datos más completos en tus reportes si defines tus campañas o subcampañas (en Facebook: ad campaigns o ad sets) de modo que cada una segmente un país o un dispositivo.
Nota: Si los datos de plataforma se derivan de la configuración de segmentación, tus reportes pueden mostrar la plataforma a veces como "iPhone" o "iPad" y otras veces solo como "iOS", o no mostrar nada. Esto depende del nivel de segmentación en cada caso.
De forma predeterminada, Facebook usa una ventana de atribución de 7 días para los clics y de 1 día para las visualizaciones.
Si quieres usar valores diferentes en tus reportes de analytics de Singular, comunícate con el soporte de Singular para que cambien las ventanas por ti.
Para empezar a extraer datos de Facebook hacia Singular:
- En la plataforma de Singular, ve a Settings > Data Connectors.
- Pasa el cursor sobre el botón Add New Connector y empieza a escribir "Facebook". En la lista que aparece, elige Facebook.
-
Haz clic en Connect with Facebook e inicia sesión con un usuario de Facebook que tenga acceso a las cuentas publicitarias necesarias.
Nota: Antes de hacer clic en el botón, asegúrate de no haber iniciado sesión en Facebook con una cuenta no relacionada (como tu cuenta personal).
Para ejecutar campañas a través de tu cuenta de agencia de Facebook Ads, ve a Settings > Data Connectorsy agrega tu cuenta de agencia de Facebook. No necesitas hacer ningún cambio en tu integración del SDK ni en la configuración de partners.
Luego podrás obtener datos de campaña como impresiones, clics y costo con nuestras herramientas de reportes. Usa las dimensiones Account ID y Account Name al ejecutar reportes.
Si los costos de tus campañas incluyen una tarifa adicional, como una comisión de agencia, puedes hacer que Singular sume estas tarifas a los costos que se muestran en tus reportes desde Settings > Partner Fees. Consulta FAQ de tarifas de partners.
También puedes optar por ver tus datos como agencia. Ve a Settings > Data Connectors, abre tu configuración de Facebook y usa el menú desplegable View This Source As.
Singular muestra todas las cuentas a las que puede acceder el usuario con el que iniciaste sesión. Selecciona las cuentas que quieres conectar a Singular. Por ejemplo, si tienes cuentas de prueba con datos ficticios, quizá prefieras dejarlas fuera.
Nota: Si una de las cuentas que seleccionaste no es válida, no podrás guardar. Esto puede ocurrir si una cuenta de Facebook ya no está activa o si el usuario que inició sesión ya no tiene acceso a una cuenta.
La columna Source te permite dar un nombre a cada cuenta. Este es el nombre bajo el cual aparecerán los datos en tus reportes. Puedes usar el mismo nombre de fuente para varias cuentas.
Por ejemplo, si tienes una o más cuentas de Facebook para campañas publicitarias gestionadas por un Preferred Marketing Developer (PMD) o un Facebook Marketing Partner (FMP) como Nanigans, especifica "Nanigans" para esas cuentas. Los reportes de Singular sumarán los datos de estas cuentas y los mostrarán bajo el nombre de fuente "Nanigans".
De forma predeterminada, todas las cuentas reciben el nombre de fuente "Facebook".
Singular puede analizar datos sobre los eventos posteriores a la instalación de los usuarios, como el registro o la primera compra. Normalmente es preferible extraer los datos de estos eventos de tu proveedor de atribución, pero si no haces tracking de la actividad de Facebook a través de un proveedor de atribución, o si quieres hacer tracking de tráfico no móvil, puedes ingerir los datos que provienen del propio Facebook. En Facebook, los eventos de usuario se conocen como actions.
Para empezar a hacer tracking de un evento personalizado de Facebook, sigue las instrucciones de Configurar eventos personalizados para agregar un nuevo evento personalizado. Si tienes campañas de Facebook configuradas, el cuadro New Custom Event incluye una lista desplegable de Facebook. Haz clic en la lista para mostrar todas las actions de Facebook disponibles y selecciona una acción a la que asignar el evento personalizado.
Si tu reporte de iOS no muestra los números de instalaciones, comprueba que estés viendo el reporte correcto. El reporte SKAN te mostrará el valor de instalaciones SKAN; Reports te mostrará tanto las instalaciones de red como las de MMP.
Ten en cuenta lo siguiente:
- Reportes SKAN: Los reportes SKAN combinan datos de red e instalaciones SKAN. Los datos de red son detallados, mientras que los datos SKAN suelen estar a nivel de campaña debido a las limitaciones de SKAdNetwork.
- Desglose del reporte: Al desglosar por subcampaña, las instalaciones SKAN pueden aparecer como 'N/A' si los partners solo envían datos a nivel de campaña. El resto de los datos aparecerá en sus respectivas subcampañas.
Un error de permisos de creativos de Facebook suele significar que no tienes acceso a la Página o a la Cuenta publicitaria, que el activo (imagen/video) no está disponible, o que tu rol no es suficiente. Normalmente se soluciona revisando Business Settings > Accounts > Pages/Ad Accounts, asegurándote de tener derechos de administrador de la Página, pidiendo a un administrador que asigne roles (Admin/Advertiser) para la Cuenta publicitaria, o solicitando acceso al dominio si estás vinculando. Las soluciones habituales incluyen confirmar los permisos en Ads Manager, comprobar el estado de la Página (que no esté eliminada ni desactivada) o, a veces, simplemente duplicar el anuncio/creativo y volver a publicarlo rápidamente. Puedes leer más en la documentación de Facebook aquí