Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

Overview

Our client-side tags can also be requested server-side, like a simple API. A server-side video tag looks like the following. You should be sure to set up your ad server to replace the macros with relevant values.

https://mfx.mobilefuse.com/video?id=000000&w=320&h=480&bundle=${BUNDLE}&ifa=${IFA}&ip=${IP_ADDRESS}&lat=${LATITUDE}&lon=${LONGITUDE}&lltype=${LAT_LON_TYPE}&pos=${POS}&apis=${APIS}&mimes=${MIME_TYPES}&protocols=${PROTOCOLS}&schain=${SUPPLY_CHAIN}&age=${AGE}&gender=${GENDER}&ua=${USER_AGENT}&cb=${CACHEBUSTER}

Parameters

All parameters should be URL encoded where necessary. If you are unable to provide a parameter, you should remove it from the tag. Items marked with an asterisk are highly recommended to maximize earning potential.

Field

Required

Description

id

Yes

MobileFuse-provided ID for this ad unit

w

Yes

Width in pixels

h

Yes

Height in pixels

bundle

Yes

On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it should be a numeric ID.

ifa

No*

Identifier For Advertisers (aka IDFA)

ip

Yes

IPv4 IP address

lat

No*

Latitude expressed as a float

lon

No*

Longitude expressed as a float

lltype

No*

Lat/Lon type, ie. how was lat/lon collected?

  • 1 = GPS/Location Services

  • 2 = IP Address

  • 3 = User provided (eg. registration data)

pos

No

Position of ad in the viewport

  • 0 = Unknown

  • 1 = Above Fold

  • 3 = Below Fold

schain

Yes, if not a direct publisher

The serialized form of the supply chain object. Only required if the publisher’s relationship with MobileFuse is not direct.

instl

No

Whether this ad unit is within an interstitial or not

  • 0 = No

  • 1 = Yes

age

No*

Age or year of birth of user (eg. 51, 24, 1988, 1957)

gender

No*

Gender of user. Lowercase values will work as well

  • M = Male

  • F = Female

  • O = Other

dnt

No

Do not track (or limit ad tracking, since we treat both the same way)

  • 0 = No

  • 1 = Yes

us_privacy

No

US privacy string, required jurisdictions where legally enforced
https://github.com/InteractiveAdvertisingBureau/USPrivacy/blob/master/CCPA/US%20Privacy%20String.md

ctx

No

Type of content (game, video, text, etc.).

  • 1 = Video

  • 2 = Game

  • 3 = Music

  • 4 = Application

  • 5 = Text

  • 6 = Other

  • 7 = Unknown

test

No

Indicator of test mode in which auctions are not billable

  • 0 = Live

  • 1 = Test

mimes

No*

Comma separated list of the player’s supported mime types (eg. video/mp4)

minduration

No

Minimum duration allowed in seconds

maxduration

No

Maximum duration allowed in seconds

minbitrate

No

Minimum bitrate allowed in Kbps

maxbitrate

No

Maximum bitrate allowed in Kbps

protocols

No*

Comma separated list of supported video protocol IDs

  • 1 = VAST 1.0

  • 2 = VAST 2.0

  • 3 = VAST 3.0

  • 4 = VAST 1.0 Wrapper

  • 5 = VAST 2.0 Wrapper

  • 6 = VAST 3.0 Wrapper

  • 7 = VAST 4.0

  • 8 = VAST 4.0 Wrapper

  • 9 = DAAST 1.0

  • 10 = DAAST 1.0 Wrapper

apis

No*

Comma separated list of supported video API IDs

  • 1 = VPAID 1.0

  • 2 = VPAID 2.0

  • 3 = MRAID-1

  • 4 = ORMMA

  • 5 = MRAID-2

  • 6 = MRAID-3

  • 7 = OMID-1

playbackmethod

No

Playback method that is used, if none is specified, any may be used:

  • 1 = Initiates on Page Load with Sound On

  • 2 = Initiates on Page Load with Sound Off by Default

  • 3 = Initiates on Click with Sound On

  • 4 = Initiates on Mouse-Over with Sound On

  • 5 = Initiates on Entering Viewport with Sound On

  • 6 = Initiates on Entering Viewport with Sound Off by Default

startdelay

No

Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll:

  • Value > 0 = Mid-Roll (value indicates start delay in second)

  • 0 = Pre-Roll

  • 1 = Generic Mid-Roll

  • 2 = Generic Post-Roll

placement

No

Placement type for the impression:

  • 1 = In-Stream

  • 2 = In-Banner

  • 3 = In-Article

  • 4 = In-Feed

  • 5 = Interstitial

ua

Yes

The client’s user-agent

cb

No

Recommended to ensure requests are not cached by client

  • No labels