Integración del inicio de sesión con Facebook con la API de informes de Audience Network V2

El inicio de sesión con Facebook es una nueva forma de conceder acceso a los datos de la API de informes de Audience Network. Este método sustituirá el antiguo identificador de usuario del sistema de copiar y pegar de la interfaz del administrador de monetización. Se trata de una forma más segura de conceder acceso a los datos debido al riesgo de que el identificador del administrador de monetización quede expuesto fuera de la empresa.

Este documento se centra en proporcionar instrucciones para las integraciones directas de la API de informes, los socios de evaluación de la actividad en móviles, los socios de mediación y otros socios de Facebook que trabajan en el acceso a los datos de la API de informes en nombre de los editores.

Obtención de los datos de la API de informes de un tercero

Si utilizas a los socios actuales de evaluación de la actividad en móviles o de mediación, no necesitas hacer nada más en relación con el código. Asegúrate de que el socio integre el flujo de inicio de sesión con Facebook. Tendrás que hacer clic en la opción “Inicio de sesión con Facebook” y seleccionar las propiedades a las que quieras conceder acceso con el identificador que generarás.

Si seleccionas TODAS las propiedades, el identificador proporcionará acceso a todas las propiedades de la empresa siempre que el usuario que haya creado el identificador tenga acceso a la propiedad en Business Manager.

Permisos

Si tienes que usar la API de informes directamente, primero tendrás que crear una aplicación de Facebook y obtener los permisos necesarios. La aplicación necesitará el permiso read_audience_network_insights para acceder a los datos de la API de informes de Audience Network. A fin de obtener este permiso para tu aplicación, la empresa tiene que estar incorporada en Audience Network.

• Una vez incorporada en el Administrador de monetización, ve a la página de Facebook para desarrolladores y empieza a crear una nueva aplicación empresarial.

• Selecciona la empresa que acabas de crear en el campo de la cuenta empresarial.

Después de crear la aplicación, tendrás que vincularla a tu cuenta del Administrador de monetización; para ello, selecciona “Audience Network” y haz clic en el botón “Configurar”. Tendrás que elegir la cuenta del Administrador de monetización que quieras vincular.

Para hacerlo, también puedes ir a developers.facebook.com/apps y seleccionar la aplicación que acabas de crear.

La aplicación ya se ha incorporado a Audience Network y puede usar el permiso read_audience_network_insights. Si no puedes ver read_audience_network_insights, asegúrate de que la aplicación tenga acceso a la cuenta empresarial del Administrador de monetización.

Si ya has obtenido el permiso read_insights permission con el inicio de sesión con Facebook, el acceso seguirá funcionando, pero te recomendamos que comiences a usar el permiso read_audience_network_insights.

La forma en que enfoques el acceso a la API de informes variará en función del tipo de integración que tengas. Sigue las instrucciones que se ajusten a tu caso:

• Integración directa de la API sin interfaz de usuario
• Integración directa de la API con interfaz de usuario

Integración directa de la API sin interfaz de usuario

Si tienes una integración (directa) de la API de informes personalizada sin ninguna interfaz de usuario o front-end y la usas para consultar los datos solo de tu empresa, puedes usar las siguientes instrucciones a fin de obtener acceso a la API de informes.

Crear un identificador de usuario con el explorador de la API Graph

1. Si ya usas la “API de marketing” en tu aplicación, omite este paso. De lo contrario, sigue las instrucciones para obtener el permiso read_audience_network_insights.
2. Ve al explorador de la API Graph.
3. Selecciona la aplicación.
4. Selecciona el permiso “read_audience_network_insights” (lo encontrarás en Permisos > Páginas del grupo de eventos) y haz clic en “Generar identificador de acceso”.
1. Ahora puedes acceder a los datos de la API de informes de Audience Network durante un breve periodo de tiempo usando este identificador, y no el del Administrador de monetización.
2. Descargo de responsabilidad: este identificador caducará en dos horas y tendrás que convertirlo en un identificador de acceso de larga duración siguiendo las instrucciones que aparecen a continuación.

Convertir un identificador en un identificador de acceso de larga duración

1. Ve al depurador de identificadores de acceso.
2. Introduce tu identificador y pulsa “Depurar”.
3. Desplázate hasta la parte inferior de la tabla que contiene toda la información sobre los identificadores y haz clic en el botón “Ampliar identificador de acceso”.

4. Copia el identificador que se haya generado.

Ahora puedes acceder a los datos de la API de informes de Audience Network usando este identificador.

Integración directa de la API con interfaz de usuario

La guía siguiente es útil para los editores y socios que tienen su propia interfaz de usuario en la que se puede colocar el botón de inicio de sesión con Facebook. Esta guía será útil para los editores que quieran acceder a sus propios datos, así como para los socios que quieran acceder a los datos de monetización de otros editores con su permiso.

También puedes consultar el vídeo de demostración completa de la guía siguiente, que incluye el paso de los permisos anterior:

Se ha producido un error

Tenemos problemas para reproducir este vídeo.

Más información

• En el Portal para desarrolladores, selecciona la aplicación empresarial que acabas de crear en los pasos anteriores.
• Añade un nuevo producto “Inicio de sesión con Facebook” a esta aplicación.

• Selecciona la opción “Web” y sigue los pasos para la integración.

• Introduce la URL del sitio web donde mostrarás la experiencia del inicio de sesión con Facebook. Asegúrate de que sea compatible con el protocolo HTTPS.

• Al completar los pasos de integración, obtendrás el código de ejemplo para integrar el inicio de sesión con Facebook en tu sitio. Puedes copiar este código; no obstante, es recomendable usar el permiso “read_audience_network_insights” al que acabas de acceder en lugar de los permisos public_profile,email que se sugieren. El código del botón con el permiso actualizado debería tener este aspecto:

<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>

• Asegúrate de activar el SDK para JavaScript en la página de configuración del producto de inicio de sesión con Facebook de la aplicación.

• Ahora, los usuarios pueden pasar por el proceso de inicio de sesión con Facebook de la página para generar el identificador de acceso.
• El identificador de acceso se devolverá como parte del argumento que se pase al método de JavaScript statusChangeCallback de los pasos anteriores.

• De forma predeterminada, este identificador caducará en unas dos horas.
• Los desarrolladores pueden solicitar ampliar este identificador a los identificadores de acceso de larga duración sin necesidad de más interacciones del usuario.

  • Los identificadores de larga duración se actualizan una vez al día, cuando se realiza una solicitud de la API de informes a los servidores de Facebook. Si no se realiza ninguna solicitud, el identificador caduca pasados 60 días, aproximadamente, y el usuario tendrá que generar uno nuevo.
• Ten en cuenta que los datos que están disponibles mediante este identificador dependen en gran medida del usuario que pasa por este flujo de inicio de sesión con Facebook y de los datos que ha aceptado compartir. Así que, si un empleado de la empresa pasa por este flujo, el identificador de acceso que se genera tendrá los mismos permisos que este empleado.

Solución de problemas