Ortb Integration Guide

  https://api.nexverse.ai/openrtb2/auction
  

  {
  "id": "1d58fd5a503f9e02decefab159354f85:card-pp1:pp1_1",
  "test": 1,
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250,
        "mimes": [
          "text/html",
          "image/png",
          "image/gif",
          "image/jpeg",
          "application/javascript",
          "text/javascript"
        ],
        "api": [3, 5, 7]
      },
      "instl": 0,
      "bidfloor": 0.01,
      "secure": 1,
      "ext": {
        "nexverse": {
          "uid": "ff8b7f99e1bc174ba6debc9d9f30867a",
          "pub_id": "24053",
          "pub_epid": "34054",
          "test": 1,
          "configId": "8ce6a9b0-59bd-4f94-865f-e0f1fe3b7f92"
        }
      }
    }
  ],
  "app": {
    "id": "com.eterno",
    "name": "Dailyhunt (Newshunt)- Cricket, News,Videos",
    "domain": "dailyhunt.in",
    "bundle": "com.eterno",
    "publisher": {
      "id": "16164",
      "domain": "dailyhunt.in"
    },
    "storeurl": "https://play.google.com/store/apps/details?id=com.eterno&hl=en"
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 14; V2311 Build/UP1A.231005.007_MOD1; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/136.0.7103.60 Mobile Safari/537.36",
    "ip": "152.59.5.225",
    "geo": {
      "country": "IND",
      "city": "vadodara"
    },
    "dpidmd5": "1cb611b2148bb00e37d3785fd9d84a7f",
    "language": "gu",
    "os": "android",
    "devicetype": 4,
    "ifa": "e877a025-deaf-4608-94f4-2d28028b84c9",
    "mccmnc": "-"
  },
  "user": {
    "id": "e877a025-deaf-4608-94f4-2d28028b84c9",
    "buyeruid": "dh.SExZUnNoU0xzQTQzMDNoZjJkaEtmdz09A"
  },
  "at": 1,
  "tmax": 500,
  "badv": [
    "paytm.com",
    "primevideo.com",
    "goibibo.com",
    "moneyview.in",
    "samsung.com",
    "ajio.com",
    "fancode.com",
    "lg.com",
    "ketto.org",
    "indusind.com",
    "mi.com",
    "donateforhealth.com",
    "amazon.in",
    "in.a23.rummy",
    "betway.com",
    "bigo.tv",
    "dailyhunt.in"
  ],
  "bapp": [
    "com.dreamplug.androidapp"
  ]
}
  

  {
  "id": "1",
  "banner": {
    "w": 320,
    "h": 50,
    "pos": 7,
    "format": [
      { "w": 320, "h": 50 },
      { "w": 300, "h": 250 }
    ],
    "topframe": 1
  },
  "bidfloor": 0.75,
  "bidfloorcur": "USD",
  "secure": 1,
  "ext": {
    "nexverse": {
      "uid": "ff8b7f99e1bc174ba6debc9d9f30867a",
      "pub_id": "24053",
      "pub_epid": "34054",
      "test": 1
    }
  }
}
  

  {
  "id": "2",
  "video": {
    "mimes": ["video/mp4", "video/webm"],
    "minduration": 5,
    "maxduration": 30,
    "protocols": [2, 3, 5],
    "playbackmethod": [1, 3],
    "delivery": [1],
    "pos": 1
  },
  "bidfloor": 1.50,
  "bidfloorcur": "USD",
  "secure": 1,
  "ext": {
    "nexverse": {
      "uid": "ff8b7f99e1bc174ba6debc9d9f30867a",
      "pub_id": "24053",
      "pub_epid": "34054",
      "test": 1
    }
  }
}
  

  {
  "id": "1234567890",
  "bidid": "bidresponse_id_123",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "dsp_seat_A",
      "bid": [
        {
          "id": "bid_id_1",
          "impid": "1",
          "price": 1.25,
          "nurl": "https://rtb.nexverse.ai/win_notice?bidid=${AUCTION_BID_ID}&impid=${AUCTION_IMP_ID}&price=${AUCTION_PRICE}",
          "adm": "<div style=\"width:300px; height:250px; background-color:#f0f0f0; border:1px solid #ccc; display:flex; justify-content:center; align-items:center; font-family: 'Inter', sans-serif;\"><h2>Ad Creative!</h2><p>This is a sample ad.</p><button style=\"padding: 8px 16px; background-color: #007bff; color: white; border: none; border-radius: 4px; cursor: pointer;\">Click Me</button></div>",
          "adomain": ["examplead.com"],
          "iurl": "https://rtb.nexverse.ai/creative_preview.jpg",
          "crid": "creative_id_xyz",
          "w": 300,
          "h": 250,
          "ext": {
            "vasttag": "https://rtb.nexverse.ai/vasttag.xml"
          }
        }
      ]
    }
  ]
}
  

  /**
 * Function to construct and send an OpenRTB BidRequest.
 * @param {object} bidRequest The OpenRTB BidRequest object.
 * @returns {Promise<object|null>} A promise that resolves with the BidResponse object or null on error/no bids.
 */
