Fyber Mobile App VAST Integration
Last updated on August 10, 2020
If you are using the OpenX Ad Exchange and Fyber as a mobile ad server, you can create OpenX VAST ad tags to integrate with Fyber and pass various parameters from custom apps on Android and iOS devices.
The tag you generate by creating a mobile app linear video ad unit in the OpenX user interface (UI) comes with some Fyber macros already appended.
You can include additional Fyber macros in OpenX ad tags to automatically capture other user-specific parameters. However, if you want to define additional inventory-specific parameters, you must do so manually with URL-encoded values.
Sample VAST Ad Tag with Fyber Macros
To view your VAST ad tag, find the linear video ad unit you created in your site Ad Units tab and click the name of the ad unit. You will see the VAST URI for your tag:
VAST URI
http://your-instance.openx.net/v/1.0/av?auid=0123456789&ifa=[[GA-ID]]&lmt=[[LimitedAdTracking]]&app.bundle=[[AppBundleName]]&ip=[[IP]]&dr=true&vht=[[ScreenHeight]]&vwd=[[ScreenWidth]]&net=[[ConnectionType]]&cb=[[Random]]&ua=[[UserAgent]]&cnt=[[CountryCode]]
Macro Definitions
The table below summarizes the Fyber macros that OpenX pairs with those parameters. See Fyber’s documentation for macro details.
| Parameter | Macro | This macro dynamically inserts… |
|---|---|---|
ifa | [[GA-ID]]or [[Apple-Idfa]] | The Google Advertiser Device Identifier or Apple IDFA or from the users’ device. |
lmt | [[LimitedAdTracking]] | The setting from the user’s device that indicates if private browsing is enabled (if the user has requested not to be tracked). |
app.bundle | [[AppBundleName]] | The app’s Bundle ID. |
ip | [[IP]] | The IP address from the user’s device. |
vht | [[ScreenHeight]] | The screen height of the player on the user’s device. |
vwd | [[ScreenWidth]] | The screen width of the player on the user’s device. |
net | [[ConnectionType]] | The user’s network connection type. |
cb | [[Random]] | A random alphanumerical value to avoid browser caching. |
ua | [[UserAgent]] | The device user agent, which typically indicates the app or browser making the request. |
cnt | [[CountryCode]] | The user’s country code. |
Next Steps
- Paste your new tag into the appropriate location, as explained in Fyber’s documentation.
- Set up OpenX selling rules.