diff --git a/source/_static/img/advanced_features/tango_copy_utid.png b/source/_static/img/advanced_features/tango_copy_utid.png new file mode 100644 index 000000000..842f687ff Binary files /dev/null and b/source/_static/img/advanced_features/tango_copy_utid.png differ diff --git a/source/_static/img/advanced_features/tango_open_reward_details.png b/source/_static/img/advanced_features/tango_open_reward_details.png new file mode 100644 index 000000000..60f0094d7 Binary files /dev/null and b/source/_static/img/advanced_features/tango_open_reward_details.png differ diff --git a/source/advanced_features.rst b/source/advanced_features.rst index 35149a476..8c492ba96 100644 --- a/source/advanced_features.rst +++ b/source/advanced_features.rst @@ -124,5 +124,6 @@ each with links to integration details. advanced_features/single_sign_on advanced_features/multi_currency advanced_features/sheerid + advanced_features/tango advanced_features/tremendous advanced_features/google_login diff --git a/source/advanced_features/tango.rst b/source/advanced_features/tango.rst new file mode 100644 index 000000000..4f386e6e7 --- /dev/null +++ b/source/advanced_features/tango.rst @@ -0,0 +1,59 @@ +.. _advanced_features/tango: +.. include:: /partials/common.rst + +.. meta:: + :description: Integrate Tango with your Talkable system to generate gift claim links and manage campaign-specific rewards. + +Tango Integration +################# + +This documentation provides a guide on integrating the Tango rewards with your Talkable system. +By enabling this feature, you can generate gift claim links for users and customize reward amounts based on campaign settings. + +Tango integration consists of several parts: + +1. A Reward Link reward option in Tango portal. + +3. A Tango application installed from Talkable App Store. This application is responsible + for storing all the necessary data required for Talkable to request gift cards from Tango and insert the generated + claim links in the referral campaign theme. + +2. A referral campaign in Talkable having the following attributes: + + - An Advocate Referral Incentive with "Tango" reward type + + - A :ref:`"tango" Liquid filter ` used in Reward Paid Email Page. + + The filter generates a claim link for the specified reward in Tango. + + .. code-block:: html + + + + {{ cta_text }} + + +How to find the reward ID (UTID) +................................ + +To use the `tango` Liquid filter, you will need to obtain the reward ID (called UTID) in the Tango portal: + +1. In the "Send rewards" portal section, select and click the Reward Link you intend to use to reward advocates in Talkable. + +2. On the reward details page, click "View all reward details". + + .. image:: /_static/img/advanced_features/tango_open_reward_details.png + :scale: 50% + :alt: Open Tango reward details + +3. Copy the "UTID" value and use it with the `tango` filter in the Talkable campaign theme. + + .. image:: /_static/img/advanced_features/tango_copy_utid.png + :scale: 50% + :alt: Copy Tango UTID + + .. note:: + + Make sure to only copy the value of UTID, i.e "U957978". + +.. include:: /partials/contact_us.rst diff --git a/source/campaigns/editor/filters.rst b/source/campaigns/editor/filters.rst index d68b298fe..cf3d07f7d 100644 --- a/source/campaigns/editor/filters.rst +++ b/source/campaigns/editor/filters.rst @@ -1181,6 +1181,25 @@ Returns ``strip me``. |hr| +.. _liquid_filter_tango: + +tango +..... + +Takes the ID (UTID) of a Tango reward. +Places an order for the specified reward and returns a gift claim link. +Requires the Tango app to be installed and enabled in order to work. + +.. code-block:: liquid + + {{ "U957978" | tango: amount: 10.0 }} + +Returns ``https://rewardlink.io/r/1/reward123`` + +Find more details about the integration here: :ref:`Tango ` + +|hr| + .. _liquid_filter_tremendous: tremendous