async function sendBidRequest(bidRequest) {
  const endpoint = 'https://rtb.nexverse.ai/';

  try {
    const response = await fetch(endpoint, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      },
      body: JSON.stringify(bidRequest),
      // Consider a timeout for real-time bidding, e.g., using AbortController
      // signal: abortController.signal
    });

    if (response.status === 204) {
      console.log('No bids found for this impression.');
      return null;
    }

    if (!response.ok) {
      const errorText = await response.text();
      console.error(`HTTP error! Status: ${response.status}, Details: ${errorText}`);
      throw new Error(`API request failed with status ${response.status}`);
    }

    const bidResponse = await response.json();
    return bidResponse;

  } catch (error) {
    console.error('Error sending bid request:', error);
    return null;
  }
}

/**
 * Example usage:
 */
const sampleBidRequest = {
  "id": "test_request_123",
  "imp": [{
    "id": "1",
    "banner": {
      "w": 300,
      "h": 250
    },
    "bidfloor": 0.50,
    "bidfloorcur": "USD"
  }],
  "device": {
    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.88 Safari/537.36",
    "ip": "192.168.1.1",
    "make": "Google",
    "model": "Pixel 6",
    "os": "Android",
    "osv": "12",
    "devicetype": 1 // Mobile
  },
  "app": {
    "id": "com.mytestapp",
    "name": "My Test App",
    "bundle": "com.mytestapp",
    "cat": ["IAB1"]
  },
  "at": 2,
  "tmax": 120
};

// Immediately invoked async function for demonstration
(async () => {
  console.log('Sending sample bid request...');
  const response = await sendBidRequest(sampleBidRequest);

  if (response) {
    console.log('Received BidResponse:', response);
    // Process bids and render ad
    if (response.seatbid && response.seatbid.length > 0) {
      response.seatbid.forEach(seatBid => {
        seatBid.bid.forEach(bid => {
          console.log(`Bid ID: ${bid.id}, Price: ${bid.price}, Impression ID: ${bid.impid}`);
          console.log('Ad Markup (adm):', bid.adm);

          // Example: Render HTML creative (for a banner ad)
          const adContainer = document.getElementById('ad-slot-' + bid.impid);
          if (adContainer && bid.adm) {
            adContainer.innerHTML = bid.adm; // Inject the HTML creative
            console.log(`Ad for imp ID ${bid.impid} rendered.`);

            // Fire win notice if nurl is present
            if (bid.nurl) {
              const winNoticeUrl = bid.nurl
                .replace('${AUCTION_BID_ID}', response.bidid || '')
                .replace('${AUCTION_IMP_ID}', bid.impid)
                .replace('${AUCTION_PRICE}', bid.price);
              console.log('Firing win notice URL:', winNoticeUrl);
              // In a real SDK, you'd make an HTTP GET request to this URL
              fetch(winNoticeUrl, { method: 'GET', mode: 'no-cors' }) // Use no-cors for beaconing
                .then(() => console.log('Win notice fired successfully.'))
                .catch(err => console.error('Error firing win notice:', err));
            }
          }
        });
      });
    } else {
      console.log('BidResponse received, but no bids were found.');
    }
  } else {
    console.log('No BidResponse received.');
  }
})();

// For a browser environment, you would need a div element to inject the ad
/*
<body>
  <div id="ad-slot-1" style="width:300px; height:250px; border:1px solid lightgray; margin: 20px; display: flex; justify-content: center; align-items: center; background-color: #f9f9f9; font-family: 'Inter', sans-serif; border-radius: 8px;">
    Ad will appear here for imp ID 1
  </div>
</body>
*/
  

  import requests
