{
  "user": {
    "eids": [{
      "source": "your-domain.com",
      "inserter": "your-domain.com",
      "uids": [
        {
          "id": "your-session-id",
          "atype": 500,
          "ext": { "id_type": "session", "consent_required": false }
        },
        {
          "id": "your-tracking-id",
          "atype": 1,
          "ext": { "id_type": "tracking", "consent_required": true }
        }
      ]
    }]
  },
  "ext": {
    "keyvalues": {
      "IP": "202603041502158687149647",
      "IV": "202603041502158687149647",
      "TABID": "tab-7f3e2a"
    }
  }
}

// iOS - Swift
import Foundation

let networkId = "7012768"  // your Ring DAS network ID
let bidderUrl = "https://das.idealo.com/\(networkId)/bid"

let requestBody: [String: Any] = [
    "id": UUID().uuidString,
    "imp": [[
        "id": "imp-1",
        "tagid": "product-button",
        "secure": 1,
        "native": ["request": "{}"]
    ]],
    "site": [
        "id": "demo_page",  // your site ID
        "ext": ["area": "product_card"]
    ],
    "user": [
        "ext": [
            "npa": false,  // false = consent given
            "ids": ["lu": generateUserId(), "sid": getSessionId()]  // sid: your own persistent identifier (alternative to lu)
        ]
    ],
    "ext": [
        "network": networkId,
        "keyvalues": [
            "manufacturer_id": "12345678",
            "main_category_id": 101,
            "page_product_id": "987654",
            "page_product_name": "Example Product Name"
        ],
        "is_non_prebid_request": true,
        "src": "app"
    ],
    "regs": [
        "gdpr": 1,
        "ext": ["dsa": 1]
    ],
    "tmax": 1000
]

// Encode and send as GET request
let jsonData = try! JSONSerialization.data(withJSONObject: requestBody)
let jsonString = String(data: jsonData, encoding: .utf8)!
let encoded = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)!
let url = URL(string: "\(bidderUrl)?data=\(encoded)")!

URLSession.shared.dataTask(with: url) { data, response, error in
    guard let httpResponse = response as? HTTPURLResponse else { return }

    // Handle 204 No Content (no ad available)
    if httpResponse.statusCode == 204 {
        print("No ad available")
        return
    }

    // Parse response...
}.resume()

// Android - Kotlin
import okhttp3.*
import org.json.JSONArray
import org.json.JSONObject
import java.net.URLEncoder

val networkId = "7012768"  // your Ring DAS network ID
val bidderUrl = "https://das.idealo.com/$networkId/bid"

val requestBody = JSONObject().apply {
    put("id", java.util.UUID.randomUUID().toString())
    put("imp", JSONArray().put(JSONObject().apply {
        put("id", "imp-1")
        put("tagid", "product-button")
        put("secure", 1)
        put("native", JSONObject().put("request", "{}"))
    }))
    put("site", JSONObject().apply {
        put("id", "demo_page")  // your site ID
        put("ext", JSONObject().put("area", "product_card"))
    })
    put("user", JSONObject().apply {
        put("ext", JSONObject().apply {
            put("npa", false)  // false = consent given
            put("ids", JSONObject().put("lu", generateUserId()).put("sid", getSessionId()))  // sid: your own persistent identifier (alternative to lu)
        })
    })
    put("ext", JSONObject().apply {
        put("network", networkId)
        put("keyvalues", JSONObject().apply {
            put("manufacturer_id", "12345678")
            put("main_category_id", 101)
            put("page_product_id", "987654")
            put("page_product_name", "Example Product Name")
        })
        put("is_non_prebid_request", true)
        put("src", "app")
    })
    put("regs", JSONObject().apply {
        put("gdpr", 1)
        put("ext", JSONObject().put("dsa", 1))
    })
    put("tmax", 1000)
}

// Encode and send as GET request
val encoded = URLEncoder.encode(requestBody.toString(), "UTF-8")
val request = Request.Builder().url("$bidderUrl?data=$encoded").build()

client.newCall(request).enqueue(object : Callback {
    override fun onResponse(call: Call, response: Response) {
        // Handle 204 No Content (no ad available)
        if (response.code == 204) {
            println("No ad available")
            return
        }

        // Parse response...
    }
    override fun onFailure(call: Call, e: IOException) { }
})

