Asignaciones de bloques de anuncios

Los parámetros de configuración de terceros que se asignan a una unidad de anuncios de AdMob y le permiten realizar una solicitud de anuncio a una red de publicidad de terceros se denominan asignaciones de unidades de anuncios.

Cuando se crea un grupo de mediación, las asignaciones de unidades de anuncios se utilizan como parámetro para cada línea del grupo de mediación como configuración de la unidad de anuncios especificada para realizar solicitudes a redes de publicidad de terceros. A diferencia de la IU de AdMob, las asignaciones de unidades de anuncios deben crearse de forma independiente fuera de los grupos de mediación y las líneas de grupos de mediación. Después de la creación, puedes listar todas las asignaciones de unidades de anuncios y usarlas como parámetro cuando crees o actualices líneas de grupos de mediación con asignaciones de unidades de anuncios nuevas.

Ejemplos

Con las credenciales de OAuth 2.0 creadas, ya puedes comenzar a usar la API de AdMob. Para solicitar acceso con OAuth 2.0, tu aplicación también necesitará la información del alcance.

A continuación, se muestra la información del alcance de OAuth 2.0:

Alcance Significado
https://www.googleapis.com/auth/admob.monetization Ver, crear y editar tu configuración de monetización de AdMob
https://www.googleapis.com/auth/admob.readonly Ver todos los datos de AdMob Esto puede incluir información de la cuenta, la configuración del inventario y la mediación, informes y otros datos. No se incluyen datos sensibles, como detalles de pagos o campañas.

Sigue estos pasos para crear tu primera asignación de unidad de anuncios:

curl (línea de comandos)

Solicitudes con curl

  1. Carga el archivo de secretos del cliente y genera credenciales de autorización.

    La primera vez que realices este paso, se te pedirá que aceptes un mensaje de autorización en tu navegador. Antes de aceptar, asegúrate de haber accedido con una Cuenta de Google que tenga acceso a la API de AdMob. Tu aplicación estará autorizada para acceder a los datos en nombre de la cuenta que esté conectada en ese momento.

    Para la autenticación y la autorización, te recomendamos que uses oauth2l, una herramienta de línea de comandos simple para trabajar con Google OAuth 2.0. Instala oauth2l y ejecuta el siguiente comando, reemplazando path_to_credentials_json por una ruta de acceso a un archivo credentials.json que descargas cuando registras tu aplicación en la nube. En la primera ejecución, el comando te guía por el flujo de autorización de OAuth 2.0. Las ejecuciones posteriores actualizan el token automáticamente.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. Enumera las fuentes de anuncios.

    Obtén información sobre la fuente de anuncios de AdMob reemplazando pub-XXXXXXXXXXXXXXXX por tu ID de publicador. Consulta las instrucciones para encontrar tu ID de publicador.

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Respuesta de muestra:

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. Enumera los adaptadores.

    Reemplaza SSSSSSSSSSSSSSSSSSSS por el ID de la fuente de anuncios de los adaptadores que te interesan.

    Usa el siguiente comando para obtener una lista de los adaptadores:

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Ejemplo de respuesta para la fuente de anuncios de la red de AdMob con el ID 5450213213286189855:

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

  4. Crea una asignación de unidad de anuncios.

    Reemplaza YYYYYYYYYY por el fragmento de tu ID de unidad de anuncios. El fragmento del ID de la unidad de anuncios son los últimos 10 dígitos del ID de la unidad de anuncios, que sigue el formato "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consulta las instrucciones para encontrar tu ID de unidad de anuncios.

    curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

  5. Enumera todas las asignaciones de unidades de anuncios.

    Reemplaza YYYYYYYYYY por el fragmento de tu ID de unidad de anuncios. El fragmento del ID de la unidad de anuncios son los últimos 10 dígitos del ID de la unidad de anuncios en el formato "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consulta las instrucciones para encontrar tu ID de unidad de anuncios.

     curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    {
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}