Tracking link macros

Macros are special labels or markers used in click and inpression URLs to get additional information about ad conversions.

For example, in this Click URL template:
https://trk.mail.ru/c/a12345/?idfa={mt_idfa}&clickId={clickId}&sub1={mt_sub1}
macros are the following:

• {mt_idfa} — device identifier
• {clickId} — identifier of the attribution click
• {mt_sub1} — information on ad campaign

How it works

When generating the final Click URL that will be shown to the user, macros must be replaced with specific values. For example, the above template may turn into such a URL:
https://trk.mail.ru/c/a12345/?idfa=AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA&clickId=click123&sub1=offer1
with following replacements:

• {mt_idfa} → AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA
• {clickId} → click123
• {mt_sub1} → offer1

Your partner will replace macros with specific values. Usually, the replacement process is automated. To be able to do this, your partner needs to know what macros are used in URLs.

Some partners may work with default macros provided by MyTracker (see MyTracker macros). For other partners, MyTracker macros in the URL need to be replaced with their own macros (see partner macros).

For more details on Click URL structure and sources of its parameters, refer to Click and Impression URLs

Partner macros

If a partner uses the own macros in the tracking links, you should configure macros in MyTracker.

For integrated partners (indicated by the symbol ), macros are set by default. If you need to modify it, contact our support team

For non-integrated partner that you have connected yourself, you can set up macros as follows:

1. Request written documentation or a verbal explanation of their requirements from your partner. Make sure to ask whether they have a preconfigured set of macros for use with tracking links.
2. In MyTracker interface, find the partner you need in the list and click on its name.

3. On the page that opens, go to Macros.
   
4. Specify the replacements to be made in the tracking links:
   • To add a new line to be filled, click Add macro.
   • In the left column, enter the name of the parameter in the tracking link. The name must match the name of the MyTracker macro or the click url parameter name you added as a URL parameter in the postback.
   • In the right column, enter the name of the macro, that the partner expects to receive.
   • Make sure to click Save , once all fields have been filled.

As a result, all tracking links for the partner will include the specified replacements. And the already created links will be updated automatically.

For example, the URL templates on the tracking link view page shown below:
https://trk.mail.ru/c/a12345/?idfa={mt_idfa}&clickId={clickId}&sub1={mt_sub1}
will be modified as follows:
https://trk.mail.ru/c/a12345/?idfa=%%IDFA%%&clickId=%%CLICK_ID%%&sub1=%%OFFER%%

This makes replacing familiar macro markers, such as %%IDFA%% , with specific values an easy job for your partner.

MyTracker macros

List of MyTracker macros that can be used in tracking links:

Device info

Click/View info

Traffic info

For information about campaign details, refer to the section SubID

Campaign costs info

For information about costs, refer to the section Campaigns > Costs