// iOS - Swift
guard let data = data,
      let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
      let seatbid = json["seatbid"] as? [[String: Any]],
      let bid = seatbid.first?["bid"] as? [[String: Any]],
      let firstBid = bid.first,
      let admString = firstBid["adm"] as? String,
      let admData = admString.data(using: .utf8),
      let adm = try? JSONSerialization.jsonObject(with: admData) as? [String: Any] else {
    return
}

// Extract tracking data
let gctx = adm["gctx"] as? String
let lctx = adm["lctx"] as? String

// Click tracking URL
let clickUrl = (adm["meta"] as? [String: Any])?["adclick"] as? String

if let fields = adm["fields"] as? [String: Any] {
    // Brand logo from AD SERVER
    let logoUrl = fields["image"] as? String
}

// DSA info (optional)
let dsaInfo = (firstBid["ext"] as? [String: Any])?["dsa"] as? [String: Any]

// Android - Kotlin
response.body?.string()?.let { body ->
    val json = JSONObject(body)
    val seatbid = json.optJSONArray("seatbid") ?: return
    val bid = seatbid.optJSONObject(0)?.optJSONArray("bid")?.optJSONObject(0) ?: return
    val adm = JSONObject(bid.getString("adm"))

    // Extract tracking data
    val gctx = adm.optString("gctx")
    val lctx = adm.optString("lctx")

    // Click tracking URL
    val clickUrl = adm.optJSONObject("meta")?.optString("adclick", null)

    // Brand logo from AD SERVER
    val logoUrl = adm.optJSONObject("fields")?.optString("image", null)

    // DSA info (optional)
    val dsaInfo = bid.optJSONObject("ext")?.optJSONObject("dsa")
}

// iOS - Swift
// YOUR shop data (price and URL) - brand logo comes from ad server!
struct ShopData {
    let productUrl = "https://apple.com/store/iphone"
    let shopName = "Apple"
    let price = "€899.00"
    // Note: brand logo comes from ad response (fields.image)
}

// Render button in your app's UI
// Attach click handler that:
// 1. Fires click tracking pixel
// 2. Opens shop URL

// Android - Kotlin
// YOUR shop data (price and URL) - brand logo comes from ad server!
data class ShopData(
    val productUrl: String = "https://apple.com/store/iphone",
    val shopName: String = "Apple",
    val price: String = "€899.00"
    // Note: brand logo comes from ad response (fields.image)
)

// Render button in your app's UI
// Attach click handler that:
// 1. Fires click tracking pixel
// 2. Opens shop URL

// iOS - Swift
func fireImpression(gctx: String, lctx: String, networkId: String) {
    let eventData: [String: Any] = [
        "gctx": gctx,
        "ems": [[
            "lctx": lctx,
            "is_measurable": true
        ]]
    ]

    guard let jsonData = try? JSONSerialization.data(withJSONObject: eventData),
          let jsonString = String(data: jsonData, encoding: .utf8),
          let encoded = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed),
          let url = URL(string: "https://das.idealo.com/\(networkId)/v1/events-processor/ems?eventData=\(encoded)") else {
        return
    }

    URLSession.shared.dataTask(with: url).resume()
}

// Android - Kotlin
fun fireImpression(gctx: String, lctx: String, networkId: String) {
    val eventData = JSONObject().apply {
        put("gctx", gctx)
        put("ems", JSONArray().put(JSONObject().apply {
            put("lctx", lctx)
            put("is_measurable", true)
        }))
    }

    val encoded = URLEncoder.encode(eventData.toString(), "UTF-8")
    val url = "https://das.idealo.com/$networkId/v1/events-processor/ems?eventData=$encoded"

    client.newCall(Request.Builder().url(url).build()).enqueue(object : Callback {
        override fun onFailure(call: Call, e: IOException) {}
        override fun onResponse(call: Call, response: Response) {}
    })
}

// iOS - Swift
func fireActiveView(gctx: String, lctx: String, networkId: String) {
    let eventData: [String: Any] = [
        "gctx": gctx,
        "ems": [[
            "lctx": lctx
        ]]
    ]

    guard let jsonData = try? JSONSerialization.data(withJSONObject: eventData),
          let jsonString = String(data: jsonData, encoding: .utf8),
          let encoded = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed),
          let url = URL(string: "https://das.idealo.com/\(networkId)/v1/events-processor/av?eventData=\(encoded)") else {
        return
    }

    URLSession.shared.dataTask(with: url).resume()
}

// Example viewability implementation
class ViewabilityTracker {
    private var timer: Timer?
    private var visibleStartTime: Date?
    private let requiredDuration: TimeInterval = 1.0
    private let requiredVisibility: CGFloat = 0.5

