Quick and easy: Copy the following code snippet into your existing HTML-Markup and you're done:
Feel free to tweak the JS-variables for the settings, especially "attachToID". You'll find it in the commented JS snipped you can copy with the button above. You may host the file to maintain control over what it does.
If you'd like to customize the frontend view yourself in order to create a deep integration of thinksuggest inside your existing services, pick this way.
Read the API introductionparameter | meaning | possible values | explanation |
m | method | s, c | whether you want to
|
pid | PartnerID | your partner id within our system, e.g. "demopartner" | To be provided by your contact at ThinkLABs. |
q | query | urlencoded string | Any user input. Used for delivering "s"uggestions and to optimize your individual user group based on your users' "c"licks. |
parameter | meaning | possible values | explanation |
ul | user language | ISO-3166-1: Alpha-2 Codes | The user's language, e.g. EN for English, DE for German. You might want to detect this via JS. |
uc | user's country | ISO-3166-1: Alpha-2 Codes | The user's country, e.g. GB for United Kingdom, US for USA, DE for Germany, AT for Austria. |
mo | maximum organic | Numeric value from 0 to 9999. Suggested: 30 | The maximum allowed SEO-rank of non-affiliate domains within the selected "uc" that may be
shown. We recommend to set it to at least "30", so that e.g. facebook.com, youtube.com and Co will usually show up once user types a single "f" or "y", so that your customers get used to/familiar with clicking this placement. |
ps | personal suggestions | string | Please eighter
|
jc (optional) | JsonCallback | JS Function Name | If you prefer to get the API-response wrapped in a JS callback function state your function name in this parameter. |
cap (optional) | Capping (maximum number of results) | numeric 0-10 | If you want to limit the number of thinksuggest-results, you can set this value to anything between 1 and 10. Leaving the parameter away or setting it to 0 will make it use the default maximum of 10. |
{
"suggestions": {
"": null,
"~": [
{
"d": "adidas.com",
"h": "7f63bc650fe1c379a176c7c99fc936ab",
"u": "https://www.adidas.com/us/i-5923-shoes/B..",
"l": "~ - adidas.com",
"t": "d",
"a": 1
},
{
"d": "finishline.com",
"h": "352d93d0169216596fb747f173c7c15d",
"u": "https://www.finishline.com/ad..",
"l": "~ - finishline.com",
"t": "d",
"a": 1
},
{
"d": "stockx.com",
"h": "fcbf4807e8e0bd6796724777931eb8e1",
"u": "https://stockx.com/ad..",
"l": "~ - stockx.com",
"t": "d",
"a": 1
},
{
"d": "urbanoutfitters.com",
"h": "4ca2d3cd1ff3c7949cec9d81a2acb536",
"u": "https://www.urbanoutfitters.com/shop/adidas-ini..",
"l": "~ - urbanoutfitters.com",
"t": "d",
"a": 1
}
],
"~ runner": [
{
"d": "adidas.com",
"h": "f1106ce072f139d442a6961975e5a5ff",
"u": "https://www.adidas.com/us/i-5923-shoes/B..",
"l": "~ runner - adidas.com",
"t": "d",
"a": 1
},
{
"d": "finishline.com",
"h": "020a85138ae871814cb5e75a8f2857af",
"u": "https://www.finishline.com/ad..",
"l": "~ runner - finishline.com",
"t": "d",
"a": 1
}
],
"~ shoes": null,
"~ red": null,
"~ sale": null,
"~ mens": null,
"~ blue": null,
"~ green": null,
"~ pink": null,
"~ boost": [
{
"d": "adidas.com",
"h": "debcca09b5e7eac032e2e935e2494cd4",
"u": "https://www.adidas.com/us/i_..",
"l": "~ boost - adidas.com",
"t": "d",
"a": 1
},
{
"d": "finishline.com",
"h": "3f84fdb49de2999fa3cfcb13951cb45f",
"u": "https://www.finishline.com/ad..",
"l": "~ boost - finishline.com",
"t": "d",
"a": 1
}
]
}
}
As you can see
"d": "adidas.com",
"h": "7f63bc650fe1c379a176c7c99fc936ab",
"u": "https://www.adidas.com/us/i-5923-shoes/B..",
"l": "~ - adidas.com",
"t": "d",
"a": 1
key | meaning | possible values | explanation |
d | domain | adidas.com | The shop domain of the result. |
h | hash | string | You'll need to pass this on to the "c"lick method in order to let your user click to that shop. |
u | URL | string | A Display-URL which you can utilize for higher click rates |
l | legible title | string | Contains a human-understandable title for the suggested result. |
t | type | 1-char, see method click | This parameter will tell us where the user should get redirected to:
|
a | affiliate-status | 0,1 | This will tell you whether you'll earn a commission on this click. You might use it to label your affiliate-links with "Ad" for legal reasons. |
s | search-string | string | This parameter is only provided for result type=s (search). It tells you that the partner shop page will be opened with the stated suggested search-query. You should append this parameter to your method="c"lick calls. |
parameter | meaning | possible values | explanation |
t | type of click | "h", "d" or "s" (homepage, deeplink, search) - You'll receive this info in the suggestion JSON | Please pass it on upon clickout. This allows us to properly forward the click to the desired destination. |
h | hash | string - You'll receive this info in the suggestion JSON | Please pass it on upon clickout. This allows us to properly forward the click to the desired destination. |
k | keyword | string - You'll receive this info in the suggestion JSON | Please pass it on upon clickout. It will help our system learn which keyword generated the click and afterwards we will evaluate how well the suggestion has performed in terms of revenue for your user group. |
s | search terms | string - You'll receive this info in the suggestion JSON | Should be specified, if the clickout type is "s" (search). Contains optimized search terms which the clickout shop should be opened with. |
Query | Possible Answer | logic |
a | amazon.de | as "a" can complete to the shop-name and amazon has a super high relevance ranking |
"amazon hdmi Kabel" or "hdmi Kabel ama" | Search "hdmi cable" on amazon.de | as shop-name ("amazon" or "ama" is part of query) |
hdmi Kabel | numerous pages that sell HDMI Cables. | Ordered by potential CPC and relevance. |
"medi" | Mediamarkt.de (homepage) | as "medi" can complete to shop name) |
"plays" | Showing results for "Playstation 4", e.g. from Mediamarkt.de | as mediamarkt ranks ~2 on Google for this Keyword |
Playstation 4 Medi | Search "Playstation 4" on Mediamarkt.de | as "medi" can complete to the shop-name |