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 anuncios a una red de publicidad de terceros.
Cuando se crea un grupo de mediación, las asignaciones de unidades de anuncios se usan como un 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 se deben crear 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 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.
Esta es la información del alcance de OAuth 2.0:
Alcance | Significado |
---|---|
https://www.googleapis.com/auth/admob.monetization |
Consulta, crea y edita la configuración de monetización de AdMob. |
https://www.googleapis.com/auth/admob.readonly |
Consultar todos los datos de AdMob Esto puede incluir información de la cuenta, la configuración de inventario y mediación, los 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
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 acceder 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 a la que se haya accedido.
Para la autenticación y autorización, te recomendamos que uses oauth2l, una herramienta de línea de comandos simple para trabajar con OAuth 2.0 de Google. Instala oauth2l y ejecuta el comando a continuación. Reemplaza 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 guiará 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
Enumera las fuentes de anuncios.
Para obtener información de la fuente de anuncios de AdMob, reemplaza pub-XXXXXXXXXXXXXXXX con 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", } ] }
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 del anuncio 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" }] }] }
Crea una asignación de unidad de anuncios.
Reemplaza YYYYYYYYYY por el fragmento de ID de tu 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
Muestra una lista de todas las asignaciones de unidades de anuncios.
Reemplaza YYYYYYYYYY por el fragmento de ID de tu unidad de anuncios. El fragmento de ID de unidad de anuncios corresponde a los últimos 10 dígitos de tu ID de unidad de anuncios con 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", } } }