Partager via

Microsoft Monetize - Informations de référence sur les appels publicitaires mobiles

Remarque

Microsoft Advertising prend désormais en charge un domaine, adnxs-simple.com, qui n’envoie ni ne lit les cookies de navigateur sur les requêtes. Les clients peuvent tirer parti de ce domaine sans cookie lorsqu’il n’y a pas de consentement pour utiliser des données personnelles. Les appels pertinents lancés par Microsoft Advertising utilisent automatiquement ce domaine lorsqu’il n’y a pas de consentement ou lorsque les cookies ne sont pas nécessaires pour la fonction. Pour plus d’informations, consultez Partie des stratégies de service.

Ce document décrit nos appels publicitaires mobiles, les /ssmob appels et /mob , qui sont utilisés pour demander des publicités pour les applications mobiles. Ces appels incluent des informations sur l’appareil client en tant que paramètres de chaîne de requête.

Pour obtenir les définitions de tous les paramètres pris en charge, consultez Paramètres de chaîne de requête ci-dessous. Pour obtenir des exemples d’appels publicitaires mobiles réels, consultez exemples.

Notez que les appels et /mob décrits sur cette page concernent uniquement le /ssmobtrafic d’applications mobiles.

Étant donné que cet appel publicitaire concerne l’inventaire des applications mobiles, les tentatives de passage des domaines de site web, y compris via le paramètre déprécié referrer , seront ignorées. Cela signifie également que le site_domain champ du Guide de création de rapports sera défini sur vide, car il n’est pas nécessaire pour le trafic d’application.

Importante

Génération de format d’étiquette mobile

Le format de balise d’appel d’annonce mobile n’est pas généré par notre plateforme. Vous devez exporter les balises de placement, puis les modifier.

Si vous avez configuré un enregistrement CNAME pour la diffusion de publicités, nous vous recommandons d’utiliser un CNAME distinct pour les demandes de publicités médiatées sur /ssmob les appels qui pointent vers mediation.``adnxs``.com. Nous vous déconseillons d’utiliser un CNAME personnalisé pour /mob les appels.

Conseil

Codes d’opérateur valides pour l’exécution des enchères de débogage Vous essayez d’exécuter une enchère de débogage sur mobile ? Vous devez usurper le carrier paramètre. Pour obtenir la liste des codes d’opérateur valides, consultez Codes d’opérateur mobile.

Paramètres de chaîne de requête

L’appel d’annonce mobile accepte les paramètres de chaîne de requête indiqués ci-dessous. Pour obtenir des exemples de demandes d’appel d’annonces mobiles, consultez les exemples en bas de la page.

Importante

Notez que les champs ID d’appareil respectent la casse.

Remarque

Plusieurs de ces paramètres doivent être codés url.

