Documentation

App Object

App Object Properties

AttributeTypeDescriptionExample
idstringExchange-specific app ID."102938"
namestringApp name (may be aliased at the publisher’s request)."TestApp"
bundlestringApplication bundle or package name (e.g., com.app.game);

intended to be a unique ID across exchanges. iOS will pass the app store ID,

android - the package bundle
android: "com.app.test"

iOS: "78945611"
domainstringDomain of the app."game.app.com"
storeurlstringApp store URL for an installed app; for QAG 1.5 compliance."https://itunes.apple.com/us/app/somerandomapp/id1191231238?mt=8"
catstring arrayArray of IAB content categories of the app.["IAB2-1", "IAB2-4"]
sectioncatstring arrayArray of IAB content categories that describe the current section of the app.["IAB2"]
pagecatstring arrayArray of IAB content categories that describe the current page or view of the app.["IAB2-1"]
verstringApplication version."1.0.3"
privacypolicyintegerIndicates if the app has a privacy policy, where 0 = no, 1 = yes.1
paidinteger0 = app is free, 1 = the app is a paid version.1
publisherobjectDetails about the Publisher of the app.
keywordsstringComma separated list of keywords about the app."automotive"
extobjectPlaceholder for exchange-specific extensions to OpenRTB.

BidMachine sends sdk version, time of the session, session id, app uptime, number of impressions and clicks.
{
"sdk":"2.0.0",
"session_uptime":36,
"session_id":56,
"app_uptime":31995,
"impressions_count":142,"clicks_count":27
}

App Ext Object Properties

AttributeTime PeriodTypeDescriptionExample
session_idcurrent sessionNumberID of the current session (1st session has ID: 1)42
session_uptimecurrent sessionNumberUptime of the current session is seconds210
timpapp lifetimeObjectTotal impressions by ad type . Count of all ad impressions broken down by ad type for the app lifetime for all sessions{
"interstitial":1,
"rewarded_video":2,
"native":1,
"video":2,
"banner":1
}
tclickapp lifetimeObjectTotal clicks by ad type. Count of all ad clicks broken down by ad type for the app lifetime for all sessions{
"rewarded_video":1,
"native":1,
"video":2,
"banner":1
}
tfinishapp lifetimeObjectTotal finishes by ad type. Count of all ad finishes broken down by ad type for the app lifetime for all sessions

video/rewarded_video shows how much videos have been viewed till the end
interstitial shows how much interstitials have been closed
native shows how much native ads have been on screen for minimum 2 seconds
{
"interstitial":1,
"video":2,
"native":1
}
impcurrent session
lifetime
ObjectSession impressions by ad type. Count of all ad impressions broken down by ad type for the session lifetime{
"interstitial":1,
"rewarded_video":2,
"native":1,
"video":2,
"banner":1
}
clickcurrent session
lifetime
ObjectSession clicks by ad type. Count of all ad clicks broken down by ad type for the current session lifetime{
"rewarded_video":1,
"native":1,
"video":2,
"banner":1
}
finishcurrent session lifetimeObjectSession finishes by ad type . Count of all ad finishes broken down by ad type for the current session lifetime

video/rewarded_video shows how much videos have been viewed till the end
interstitial shows how much interstitials have been closed
native shows how much native ads have been on screen for minimum 2 seconds
{
"interstitial":1,
"video":2,
"native":1
}
imp_countapp lifetimeNumberTotal number of impressions.

iOS: Count of all ad impressions for the app lifetime for all sessions
Android: Count of all ad impressions for current session
474
click_countapp lifetimeNumberTotal number of clicks.

iOS: Count of all ad clicks for the app lifetime for all sessions
Android: Count of all ad clicks for current session
120
finish_countapp lifetimeNumberTotal number of finishes.

iOS: Count of all ad finishes for the app lifetime for all sessions
Android: Count of all ad finishes for the current session


video/rewarded_video shows how many videos have been viewed till the end
interstitial shows how many interstitials have been closed
native shows how many native ads have been on screen for at least 2 seconds

204
package_name-StringPackage name of current application"com.appodeal.sandbox"
app_timeapp lifetimeNumberApp uptime in seconds. Total uptime of the current application for the app lifetime for all sessions19850
sdk-StringAppodeal SDK version "2.1.0"
{
  "id": "6df24256-1aa1-4611-9f5c-436fcca336c0",
  "imp": [{
    "id": "0fbf2ab1-e901-464f-8294-d6d41e1a8fe4",
    "video": {
      "mimes": ["video/mp4"],
      "minduration": 5,
      "maxduration": 30,
      "protocols": [1, 2, 3, 4, 5, 6],
      "w": 320,
      "h": 480,
      "linearity": 1,
      "battr": [16],
      "playbackmethod": [1, 2, 3, 4],
      "delivery": [1, 2],
      "api": []
    },
    "displaymanager": "appodeal",
    "displaymanagerver": "2.4.0",
    "instl": 1,
    "tagid": "63",
    "bidfloor": 15.01,
    "bidfloorcur": "USD"
  }],
  "app": {
    "id": "7635",
    "name": "Appodeal Sandbox",
    "storeurl": "This app is not in store yet",
    "cat": ["IAB24"],
    "ver": "2.4.0",
    "privacypolicy": 0,
    "publisher": {
      "id": "1819",
      "name": "Dmitriy Usakov"
    },
    "ext": {
        "finish":{
            "interstitial":1,
            "video":2,
            "native":1
            },
        "imp":{
            "interstitial":1,
            "rewarded_video":2,
            "native":1,
            "video":2,
            "banner":1
            },
        "app_uptime":1462,
        "click_count":5,
        "click":{
            "rewarded_video":1,
            "native":1,
            "video":2,
            "banner":1
            },
        "session_uptime":490,
        "timp":{
            "interstitial":1,
            "rewarded_video":2,
            "native":1,
            "video":2,
            "banner":1
            },
        "sdk":"2.4.3",
        "tclick":{
            "rewarded_video":1,
            "native":1,
            "video":2,
            "banner":1
            },
        "finish_count":4,
        "session_id":10,
        "tfinish":{
            "interstitial":1,
            "video":2,
            "native":1
            },
        "imp_count":7
        }
  },
  "device": {
    "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36",
    "geo": {
      "lat": 58.5492,
      "lon": 50.0456,
      "type": 2,
      "country": "RUS",
      "city": "Kirovo-Chepetsk",
      "zip": "613044",
      "utcoffset": 180
    },
    "lmt": 0,
    "ip": "77.72.140.9",
    "devicetype": 4,
    "make": "Apple",
    "model": "x86_64",
    "os": "iOS",
    "osv": "11.2",
    "hwv": "x86_64",
    "h": 568,
    "w": 320,
    "ppi": 326,
    "pxratio": 2.0,
    "js": 1,
    "connectiontype": 2,
    "ifa": "9408EF57-D8DB-4B7C-A24F-50A6497154F5",
    "ext": {
      "battery": -100,
      "rooted": "false"
    }
  },
  "user": {
    "gender": "O",
    "geo": {
      "lat": 58.5492,
      "lon": 50.0456,
      "type": 2,
      "country": "RUS",
      "city": "Kirovo-Chepetsk",
      "zip": "613044",
      "utcoffset": 180
    }
  },
  "at": 2,
  "tmax": 300,
  "allimps": 0,
  "cur": ["USD"],
  "bcat": ["IAB-30"],
  "badv": [],
  "regs": {
    "coppa": 0
  }
}