api-ads

operated by: Vungle Limited (get company information on datarequests.org, go to tracker entry in the Exodus database)

Endpoint URLs

These are URLs or regexes of endpoints the tracker sends data to. We use these to determine which adapter to apply to a request. Some trackers use the same endpoint for several formats. In this case we use additional logic to match the adapter to the request, refer to the code for more information.

https://ads.api.vungle.com/config
https://api.vungle.com/api/v5/ads
https://events.api.vungle.com/api/v5/cache_bust

Decoding steps

Every tracking library has its own way of transmitting tracking data, often even several. They are regularly pretty convoluted, nested encoding schemes. Because of that, the adapter needs to decode the request information into a consistent format. We try to keep keys and paths intact, but the structure results from our decoding. All steps used in the decoding for this adapter are documented here.

Description

Parse the request body as JSON. Store that in the result for the request body.

Pseudo code

1res.body = parseJson(body)

Observed data transmissions

This is data that we observed being transmitted by this tracker. Not every request contains all of this data. The context of the data describes where we found the data in the request, the path describes the location of the data in the decoded request. The examples are a selection of observed values.

Property	Context	Path	Examples of observed values
App ID	body	`app.bundle`	`com.outfit7.mytalkingtom2` `com.PSVStudio.HippoBabyBall` `com.casual.stairwaytoheaven` `mylittleprincess.wizard.free` `com.stx.pullhimout`
App version	body	`app.ver`	`2.4.0.544` `1.4.5` `1.8` `1.13` `1.2.1`
Battery level	body	`device.ext.vungle.android.battery_level`	`0.77` `1`
Battery level	body	`device.ext.vungle.ios.battery_level`	`1` `0.9900000095367432` `0.8500000238418579` `0.8700000047683716` `0.8799999952316284`
Carrier	body	`device.carrier`	`Android` `o2-de` `T-Mobile`
Free disk space	body	`device.ext.vungle.android.storage_bytes_available`	`5.577330688e+09` `5.577191424e+09` `5.57709312e+09` `5.577109504e+09` `5.577019392e+09`
Free disk space	body	`device.ext.vungle.ios.storage_bytes_available`	`1.4808190976e+10` `1.4806761472e+10` `1.4805266432e+10` `1.5395811328e+10` `1.5393656832e+10`
Device advertising ID (GAID/IDFA)	body	`device.ifa`	`827d8162-0e1c-48cd-892e-4abd3df95ba8` `ea70edc1-ac05-481c-8d2a-66b1be496a7e` `00000000-0000-0000-0000-000000000000` `C28EC4DC-DC86-4D1E-A3A9-353789F5CD26` `F04C6D92-D4FA-4CA4-AC62-DE94C8C2DAE7`
	body	`device.ext.vungle.android.gaid`	`827d8162-0e1c-48cd-892e-4abd3df95ba8` `ea70edc1-ac05-481c-8d2a-66b1be496a7e` `49b61a9c-cece-4300-b52e-26840e4c258e` `fffe8a97-a504-4d14-89ab-c2025fbaf065`
	body	`device.ext.vungle.ios.idfa`	`00000000-0000-0000-0000-000000000000` `C28EC4DC-DC86-4D1E-A3A9-353789F5CD26` `F04C6D92-D4FA-4CA4-AC62-DE94C8C2DAE7`
Developer-scoped device ID (IDFV/ASID/ANDROID_ID)	body	`device.ext.vungle.ios.idfv`	`8F2B0125-2F16-4F35-A419-1BABC693B890` `8B9FA787-6700-43E4-AB80-3E99D34A89E3` `96B9FAB0-9947-47A3-B06B-C0D638E5437D` `6BECBE05-26D9-43D4-BDA6-353DC1809D5E` `C71E5C30-4FB9-46E7-8C71-B5F625937BE9`
Charging status	body	`device.ext.vungle.android.battery_state`	`NOT_CHARGING`
Charging status	body	`device.ext.vungle.ios.battery_state`	`charging` `full`
Language	body	`device.ext.vungle.android.language`	`en`
Language	body	`device.ext.vungle.ios.language`	`en-DE` `de` `en`
Manufacturer	body	`device.make`	`Google` `Apple`
Model	body	`device.model`	`sdk_gphone_x86_64_arm64` `iPhone9,3` `iPhone10,4` `iPhone10,6` `sdk_gphone_x86_64`
Network connection type	body	`device.ext.vungle.android.connection_type`	`WIFI` `MOBILE`
Network connection type	body	`device.ext.vungle.ios.connection_type`	`wifi`
OS name	body	`device.os`	`android` `ios`
OS version	body	`device.osv`	`11` `14.8` `14.5.1` `15.6.1` `13`
Screen height	body	`device.h`	`2392` `1440` `1334` `750` `640`
Screen width	body	`device.w`	`1440` `2392` `750` `1334` `1136`
Time zone	body	`device.ext.vungle.android.time_zone`	`Europe/Berlin`
Time zone	body	`device.ext.vungle.ios.time_zone`	`Europe/Berlin`
User agent	body	`device.ua`	`Mozilla/5.0 (Linux; Android 11; sdk_gphone_x86_64_arm64 Build/RSR1.201013.001; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/83.0.4103.106 Mobile Safari/537.36` `Mozilla/5.0 (Linux; Android 11; sdk_gphone_x86_64_arm64 Build/RSR1.201211.001.A1; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/83.0.4103.106 Mobile Safari/537.36` `Mozilla/5.0 (iPhone; CPU iPhone OS 14_8 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148` `Mozilla/5.0 (iPhone; CPU iPhone OS 14_8 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MangaToon/2.09.00` `Dalvik/2.1.0 (Linux; U; Android 11; sdk_gphone_x86_64_arm64 Build/RSR1.201211.001.A1)`
Volume	body	`device.ext.vungle.android.volume_level`	`0.33333334` `0.8`
Volume	body	`device.ext.vungle.ios.volume_level`	`0` `9.999999747378752e-06` `0.125` `0.5`