Image URL Tracking


All the image URL output by the ATDW API will contain the tracking code (additional query string at the end of each image URL) on Tuesday, 27 July 2021.

This will enable ATDW to collect the view tracking on the images to strengthen and improve accuracy and data provided to all listing profile owners from across the ATDW distribution network.


Note:

  • The new image URL with the tracking code is expected not to exceed 500 characters.
  • Most popular browsers support 2,048 characters
  • The screenshot below highlights the tracking code in the image URL:
  • Image URL tracking code


Impact:

  • We do not anticipate any impact unless you have a setting in place to restrict the maximum URL length.

  • Solution:

    If you experience issues requesting the image containing the tracking URL, please check to see if any of the following resolves the issue:

    • Remove the limitation (if any) set for the URL length.
    • Increase the max URL length to store up to 2,048 characters.
    • Change the data type of the field that allows maximum characters to be stored.

    Current image URL without tracking code:

    JSON Output:
    "multimedia": [
    	{
    		"marketVariantId": "",
    		"multimediaId": "56b25dba2880253d74c45277",
    		"authoredDate": "2016-02-04",
    		"serverPath": "https://assets.atdw-online.com.au/images/Original__9194800_AD00_Pool_with_Skyline_gttyijq.jpg?rect=197%2C0%2C3149%2C2362&w=2048&h=1536",
    		"attributeIdMultimediaContent": "IMAGE",
    		"attributeIdMultimediaContentDescription": "Image",
    		"attributeIdSizeOrientation": "4X3",
    		"width": "2048",
    		"height": "1536",
    		"altText": "Pool Terrace",
    		"caption": "Pool Terrace",
    		"photographer": "",
    		"copyright": "",
    		"sequenceNumber": "100"
    	}
    ]
    

    XML Output:
    <product_multimedia>
    	<row>
    		<market_variant_id/>
    		<multimedia_id>56b25dba2880253d74c45277</multimedia_id>
    		<authored_date>2016-02-04</authored_date>
    		<server_path>https://assets.atdw-online.com.au/images/Original__9194800_AD00_Pool_with_Skyline_gttyijq.jpg?rect=197%2C0%2C3149%2C2362&w=2048&h=1536</server_path>
    		<attribute_id_multimedia_content>IMAGE</attribute_id_multimedia_content>
    		<attribute_id_multimedia_content_description>Image</attribute_id_multimedia_content_description>
    		<attribute_id_size_orientation>4X3</attribute_id_size_orientation>
    		<width>2048</width>
    		<height>1536</height>
    		<alt_text>Pool Terrace</alt_text>
    		<caption>Pool Terrace</caption>
    		<photographer/>
    		<copyright/>
    		<sequence_number>100</sequence_number>
    	</row>
    </product_multimedia>
    


    New image URL with tracking code:

    JSON output:
    "multimedia": [
    	{
    		"marketVariantId": "",
    		"multimediaId": "56b25dba2880253d74c45277",
    		"authoredDate": "2016-02-04",
    		"serverPath": "https://assets.atdw-online.com.au/images/Original__9194800_AD00_Pool_with_Skyline_gttyijq.jpg?rect=197%2C0%2C3149%2C2362&w=2048&h=1536&q=eyJ0eXBlIjoibGlzdGluZyIsImxpc3RpbmdJZCI6IjU2YjI1ZGI5Mjg4MDI1M2Q3NGM0NTI1NyIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9",
    		"attributeIdMultimediaContent": "IMAGE",
    		"attributeIdMultimediaContentDescription": "Image",
    		"attributeIdSizeOrientation": "4X3",
    		"width": "2048",
    		"height": "1536",
    		"altText": "Pool Terrace",
    		"caption": "Pool Terrace",
    		"photographer": "",
    		"copyright": "",
    		"sequenceNumber": "100"
    	}
    ]
    

    XML Output:
    <product_multimedia>
    	<row>
    		<market_variant_id/>
    		<multimedia_id>56b25dba2880253d74c45277</multimedia_id>
    		<authored_date>2016-02-04</authored_date>
    		<server_path>https://assets.atdw-online.com.au/images/Original__9194800_AD00_Pool_with_Skyline_gttyijq.jpg?rect=197%2C0%2C3149%2C2362&w=2048&h=1536&q=eyJ0eXBlIjoibGlzdGluZyIsImxpc3RpbmdJZCI6IjU2YjI1ZGI5Mjg4MDI1M2Q3NGM0NTI1NyIsImRpc3RyaWJ1dG9ySWQiOiI1NmIxZWI5MzQ0ZmVjYTNkZjJlMzIwYzYiLCJhcGlrZXlJZCI6IjU2YjFmNjNmMGNmMjEzYWQyMGRlZGVjOCJ9</server_path>
    		<attribute_id_multimedia_content>IMAGE</attribute_id_multimedia_content>
    		<attribute_id_multimedia_content_description>Image</attribute_id_multimedia_content_description>
    		<attribute_id_size_orientation>4X3</attribute_id_size_orientation>
    		<width>2048</width>
    		<height>1536</height>
    		<alt_text>Pool Terrace</alt_text>
    		<caption>Pool Terrace</caption>
    		<photographer/>
    		<copyright/>
    		<sequence_number>100</sequence_number>
    	</row>
    </product_multimedia>
    



    For more information, please do not hesitate to Contact Us.