비드 요청

AppLovin RTB bid requests는 항상 하나의 광고 노출에 대해서만 전송됩니다(이는 OpenRTB 스키마와 다릅니다). 각 request에는 하나의 impression 객체(imp)가 있습니다.

Seats

AppLovin RTB Exchange는 비더당 여러 seat을 지원하지 않습니다. seat 화이트리스트 wseat 배열은 무시됩니다.

Bid request object

App object

Device object

Valid region codes

• AK (Alaska)
• AL (Alabama)
• AR (Arkansas)
• AZ (Arizona)
• CA (California)
• CO (Colorado)
• CT (Connecticut)
• DC (District of Columbia)
• DE (Delaware)
• FL (Florida)
• GA (Georgia)
• HI (Hawaii)
• IA (Iowa)
• ID (Idaho)
• IL (Illinois)
• IN (Indiana)
• KS (Kansas)
• KY (Kentucky)
• LA (Louisiana)
• MA (Massachusetts)
• MD (Maryland)
• ME (Maine)
• MI (Michigan)
• MN (Minnesota)
• MO (Missouri)
• MS (Mississippi)
• MT (Montana)
• NC (North Carolina)
• ND (North Dakota)
• NE (Nebraska)
• NH (New Hampshire)
• NJ (New Jersey)
• NM (New Mexico)
• NV (Nevada)
• NY (New York)
• OH (Ohio)
• OK (Oklahoma)
• OR (Oregon)
• PA (Pennsylvania)
• PR (Puerto Rico)
• RI (Rhode Island)
• SC (South Carolina)
• SD (South Dakota)
• TN (Tennessee)
• TX (Texas)
• UT (Utah)
• VA (Virginia)
• VT (Vermont)
• WA (Washington)
• WI (Wisconsin)
• WV (West Virginia)
• WY (Wyoming)

Impression object

AppLovin RTB bid request는 항상 단일 impression을 전달합니다 (이는 OpenRTB 스키마와 다릅니다). 각 request에는 하나의 impression 객체(imp)가 있습니다.

request의 impression 객체에 banner 객체가 포함되어 있으면 해당 impression은 HTML 및 MRAID 광고를 게재할 수 있습니다. request에 video 객체가 포함되어 있으면 해당 impression은 VAST 광고를 게재할 수 있습니다. impression 객체에는 banner 객체, video 하위 객체 또는 둘 다 포함될 수 있습니다.

Metric object

Video object

Banner object

Native object

AppLovin native 광고는 OpenRTB Dynamic Native Ads API Specification Version 1.2를 사용합니다. impression 객체에는 native 객체가 포함됩니다. native 객체에는 native request의 JSON 문자열 표현이 포함된 request 필드가 있습니다. AppLovin은 video 에셋을 지원하지 않습니다.

Example bid request

{
  "app": {
    "bundle": "com.example.game",
    "cat": ["IAB9-30"],
    "id": "188e1f4c72744d3da3134a25",
    "name": "Example Game",
    "publisher": {
      "id": "41c8cd761e099946e85842c11debfb4d"
    },
    "storeurl": "https://play.google.com/store/apps/details?id=com.example.game"
  },
  "at": 1,
  "bcat": ["IAB8-5","IAB8-18","IAB11-4","IAB25","IAB26"],
  "device": {
    "carrier": "telekomde",
    "connectiontype": 3,
    "devicetype": 4,
    "dnt": 0,
    "geo": {
      "city": "Barrington",
      "country": "USA",
      "metro": "",
      "type": 2,
      "zip": ""
    },
    "h": 1280,
    "hwv": "hllte",
    "ifa": "e1020eb8-fc74-454d-b420-a9763d8bc556",
    "ip": "203.0.113.12",
    "js": 1,
    "language": "de",
    "lmt": 0,
    "make": "samsung",
    "model": "SM-N7505",
    "os": "Android",
    "osv": "5.1.1",
    "ua": "Mozilla/5.0 (Linux; Android 4.3; SM-N7505 Build/JSS15J) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.89 Mobile Safari/537.36",
    "w": 720
  },
  "id": "94dedeadbeefc4b8fcba406639bbf15912766bdc",
  "imp": [
    {
      "banner": {
        "api": [
          3,
          5
        ],
        "battr": [
          1,
          2,
          5,
          8,
          9,
         14,
         17
        ],
        "btype": [
          1,
          4
        ],
        "h": 480,
        "pos": 1,
        "w": 320
      },
     "displaymanager": "applovin",
     "displaymanagerver": "6.1.4",
     "id": "1",
     "instl": 1,
     "secure": 0,
     "tagid": "0652dbc39a23edfd",
     "video": {
        "battr": [
          1,
          2,
          3,
          7,
          8,
          9,
         14,
         13
        ],
        "companiontype": [
          1,
          2,
          3
        ],
        "h": 480,
        "linearity": 1,
        "mimes": [
          "video/mp4"
        ],
        "protocols": [
          2,
          3
        ],
        "w": 320
      }
    }
  ]
}

Example native bid request

