MobileFuse Exchange (MFX) supports cookie syncing (also known as user matching, cookie mapping, etc.) for web traffic. MFX hosts the mapping table for bidders and expects supply partners to pass the MF cookie user ID (MFUID) via the user.buyeruid field in OpenRTB requests. MFX will in turn pass its bidders their cookie user IDs in the user.buyeruid field along with the MFUID in the user.id field.

User Privacy

These endpoints should only be used when a user has not opted out and local privacy regulations allow.

MobileFuse currently only operates in the US and Canada, so GDPR does not apply.

All endpoints on this page support GPP params gpp and gpp_sid.

Retrieve a User ID from MFX (getuid)

Partners can retrieve a user ID MFX using the /getuid endpoint.

https://mfx.mobilefuse.com/getuid?redir=[REDIR_URL]

Be sure to replace [REDIR_URL] with a URL to redirect to. Insert $UID into this URL where you would like the MFUID to be set. Be sure to URL encode the full redir param value.

Example

https://mfx.mobilefuse.com/getuid?redir=https%3A%2F%2Fexample%2Ecom%2Fusync%3Fid%3D%24UID

Storing a User ID with MFX (setuid)

Bidders can store their user ID in the mapping table with MFX using the /setuid endpoint.

[PARTNER_ID] will need to be replaced with your unique partner label, which will be provided by your account rep.

[PARTNER_USER_ID] should be replaced by your bidder's user ID.

Set User ID only

https://mfx.mobilefuse.com/setuid?pid=[PARTNER_ID]&uid=[PARTNER_USER_ID]

Example

https://mfx.mobilefuse.com/setuid?pid=bdr&uid=abcdefg

Set User ID and redirect back

The /setuid endpoint can also return the MFUID back to another URL, specified in the redir param. Insert $UID into your URL where you would like the MFUID to be set. Be sure to URL encode the full redir param value.

https://mfx.mobilefuse.com/setuid?pid=[PARTNER_ID]&uid=[PARTNER_USER_ID]&redir=[REDIR_URL]

Example

https://mfx.mobilefuse.com/setuid?pid=bdr&uid=abcdefg&redir=https%3A%2F%2Fexample%2Ecom%2Fusync%3Fid%3D%24UID

https://mfx.mobilefuse.com/getuid?redir=https%3A%2F%2Fexample%2Ecom%2Fusync%3Fid%3D%24UID

Initiate a user sync (usync)

Supply Partners can maximize yield by initiating a user sync via the /usync endpoint. This endpoint will return an HTML for use in an iframe that will ensure that MFX syncs with the supply partner and up to 4 of its demand partners at once in order to limit impact on the end user.

https://mfx.mobilefuse.com/usync?pxurl=[SUPPLY_PARTNER_PIXEL_URL]

To receive the MFUID as part of the sync, be sure to include a pxurl via [SUPPLY_PARTNER_PIXEL_URL] with a URL to redirect to. Insert $UID into this URL where you would like the MFUID to be set. Be sure to URL encode the full redir param value.

Example

https://mfx.mobilefuse.com/usync?redir=https%3A%2F%2Fexample%2Ecom%2Fsetcookie%3Fid%3D%24UID