Microsoft Monetize: referencia de llamada de anuncios móviles

Nota:

Microsoft Advertising ahora admite un dominio, adnxs-simple.com, que no envía ni lee cookies del explorador a petición. Los clientes pueden aprovechar este dominio libre de cookies cuando no hay consentimiento para usar datos personales. Las llamadas relevantes iniciadas por Microsoft Advertising utilizarán automáticamente este dominio cuando no haya consentimiento o cuando las cookies no sean necesarias para la función. Para obtener más información, consulte Parte de las directivas de servicio.

Este documento describe nuestras llamadas de anuncios móviles, las /ssmob llamadas y /mob llamadas, que se utilizan para solicitar anuncios para aplicaciones móviles. Estas llamadas incluyen información sobre el dispositivo cliente como parámetros de cadena de consulta.

Para obtener definiciones de todos los parámetros admitidos, consulte Parámetros de cadena de consulta a continuación. Para ver ejemplos de llamadas de anuncios móviles reales, vea los ejemplos.

Tenga en cuenta que las llamadas and /mob descritas en esta página son solo para el tráfico de/ssmob aplicaciones móviles.

Dado que esta llamada de anuncio es para el inventario de aplicaciones móviles, se omitirán los intentos de pasar dominios de sitios web, incluso a través del parámetro obsoleto referrer . Esto también significa que el campo de la Guía de informes se pondrá en blanco, ya que no es necesario para el site_domain tráfico de aplicaciones.

Importante

Generación de formato de etiqueta móvil

El formato de etiqueta de llamada de anuncios móviles no es generado por nuestra plataforma. Tendrá que exportar las etiquetas de ubicación y, a continuación, modificarlas.

Si has configurado un registro CNAME para la publicación de anuncios, te recomendamos que uses un CNAME independiente para las solicitudes de anuncios mediadas en /ssmob llamadas que apunten a mediation.``adnxs``.com. No se recomienda usar un CNAME personalizado para /mob las llamadas.

Sugerencia

Códigos de operador válidos para ejecutar subastas de depuración ¿Intentando ejecutar una subasta de depuración en dispositivos móviles? Deberá suplantar el carrier parámetro. Para obtener una lista de los códigos de operador válidos, consulte Códigos de operador de telefonía móvil.

Parámetros de la cadena de consulta

La llamada de anuncio móvil acepta los parámetros de cadena de consulta que se muestran a continuación. Para ver ejemplos de solicitudes de llamada de anuncios móviles, consulta los ejemplos al final de la página.

Importante

Ten en cuenta que los campos de identificador de dispositivo distinguen mayúsculas de minúsculas.

Nota:

Varios de estos parámetros deben codificarse como dirección URL.

