Personalization & insights

Tweakwise Personalization allows you to build a profile of your visitors to display tailor-made recommendations on every visit to your platform. Insights will provide insights in builder, template and algorithm usage.

The provide personalized requests, our engine requires three steps:

  • Identify : recognize the current user.
  • Collect : capture key moments in the user journey.
  • Apply send the profilekey with every request

Identify

Customer identification is done through a profile key. This is our way to identify your customers using a unique identifier. To learn more, see Identification.

Collect

Follow our Event Tag guide to get started with collecting key events like product views and purchases.

Apply

Add the profilekey to every request, so we can generate personalized results.

In the examples we use the a fictional profilekey 8Vm8EbmlHdDU60whm4.

Navigation

Use tn_profilekey to identify the user on merchandising requests:

curl --request GET \
     --url 'https://gateway.tweakwisenavigator.com/navigation/c1a12e92?tn_profilekey=8Vm8EbmlHdDU60whm4' \
     --header 'TWN-Source: Tweakwise API docs' \
     --header 'accept: application/json'

Search

Use tn_profilekey to identify the user on search requests:

curl --request GET \
     --url 'https://gateway.tweakwisenavigator.com/navigation-search/c1a12e92?tn_q=hoody&tn_profilekey=8Vm8EbmlHdDU60whm4' \
     --header 'TWN-Source: Tweakwise API docs' \
     --header 'accept: application/json'

Suggestion products

Use tn_profilekey to identify the user for product suggestions:

curl --request GET \
     --url 'https://gateway.tweakwisenavigator.com/suggestions/products/c1a12e92?tn_q=hoody&tn_profilekey=8Vm8EbmlHdDU60whm4' \
     --header 'TWN-Source: Tweakwise API docs' \
     --header 'accept: application/json'

Recommendations

Use tn_profilekey to identify the user for product recommendations:

curl --request GET \
     --url 'https://gateway.tweakwisenavigator.com/recommendations/features/c1a12e92/1?tn_profilekey=8Vm8EbmlHdDU60whm4' \
     --header 'TWN-Source: Tweakwise API docs' \
     --header 'accept: application/json'