Asignaciones de bloques de anuncios

Las asignaciones de unidades de anuncios son 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.

Cuando se crea un grupo de mediación, las asignaciones de unidades de anuncios se usan como parámetro para cada línea del grupo de mediación como configuración para que la unidad de anuncios especificada realice solicitudes a la red de publicidad de terceros. A diferencia de la IU de AdMob, las asignaciones de unidades de anuncios deben ser creadas independientemente fuera de los grupos de mediación y las líneas de grupos de mediación. Después de la creación, puedes enumerar todas las asignaciones de unidades de anuncios y usarlas como parámetro cuando crees o actualices líneas de grupos de mediación con nuevas asignaciones de unidades de anuncios.

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 la configuración de monetización de AdMob
https://www.googleapis.com/auth/admob.readonly Ver todos los datos de AdMob (esto puede incluir la información de la cuenta , los informes y la configuración de inventario y mediación, entre otros) (no se incluyen datos sensibles, como detalles de pagos o campañas)

Comienza a crear tu primera asignación de unidades 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 descargues cuando registres 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. En las ejecuciones posteriores, se actualiza el token automáticamente.

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

  2. Enumera las fuentes de anuncios.

    Para obtener información sobre las fuentes de anuncios de AdMob, reemplaza 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 de interés.

    Usa el siguiente comando para obtener una lista de 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)"

    Respuesta de muestra 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 unidades de anuncios.

    Reemplaza YYYYYYYYYY por tu fragmento de ID de unidad de anuncios. El fragmento de ID de unidad de anuncios son los últimos 10 dígitos de tu ID de 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 tu fragmento de ID de unidad de anuncios. El fragmento de ID de unidad de anuncios son los últimos 10 dígitos de tu ID de 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 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",
     }
   }
}