Parámetro Tipo ¿Necesario? Descripción
aaid string No Identificador de publicidad de Google para dispositivos Android, tal y como se recupera de los servicios de Google Play.
appid string No (pero muy recomendable; consulte la descripción) Esta cadena se usa para identificar una aplicación móvil que se ejecuta en dispositivos Android o iOS.
- En Android, este es el nombre del paquete de la aplicación. Tiene el siguiente formato: com example.helloworld.
- En iOS, este es el ID de iTunes de la aplicación. Tiene el siguiente formato: 123456789.
Muchos compradores establecen la segmentación y los informes basándose en .appid Si no proporciona un identificador de usuario correcto, su inventario no será atractivo para estos compradores. Por lo tanto, se recomienda encarecidamente pasar este campo cuando supply_type se establece en "mobile_app". Ten en cuenta que esto es lo que hacen nuestros SDK para móviles cuando solicitan un anuncio. (Consulte la información a continuación para ver cómo nuestro SDK pasa el appid.)
Para buscar el ID de una aplicación Android o IOS en particular, busque la página de detalles de la aplicación ? La forma más fácil es hacer una búsqueda web. La dirección URL de la página de detalles de la tienda de aplicaciones mostrará el identificador de la aplicación (resaltado aquí en rojo para mayor visibilidad).
Por ejemplo, estas son las páginas de detalles de la aplicación "Fussball":
- Google Play: https://play.google.com/store/apps/details?id=de.telekom.FUSSBALL.DE
- iTunes: https://itunes.apple.com/de/app/fussball.de/id422052549
transportista string No Nombre del operador de telefonía móvil. Esto es opcional porque nuestro sistema normalmente puede deducir el operador a partir de la dirección IP del dispositivo.
connection_type string No El tipo de red que usa el dispositivo. Los valores permitidos son "wifi" or "wan".
devmake string No Fabricante del dispositivo que solicita un anuncio.
modelo de desarrollo string No Modelo del dispositivo que solicita un anuncio.
Tiempo de desarrollo Entero No El tiempo en el dispositivo, medido en segundos desde la época, o tiempo UNIX.
Devtz string No La zona horaria del dispositivo.
DNT booleano No Nota: Este campo está en desuso y puede quitarse en el futuro. Use la LimitAdTrackingEnabled marca en su lugar.
Si true, el usuario ha establecido la preferencia a nivel del sistema para no recibir anuncios segmentados por comportamiento. Valores permitidos: true, false, 1o 0.
id Entero Sí Id. exclusivo del emplazamiento en el que se publicará el anuncio. Si prefiere no pasar el identificador de ubicación sin formato, puede pasar una combinación de member y inv_code parámetros. Para obtener más información, consulte la documentación de esos parámetros.
IDFA string No Identificador de publicidad de Apple para dispositivos iOS con iOS 6+.
inv_code string No (Opcional) Un "código" proporcionado por el usuario (cadena arbitraria) que identifica una ubicación determinada. En lugar de pasar el identificador de ubicación, puede pasar una combinación de este campo e member identificar de forma única una ubicación específica.
IP string Sí, en /ssmob llamadas Dirección IP del dispositivo que realiza la solicitud de anuncio, por ejemplo, 207.237.150.246.
- Si no se especifica para /mob las llamadas, la IP pasada a través de encabezados HTTP se utilizará para la detección geográfica.
- Si no se especifica para /ssmob las llamadas, Microsoft Advertising no podrá detectar la ubicación geográfica y, por tanto, los compradores no podrán segmentar por ubicación geográfica.
istest booleano No Si se trata de una solicitud de prueba. Valores permitidos: true o false, 1 o 0.
language string No El idioma del dispositivo, especificado con un código de idioma ISO.
LimitAdTrackingEnabled booleano No Si true, el usuario ha establecido la preferencia a nivel del sistema para no recibir anuncios segmentados por comportamiento. Valores permitidos: true, false, 1o 0.
Consejo: Para obtener más información sobre las preferencias de anuncios a nivel de sistema en iOS, consulte Optar por no recibir anuncios basados en intereses de iAd.
Para obtener más información sobre las preferencias de anuncios a nivel de sistema en Android, consulte Id. de publicidad.
LoM string No La ubicación del usuario expresada en latitud y longitud, con el formato: snnn.ddddddddddddd,snnn.ddddddddddddd. Se permiten hasta 13 posiciones decimales de precisión.
loc_age Entero No Antigüedad de los datos de ubicación en milisegundos.
loc_prec Entero No Precisión de los datos de ubicación en metros.
max_size string No El tamaño máximo de banner permitido, por ejemplo, "320x250". N/A para anuncios intersticiales.
MCC Entero No El código de país del móvil especificado por la UIT.
md5udid string No El hash MD5 del archivo ANDROID_ID. Esto solo debe enviarse para dispositivos Android. Debe ser una URL codificada.
miembro Entero No (Opcional) Id. de miembro del miembro en cuya ubicación se publicará el anuncio. En lugar de pasar el identificador de ubicación, puede pasar una combinación de este campo e inv_code identificar de forma única una ubicación específica.
MULTINACIONAL Entero No El código de red móvil especificado por la UIT.
OpenUdid string No OpenUDID del dispositivo. Esto solo debe enviarse para las versiones 5 e inferiores de iOS.
orientation string No Orientación de la pantalla del dispositivo durante la solicitud de anuncio. Los valores permitidos son "v" or "h".
os string No El sistema operativo del dispositivo. Por ejemplo, Android 4.0.2. Para las aplicaciones móviles, esto generalmente lo proporciona el agente de usuario.
Código de dispositivo string No El código postal del usuario que solicita un anuncio. Si no se especifica, el código postal se determinará a partir de la dirección IP.
PSA booleano No Si true, los PSA servirán si la subasta no tiene ganador. De lo contrario, se devolverá una respuesta HTTP vacía 200 OK . Valores permitidos: true o false, 1 o 0.
SHA1MAC string No sha1mac quedó en desuso el 7 de mayo de 2019. No usar.
SHA1UDID string No El hash SHA1 del ANDROID_IDarchivo . Esto solo debe enviarse para dispositivos Android. Esto debe estar codificado como URL.
size string No El tamaño de banner solicitado, por ejemplo, "320x50"o el tamaño de pantalla de los anuncios intersticiales.
st string No El tipo de suministro del inventario, que indica el entorno en el que se mostrará un anuncio. Valores permitidos: "mobile_app", "mobile_web"o "web". Valores predeterminados de "mobile_app".
tmpl_id Entero No Identificador de la plantilla de suministro.
ua string No La cadena de agente de usuario asociada al dispositivo que solicita un anuncio. Si se especifica, se usará este valor en lugar del agente de usuario estándar enviado a través del encabezado HTTP. Debe ser una URL codificada.

