{"__v":17,"_id":"564f42e41af2c835004bfbe9","category":{"__v":5,"_id":"56858767d96a760d00545da6","pages":["568587afa3c7070d003dd7a8","5685979c3703ed1700e420bf","56859893d96a760d00545db9","5693c1d03e9d080d00f0641f","5693cb3a237d3b0d00740650"],"project":"564621e00c30fb2100ba3814","version":"564621e10c30fb2100ba3817","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-31T19:52:07.609Z","from_sync":false,"order":5,"slug":"mobfox-demand-side-platform","title":"Advertiser Resources"},"parentDoc":null,"project":"564621e00c30fb2100ba3814","user":"56499dade2efd717002afc83","version":{"__v":14,"_id":"564621e10c30fb2100ba3817","project":"564621e00c30fb2100ba3814","createdAt":"2015-11-13T17:46:09.275Z","releaseDate":"2015-11-13T17:46:09.275Z","categories":["564621e10c30fb2100ba3818","564624cf0c30fb2100ba3822","564628d69f3f550d00fa3db6","564dafeeda00e82b00ed601d","564daff8fc36dc3700882b95","564db0ccda00e82b00ed601f","564dcf87d3320b0d0028ca10","5661a6e436398e0d00f79566","568585153703ed1700e420b0","56858767d96a760d00545da6","56858d693703ed1700e420b2","56858d8d22c41b0d00e4666c","56859e9c009a8d0d00797130","5685a6453703ed1700e420d3"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-20T15:57:24.038Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"A click macro is a special variable that can be inserted into the click URL of an ad that is running on the MobFox network. When an end-user clicks on your ad, our ad server dynamically replaces the macro with information about the click before redirecting the user to the destination of the ad.\n\nClick Macros are proven to be very useful for campaign optimisation since they allow you to receive additional information about each click your campaigns generate in real time, such as the ID of the MobFox Publisher that generated the click or a unique Click ID that can later be used for conversion tracking.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Usable Click Macros\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Macro\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"${MFOXCLICKID}\",\n    \"0-1\": \"Lowercase MD5 Hash\",\n    \"0-2\": \"This macro returns a unique identifier for the click that has occured. You can use our Conversion Tracking API to use this ID for conversion tracking.\",\n    \"1-0\": \"${MFOXPUBID}\",\n    \"1-1\": \"String\",\n    \"1-2\": \"This macro is replaced with the ID of the MobFox Publisher that has generated the ad click. You can use our Targeting Features to exclude poor performing Publisher ID's from your campaigns.\",\n    \"2-0\": \"${MFOXIFA}\",\n    \"2-1\": \"String\",\n    \"2-2\": \"If available, this macro is replaced with the **iOS IDFA** string of the device that has generated the click.\",\n    \"3-0\": \"${MFOXGAID}\",\n    \"3-1\": \"String\",\n    \"3-2\": \"If available, this macro is replaced with the **Google Advertising ID** string of the device that has generated the click.\",\n    \"5-0\": \"${MFOXCAID}\",\n    \"5-1\": \"Integer\",\n    \"5-2\": \"Unique ID of your Campaign in our system\",\n    \"6-0\": \"${MFOXAGID}\",\n    \"6-1\": \"Integer\",\n    \"6-2\": \"Unique ID of your Ad Group in our system\",\n    \"7-0\": \"${MFOXADID}\",\n    \"7-1\": \"Integer\",\n    \"7-2\": \"Unique ID of your Ad Unit in our system\",\n    \"8-0\": \"${MFOXTSTAMP}\",\n    \"8-1\": \"EPOCH Timestamp (UTC)\",\n    \"8-2\": \"This macro returns the UTC timestamp of when the ad click occurred.\",\n    \"9-0\": \"${RANDOMNR}\",\n    \"9-1\": \"Random number between:\\n1 - 50000\",\n    \"9-2\": \"This macro returns a random number. If you use the same macro for the impression pixel call, the random number will be identical to the one used at time of impression.\",\n    \"4-0\": \"${MFOXUDID}\",\n    \"4-1\": \"String\",\n    \"4-2\": \"Unique Device Identifier. It can be either Android ID or Android IMEI (both are deprecated).\"\n  },\n  \"cols\": 3,\n  \"rows\": 10\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Examples\"\n}\n[/block]\nAd click URL - this is the click URL with macros you would insert into it if the \"Click URL\" field when setting up your MobFox Campaign. \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"http://www.mylandingpage.com/page.php?pubid=${MFOXPUBID}&clickid=${MFOXCLICKID}&gaid=${MFOXGAID}&campaignid=${MFOXCAID}\",\n      \"language\": \"http\",\n      \"name\": \"Original Ad Click URL\"\n    }\n  ]\n}\n[/block]\nRedirection URL \n\nWhen an end-user clicks on your ad, our server replaces the click macros in the URL before redirecting the user to the final landing page. Once clicked, the user will be redirected to the URL below.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"http://www.mylandingpage.com/page.php?pubid=1004&clickid=1aabac6d068eef6a7bad3fdf50a05cc8&gaid=1234567890&campaignid=1234\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]","excerpt":"Placeholders which will be replaced in your click urls","slug":"click-tokens","type":"basic","title":"Click Macros"}

Click Macros

Placeholders which will be replaced in your click urls

A click macro is a special variable that can be inserted into the click URL of an ad that is running on the MobFox network. When an end-user clicks on your ad, our ad server dynamically replaces the macro with information about the click before redirecting the user to the destination of the ad. Click Macros are proven to be very useful for campaign optimisation since they allow you to receive additional information about each click your campaigns generate in real time, such as the ID of the MobFox Publisher that generated the click or a unique Click ID that can later be used for conversion tracking. [block:api-header] { "type": "basic", "title": "Usable Click Macros" } [/block] [block:parameters] { "data": { "h-0": "Macro", "h-1": "Type", "h-2": "Description", "0-0": "${MFOXCLICKID}", "0-1": "Lowercase MD5 Hash", "0-2": "This macro returns a unique identifier for the click that has occured. You can use our Conversion Tracking API to use this ID for conversion tracking.", "1-0": "${MFOXPUBID}", "1-1": "String", "1-2": "This macro is replaced with the ID of the MobFox Publisher that has generated the ad click. You can use our Targeting Features to exclude poor performing Publisher ID's from your campaigns.", "2-0": "${MFOXIFA}", "2-1": "String", "2-2": "If available, this macro is replaced with the **iOS IDFA** string of the device that has generated the click.", "3-0": "${MFOXGAID}", "3-1": "String", "3-2": "If available, this macro is replaced with the **Google Advertising ID** string of the device that has generated the click.", "5-0": "${MFOXCAID}", "5-1": "Integer", "5-2": "Unique ID of your Campaign in our system", "6-0": "${MFOXAGID}", "6-1": "Integer", "6-2": "Unique ID of your Ad Group in our system", "7-0": "${MFOXADID}", "7-1": "Integer", "7-2": "Unique ID of your Ad Unit in our system", "8-0": "${MFOXTSTAMP}", "8-1": "EPOCH Timestamp (UTC)", "8-2": "This macro returns the UTC timestamp of when the ad click occurred.", "9-0": "${RANDOMNR}", "9-1": "Random number between:\n1 - 50000", "9-2": "This macro returns a random number. If you use the same macro for the impression pixel call, the random number will be identical to the one used at time of impression.", "4-0": "${MFOXUDID}", "4-1": "String", "4-2": "Unique Device Identifier. It can be either Android ID or Android IMEI (both are deprecated)." }, "cols": 3, "rows": 10 } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] Ad click URL - this is the click URL with macros you would insert into it if the "Click URL" field when setting up your MobFox Campaign. [block:code] { "codes": [ { "code": "http://www.mylandingpage.com/page.php?pubid=${MFOXPUBID}&clickid=${MFOXCLICKID}&gaid=${MFOXGAID}&campaignid=${MFOXCAID}", "language": "http", "name": "Original Ad Click URL" } ] } [/block] Redirection URL When an end-user clicks on your ad, our server replaces the click macros in the URL before redirecting the user to the final landing page. Once clicked, the user will be redirected to the URL below. [block:code] { "codes": [ { "code": "http://www.mylandingpage.com/page.php?pubid=1004&clickid=1aabac6d068eef6a7bad3fdf50a05cc8&gaid=1234567890&campaignid=1234", "language": "http" } ] } [/block]