    func startTracking(adView: UIView, onViewable: @escaping () -> Void) {
        timer = Timer.scheduledTimer(withTimeInterval: 0.1, repeats: true) { [weak self] _ in
            guard let self = self else { return }

            if self.isViewVisible(adView, threshold: self.requiredVisibility) {
                if self.visibleStartTime == nil {
                    self.visibleStartTime = Date()
                } else if Date().timeIntervalSince(self.visibleStartTime!) >= self.requiredDuration {
                    self.timer?.invalidate()
                    onViewable()
                }
            } else {
                self.visibleStartTime = nil  // Reset if visibility lost
            }
        }
    }

    private func isViewVisible(_ view: UIView, threshold: CGFloat) -> Bool {
        guard let window = view.window else { return false }
        let viewFrame = view.convert(view.bounds, to: window)
        let intersection = viewFrame.intersection(window.bounds)
        let visibleArea = intersection.width * intersection.height
        let totalArea = viewFrame.width * viewFrame.height
        return visibleArea / totalArea >= threshold
    }
}

// Android - Kotlin
fun fireActiveView(gctx: String, lctx: String, networkId: String) {
    val eventData = JSONObject().apply {
        put("gctx", gctx)
        put("ems", JSONArray().put(JSONObject().put("lctx", lctx)))
    }

    val encoded = URLEncoder.encode(eventData.toString(), "UTF-8")
    val url = "https://das.idealo.com/$networkId/v1/events-processor/av?eventData=$encoded"

    client.newCall(Request.Builder().url(url).build()).enqueue(object : Callback {
        override fun onFailure(call: Call, e: IOException) {}
        override fun onResponse(call: Call, response: Response) {}
    })
}

// Example viewability implementation
class ViewabilityTracker(
    private val adView: View,
    private val onViewable: () -> Unit
) {
    private val handler = Handler(Looper.getMainLooper())
    private var visibleStartTime: Long? = null
    private val requiredDurationMs = 1000L
    private val requiredVisibility = 0.5f

    private val checkRunnable = object : Runnable {
        override fun run() {
            if (isViewVisible(adView, requiredVisibility)) {
                if (visibleStartTime == null) {
                    visibleStartTime = System.currentTimeMillis()
                } else if (System.currentTimeMillis() - visibleStartTime!! >= requiredDurationMs) {
                    onViewable()
                    return  // Stop checking
                }
            } else {
                visibleStartTime = null  // Reset if visibility lost
            }
            handler.postDelayed(this, 100)
        }
    }

    fun startTracking() {
        handler.post(checkRunnable)
    }

    fun stopTracking() {
        handler.removeCallbacks(checkRunnable)
    }

    private fun isViewVisible(view: View, threshold: Float): Boolean {
        val visibleRect = Rect()
        if (!view.getGlobalVisibleRect(visibleRect)) return false

        val visibleArea = visibleRect.width() * visibleRect.height()
        val totalArea = view.width * view.height
        return visibleArea.toFloat() / totalArea >= threshold
    }
}

// iOS - Swift
func handleAdClick(clickUrl: String, shopUrl: String) {
    // 1. Fire click tracking pixel (non-blocking)
    if let url = URL(string: clickUrl) {
        URLSession.shared.dataTask(with: url).resume()
    }

    // 2. Open shop URL
    if let url = URL(string: shopUrl) {
        UIApplication.shared.open(url)
    }
}

// Android - Kotlin
fun handleAdClick(clickUrl: String, shopUrl: String, context: Context) {
    // 1. Fire click tracking pixel (non-blocking)
    client.newCall(Request.Builder().url(clickUrl).build()).enqueue(object : Callback {
        override fun onFailure(call: Call, e: IOException) {}
        override fun onResponse(call: Call, response: Response) {}
    })

    // 2. Open shop URL
    val intent = Intent(Intent.ACTION_VIEW, Uri.parse(shopUrl))
    context.startActivity(intent)
}

// iOS - Swift - Complete Example
import Foundation
import UIKit

class BrandStoreAdManager {
    private let networkId: String
    private let bidderUrl: String
    private let client = URLSession.shared

    // Parsed ad data
    private var gctx: String?
    private var lctx: String?
    private var clickUrl: String?
    private var logoUrl: String?
    private var userId: String
    private var sessionId: String?  // your own persistent identifier (alternative to lu)

    init(networkId: String) {
        self.networkId = networkId
        self.bidderUrl = "https://das.idealo.com/\(networkId)/bid"
        self.userId = Self.generateUserId()
    }