import json

def send_bid_request(bid_request):
    """
    Sends an OpenRTB BidRequest to the endpoint.

    Args:
        bid_request (dict): The OpenRTB BidRequest dictionary.

    Returns:
        dict or None: The BidResponse dictionary if successful, None otherwise.
    """
    endpoint = 'https://rtb.nexverse.ai/'
    headers = {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    }

    try:
        response = requests.post(endpoint, headers=headers, data=json.dumps(bid_request), timeout=0.150) # 150ms timeout
        response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)

        if response.status_code == 204:
            print("No bids found for this impression.")
            return None
        
        return response.json()

    except requests.exceptions.Timeout:
        print("The request timed out.")
        return None
    except requests.exceptions.HTTPError as err:
        print(f"HTTP error occurred: {err} - {err.response.text}")
        return None
    except requests.exceptions.RequestException as err:
        print(f"An error occurred: {err}")
        return None

def fire_win_notice(nurl, bid_id, imp_id, price):
    """
    Fires the win notice URL after a successful impression.
    """
    if nurl:
        win_notice_url = nurl \
            .replace('${AUCTION_BID_ID}', bid_id) \
            .replace('${AUCTION_IMP_ID}', imp_id) \
            .replace('${AUCTION_PRICE}', str(price)) # Price might need to be stringified

        print(f"Firing win notice URL: {win_notice_url}")
        try:
            # Use a short timeout and don't care about the response for beaconing
            requests.get(win_notice_url, timeout=1, stream=True)
            print("Win notice fired successfully.")
        except requests.exceptions.RequestException as err:
            print(f"Error firing win notice: {err}")

# Example usage:
sample_bid_request = {
  "id": "test_py_request_001",
  "imp": [{
    "id": "1",
    "banner": {
      "w": 300,
      "h": 250
    },
    "bidfloor": 0.50,
    "bidfloorcur": "USD"
  }],
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 10) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.58 Mobile Safari/537.36",
    "ip": "192.168.1.100",
    "make": "Python",
    "model": "SDK",
    "os": "Linux",
    "osv": "5.4",
    "devicetype": 1
  },
  "app": {
    "id": "com.pythonsdk.app",
    "name": "Python SDK Test App",
    "bundle": "com.pythonsdk.app",
    "cat": ["IAB1"]
  },
  "at": 2,
  "tmax": 120
}

print("Sending sample bid request from Python...")
bid_response = send_bid_request(sample_bid_request)

if bid_response:
    print("\nReceived BidResponse:")
    print(json.dumps(bid_response, indent=2))

    if 'seatbid' in bid_response and bid_response['seatbid']:
        for seat_bid in bid_response['seatbid']:
            for bid in seat_bid.get('bid', []):
                print(f"\nProcessing Bid ID: {bid.get('id')}")
                print(f"  Impression ID: {bid.get('impid')}")
                print(f"  Price: {bid.get('price')}")
                print(f"  Ad Markup (first 100 chars): {bid.get('adm', '')[:100]}...")

                # In a real SDK, you would parse and render 'adm'
                # For demonstration, we'll just fire the win notice if available.
                
                # Fire win notice if nurl is present
                if bid.get('nurl'):
                    fire_win_notice(
                        bid['nurl'],
                        bid_response.get('bidid', ''), # Use actual bid response ID
                        bid['impid'],
                        bid['price']
                    )
    else:
        print("BidResponse received, but no bids were found.")
else:
    print("No BidResponse received.")
  

  dependencies {
    implementation 'com.squareup.okhttp3:okhttp:4.10.0'
    implementation 'com.google.code.gson:gson:2.10.1'
}
  

  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.yourapp">

    <uses-permission android:name="android.permission.INTERNET" />

    <application
        ...
    </application>
</manifest>
  

  import android.os.AsyncTask;
import android.util.Log;
import android.webkit.WebView;
import android.webkit.WebViewClient;
import com.google.gson.Gson;
import com.google.gson.annotations.SerializedName;
import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;

import java.io.IOException;
import java.util.List;
import java.util.concurrent.TimeUnit;

public class OrtbiAdManager {

    private static final String TAG = "OrtbiAdManager";
    private static final String API_ENDPOINT = "https://rtb.nexverse.ai/";
    private static final MediaType JSON = MediaType.get("application/json; charset=utf-8");

    private OkHttpClient httpClient;
    private Gson gson;

