{"id":1249,"date":"2021-07-09T17:15:04","date_gmt":"2021-07-09T13:15:04","guid":{"rendered":"https:\/\/blog.keitaro.io\/en\/?p=1249"},"modified":"2021-09-15T12:40:22","modified_gmt":"2021-09-15T08:40:22","slug":"kbp-globalaliases","status":"publish","type":"post","link":"https:\/\/blog.keitaro.io\/en\/kbp-globalaliases\/","title":{"rendered":"Keitaro Best Practices #2: Global Parameter Aliases"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

We continue our new heading \u201cKeitaro Best Practices\u201d, and in today\u2019s article, we will talk about global parameter aliases. Let\u2019s figure it out!<\/p>\n\n\n\n\n\n\n\n

A bit of theory about the parameters: After the campaign has been created, it\u2019s time to configure its parameters (the third tab of the campaign settings).<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Here we see three columns: Name<\/strong>, Parameter<\/strong>, and Token or Value<\/strong>.<\/p>\n\n\n\n

The Name<\/strong> is what a parameter will be called in the tracker report. This doesn\u2019t affect anything else. Basic parameters whose names cannot be changed are Keyword \u2013 Site<\/strong>. The rest go by default as Sub ID 1\u201315<\/strong> and Extra param 1\u201310<\/strong>. The latter are included separately in the tracker settings (Maintenance \u2013 Settings \u2013 General \u2013 Enable extra params<\/strong>). Extra params are used only for storing data and displaying it in reports. These cannot be used in parameter filters.<\/p>\n\n\n\n

How does it work?<\/h2>\n\n\n\n

We set a custom value, and then we can see it when creating a report:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Build a report (click on the three dots to the right of the \u201cLog\u201d button, then \u201cClicks\u201d).<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Quite simply! Let\u2019s move on. The second column is Parameter<\/strong>.<\/p>\n\n\n\n

Parameter<\/strong> is the naming convention used for the parameter that you want to pass to the tracker\u2014not the value of the parameter, but its name. For example, when working with Facebook, you pass the adset name using the standard Facebook dynamic parameter {{adset.name}}<\/strong>. But to pass the value of the adset name, you must write it to some parameter (at your discretion). Let it be adset_name<\/strong>. The total we get is adset_name={{adset.name}}<\/strong>.<\/p>\n\n\n\n

Where adset_name<\/strong> is the name of the parameter and {{adset.name}}<\/strong> is a macro. <\/p>\n\n\n\n

{{adset.name}}<\/strong> is also a token and a value, which will be substituted in the end for a macro when a click leaves Facebook via your link.<\/p>\n\n\n\n

So, in the second column of the tracker, called Parameter<\/strong>, we must fill the name with the adset_name<\/strong> parameter, after which we can send adset_name=any_our_value<\/strong> to the tracker and the tracker will be able to record it, since it will find a parameter named adset_name<\/strong> and will know exactly where to write the received parameter value.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

And here we smoothly come to the third column: Macro\/ Token\/ Value<\/strong>.<\/p>\n\n\n\n

In our case, {{adset.name}}<\/strong> is a macro. It is indicated in the traffic source because it is on the source side, in which the real value should be substituted for the macro. But the tracker has such a setting: Traffic Sources<\/strong> (Learn more about sources and S2S<\/a>). This is a set of ready-made templates of known traffic sources that already contain all the necessary parameters and their tokens (macros) for the convenience of the client, eliminating the need to fill them in manually. That is, if you add a ready-made template in the campaign settings, for example, the same Facebook\u2014then we will get the filled Parameter<\/strong> and Token<\/strong> columns.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The third column is filled in here only so that you can take the campaign link (to the left of the \u201cLog\u201d button) and get a ready-made set of all tags written in the URL:<\/p>\n\n\n\n

https:\/\/keitarosupport1.xyz\/N27j6z?utm_creative={{ad.name}}&utm_campaign={{campaign.name}}&utm_source={{site_source_name}}&utm_placement={{placement}}&campaign_id={{campaign.id}}&adset_id={{adset.id}}&ad_id={{ad.id}}&adset_name={{adset.name}}<\/span><\/p>\n\n\n\n

In fact, the value of the parameter is checked at the input of the click to the tracker, so if you delete all values \u200b\u200bfrom the Token<\/strong> column, nothing will change in the tracker, but the link will have to be collected manually (substituting macros for the parameters).<\/p>\n\n\n\n

Important Point!<\/strong><\/p>\n\n\n\n

The Keitaro tracker provides for static transmission of parameters from a campaign along its streams, so if you filled in the Token column but didn’t send any real values from the source, the tracker will take the content of this column as a basis and record it as the only correct one.<\/strong><\/p>\n\n\n\n

For example: utm_creative={{ad.name}}<\/strong><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

If Facebook returns the real value along with the click, then the tracker will receive conditionally: utm_creative=creo1<\/strong><\/p>\n\n\n\n

If, for some reason, the tracker does not receive this data (utm_creative=any_value), then it will write down the value utm_creative={{ad.name}} along with the click.<\/strong><\/p>\n\n\n\n

This is done to implement those cases in which the client needs to transfer fixed data from the tracker without receiving it from the source.<\/strong><\/p>\n\n\n\n

Now that we understand parameters, it\u2019s time to move on to the main question of this article \u2013 Global Parameter Aliases.<\/p>\n\n\n\n

They are located at: Maintenance \u2013 Settings \u2013 General \u2013 Global parameter aliases<\/strong>. As you already understand, these are the aliases for our second column of campaign parameters.<\/p>\n\n\n\n

What are they needed for?<\/strong><\/h2>\n\n\n\n

Above, we reviewed the procedure for setting parameters for a specific campaign. You must perform this action repeatedly when creating new campaigns. Global aliases simplify this point and allow you to specify a list of parameter names one time at the level of the entire tracker.<\/p>\n\n\n\n

How can you use it?<\/strong><\/h2>\n\n\n\n

If, in your work, you are accustomed to using a certain set of parameters, then just set those parameters at the level of global aliases and forget about constant parameter adjusting for every campaign. For example, if you need to use the names sub1\u201310<\/strong> and use custom parameter names\u2014such as name<\/strong>, app_name<\/strong>, geo<\/strong>, etc.\u2014then go to the global aliases and, opposite the columns you need (according to the list we have in the first column, Name<\/strong>, as you will see it in the reports), write your custom names.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Save the changes, and from now on, global aliases will immediately work in the tracker for any created campaign. You can create a new campaign and immediately use sub1=token&name=token&app_name=token in<\/strong> your link without setting up the Parameters<\/strong> tab. The tracker will recognize the values and record them.<\/p>\n\n\n\n

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

Create a new campaign and leave the Parameters<\/strong> tab unaffected. Take the campaign link<\/p>\n\n\n\n

https:\/\/keitarosupport1.xyz\/27fdgz<\/span> <\/strong><\/p>\n\n\n\n

and add name=testname<\/strong> to get https:\/\/keitarosupport1.xyz\/27fdgz?name=testname<\/span>, make the click, and see the report on \u201cClicks.\u201d<\/p>\n\n\n\n

The alias name was recorded in creative_id<\/strong>, so we display this column in the report and check it.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Setup Works!<\/p>\n\n\n\n

Follow the \u201cKBP\u201d heading, because in the next issues, you will find even more analyses of unique Keitaro functions.<\/p>\n","protected":false},"excerpt":{"rendered":"

We continue our new heading \u201cKeitaro Best Practices\u201d, and in today\u2019s article, we will talk about … <\/p>\n","protected":false},"author":19,"featured_media":1261,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_uf_show_specific_survey":0,"_uf_disable_surveys":false,"footnotes":""},"categories":[20],"tags":[21],"class_list":["post-1249","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-usecases","tag-kbp"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t