Paramètre Type Obligatoire ? Description
aaid string Non Identificateur de publicité Google pour les appareils Android récupéré à partir des services Google Play.
Appid chaîne Non (mais fortement recommandé ; voir description) Cette chaîne est utilisée pour identifier une application mobile s’exécutant sur des appareils Android ou iOS.
- Sur Android, il s’agit du nom du package de l’application. Il est mis en forme comme suit : com example.helloworld.
- Sur iOS, il s’agit de l’ID iTunes de l’application. Il est mis en forme comme suit : 123456789.
De nombreux acheteurs définissent le ciblage et la création de rapports basés sur appid. Si vous ne fournissez pas un appid correct, votre inventaire n’est pas attrayant pour ces acheteurs. Par conséquent, la transmission de ce champ est fortement recommandée lorsque supply_type est défini sur "mobile_app". Notez que c’est ce que font nos Kits de développement logiciel (SDK) mobiles lorsqu’ils demandent une publicité. (Consultez la section ci-dessous pour voir comment notre Kit de développement logiciel (SDK) transmet le appid.)
Pour rechercher l’ID d’application pour une application Android ou IOS particulière, recherchez la page de détails de l’application ? le moyen le plus simple est d’effectuer une recherche sur le web. L’URL de la page de détails de l’App Store affiche l’ID de l’application (mis en évidence ici en rouge pour la visibilité).
Par exemple, voici les pages de détails de l’application « 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
Transporteur string Non Nom de l’opérateur mobile. Cela est facultatif, car notre système peut généralement déduire l’opérateur de l’adresse IP de l’appareil.
connection_type string Non Type de réseau utilisé par l’appareil. Les valeurs autorisées sont "wifi" ou "wan".
devmake string Non Fabricant de l’appareil demandant une annonce.
devmodel string Non Modèle de l’appareil demandant une publicité.
devtime int Non Temps sur l’appareil, mesuré en secondes depuis l’époque, ou Heure UNIX.
devtz string Non Fuseau horaire de l’appareil.
dnt valeur booléenne Non Remarque : Ce champ est déconseillé et peut être supprimé à l’avenir. Utilisez plutôt l’indicateur LimitAdTrackingEnabled .
Si truela valeur est , l’utilisateur a défini la préférence au niveau du système pour ne pas recevoir de publicités ciblées de manière comportementale. Valeurs autorisées : true, false, 1ou 0.
id int Oui ID unique du placement où la publicité sera servie. Si vous préférez ne pas passer l’ID de placement brut, vous pouvez passer une combinaison de member paramètres et inv_code . Pour plus d’informations, consultez la documentation relative à ces paramètres.
Idfa string Non Identificateur de publicité Apple pour les appareils iOS exécutant iOS 6+.
inv_code string Non (Facultatif) Un « code » fourni par l’utilisateur (chaîne arbitraire) qui identifie un emplacement particulier. Au lieu de transmettre l’ID de placement, vous pouvez passer une combinaison de ce champ et member pour identifier un emplacement spécifique de manière unique.
Ip string Oui, sur /ssmob les appels Adresse IP de l’appareil qui effectue la demande d’annonce, par exemple . 207.237.150.246
- S’il n’est pas spécifié pour /mob les appels, l’adresse IP transmise via les en-têtes HTTP sera utilisée à la place pour la détection géographique.
- S’il n’est pas spécifié pour /ssmob les appels, Microsoft Advertising ne sera pas en mesure de détecter l’emplacement géographique, et les acheteurs ne pourront donc pas cibler par géo.
istest valeur booléenne Non Indique s’il s’agit d’une demande de test. Valeurs autorisées : true ou false, 1 ou 0.
language string Non Langue de l’appareil, spécifiée avec un code de langue ISO.
LimitAdTrackingEnabled valeur booléenne Non Si truela valeur est , l’utilisateur a défini la préférence au niveau du système pour ne pas recevoir de publicités ciblées de manière comportementale. Valeurs autorisées : true, false, 1ou 0.
Conseil : Pour plus d’informations sur les préférences publicitaires au niveau du système sur iOS, consultez Désactiver les publicités basées sur les centres d’intérêt d’iAd.
Pour plus d’informations sur les préférences de publicité au niveau du système sur Android, consultez ID de publicité.
Loc string Non Emplacement de l’utilisateur exprimé en latitude et longitude, au format : snnn.ddddddddddddd,snnn.ddddddddddddd. Jusqu’à 13 décimales de précision sont autorisées.
loc_age int Non Ancienneté des données d’emplacement en millisecondes.
loc_prec int Non Précision des données d’emplacement dans les compteurs.
max_size string Non Taille de bannière maximale autorisée, par exemple. "320x250" N/A pour les annonces d’interstitiel.
Mcc int Non Le code du pays mobile tel que spécifié par l’UIT.
md5udid string Non Hachage MD5 du ANDROID_ID. Cela ne doit être envoyé que pour les appareils Android. Il doit s’agir d’une URL encodée.
member int Non (Facultatif) ID de membre du membre sur lequel l’annonce sera mise en place. Au lieu de transmettre l’ID de placement, vous pouvez passer une combinaison de ce champ et inv_code pour identifier un emplacement spécifique de manière unique.
Mnc int Non Code de réseau mobile tel que spécifié par l’UIT.
openudid string Non OpenUDID de l’appareil. Cela doit être envoyé uniquement pour iOS versions 5 et antérieures.
orientation string Non Orientation de l’écran de l’appareil pendant la demande d’annonce. Les valeurs autorisées sont "v" ou "h".
système d'exploitation string Non Système d’exploitation de l’appareil. Par exemple, Android 4.0.2. Pour les applications mobiles, cela est généralement fourni par l’agent utilisateur.
pcode string Non Code postal de l’utilisateur demandant une publicité. S’il n’est pas spécifié, le code postal est déterminé à partir de l’adresse IP.
Psa valeur booléenne Non Si truela valeur est , les psas serviront si la vente aux enchères n’a pas de gagnant. Sinon, une réponse HTTP vide 200 OK est retournée. Valeurs autorisées : true ou false, 1 ou 0.
sha1mac string Non sha1mac a été déconseillé depuis le 7 mai 2019. Ne pas utiliser.
sha1udid string Non Hachage SHA1 de .ANDROID_ID Cela ne doit être envoyé que pour les appareils Android. Il doit s’agir d’une URL encodée.
size string Non Taille de bannière demandée, par exemple , "320x50"ou taille d’écran pour les publicités publicitaires.
st string Non Type d’approvisionnement de l’inventaire, qui indique l’environnement dans lequel une annonce sera affichée. Valeurs autorisées : "mobile_app", "mobile_web"ou "web". La valeur par défaut est "mobile_app".
tmpl_id int Non Identificateur du modèle d’approvisionnement.
ua string Non Chaîne de l’agent utilisateur associée à l’appareil demandant une publicité. Si elle est spécifiée, cette valeur est utilisée plutôt que l’agent utilisateur standard envoyé via l’en-tête HTTP. Il doit s’agir d’une URL encodée.

