Contact support

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