    public OrtbiAdManager() {
        // Initialize OkHttpClient with a timeout
        httpClient = new OkHttpClient.Builder()
                .connectTimeout(150, TimeUnit.MILLISECONDS) // Connection timeout
                .readTimeout(150, TimeUnit.MILLISECONDS)    // Read timeout
                .build();
        gson = new Gson();
    }

    /**
     * Represents a simplified OpenRTB BidRequest object for demonstration.
     * In a real SDK, this would be a full class hierarchy matching OpenRTB spec.
     */
    public static class BidRequest {
        @SerializedName("id")
        public String id;
        @SerializedName("imp")
        public List<Impression> imp;
        @SerializedName("device")
        public Device device;
        @SerializedName("app") // Or @SerializedName("site")
        public App app;
        @SerializedName("user")
        public User user;
        @SerializedName("test")
        public int test;
        @SerializedName("at")
        public int at;
        @SerializedName("tmax")
        public int tmax;
        @SerializedName("cur")
        public List<String> cur;
        @SerializedName("bcat")
        public List<String> bcat;
        @SerializedName("badv")
        public List<String> badv;
        @SerializedName("bapp")
        public List<String> bapp;

        // Nested classes for BidRequest components (Impression, Device, App, User, etc.)
        public static class Impression {
            @SerializedName("id") public String id;
            @SerializedName("banner") public Banner banner;
            @SerializedName("video") public Video video;
            @SerializedName("bidfloor") public Double bidfloor;
            @SerializedName("bidfloorcur") public String bidfloorcur;
            @SerializedName("secure") public Integer secure;
            // More fields as per ORTB spec
        }

        public static class Banner {
            @SerializedName("w") public Integer w;
            @SerializedName("h") public Integer h;
            @SerializedName("pos") public Integer pos;
            // More fields as per ORTB spec
        }

        public static class Video {
            @SerializedName("mimes") public List<String> mimes;
            @SerializedName("minduration") public Integer minduration;
            @SerializedName("maxduration") public Integer maxduration;
            // More fields as per ORTB spec
        }

        public static class Device {
            @SerializedName("ua") public String ua;
            @SerializedName("ip") public String ip;
            @SerializedName("make") public String make;
            @SerializedName("model") public String model;
            @SerializedName("os") public String os;
            @SerializedName("osv") public String osv;
            @SerializedName("ifa") public String ifa;
            @SerializedName("connectiontype") public Integer connectiontype;
            @SerializedName("devicetype") public Integer devicetype;
            // More fields
        }

        public static class App {
            @SerializedName("id") public String id;
            @SerializedName("name") public String name;
            @SerializedName("bundle") public String bundle;
            @SerializedName("cat") public List<String> cat;
            public Publisher publisher; // Nested Publisher
        }
        
        public static class Publisher {
            @SerializedName("id") public String id;
            @SerializedName("name") public String name;
        }

        public static class User {
            @SerializedName("id") public String id;
            @SerializedName("buyeruid") public String buyeruid;
            @SerializedName("gender") public String gender;
            @SerializedName("yob") public Integer yob;
            @SerializedName("geo") public Geo geo;
        }

        public static class Geo {
            @SerializedName("lat") public Double lat;
            @SerializedName("lon") public Double lon;
            @SerializedName("country") public String country;
            @SerializedName("region") public String region;
        }
    }

    /**
     * Represents a simplified OpenRTB BidResponse object.
     */
    public static class BidResponse {
        @SerializedName("id")
        public String id;
        @SerializedName("bidid")
        public String bidid;
        @SerializedName("cur")
        public String cur;
        @SerializedName("seatbid")
        public List<SeatBid> seatbid;
        @SerializedName("nbr")
        public Integer nbr;

        // Nested classes for BidResponse components
        public static class SeatBid {
            @SerializedName("seat")
            public String seat;
            @SerializedName("bid")
            public List<Bid> bid;
        }

        public static class Bid {
            @SerializedName("id")
            public String id;
            @SerializedName("impid")
            public String impid;
            @SerializedName("price")
            public Double price;
            @SerializedName("nurl")
            public String nurl;
            @SerializedName("adm")
            public String adm; // Ad Markup (HTML or VAST XML)
            @SerializedName("adomain")
            public List<String> adomain;
            @SerializedName("iurl")
            public String iurl;
            @SerializedName("crid")
            public String crid;
            @SerializedName("w")
            public Integer w;
            @SerializedName("h")
            public Integer h;
            @SerializedName("ext")
            public Object ext; // Generic object for extensions
        }
    }