Exemples

La plupart des exemples de cette section sont basés sur des appels publicitaires réels effectués par notre Kit de développement logiciel (SDK) mobile. Vous devriez pouvoir les essayer vous-même.

Les requêtes diffèrent de celles effectuées par le KIT de développement logiciel (SDK) comme suit :

  • Nous demandons l’annonce dans différents formats ? JavaScript (valeur par défaut), JSON et HTML
  • Nous utilisons l’outil curl en ligne de commande pour demander l’annonce au serveur ; pour plus d’informations sur curl, consultez le site web du projet à l’adresse https://curl.haxx.se/

Remarque

Le id paramètre dans ces exemples fait référence à l’ID de placement Microsoft Advertising. Vous devez le remplacer par celui fourni par le membre de la plateforme Microsoft Advertising avec lequel vous travaillez.

JavaScript

Importante

Si aucun format de réponse n’est spécifié, la réponse est JavaScript par défaut.

$ 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

Pour recevoir une réponse JSON, vous devez ajouter &format=json à la chaîne de requête de votre requête.

$ 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>"}] }

Interstitielle

$ 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" }

Aucune annonce retournée

$ 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"

Remarque

Aucune réponse JSON n’est retournée si aucune annonce n’est retournée.

Message d’erreur

$ 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

Pour recevoir une réponse HTML, vous devez ajouter &format=html à la chaîne de requête de votre requête.

$ 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>

Annonces natives

Remarque

Les publicités natives ne sont pas disponibles à partir du point de /ssmob terminaison.

Réponse vide

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

Réponse avec des publicités natives

Conseil

Le "native" tableau de cette réponse contient un ensemble d’objets ad natifs. Pour plus d’informations sur les créations natives, consultez Creative Service.

Les éléments à noter sur la réponse publicitaire native sont les suivants :

  • Les valeurs possibles du type champ sont "in-feed-standard" et "recommendation-widget."

  • La page web/l’application doit effectuer un test ping uniquement impression_trackers lorsque la publicité native est affichée.

  • La page web/l’application est requise pour effectuer un test ping sur lorsqu’un click_trackers clic est détecté.

    $ 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