Install FXMacroData on Mobile app

Setting it up

1. 01

   Register the Mobile app surface

   Add it in API Management and copy the redistribution key. Registering enables access immediately; there is no review queue.

2. 02

   Derive the user reference

   For Mobile app, use your own account id for the signed-in user. Hash it with a secret only you hold, so the value we store cannot be reversed and cannot be correlated with anyone else's report.

   user_ref = hmac_sha256(
       key=YOUR_SECRET,
       message=account_id,
   ).hexdigest()

3. 03

   Report once per person per billing period

   Send the reference the first time you serve that person in the period, then mark them done. Repeats are free, so a retry or a replay is never a problem.

   POST https://fxmacrodata.com/partner-meter/v1/audience
   Authorization: Bearer <your redistribution key>
   Content-Type: application/json
   
   {
     "surface_id": "Mobile app",
     "user_ref": "<hmac of account_id>"
   }

4. 04

   Show the attribution

   The FXMacroData credit has to be visible wherever the data appears, in the same view as the data itself.

Confirming it works

1. 1 Send one report for a test user and confirm a 202 response.
2. 2 Send the same reference again and confirm the billable count does not move.
3. 3 Open API Management and confirm the measured user appears against this surface.

Reference

Shared detail that applies to every authenticated channel, kept in one place rather than restated here.