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

El inicio de sesión con Facebook ofrece una nueva alternativa para permitir el acceso a datos de la API de informes de Audience Network. Este enfoque reemplazará al viejo token de usuario del sistema de copia y pegado de la interfaz del administrador de monetización. Este enfoque es una forma más segura de otorgar acceso a tus datos, debido al riesgo de que el token del administrador de monetización quede expuesto fuera de la empresa.

Este documento se centra en brindar orientación para socios de integraciones directas de la API de informes, medición de dispositivos móviles, mediación y otros socios de Facebook que trabajan para acceder a los datos de la API de informes en representación de los editores.

Uso tecnología de terceros para obtener los datos de la API de informes

Si se trata de un socio preexistente (socio de medición de dispositivos móviles o socio de mediación), no hace falta que realices ninguna otra tarea de programación. Asegúrate de que tu socio integre el proceso de inicio de sesión con Facebook. Es necesario que hagas clic en la opción "Iniciar sesión con FB" y selecciones las propiedades a las que quieres dar acceso con el token que generarás.

Si seleccionas TODAS las propiedades, el token proporcionará acceso a todas las propiedades del negocio, siempre que el usuario que creó el token tenga acceso a la propiedad en el administrador comercial.

Permisos

Si necesitas usar la API de informes directamente, primero tendrás que crear una app de Facebook y obtener los permisos obligatorios. Tu app necesita el permiso read_audience_network_insights para acceder a los datos de la API de informes de Audience Network. Si deseas obtener este permiso para la app, es necesario que el negocio se registre en Audience Network.

• Tras el registro en el administrador de monetización, ve a la página para desarrolladores de Facebook y comienza a crear una nueva app de negocios.

• Selecciona la empresa creada en el campo de cuenta de empresa.

Después de crear la app, necesitarás vincularla a tu cuenta de administrador de monetización seleccionando "Audience Network" y haciendo clic en el botón "Configurar". Debes elegir qué cuenta de administrador de monetización deseas vincular.

También puedes hacerlo si vas a developers.facebook.com/apps y seleccionas la app que acabas de crear.

Ahora tu app está registrada en Audience Network y puede usar el permiso read_audience_network_insights. Si no puedes ver el permiso read_audience_network_insights, asegúrate de que la app tenga acceso a la cuenta de administrador de monetización del negocio.

También funcionará si cuentas con el premiso read_insights permission, que obtuviste con anterioridad, con el inicio de sesión con Facebook. Sin embargo, te recomendamos que uses el permiso read_audience_network_insights.

La forma en que accedes a la API de informes dependerá del tipo de integración con la que cuentas. Sigue las instrucciones que se refieren a tu caso:

• Integración de API directa sin interfaz de UI
• Integración de API directa con interfaz de UI

Integración de API directa sin interfaz de UI

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

Crea un token de usuario mediante el explorador de la API Graph

1. Si ya usas la API de marketing en tu app, 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 tu app
4. Selecciona el permiso "read_audience_network_insights" (se puede encontrar en Permisos > Páginas de grupos de eventos) y haz clic en Generar token de acceso.
1. Ahora, podrás acceder a los datos de la API de informes de Audience Network con ese token, aunque solo por un breve período, en lugar del token del administrador de monetización.
2. Descargo de responsabilidad: este token caducará en 2 horas. Tendrás que convertirlo en el token de acceso de larga duración usando las instrucciones que se indican abajo.

Convertir este token en un token de acceso de larga duración

1. Ve al depurador de token de acceso.
2. Inserta el token y presiona Depurar.
3. Desplázate hasta la parte inferior de la tabla que contiene toda la información del token y haz clic en el botón Extender token de acceso.

4. Copia el token generado.

Ahora puedes acceder a los datos de la API de informes de Audience Network con este token.

Integración de API directa con interfaz de UI

La siguiente guía es útil para editores y socios que cuentan con su propia interfaz de UI, en la que se puede colocar el botón de inicio de sesión con Facebook. Resulta útil para los editores que desean acceder a sus propios datos y también para los socios que quieren contar con acceso a los datos de monetización de los editores con su permiso.

También puedes ver el video de demostración de extremo a extremo de la siguiente guía si incluyes el paso relativo a los permisos que se indicó con anterioridad:

Se produjo un error

Tenemos problemas para reproducir este video.

Más información

• En el portal de desarrolladores, selecciona la nueva app de negocios de los pasos anteriores.
• Agrega un nuevo producto de "inicio de sesión con Facebook" a este paso.

• Selecciona la opción "Web" y sigue los pasos de la integración.

• Inserta la URL del sitio web en el que mostrarás tu experiencia de inicio de sesión en Facebook. Asegúrate de que admita el protocolo HTTPS.

• Cuando hayas completado los pasos de integración, se te proporcionará el código de ejemplo para integrar el inicio de sesión con Facebook en tu sitio web. Puedes copiar este código, pero solo si usas el permiso read_audience_network_insights al que recién accediste, en vez del permiso public_profile,email que se sugiere. Con el permiso actualizado, el código de tu botón debería tener el siguiente aspecto:

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

• Asegúrate de habilitar el SDK de JavaScript en el inicio de sesión con Facebook de la página de configuración de productos de tu app.

• Ahora, los usuarios podrán seguir el proceso de inicio de sesión con Facebook en tu página para generar el token de acceso.
• El token de acceso se devolverá como parte del argumento pasado al método statusChangeCallback de JavaScript de los pasos anteriores.

• Por defecto, este token caducará en unas dos horas.
• Los desarrolladores pueden solicitar la extensión de este token y transformarlos en tokens de acceso de larga duración sin que sea necesario que los usuarios tengan mayor interacción.

  • Los tokens de larga duración se actualizan una vez al día, cuando se hace una solicitud de la API de informes a los servidores de Facebook. Si no se hacen solicitudes, el token caduca después de unos 60 días. En este caso, las personas deberán generar un nuevo token.
• Ten en cuenta que los datos disponibles mediante este token dependerán en gran medida de las personas que pasan este inicio de sesión con Facebook y de qué datos aceptan compartir. Por este motivo, si el empleado del negocio es quien pasa este proceso, el token de acceso resultante tendrá los mismos permisos que los de este empleado.

Solución de problemas