{
  "app": {
    "bundle": "com.example.game",
    "cat": [
      "IAB24"
    ],
    "id": "81a292321de8ed119cb833e0a80c4231",
    "name": "Example Game",
    "publisher": {
      "id": "41c8cd761e099946e85842c11debfb4d"
    },
    "storeurl": "https://play.google.com/store/apps/details?id=com.example.game"
  },
  "at": 1,
  "badv": [
  ],
  "device": {
    "carrier": "verizon",
    "connectiontype": 2,
    "devicetype": 4,
    "dnt": 0,
    "geo": {
      "city": "Redwood City",
      "country": "USA",
      "metro": "",
      "type": 2
    },
    "h": 0,
    "hwv": "",
    "ifa": "12341234-1234-1234-1234-123412341234",
    "ip": "255.255.255.255",
    "ipv6": "2a00:79e1:abc:6b01:d516:20e2:582d:339a",
    "js": 1,
    "language": "en",
    "lmt": 0,
    "make": "",
    "model": "",
    "os": "Android",
    "osv": "8.0.0",
    "ua": "Mozilla/5.0 (Linux; Android 8.0.0; en_US; Moto Z (2) Build/ODXS27.000-00-00) AppleWebKit/000.00 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/000.00",
    "w": 0
  },
  "id": "d628d2709c061c14ea4a2e17a52da1778534d1f5",
  "imp": [
    {
      "displaymanager": "applovin",
      "displaymanagerver": "6.0.0",
      "ext": { },
      "id": "1",
      "native": {
        "api": [],
        "battr": [
          1,
          2,
          5,
          8,
          9,
         14,
         17,
          3,
          4,
         13
        ],
        "request": "{\"native\":{\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":140}},{\"id\":2,\"img\":{\"hmin\":800,\"type\":3,\"wmin\":417},\"required\":1},{\"id\":3,\"img\":{\"hmin\":50,\"type\":1,\"wmin\":50},\"required\":1},{\"data\":{\"len\":140,\"type\":2},\"id\":4,\"required\":0},{\"data\":{\"len\":15,\"type\":12},\"id\":5,\"required\":1},\"context\":1501,\"plcmtcnt\":1,\"plcmttype\":1,\"ver\":\"1.2\"}}",
        "ver": "1.2"
      },
      "secure": 0,
      "tagid": "5ba489fc7ec59a27:NOTIFYCLEAN"
    }
  ]
}

Example CTV bid request

{
  "id": "eb3ebe82eb5223c2525d46bd3bef213649466b0a",
  "at": 1,
  "bcat": [
    "IAB11-4",
    "IAB8-5",
    "test1",
    "IAB8-18",
    "IAB25-7",
    "IAB25-1",
    "IAB25-5",
    "IAB25-2",
    "IAB25-3",
    "IAB26-1",
    "IAB25-4",
    "IAB26-4",
    "IAB26-2",
    "IAB26-3",
    "IAB25-6",
    "test2"
  ],
  "tmax": 500,
  "badv": [
    "test2",
    "test1"
  ],
  "app": {
    "name": "APPINT",
    "bundle": "com.applovin.appint",
    "cat": [],
    "id": "a9dad9c29f02533c9462db5555561e79",
    "publisher": {
      "id": "61310",
      "ext": {}
    },
    "content": {
      "contentrating": "TV-PG",
      "genre": "Documentary,Science",
      "episode": 2,
      "season": "7",
      "ext": {
        "channel": "AppLovin Test"
      }
    },
    "storeurl": "https://channelstore.roku.com/details/196460",
    "ext": {}
  },
  "device": {
    "ifa": "66dcd4a1-a0ed-b2b8-7e1a-3d2ea2ecc889",
    "ip": "204.14.60.221",
    "language": "en",
    "devicetype": 3,
    "js": 0,
    "geo": {
      "type": 2,
      "ipservice": 3,
      "city": "Sidney Center",
      "country": "USA",
      "region": "ny",
      "dma": "502",
      "metro": "502",
      "zip": "13839",
      "ext": {
        "org": "DTC Cable",
        "isp": "DTC Cable"
      }
    },
    "ext": {},
    "make": "Roku",
    "model": "DVP",
    "os": "Roku OS",
    "dnt": 0,
    "lmt": 0
  },
  "imp": [
    {
      "id": "1",
      "displaymanager": "applovin",
      "instl": 0,
      "secure": 1,
      "tagid": "2f850a687d1acfdb:",
      "bidfloor": 22.58823529411765,
      "bidfloorcur": "USD",
      "exp": 14400,
      "video": {
        "w": 1920,
        "h": 1080,
        "battr": [
          1,
          2,
          5,
          8,
          9,
          14,
          17,
          3,
          4,
          13
        ],
        "mimes": [
          "video/mp4",
          "video/ogg",
          "video/webm"
        ],
        "placement": 1,
        "pos": 1,
        "minduration": 5,
        "maxduration": 60,
        "startdelay": -1,
        "minbitrate": 1,
        "maxbitrate": 280000,
        "linearity": 1,
        "sequence": 1,
        "protocols": [
          1,
          2,
          3,
          4,
          5,
          6
        ],
        "podid": "pod_1",
        "podseq": 0,
        "slotinpod": 0,
        "ext": {
          "maxsequence": 1
        }
      },
      "rwdd": 0,
      "ext": {}
    }
  ],
  "user": {
    "ext": {
      "gdpr": 0
    },
    "id": "66dcd4a1-a0ed-b2b8-7e1a-3d2ea2ecc889"
  },
  "regs": {
    "ext": {
      "ccpa": 0,
      "gdpr": 0
    }
  },
  "source": {
    "ext": {
      "schain": {
        "ver": "1.0",
        "complete": 1,
        "nodes": [
          {
            "asi": "applovin.com",
            "sid": "61310",
            "rid": "eb3ebe82eb5223c2525d46bd3bef213649466b0a",
            "hp": 1
          }
        ]
      }
    }
  }
}