External URL groups are objects that tell ETRNL the URLs that should be embedded into the tags. These typically represent products and point your tags to the page on your own website where the product information can be displayed. The URL groups allow you to program many tags that point to your product’s details page and collect useful analytics on these products.
External URL Groups can only be created through our API because this process is intended to be automated. For example; every time you create a product within your website’s CMS, you could automate the creation of the corresponding URL group within ETRNL using the API.
Define the external URL
POST to the API
A custom URL can be defined by writing out your URL and wrapping 4 of the required parameters in curly braces ”{}”.
https://exmaple.com/?tagId={tagId}&enc={enc}&cmac={cmac}&eCode={eCode}
The custom URL params can only be used as a query parameter, or a URL slug.
For tag tamper URLs, you cannot include the cmac value as the tt message includes both the cmac and the encrypted tamper status.
So the custom URL would look something like:
https://exmaple.com/{tagId}/?enc={enc}&tt={tt}&eCode={eCode}
Once you have your custom URL defined, you can POST to the /v1/url-groups endpoint to create the group in ETRNL.
Code examples to send the POST request can be found on the API page in multiple programming languages.
You will now see the URL group in the programmer with the app name as the prefix.