    /**
     * Asynchronously sends a BidRequest and processes the BidResponse.
     * Use a callback interface to deliver the response to the calling Activity/Fragment.
     */
    public interface AdResponseListener {
        void onAdReceived(BidResponse.Bid bid);
        void onNoAd(String message);
        void onError(String errorMessage);
    }

    public void requestAd(BidRequest bidRequest, AdResponseListener listener) {
        new AsyncTask<BidRequest, Void, BidResponse>() {
            private String errorMessage = null;

            @Override
            protected BidResponse doInBackground(BidRequest... requests) {
                try {
                    String json = gson.toJson(requests[0]);
                    RequestBody body = RequestBody.create(json, JSON);
                    Request request = new Request.Builder()
                            .url(API_ENDPOINT)
                            .post(body)
                            .build();

                    try (Response response = httpClient.newCall(request).execute()) {
                        if (response.code() == 204) {
                            errorMessage = "No bids found for this impression (HTTP 204).";
                            return null;
                        }
                        if (!response.isSuccessful()) {
                            errorMessage = "API request failed: HTTP " + response.code() + " - " + response.message() + " " + response.body().string();
                            Log.e(TAG, errorMessage);
                            return null;
                        }

                        String responseBody = response.body().string();
                        return gson.fromJson(responseBody, BidResponse.class);

                    }
                } catch (IOException e) {
                    errorMessage = "Network error or API call failed: " + e.getMessage();
                    Log.e(TAG, errorMessage, e);
                    return null;
                } catch (Exception e) {
                    errorMessage = "Error parsing response or unexpected error: " + e.getMessage();
                    Log.e(TAG, errorMessage, e);
                    return null;
                }
            }

            @Override
            protected void onPostExecute(BidResponse bidResponse) {
                if (bidResponse != null && bidResponse.seatbid != null && !bidResponse.seatbid.isEmpty()) {
                    // For simplicity, take the first bid from the first seatbid.
                    // A real SDK might have more sophisticated bid selection logic.
                    if (bidResponse.seatbid.get(0).bid != null && !bidResponse.seatbid.get(0).bid.isEmpty()) {
                        BidResponse.Bid winningBid = bidResponse.seatbid.get(0).bid.get(0);
                        listener.onAdReceived(winningBid);
                    } else {
                        listener.onNoAd("BidResponse received, but no bids found in seatbid.");
                    }
                } else if (errorMessage != null) {
                    listener.onError(errorMessage);
                } else {
                    listener.onNoAd("No BidResponse or empty BidResponse received.");
                }
            }
        }.execute(bidRequest);
    }

    /**
     * Fires the win notice URL. This should be called after the ad is displayed.
     * This is a non-blocking call.
     */
    public void fireWinNotice(String nurl, String bidId, String impId, double price) {
        if (nurl == null || nurl.isEmpty()) {
            Log.w(TAG, "Win notice URL is empty. Cannot fire win notice.");
            return;
        }

        final String finalNurl = nurl
                .replace("${AUCTION_BID_ID}", bidId != null ? bidId : "")
                .replace("${AUCTION_IMP_ID}", impId != null ? impId : "")
                .replace("${AUCTION_PRICE}", String.valueOf(price));

        new Thread(() -> {
            try {
                Request request = new Request.Builder()
                        .url(finalNurl)
                        .get()
                        .build();
                // Use a short timeout for beaconing and don't care about the response body
                httpClient.newCall(request).execute().close();
                Log.d(TAG, "Win notice fired successfully: " + finalNurl);
            } catch (IOException e) {
                Log.e(TAG, "Error firing win notice: " + finalNurl, e);
            }
        }).start();
    }

    // --- Example Usage within an Activity/Fragment ---
    // In your MainActivity or a custom AdView class

