{"id":15472,"date":"2026-02-20T07:06:11","date_gmt":"2026-02-20T07:06:11","guid":{"rendered":"http:\/\/mariusz.bijok"},"modified":"2026-06-29T07:14:58","modified_gmt":"2026-06-29T07:14:58","password":"","slug":"callback-macros","status":"publish","type":"docs","link":"https:\/\/tenjin.com\/tr\/docs\/callback-macros\/","title":{"rendered":"Callback Macros"},"content":{"rendered":"

<\/h2>\n\n\n\n

<\/p>\n\n\n\n

Callback macros<\/h4><\/div><\/div><\/div>
<\/span><\/div><\/div>
\n

Macros are placeholders for values that change dynamically in a URL’s server request. These macros are pre-configured for Tenjin integrated networks, but learning how macros work can be useful for any custom channels that you want add.<\/p>\n\n\n\n

\n\n\n\n
Why do we need macros?<\/h5>\n\n\n\n

We need macros to pass dynamically changing data through unchanging tracking link parameters.<\/p>\n\n\n\n

To unpack this, we will explain how URLs, parameters, values, and dynamically changing values work within attribution.<\/p>\n\n\n\n

\n\n\n\n
URLs and parameters<\/h5>\n\n\n\n

Let\u2019s take a look at a standard URL: https:\/\/track.tenjin.com?param1=value1<\/strong>. In this URL you can see there is a server address track.tenjin.io<\/strong> and a single parameter param1<\/strong> set to a value value1<\/strong>. When this URL hits the track.tenjin.io<\/strong> server, Tenjin\u2019s server reads this URL and parses the parameter and value. In this case param1<\/strong> is set to value1<\/strong>.<\/p>\n\n\n\n

In a more realistic example relating to attribution parameters and values, take this URL with two parameters (advertising_id<\/strong> and country<\/strong>) and two values: https:\/\/track.tenjin.com?advertising_id=xyz123&country=US<\/strong>. When this request hits the Tenjin server at track.tenjin.com<\/strong>, we know that the advertising_id<\/strong> that hit the server is the device xyz123<\/strong> with a country<\/strong> of US.<\/p>\n\n\n\n

\n\n\n\n
Dynamic parameter values<\/h5>\n\n\n\n

Now that we know how values and parameters are passed to a server, let’s look at how URLs are used in the context of attribution and tracking.<\/p>\n\n\n\n

In order for Tenjin to attribute a user to a click or an impression, Tenjin collects device information and properties on each click or impression. These properties are used to match up with the properties collected when a device installs the app.<\/p>\n\n\n\n

A Tenjin tracking URL is generated whenever you create a campaign<\/a> for a non-SAN network or a custom channel. This tracking URL contains \u201cmacros\u201d that dynamically adapt to changing values around the click or impression. Macros are used as placeholders for values that change in a specific URL.<\/p>\n\n\n\n

Let\u2019s say that you wanted to run a campaign on a non SAN<\/a> network. You create a tracking link through the Tenjin dashboard and give this to your ad network.<\/p>\n\n\n\n

This is what a tracking link from Tenjin might look like:

https:\/\/track.tenjin.com?advertising_id={idfa}&country={country}<\/code><\/p>\n\n\n\n

In this case {idfa}<\/strong> and {country}<\/strong> are macros. When a device uses this link, the ad network will fill in these macros with the actual values of the device. Using the previous example, {idfa}<\/strong> and {country}<\/strong> would fill in values with xyz123<\/strong> and US<\/strong> respectively.<\/p>\n\n\n\n

Once filled in, the ad network or channel will hit Tenjin’s server using the following URL:<\/p>\n\n\n\n

https:\/\/track.tenjin.com?advertising_id=xyz123&country=US<\/code><\/p>\n\n\n\n

Alternatively, if the user\u2019s device changed and had an advertising_id<\/strong> of abc234<\/strong> and a country<\/strong> of CA the URL would change to:

https:\/\/track.tenjin.com?advertising_id=abc234&country=CA<\/code><\/p>\n\n\n\n

As you can see, these scenarios are using the same URL, but changing the values based on the device\/user that is using the tracking link.<\/p>\n\n\n\n

Macros allow ad networks to change the URL for each user’s click\/impression. These macros are simply placeholders for the values that are changing when different users interact with the tracking links.<\/p>\n<\/div><\/div><\/div>\n\n\n\n

\n\n\n\n

<\/h3>\n\n\n\n

Macros for ad-network callbacks<\/h4><\/div><\/div><\/div>
<\/span><\/div><\/div>
\n

Each ad network has its own set of click and impression macros for the following device properties:<\/p>\n\n\n\n