Supply inventory with in-app webview
Overview
If Equativ's iOS and Android SDKs cannot be used, you can render ads inside a compatible webview using javascript ad tags. While Equativ does not provide ready-to-use javascript tags for this use case, you can compose them manually using the instructions in this document.
Javascript ad tag syntax
The javascript ad tag to be placed in the webview of your app has the following syntax:
<script type="application/javascript" src="https://[SUBDOMAIN].smartadserver.com/ac?nwid=[NETWORKID]&siteid=[SITEID]&pgid=[PAGEID]&fmtid=[FORMATID]&visit=m&tmstp=[TIMESTAMP]&uid=[DEVICEUID]&appname=[APPNAME]&buid=[BUNDLEID]&out=js&mraid=[X.X]&tgt=mraid%3D[X.X]&la=[LATITUDE]&lg=[LONGITUDE]"></script>
Replace each placeholder— for example [SITEID]
— by the actual IDs or values, including the square brackets.
Parameters
The following table table describes each parameter:
Parameter name | Description | Requirement level |
---|---|---|
[SUBDOMAIN] |
The subdomain assigned to your network, as rendered in Equativ’s ad tags, under Administration > Websites & Pages in EMP. | Required |
appname |
The name of the mobile application. URL encoded. | Required |
buid |
The mobile application identifier (bundle Id or package name). | Required |
fmtid |
The format (ad slot) on the page. | Required |
la |
The current latitude used for geo-targeting. Typically, generated with a macro. | Recommended |
lg |
The current longitude used for geo-targeting. Typically, generated with a macro. | Recommended |
mraid |
The standalone MRAID version parameter, used to enrich bid requests. Version format: X.X , for example: mraid=1.6 . |
Recommended |
mraid%3D[X.X] |
The MRAID version passed as a key-value pair, as part of the tgt parameter, for example: tgt=mraid%3D1.6 . Used for reporting purposes. |
Recommended |
nwid |
The Equativ network ID. | Required |
out |
The expected output, to remain unchanged: out=js . |
Required |
pgid |
The page ID, representing a sub-unit of the mobile application, for example a page within the app. | Required |
siteid |
The site ID. In the in-app context, this parameter represents the mobile application. | Required |
tgt |
The targeting criteria, used to pass keywords or key-value pairs for targeting purposes. Must be URL-encoded. | Optional |
tmstp |
The timestamp—a unique 11 digits number—used for cache busting. Typically, generated with a macro. | Required |
uid |
The device identifier, for example Apple's IDFA. Typically, generated with a macro. | Required |
user_agent |
The user agent of the device, which can be used if the device user agent is not included in the headers of the request. | Optional |
visit |
A parameter used to determine unique visits per page impression, to remain unchanged (visit=m ). |
Required |