Ejemplos

La mayoría de los ejemplos de esta sección se basan en llamadas publicitarias reales realizadas por nuestro SDK móvil. Deberías poder probarlos tú mismo.

Las solicitudes difieren de las realizadas por el SDK de la siguiente manera:

  • Pedimos el anuncio en diferentes formatos ? JavaScript (predeterminado), JSON y HTML
  • Usamos la curl herramienta de línea de comandos para solicitar el anuncio al servidor; para obtener más información sobre curl, consulte el sitio web del proyecto en https://curl.haxx.se/

Nota:

El id parámetro de estos ejemplos hace referencia al identificador de emplazamiento de Microsoft Advertising. Tendrás que reemplazarla por una proporcionada por el miembro de la plataforma de Microsoft Advertising con el que estés trabajando.

JavaScript

Importante

Si no se especifica ningún formato de respuesta, la respuesta será JavaScript de forma predeterminada.

$ curl "https://mobile.adnxs.com/mob?id=1281482&idfa=610B91D7-8F0D-423A-A98E-333DC41D04A2&devmake=Apple&devmodel=x86_64&appid=ANX.FunWithBeingMediatedByMoPub&ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%207_0_3%20like%20Mac%20OS%20X%29%20AppleWebKit%2F537.51.1%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F11B508&orientation=v&connection_type=wifi&devtime=1389725718&language=en&native_browser=0&psa=1&st=mobile_app&sdkver=1.7&size=320x50" document.write('<a href="https://nym1.mobile.adnxs.com/click?_Knx0k1iUD_8qfHSTWJQPwAAAAAAAPA__Knx0k1iUD_8qfHSTWJQP6DymlWmmrZKp-qJIdPe_STeGiJTAAAAAMqNEwC-AwAAvgMAAAIAAADtN2oAPsYCAAYAAQBVU0QAVVNEAEABMgARIAAAS7AAAgMCAQIAAAAADSiQdwAAAAA./cnd=%21LAZnOQjmx04Q7e-oAxi-jAsgBA../referrer=https%3A%2F%2Fapps.mobile.adnxs.com/clickenc=https%3A%2F%2Faww.reddit.com" target="_blank"><img width="320" height="50" style="border-style: none" src="https://placekitten.com/g/320/50"/></a>');

JSON

Importante

Para recibir una respuesta JSON, debe agregarla &format=json a la cadena de consulta de la solicitud.

$ curl "https://mobile.adnxs.com/mob?id=1281482&idfa=610B91D7-8F0D-423A-A98E-333DC41D04A2&devmake=Apple&devmodel=x86_64&appid=ANX.FunWithBeingMediatedByMoPub&ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%207_0_3%20like%20Mac%20OS%20X%29%20AppleWebKit%2F537.51.1%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F11B508&orientation=v&connection_type=wifi&devtime=1389725718&language=en&native_browser=0&psa=1&format=json&st=mobile_app&sdkver=1.7&size=320x50" { "status": "ok", "ads": [{"type":"banner", "width":320, "height":50, "content": "<script type=\"text/javascript\">document.write('<a href=\"https://nym1.mobile.adnxs.com/click?_Knx0k1iUD_8qfHSTWJQPwAAAAAAAPA__Knx0k1iUD_8qfHSTWJQP-ciduUWOCtUp-qJIdPe_SR4FSJTAAAAAMqNEwC-AwAAvgMAAAIAAADtN2oAPsYCAAYAAQBVU0QAVVNEAEABMgARIAAA4pUABQMCAQIAAAAAkSZ64AAAAAA./cnd=%21LAZnOQjmx04Q7e-oAxi-jAsgBA../referrer=https%3A%2F%2Fapps.mobile.adnxs.com/clickenc=https%3A%2F%2Faww.reddit.com\" target=\"_blank\"><img width=\"320\" height=\"50\" style=\"border-style: none\" src=\"https://placekitten.com/g/320/50\"/></a>');</script>"}] }

