Microsoft Invest: referencia de llamadas de anuncios móviles

Artículo
05/18/2024

Nota:

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

En este documento se describen nuestras llamadas de anuncios móviles, las /ssmob llamadas y /mob , que se usan 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 obtener ejemplos de llamadas de anuncios móviles reales, consulte los ejemplos.

Tenga en cuenta que las /ssmob llamadas y /mob descritas en esta página son solo para el tráfico de 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 sitio web, incluido el parámetro en referrer desuso. Esto también significa que el campo de la site_domainGuía de informes se establecerá en blanco, ya que no es necesario para el tráfico de aplicaciones.

Importante

Generación de formato de etiqueta móvil

Nuestra plataforma no genera el formato de etiqueta de llamada de anuncio móvil. Tendrá que exportar etiquetas de selección de ubicación y, a continuación, modificarlas.

Si ha configurado un registro CNAME para la publicación de anuncios, se recomienda usar 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

¿Está intentando ejecutar una subasta de depuración en el móvil? Tendrá que suplantar el carrier parámetro. Para obtener una lista de 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 obtener ejemplos de solicitudes de llamadas de anuncios móviles, consulte los ejemplos de la parte inferior de la página.

Importante

Los campos id. de dispositivo distinguen mayúsculas de minúsculas.

Nota:

Varios de estos parámetros deben estar codificados con dirección URL.

Parámetro	Tipo	¿Necesario?	Description
`id`	Entero	Yes	Identificador único de la ubicación en la que se mostrará el anuncio. Si prefiere no pasar el identificador de ubicación sin procesar, puede pasar una combinación de `member` parámetros y `inv_code` . Para obtener más información, consulte la documentación de esos parámetros.
`member`	Entero	No	(Opcional) El identificador de miembro del miembro en el que se colocará 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.
`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.
`appid`	string	No (pero se recomienda encarecidamente; 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 formato siguiente: `com.example.helloworld`. - En iOS, este es el id. de iTunes de la aplicación. Tiene el formato siguiente: `123456789`. Muchos compradores establecen la segmentación y los informes en función de `appid`. Si no se proporciona una corrección, `appid` el inventario no será atractivo para estos compradores. Por lo tanto, se recomienda encarecidamente pasar este campo cuando `supply_type` se establece en `"mobile_app"`. Tenga en cuenta que esto es lo que hacen nuestros SDK móviles cuando solicitan un anuncio. (Consulte lo siguiente para ver cómo nuestro SDK pasa . `appid`) Para buscar el identificador de la aplicación para una aplicación de Android o IOS determinada, busque la página de detalles de la aplicación? la manera más fácil es realizar 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 obtener 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
`carrier`	string	No	Nombre del operador de telefonía móvil. Esto es opcional porque nuestro sistema normalmente puede deducir el operador de la dirección IP del dispositivo.
`connection_type`	string	No	Tipo de red que usa el dispositivo. Los valores permitidos son `"wifi"` o `"wan"`.
`devmake`	string	No	Fabricante del dispositivo que solicita un anuncio.
`devmodel`	string	No	Modelo del dispositivo que solicita un anuncio.
`LimitAdTrackingEnabled`	booleano	No	Si `true`es , el usuario ha establecido la preferencia de nivel de sistema para no recibir anuncios dirigidos al comportamiento. Valores permitidos: `true`, `false`, `1`o `0`. Propina: Para obtener más información sobre las preferencias de anuncios de nivel de sistema en iOS, consulta Opt out of interest-based ads from iAd (No participar en anuncios basados en intereses de iAd). Para obtener más información sobre las preferencias de anuncios de nivel de sistema en Android, consulta Id. de publicidad.
`dnt`	booleano	No	Nota: Este campo está en desuso y puede quitarse en el futuro. Use la `LimitAdTrackingEnabled` marca en su lugar. Si `true`es , el usuario ha establecido la preferencia de nivel de sistema para no recibir anuncios dirigidos al comportamiento. Valores permitidos: `true`, `false`, `1`o `0`.
`devtime`	Entero	No	Tiempo en el dispositivo, medido en segundos desde la época o tiempo unix.
`devtz`	string	No	Zona horaria del dispositivo.
`md5udid`	string	No	Hash MD5 de .`ANDROID_ID` Esto solo debe enviarse para dispositivos Android. Debe estar codificado como dirección URL.
`sha1udid`	string	No	Hash SHA1 de `ANDROID_ID`. Esto solo debe enviarse para dispositivos Android. Debe ser una dirección URL codificada.
`idfa`	string	No	Identificador de publicidad de Apple para dispositivos iOS que ejecutan iOS 6+.
`aaid`	string	No	El identificador de publicidad de Google para dispositivos Android recuperado de los servicios de Google Play.
`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 dirección IP que se pasa a través de encabezados HTTP se usará para la detección geográfica en su lugar. - Si no se especifica para `/ssmob` las llamadas, Microsoft Advertising no podrá detectar la ubicación geográfica y, por lo tanto, los compradores no podrán dirigirse a la 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.
`loc`	string	No	La ubicación del usuario expresada en latitud y longitud, en 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	Tamaño máximo de banner permitido, por ejemplo, `"320x250"`. N/A para anuncios intersticiales.
`mcc`	Entero	No	Código de país móvil especificado por la UIT.
`mnc`	Entero	No	Código de red móvil especificado por la UIT.
`openudid`	string	No	OpenUDID del dispositivo. Esto solo debe enviarse para las versiones 5 y posteriores de iOS.
`orientation`	string	No	Orientación de la pantalla del dispositivo durante la solicitud de anuncio. Los valores permitidos son `"v"` o `"h"`.
`os`	string	No	Sistema operativo del dispositivo. Por ejemplo, Android 4.0.2. En el caso de las aplicaciones móviles, el agente de usuario suele proporcionar esto.
`pcode`	string	No	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`es , las 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 a partir del 7 de mayo de 2019. No usar.
`st`	string	No	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"`.
`size`	string	No	El tamaño de banner solicitado, por ejemplo, `"320x50"`o el tamaño de pantalla de los anuncios intersticiales.
`tmpl_id`	Entero	No	Identificador de plantilla de suministro.
`ua`	string	No	Cadena del agente de usuario asociada al dispositivo que solicita un anuncio. Si se especifica, este valor se usará en lugar del agente de usuario estándar enviado a través del encabezado HTTP. Debe estar codificado como dirección URL.

