Introduction

SDK-less in-app header bidding integration using a simple GET request, designed to be called before Google Ad Manager ad requests.

Nexx360 Direct InApp provides a lightweight, SDK-less integration for in-app header bidding. Unlike the standard /inapp endpoint that requires the Prebid Mobile SDK, Direct InApp uses a simple HTTP GET request that returns targeting key-values ready to be passed to Google Ad Manager.

How It Works

1. Your app calls Nexx360 via a GET request with your tag ID (or placement), bundle, and ad sizes

2. Nexx360 runs a server-side auction across all configured SSPs

3. Nexx360 returns targeting key-values (hb_pb, hb_bidder, etc.)

4. Your app sets these key-values as custom targeting on the Google Ad Manager ad request

5. Google Ad Manager evaluates the bid against its own demand and serves the winning ad

The Direct InApp call must be made before the Google Ad Manager ad request so that the targeting key-values are available when the ad is loaded.

Endpoint

GET https://fast.nexx360.io/directinapp

Supported Ad Format

Format	Description
Banner	Standard mobile formats: 300x250, 320x50, 320x100, 728x90

Query Parameters

Parameter	Required	Description	Example
tag_id	Yes*	Nexx360 stored request ID	testnexx
placement	Yes*	Nexx360 placement code (alternative to tag_id)	my-placement
bundle	Yes	App bundle identifier	com.example.myapp
sizes	Yes	Comma-separated ad sizes (WxH)	300x250,320x50
app_name	No	Application name	My App
ifa	No	Advertising ID (IDFA / AAID)	38400000-8cf0-...
gdpr	No	GDPR applies flag	0 or 1
gdpr_consent	No	TCF consent string	CPMeqrn...
test	No	Test mode flag	0 or 1
nexx360_debug	No	Enable debug output	0 or 1

* Either tag_id or placement must be provided.

Example Request

GET https://fast.nexx360.io/directinapp?tag_id=testnexx&bundle=com.example.myapp&sizes=300x250,320x50&ifa=38400000-8cf0-11bd-b23e-10b96e40000d&gdpr=1&gdpr_consent=CPMeqrnPMeqrn...

Response

Successful Response (200)

{
  "targeting": {
    "hb_env": "mobile-app",
    "hb_cache_id": "testnexx-fast-diap-1234-abc123def456",
    "hb_pb": "1.50",
    "hb_cache_path": "/cache",
    "hb_size": "300x250",
    "hb_bidder": "triplelift",
    "hb_partner": "nexx360",
    "hb_cache_host": "fast.nexx360.io",
    "hb_format": "banner"
  }
}

No Bid Response (204)

When no bids are received, the endpoint returns HTTP 204 with no body.

Error Response (400)

Returned when required parameters are missing or invalid.

Targeting Keys Reference

Key	Description	Example
hb_env	Environment identifier	mobile-app
hb_cache_id	Unique cache ID for ad retrieval	UUID
hb_pb	Price bucket	1.50
hb_cache_path	Cache endpoint path	/cache
hb_cache_host	Cache host domain	fast.nexx360.io
hb_size	Ad dimensions	300x250
hb_bidder	Winning SSP/bidder	triplelift
hb_partner	Partner identifier	nexx360
hb_format	Ad format type	banner

Privacy & Consent

GDPR consent is supported via the gdpr and gdpr_consent query parameters:

&gdpr=1&gdpr_consent=BOEFEAyOEFEAyAHABDENAI4AAAB9vABAASA

When gdpr=1 is set without a consent string, personalized ads will not be served.