In order to integrate YUDU’s digital catalog solution with your own e-commerce engine, you’ll need to adapt your e-commerce engine’s code to receive the cart’s contents from us, and return data to us so that we can forward the end-user to the right URL. It works like this:
Click To Enlarge - E-commerce Integration Data Journey
In order to get this to work, we’ll need two URLs from you: the URL that the data should be submitted to, and the end-user URL that they should be forwarded to after you send your response. (We’ll include the token you’ve provided in the response, as a query string parameter on the end of that URL - which you can use to forward the user to the correct cart on your e-commerce site). The data that is sent to the e-commerce engine, and the data you should return is attached in the two text files - it’s JSON formatted.
Passing through additional information via URL parameters
If you’d like additional information to be forwarded to your e-commerce engine (for example, a referrer code, or a country code), you can simply append the parameters to the URL of your catalog, using typical URL syntax:
http://yourcataloguelinkhere/folder/index.html?referrer_code=ABC01&country_code=au
Then, in Publisher, modify the custom URL and redirect URL to include this information (custom URL is the URL that the cart will submit the data to, whilst the redirect URL will be the landing page in your e-commerce engine).
The parameters you’re forwarding as above should be set using:
parameter_name=<parameter_name|default_value> (where |default_value is optional).
To take the above example, I could set the custom URL to:
If a referrer code or country code is on the original URL, then it will be passed through, but if they’re not provided, this will resolve to:
http://mycommerceengine.com/addToCart.html?referrer_code=na&country_code=au
The same formatting can be used for the redirect URL. Note that this is flexible – you could customise any part of the redirect or custom URLs using similar formatting. Here’s an example of how to redirect users towards a specific domain e-commerce engine, if you have multiple e-commerce engines in multiple countries:
http://mycommerceengine<domain_name|.co.uk>/addToCart.html
Which would deliver to the .co.uk domain based e-commerce engine if the domain name parameter isn't included in the original catalogue, or another domain otherwise)