Ejemplos

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

Las solicitudes difieren de las realizadas por el SDK como se indica a continuación:

Pedimos el anuncio en diferentes formatos; JavaScript (valor predeterminado), JSON y HTML.
Usamos la curl herramienta de línea de comandos para solicitar el anuncio desde el 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 ubicación de Microsoft Advertising. Tendrá que reemplazarlo por uno proporcionado por el miembro de la plataforma de Microsoft Advertising con el que trabaja.

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 agregar &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 agregar &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

Nota:

Los anuncios nativos no están disponibles en el punto de /ssmob conexión.

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 anuncio nativos. Para obtener más información sobre las creatividades nativas, consulte El servicio creativo.

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

Los valores posibles del type campo son "in-feed-standard" y "recommendation-widget."
La página web o aplicación es necesaria para hacer ping a solo impression_trackers cuando se muestra el anuncio nativo.

La página web o aplicación es necesaria para hacer ping a click_trackers cuando se detecta 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"}]}

Compartir a través de

Microsoft Invest: referencia de llamadas de anuncios móviles

Parámetros de la cadena de consulta

Ejemplos

JavaScript

JSON

Banner

Intersticial

No se devolvió ningún anuncio

Mensaje de error

HTML

Anuncios nativos

Respuesta vacía

Respuesta con anuncios nativos

Recursos adicionales

Compartir a través de

Microsoft Invest: referencia de llamadas de anuncios móviles

Parámetros de la cadena de consulta

Ejemplos

JavaScript

JSON

Banner

Intersticial

No se devolvió ningún anuncio

Mensaje de error

HTML

Anuncios nativos

Respuesta vacía

Respuesta con anuncios nativos

Temas relacionados

Recursos adicionales