ATLAS

Contact & Booking URL Tracking

ATDW has introduced new tracking URLs in October 2021.

This allows ATDW to communicate to the profile owners how your distribution channel has assisted their business by providing insights on the profile performance which we hope leads to better engagement between distributor and operator.

We need all distribution partners to implement the tracking URL versions on all click actions to an ATDW supplied URL on your website. Wherever you have a URL displayed or a button please ensure the "withTracking" URL is used to generate these metrics.

A new field has been introduced to output the tracking URLs in the Get Product API and Get Service API endpoint. The new fields are implemented alongside the current fields and are identified using the keyword "with tracking". There are no changes to the values in the current fields that will continue to show the actual URLs (without the tracking code) as supplied by the profile owners and this will ensure the existing distribution websites displaying the actual URLs are not affected. Please see below more information:

JSON Field:

Content	Current Field	New Field	Applicable Endpoint
Website URL, Booking URL and Shopping URL	communicationDetail	communicationDetailWithTracking	Get Product API
Deal URL	dealUrl	dealUrlWithTracking	Get Product API and Get Service API
Tour URL	tourBooking	tourBookingWithTracking	Get Service API
Tour Booking URL	serviceBooking	serviceBookingWithTracking	Get Service API

XML Field:

Content	Current Field	New Field	Applicable Endpoint
Website URL, Booking URL and Shopping URL	communication_detail	communication_detail_with_tracking	Get Product API
Deal URL	deal_url	deal_url_with_tracking	Get Product API and Get Service API
Tour URL	tour_booking	tour_booking_with_tracking	Get Service API
Tour Booking URL	service_booking	service_booking_with_tracking	Get Service API

Syntax:

The following table shows the format of content output by the new field that exists alongside the current field.

Current Field	New Field
actual URL (content as supplied by the profile owners)	re-direct URL + actual URL + tracking code

Sample API response:

Product level communication data:

JSON Output:

"communication": [
    {
        "attributeIdCommunication": "CAURENQUIR",
        "attributeIdCommunicationDescription": "URL Enquiries",
        "communicationIsdCode": "61",
        "countryName": "Australia",
        "communicationDetail": "https://www.yourwebsite.com/en/",
        "communicationDetailWithTracking": "https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourwebsite.com%2Fen%2F&q=eyJ0eXBlIjoicHJvZHVjdCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cndlYnNpdGUuY29tL2VuLyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9"
    },
    {
        "attributeIdCommunication": "CAUBENQUIR",
        "attributeIdCommunicationDescription": "Booking URL",
        "communicationIsdCode": "61",
        "countryName": "Australia",
        "communicationDetail": "https://www.yourbookingURL.com/en/make-booking",
	"communicationDetailWithTracking": "https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourbookingURL.com%2Fen%2Fmake-booking&q=eyJ0eXBlIjoiYm9va2luZyIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cmJvb2tpbmdVUkwuY29tL2VuL21ha2UtYm9va2luZyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9"
    },
    {
        "attributeIdCommunication": "CAUSENQUIR",
        "attributeIdCommunicationDescription": "Shopping URL",
        "communicationIsdCode": "61",
        "countryName": "Australia",
        "communicationDetail": "https://www.yourshoppingURL.com/shop/",
        "communicationDetailWithTracking": "https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourshoppingURL.com%2Fshop%2F&q=eyJ0eXBlIjoic2hvcCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cnNob3BwaW5nVVJMLmNvbS9zaG9wLyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9"
    }
]

XML Output:

<product_communication>
    <row>
        <attribute_id_communication>CAURENQUIR</attribute_id_communication>
        <attribute_id_communication_description>URL Enquiries</attribute_id_communication_description>
        <communication_isd_code>61</communication_isd_code>
        <country_name>Australia</country_name>
        <communication_detail>https://www.yourwebsite.com/en/</communication_detail>
        <communication_detail_with_tracking>https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourwebsite.com%2Fen%2F&q=eyJ0eXBlIjoicHJvZHVjdCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cndlYnNpdGUuY29tL2VuLyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9</communication_detail_with_tracking>
    </row>
    <row>
        <attribute_id_communication>CAUBENQUIR</attribute_id_communication>
        <attribute_id_communication_description>Booking URL</attribute_id_communication_description>
        <communication_isd_code>61</communication_isd_code>
        <country_name>Australia</country_name>
        <communication_detail>https://www.yourbookingURL.com/en/make-booking</communication_detail>
	<communication_detail_with_tracking>https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourbookingURL.com%2Fen%2Fmake-booking&q=eyJ0eXBlIjoiYm9va2luZyIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cmJvb2tpbmdVUkwuY29tL2VuL21ha2UtYm9va2luZyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9</communication_detail_with_tracking>
    </row>
    <row>
        <attribute_id_communication>CAUSENQUIR</attribute_id_communication>
        <attribute_id_communication_description>Shopping URL</attribute_id_communication_description>
        <communication_isd_code>61</communication_isd_code>
        <country_name>Australia</country_name>
        <communication_detail>https://www.yourshoppingURL.com/shop/</communication_detail>
        <communication_detail_with_tracking>https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourshoppingURL.com%2Fshop%2F&q=eyJ0eXBlIjoic2hvcCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cnNob3BwaW5nVVJMLmNvbS9zaG9wLyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9</communication_detail_with_tracking>
    </row>
</product_communication>

Product level Deals:

JSON Output:

"deals": [
    {
        "dealUrl": "https://www.yourdealsurl.com.au/offer/",
        "dealUrlWithTracking": "https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourdealsurl.com.au%2Foffer%2F&q=eyJ0eXBlIjoiZGVhbCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cmRlYWxzdXJsLmNvbS5hdS9vZmZlci8iLCJsaXN0aW5nSWQiOiI2MDUxODYzZWQxNGY0MDc3MjIzZWIyNTgiLCJkaXN0cmlidXRvcklkIjoiNTZiMWViOTM0NGZlY2EzZGYyZTMyMGM2IiwiYXBpa2V5SWQiOiI1NmIxZjYzZjBjZjIxM2FkMjBkZWRlYzgifQ%3D%3D",
    }
]

XML Output:

<deals>
    <row>
        <deal_url>https://www.yourdealsurl.com.au/offer/</deal_url>
        <deal_url_with_tracking>https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourdealsurl.com.au%2Foffer%2F&q=eyJ0eXBlIjoiZGVhbCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cmRlYWxzdXJsLmNvbS5hdS9vZmZlci8iLCJsaXN0aW5nSWQiOiI2MDUxODYzZWQxNGY0MDc3MjIzZWIyNTgiLCJkaXN0cmlidXRvcklkIjoiNTZiMWViOTM0NGZlY2EzZGYyZTMyMGM2IiwiYXBpa2V5SWQiOiI1NmIxZjYzZjBjZjIxM2FkMjBkZWRlYzgifQ%3D%3D</deal_url>
    </row>
</deals>

Service level communication data (Tour):

JSON Output:

"tourBooking": "https://www.yourtourinfourl.com.au/tours",
"tourBookingWithTracking": "https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourtourinfourl.com.au%2Ftours&q=eyJ0eXBlIjoic2VydmljZSIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cnRvdXJpbmZvdXJsLmNvbS5hdS90b3VycyIsImxpc3RpbmdJZCI6IjU2YjI3NDgzMjg4MDI1M2Q3NGM1YzQyMCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9" 

"serviceBooking": "https://www.yourtourbookingurl.com.au/booknow",
"serviceBookingWithTracking": "https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourtourbookingurl.com.au%2Fbooknow&q=eyJ0eXBlIjoiYm9va2luZyIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cnRvdXJib29raW5ndXJsLmNvbS5hdS9ib29rbm93IiwibGlzdGluZ0lkIjoiNTZiMjc0ODMyODgwMjUzZDc0YzVjNDIwIiwiZGlzdHJpYnV0b3JJZCI6IjU2YjFlYjkzNDRmZWNhM2RmMmUzMjBjNiIsImFwaWtleUlkIjoiNTZiMWY2M2YwY2YyMTNhZDIwZGVkZWM4In0%3D"

XML Output:

<tour_booking>https://www.yourtourinfourl.com.au/tours</tour_booking>
<tour_booking_with_tracking>https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourtourinfourl.com.au%2Ftours&q=eyJ0eXBlIjoic2VydmljZSIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cnRvdXJpbmZvdXJsLmNvbS5hdS90b3VycyIsImxpc3RpbmdJZCI6IjU2YjI3NDgzMjg4MDI1M2Q3NGM1YzQyMCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9</tour_booking_with_tracking>

