Bidding with In-House Mediation

Integración de las pujas de servidor a servidor

La mediación interna no está disponible públicamente

La puja interna con Audience Network está actualmente en versión beta cerrada y no está disponible públicamente. Proporcionaremos más actualizaciones si se produce algún cambio.

Como alternativa, puedes acceder a la puja de Audience Network mediante una de las plataformas de mediación con las que nos asociamos.

Facebook Audience Network tiene un postor de Open Real-Time Bidding (ORTB) compatible con integraciones de cliente directas e integraciones de servidor a servidor. En esta guía se describe cómo integrar las pujas desde un servidor de subastas.

En una integración de servidor a servidor, un servidor de subastas llama al extremo de pujas de Facebook Audience Network y al resto de orígenes de demanda para obtener respuestas de puja. A continuación, el servidor de subastas lleva a cabo la subasta y elige la puja ganadora. Este servidor de subastas puede ser un servidor interno que ejecute la lógica de la subasta que creaste o un servidor de terceros integrado con las pujas de la aplicación de Audience Network. Esto te permite utilizar los recursos del servidor y la red disponible para llamar a los extremos de pujas de los orígenes de demanda. También te permite hacer cambios en las integraciones de estos extremos sin necesidad de solicitar actualizaciones del cliente.

Requisitos previos

Antes de empezar, lee Información general acerca de las pujas de Audience Network y Prácticas recomendadas de integración de las pujas.

Android

iOS

Preparación

Es necesario seguir los pasos que se describen a continuación para preparar las pujas internas de servidor a servidor:

Registrar la empresa

Cada editor debe crear un identificador de negocio de Audience Network, que añadiremos a la lista de autorizados para las pujas. Este identificador de negocio permite crear varias propiedades que utilizan el extremo de pujas.

  • Ve a la documentación de Facebook Audience Network y haz clic en el botón Empezar ahora para crear un identificador de negocio nuevo, o bien utiliza tu identificador de negocio existente.
  • Puedes crear propiedades con el mismo identificador de negocio, pero tendrás que registrarlas. Para obtener más información, consulta Administrador de monetización.
  • Comunícanos el identificador de negocio (tu identificador de editor).
  • Puedes administrar el acceso de los usuarios a tu aplicación o negocio.

Crear una aplicación de seguridad de Facebook

Todos los editores internos del lado del servidor deben crear una aplicación de seguridad de Facebook en https://developers.facebook.com. Una vez creada, tendrás que obtener el identificador y la clave secreta de la aplicación de seguridad. La clave secreta de la aplicación se utilizará en todas las solicitudes para crear un identificador de autenticación a fin de validar al autor de la solicitud.

Asegúrate de usar el hash correcto (que se especifica a continuación) y, si el hash empieza por 0, de que no se pierda

.

Para crear una aplicación de seguridad y vincularla a tu negocio, haz lo siguiente:

  1. Inicia sesión en https://developers.facebook.com.
  2. En el menú Mis aplicaciones, haz clic en Crear aplicación.
  3. Selecciona Empresa y, a continuación, haz clic en Siguiente.
  4. Proporciona un nombre para la aplicación con el prefijo “AN_SECURITY_APP” y, a continuación, haz clic en Crear un identificador de la aplicación.
  5. En el menú de la izquierda, selecciona Configuración → Básica.
  6. En el campo Clave secreta de la aplicación, haz clic en Mostrar. Anota el identificador y la clave secreta de la aplicación.
  7. Ve a https://business.facebook.com y selecciona tu empresa.
  8. En el menú de la izquierda, selecciona Configuración de la empresa.
  9. En el menú de la izquierda de la página Configuración de la empresa, selecciona Cuentas → Aplicaciones.
  10. En el panel Aplicaciones, haz clic en Añadir → Añadir una aplicación.
  11. Especifica el identificador de la aplicación de seguridad y, a continuación, haz clic en Añadir una aplicación. La aplicación con el prefijo AN_SECURITY_APP debería aparecer en tu empresa.

El valor de authentication_id específico de la solicitud se genera con el algoritmo HMAC-SHA256. Este algoritmo utiliza las entradas siguientes:

  • Identificador de solicitud como mensaje
  • Clave secreta de la aplicación como clave
      authentication_id = HMAC_SHA256(request_id, app_secret)

A continuación, el identificador generado se añade a la extensión de solicitud de puja de OpenRTB de nivel superior en el campo authentication_id. Por ejemplo, si el identificador de solicitud es “9r90wurjqw” y la clave secreta de la aplicación es “12345asdfg”, el valor de authentication_id se genera así:

      authentication_id = HMAC_SHA256(9r90wurjqw, 12345asdfg) = 39bbe40bc68899a9356085ca8c81

Este identificador se incluirá en cada solicitud junto con el identificador de la aplicación de seguridad.

      {
      "id": "9r90wurjqw",
      ...
      "ext": {
      "authentication_id": "39bbe40bc68899a9356085ca8c81d3021cfa124f2a2b3c68c88f95fb4cde40a4",
      "security_app_id": "AN_SECURITY_APP_MY_SECURITY_APP_ID" 
      ...
      }
      }

Pasar el identificador de identidad al postor

Nuestro postor espera un identificador de identidad en el campo user.buyeruid de la solicitud ORTB. Este identificador se genera de distintas formas para distintas plataformas.

Android

En un subproceso en segundo plano, llama a com.facebook.ads.BidderTokenProvider.getBidderToken() desde el SDK de Audience Network para Android. El identificador se debe solicitar para cada solicitud de puja. Pasa también el valor de IDFA en el campo device.ifa a AdvertisingIdClient.getAdvertisingIdInfo(context).getId().

iOS

Llama a [FBAdSettings bidderToken] desde el SDK de Audience Network para iOS. El identificador se debe solicitar para cada solicitud de puja. Pasa también el valor de IDFA en el campo device.ifa con [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString].

Siguientes pasos