    private OrtbiAdManager adManager;
    private WebView adWebView; // Assuming you have a WebView in your layout to display ads

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main); // Your layout

        adManager = new OrtbiAdManager();
        adWebView = findViewById(R.id.ad_webview); // Assuming you have <WebView android:id="@+id/ad_webview" ... />

        // Configure WebView for displaying HTML ads
        adWebView.getSettings().setJavaScriptEnabled(true);
        adWebView.setWebViewClient(new WebViewClient() {
            @Override
            public boolean shouldOverrideUrlLoading(WebView view, String url) {
                // Handle clicks on the ad creative. Typically, you'd open the URL in a browser or custom tab.
                Log.d(TAG, "Ad creative clicked: " + url);
                // For example: startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(url)));
                return true; // Return true to indicate you handled the URL
            }
        });

        // Create a sample BidRequest (populate with real device/app info)
        OrtbiAdManager.BidRequest bidRequest = new OrtbiAdManager.BidRequest();
        bidRequest.id = "android_request_" + System.currentTimeMillis();
        
        // Populate Impression
        OrtbiAdManager.BidRequest.Impression imp = new OrtbiAdManager.BidRequest.Impression();
        imp.id = "1";
        OrtbiAdManager.BidRequest.Banner banner = new OrtbiAdManager.BidRequest.Banner();
        banner.w = 320;
        banner.h = 50;
        imp.banner = banner;
        imp.bidfloor = 0.50;
        imp.bidfloorcur = "USD";
        imp.secure = 1;
        bidRequest.imp = Collections.singletonList(imp);

        // Populate Device (example, you'd collect real device data)
        OrtbiAdManager.BidRequest.Device device = new OrtbiAdManager.BidRequest.Device();
        device.ua = System.getProperty("http.agent"); // User agent
        device.ip = "192.168.1.10"; // Local IP or public IP if accessible
        device.make = android.os.Build.MANUFACTURER;
        device.model = android.os.Build.MODEL;
        device.os = "Android";
        device.osv = android.os.Build.VERSION.RELEASE;
        device.ifa = "your_advertising_id_here"; // Get from Google Play Services API
        device.connectiontype = 2; // Wifi
        device.devicetype = 1; // Mobile
        bidRequest.device = device;

        // Populate App (example, use your app's actual package name, etc.)
        OrtbiAdManager.BidRequest.App app = new OrtbiAdManager.BidRequest.App();
        app.id = getPackageName();
        app.name = getApplicationInfo().loadLabel(getPackageManager()).toString();
        app.bundle = getPackageName();
        app.cat = Arrays.asList("IAB1", "IAB9"); // Example categories
        OrtbiAdManager.BidRequest.Publisher publisher = new OrtbiAdManager.BidRequest.Publisher();
        publisher.id = "android_pub_id";
        publisher.name = "My Android App Publisher";
        app.publisher = publisher;
        bidRequest.app = app;
        
        bidRequest.at = 2;
        bidRequest.tmax = 120;
        bidRequest.cur = Collections.singletonList("USD");
        bidRequest.test = 0;


        // Make the ad request
        requestAd(bidRequest, new AdResponseListener() {
            @Override
            public void onAdReceived(BidResponse.Bid bid) {
                Log.d(TAG, "Ad received! Creative ID: " + bid.crid);
                // Load HTML ad into WebView
                adWebView.loadDataWithBaseURL("about:blank", bid.adm, "text/html", "UTF-8", null);

                // Fire win notice after ad is loaded/displayed
                // In a real scenario, you might want to wait for WebView to fully load
                // or for the ad to be deemed 'viewable' before firing.
                adManager.fireWinNotice(bid.nurl, bid.id, bid.impid, bid.price);
            }

            @Override
            public void onNoAd(String message) {
                Log.d(TAG, "No ad received: " + message);
                adWebView.loadDataWithBaseURL("about:blank", "<div style='text-align:center; padding:20px;'>No ad available.</div>", "text/html", "UTF-8", null);
            }

            @Override
            public void onError(String errorMessage) {
                Log.e(TAG, "Ad request error: " + errorMessage);
                adWebView.loadDataWithBaseURL("about:blank", "<div style='text-align:center; padding:20px; color:red;'>Error loading ad: " + errorMessage + "</div>", "text/html", "UTF-8", null);
            }
        });
    }

    // In a real SDK, you would abstract device and app information gathering.
    // Example: Getting Advertising ID (requires Google Play Services dependency)
    private String getAdvertisingId(Context context) {
        try {
            AdvertisingIdClient.Info adInfo = AdvertisingIdClient.getAdvertisingIdInfo(context);
            return adInfo.getId();
        } catch (Exception e) {
            Log.e(TAG, "Could not get Advertising ID: " + e.getMessage());
            return null;
        }
    }
}