Intersticial

$ curl 'https://mobile.adnxs.com/mob?id=1281482&md5udid=8747a995943822f78754d20587f7b4f7&sha1udid=028df4e36437e98f9e93c3ae0f9f99e512a28cee&devmake=motorola&devmodel=DROID%20X2&carrier=Verizon%20Wireless&appid=com.example.helloworldinterstitial&ua=Mozilla%2F5.0%20(Linux%3B%20U%3B%20Android%202.3.5%3B%20en-us%3B%20DROID%20X2%20Build%2F4.5.1A-DTN-200-18)%20AppleWebKit%2F533.1%20(KHTML%2C%20like%20Gecko)%20Version%2F4.0%20Mobile%20Safari%2F533.1&orientation=v&size=360x640&promo_sizes=300x250,320x480&language=en&devtime=1396901116263&connection_type=wan&native_browser=0&psa=1&format=json&st=mobile_app&sdkver=1.14' { "ads": [ { "content": "<script type="text/javascript">document.write('<a href="https://nym1.mobile.adnxs.com/click?_Knx0k1iUD_8qfHSTWJQPwAAAAAAAPA__Knx0k1iUD_8qfHSTWJQP833ijTfLRsp7_epnuN8OQDtBENTAAAAAMqNEwC-AwAAvgMAAAIAAABRoWAAPsYCAAYAAQBVU0QAVVNEACwB-gARIAAAA6YABQMCAQIAAAAAGScpIgAAAAA./cnd=%21vQWKNQjmx04Q0cKCAxi-jAsgBA../referrer=https%3A%2F%2Fapps.mobile.adnxs.com/clickenc=https%3A%2F%2Faww.reddit.com" target="_blank"><img width="300" height="250" style="border-style: none" src="https://placekitten.com/300/250"/></a>');</script>", "height": 250, "width": 300, "type": "interstitial" } ], "status": "ok" }

No se devolvió ningún anuncio

$ curl "https://mobile.adnxs.com/mob?id=656561&size=320x480&devmake=Motorola&devmodel=Droid&pcode=12561&LimitAdTrackingEnabled=false&appid=com.example.hello_world&format=json"

Nota:

No se devuelve ninguna respuesta JSON si no se devuelve ningún anuncio.

Mensaje de error

$ curl "https://mobile.adnxs.com/mob?id=656561&size=320x480&devmake=Motorola&devmodel=Droid&pcode=12561&LimitAdTrackingEnabled=false&appid=com.example.hello_world&format=json&FOO=BAR" { "status": "error", "errorMessage": "invalid input parameter: FOO" }

HTML

Importante

Para recibir una respuesta HTML, debe agregarla &format=html a la cadena de consulta de la solicitud.

$ curl "https://mobile.adnxs.com/mob?id=1281482&idfa=610B91D7-8F0D-423A-A98E-333DC41D04A2&devmake=Apple&devmodel=x86_64&appid=ANX.FunWithBeingMediatedByMoPub&ua=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%207_0_3%20like%20Mac%20OS%20X%29%20AppleWebKit%2F537.51.1%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F11B508&orientation=v&connection_type=wifi&devtime=1389725718&language=en&native_browser=0&psa=1&format=html&st=mobile_app&sdkver=1.7&size=320x50" <script type="text/javascript">document.write('<a href="https://nym1.mobile.adnxs.com/click?_Knx0k1iUD_8qfHSTWJQPwAAAAAAAPA__Knx0k1iUD_8qfHSTWJQP1bxcdIRjzU7p-qJIdPe_STAFyJTAAAAAMqNEwC-AwAAvgMAAAIAAADtN2oAPsYCAAYAAQBVU0QAVVNEAEABMgARIAAAQq8AAQMCAQIAAAAAuibhDAAAAAA./cnd=%21LAZnOQjmx04Q7e-oAxi-jAsgBA../referrer=https%3A%2F%2Fapps.mobile.adnxs.com/clickenc=https%3A%2F%2Faww.reddit.com" target="_blank"><img width="320" height="50" style="border-style: none" src="https://placekitten.com/g/320/50"/></a>');</script>

Anuncios nativos

Solicitud

$ curl "https://ib.adnxs.com/ssmob?member_id=958&id=37264632&psa=0&cb=1641930961049&ip=77.12.28.48&format=json&native=1"

URL de solicitud de ejemplo

https://ib.adnxs.com/ssmob
  ?member_id=958
  &id=37264632
  &psa=0
  &cb=1641930961049
  &ip=77.12.28.48
  &format=json
  &native=1

Respuesta vacía

$ curl 'https://mobile.adnxs.com/mob?id=4448024' {"status":"no_bid","version":1}

Respuesta con anuncios nativos

Sugerencia

La "native" matriz de esta respuesta contiene un conjunto de objetos de anuncios nativos. Para obtener más información sobre las creatividades nativas, consulta el Servicio de creatividades.

Entre los aspectos que hay que tener en cuenta sobre la respuesta de anuncios nativos se incluyen:

  • Los valores posibles del type campo son "in-feed-standard" y "recommendation-widget."

  • Se requiere que la página web o la impression_trackers aplicación hagan ping solo cuando se muestre el anuncio nativo.

  • Se requiere que la página web o la click_trackers aplicación hagan ping cuando se detecte un clic.

    $ curl 'https://mobile.adnxs.com/mob?id=4469257'
{"status":"ok","version":1,"ads":[],"mediated":[],
"native":
[{"type":"in-feed-standard","title":"Disqus rocks","description":"Let us disqus!",
"fulltext":"Disqus rocks really long text","iconimgurl":"https://dummyimage.com/100x100?text=ICON",
"mainmedia":[{"label":"default","width":800,"height":500,"url":"https://dummyimage.com/800x500?text=MAINIMAGE"}],"cta":"download",
"clicktrackers":
["https://secure-nym.adnxs.com/click?AAAAAAAA8D8AAAAAAADwPwAAAAAAAPAAAAAAAAA8D8AAAAAAADw
PzmS3KNRni9xPwJNJXfgutNwtVAAAAAAkyRAC-AwAAvgMAAAIAAACs95cBFPAGAAYAAQBVU0QAVVNEAAEAAQARIAAALe8BAgMAAQIAAAAAQBir5QAAAAA.
/cnd=%21fwYfPAiWscsDEKzv3wwYlOAbIAQ./",
"https://dummyimage.com/1x1?text=CLICK-TRACKER","https://dummyimage.com/1x1?text=CLICK-TRACKER2"],
"impressiontrackers":
["https://secure-nym.adnxs.com/it?e=wqT3QLXA8DOAQAAAgDWAAUIre-sqAUQuaTynprK55dxGPnw6e
i-pWCyABKi0JAAAAAAAA8D8RBQgMAPAGREJACERCQApEQmoMInkkAI4vgdAvgdIAlCs798MWJTgG2AGaJFAcAB4rd4DgAEBigEDVVNEkgUG8FCYAQGgAQGoAQGwAQC4AQLAAQPIAQ
DQAQDYAQDgAQDwAQCKAjp1ZignYScsIDQxNjA3MywgMTQyNjc5ODUwOSk7dWYoJ3InLCAyNjczNjU1NiwyHgDwbJICnQEhUlI2Nkd3aVdzY3NERUt6djN3d1lBQ0NVNEJzd0FEZ0F
RQVJJdmdkUWllU1FBbGdBWVBjRGFBQndBSGdBZ0FFQWlBRUFrQUVCbUFFQm9BRUJxQUVEc0FFQXVRRUFBQUFBQUFEd1A4RUIJDExBQThEX0pBZFlYNHB5SDFRQkEyUR0oGC1BQkFQ
VUIJLCwuLpoCHSFmd1lmUEE2oADsbE9BYklBUS7YAugh3ALH0wGAAwCIAwGQAwCYAxagAwGqAwCwAwC4AwDAA6wCyAMA2AMA4AMB6AMC8AMB&dlo=1",
"https://dummyimage.com/1x1?text=IMP-TRACKER","https://dummyimage.com/1x1?text=IMP-TRACKER2"],
"click_url":"https://disqus.com"}]}
  • Last updated on