<service_booking>https://www.yourtourbookingurl.com.au/booknow</service_booking>
<service_booking_with_tracking>https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourtourbookingurl.com.au%2Fbooknow&q=eyJ0eXBlIjoiYm9va2luZyIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cnRvdXJib29raW5ndXJsLmNvbS5hdS9ib29rbm93IiwibGlzdGluZ0lkIjoiNTZiMjc0ODMyODgwMjUzZDc0YzVjNDIwIiwiZGlzdHJpYnV0b3JJZCI6IjU2YjFlYjkzNDRmZWNhM2RmMmUzMjBjNiIsImFwaWtleUlkIjoiNTZiMWY2M2YwY2YyMTNhZDIwZGVkZWM4In0%3D</service_booking_with_tracking>

Service level Deals:

JSON Output:

"serviceDeals": [
    {
        "dealUrl": "https://www.yourdealsurl.com.au/offer/",
        "dealUrlWithTracking": "https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourdealsurl.com.au%2Foffer%2F&q=eyJ0eXBlIjoiZGVhbCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cmRlYWxzdXJsLmNvbS5hdS9vZmZlci8iLCJsaXN0aW5nSWQiOiI2MDUxODYzZWQxNGY0MDc3MjIzZWIyNTgiLCJkaXN0cmlidXRvcklkIjoiNTZiMWViOTM0NGZlY2EzZGYyZTMyMGM2IiwiYXBpa2V5SWQiOiI1NmIxZjYzZjBjZjIxM2FkMjBkZWRlYzgifQ%3D%3D",
    }
]

XML Output:

<service_deals>
    <row>
        <deal_url>https://www.yourdealsurl.com.au/offer/</deal_url>
        <deal_url_with_tracking>https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourdealsurl.com.au%2Foffer%2F&q=eyJ0eXBlIjoiZGVhbCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cmRlYWxzdXJsLmNvbS5hdS9vZmZlci8iLCJsaXN0aW5nSWQiOiI2MDUxODYzZWQxNGY0MDc3MjIzZWIyNTgiLCJkaXN0cmlidXRvcklkIjoiNTZiMWViOTM0NGZlY2EzZGYyZTMyMGM2IiwiYXBpa2V5SWQiOiI1NmIxZjYzZjBjZjIxM2FkMjBkZWRlYzgifQ%3D%3D</deal_url_with_tracking>
    </row>
</service_deals>

Suggestions for implementing the tracking URL:

The following is a guide only. Please use a method that best suites your website needs.

Distributors may opt to use the "href" attribute to embed the tracking URL.

Syntax:

<a href="insert the values from the new field here">insert the values from the current field here</a>

<a href="insert the values from the new field here">Display Text (e.g. Book Now)</a>

Example #1 - Hyperlink to actual URL:

<a href="https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourwebsite.com%2Fen%2F&q=eyJ0eXBlIjoicHJvZHVjdCIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cndlYnNpdGUuY29tL2VuLyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9">https://www.yourwebsite.com/en/</a>

Example #2 - Hyperlink to 'Book Now' button:

<a href="https://redirect.atdw-online.com.au/redirect?dest=https%3A%2F%2Fwww.yourbookingURL.com%2Fen%2Fmake-booking&q=eyJ0eXBlIjoiYm9va2luZyIsImRlc3RpbmF0aW9uIjoiaHR0cHM6Ly93d3cueW91cmJvb2tpbmdVUkwuY29tL2VuL21ha2UtYm9va2luZyIsImxpc3RpbmdJZCI6IjYwNTE4NjNlZDE0ZjQwNzcyMjNlYjI1OCIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9">Book Now</a>

Example #3 - Trigger AJAX call to the tracking URL:

The following implementation indicates the HREF attribute will have direct operator link without trackign but clicking on it will trigger an AJAX call to the tracking URL
This method will keep the user experience seamless by avoiding the redirection occurring into their browsers.

As a next step, ATDW will review the possibility of implementing the tracking URLs to the external system data (social media URLs, third party booking URLs, etc.) to further improve the engagement between the distributors and operators.

We appreciate you supporting this requirement to apply the new click tracking URL to all click actions within your website enabling ATDW to collect and serve valuable metrics to the tourism industry we serve.

For more information or support integrating this to your site, please do not hesitate to Contact Us.