    // MARK: - Public API

    func fetchAd(siteId: String, manufacturerId: String, completion: @escaping (Bool) -> Void) {
        let requestBody = buildRequest(siteId: siteId, manufacturerId: manufacturerId)

        guard let url = buildRequestURL(requestBody) else {
            completion(false)
            return
        }

        client.dataTask(with: url) { [weak self] data, response, _ in
            guard let httpResponse = response as? HTTPURLResponse else {
                completion(false)
                return
            }

            if httpResponse.statusCode == 204 {
                completion(false)
                return
            }

            guard let data = data else {
                completion(false)
                return
            }

            self?.parseResponse(data)
            completion(self?.gctx != nil)
        }.resume()
    }

    func fireImpression() {
        guard let gctx = gctx, let lctx = lctx else { return }
        fireEvent(endpoint: "ems", gctx: gctx, lctx: lctx, isMeasurable: true)
    }

    func fireActiveView() {
        guard let gctx = gctx, let lctx = lctx else { return }
        fireEvent(endpoint: "av", gctx: gctx, lctx: lctx, isMeasurable: false)
    }

    func handleClick(shopUrl: String) {
        // Fire click tracking
        if let clickUrl = clickUrl, let url = URL(string: clickUrl) {
            client.dataTask(with: url).resume()
        }

        // Open shop URL
        if let url = URL(string: shopUrl) {
            DispatchQueue.main.async {
                UIApplication.shared.open(url)
            }
        }
    }

    // MARK: - Private Helpers

    private func buildRequest(siteId: String, manufacturerId: String) -> [String: Any] {
        return [
            "id": UUID().uuidString,
            "imp": [["id": "imp-1", "tagid": "product-button", "secure": 1, "native": ["request": "{}"]]],
            "site": ["id": siteId, "ext": ["area": "product_card"]],
            "user": ["ext": ["npa": false, "ids": ["lu": userId, "sid": sessionId]]],
            "ext": ["network": networkId, "keyvalues": ["manufacturer_id": manufacturerId, "main_category_id": 101, "page_product_id": "987654", "page_product_name": "Example Product Name"], "is_non_prebid_request": true, "src": "app"],
            "regs": ["gdpr": 1, "ext": ["dsa": 1]],
            "tmax": 1000
        ]
    }

    private func buildRequestURL(_ body: [String: Any]) -> URL? {
        guard let jsonData = try? JSONSerialization.data(withJSONObject: body),
              let jsonString = String(data: jsonData, encoding: .utf8),
              let encoded = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) else {
            return nil
        }
        return URL(string: "\(bidderUrl)?data=\(encoded)")
    }

    private func parseResponse(_ data: Data) {
        guard let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
              let seatbid = json["seatbid"] as? [[String: Any]],
              let bid = seatbid.first?["bid"] as? [[String: Any]],
              let firstBid = bid.first,
              let admString = firstBid["adm"] as? String,
              let admData = admString.data(using: .utf8),
              let adm = try? JSONSerialization.jsonObject(with: admData) as? [String: Any] else {
            return
        }

        gctx = adm["gctx"] as? String
        lctx = adm["lctx"] as? String

        // Click tracking URL
        clickUrl = (adm["meta"] as? [String: Any])?["adclick"] as? String

        // Brand logo from AD SERVER
        if let fields = adm["fields"] as? [String: Any],
           let image = fields["image"] as? String {
            logoUrl = image
        }
    }

    private func fireEvent(endpoint: String, gctx: String, lctx: String, isMeasurable: Bool) {
        var emsItem: [String: Any] = ["lctx": lctx]
        if isMeasurable {
            emsItem["is_measurable"] = true
        }

        let eventData: [String: Any] = ["gctx": gctx, "ems": [emsItem]]

        guard let jsonData = try? JSONSerialization.data(withJSONObject: eventData),
              let jsonString = String(data: jsonData, encoding: .utf8),
              let encoded = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed),
              let url = URL(string: "https://das.idealo.com/\(networkId)/v1/events-processor/\(endpoint)?eventData=\(encoded)") else {
            return
        }

        client.dataTask(with: url).resume()
    }

    private static func generateUserId() -> String {
        let formatter = DateFormatter()
        formatter.dateFormat = "yyyyMMddHHmmss"
        let timestamp = formatter.string(from: Date())
        let random = String(format: "%010d", Int.random(in: 0..<10_000_000_000))
        return timestamp + random
    }
}