Integrating Events¶
In addition to running a referral campaign around regular purchases, Talkable also supports custom events that can be split into multiple categories and be used to set up advanced campaign rules.
An example of such integration can be a subscription-based business that also supports one-time purchases. A referral campaign example can be: Advocate and Friend both get $5 off discount on one-time purchases, and $15 off when purchasing a subscription plan.
In this case, the subscription purchases and the one-time purchases should be integrated as separate events under different event categories: “subscription” and “purchase”. All events should be passed to Talkable, including recurring events. Talkable’s backend referral engine runs each event through several checks to identify whether the event was associated with a referral or not. With both “subscription” and “purchase” events being passed to Talkable, we are then able to set up referral campaigns to report on and reward these events as desired. See some examples below.
Subscription payments should be registered under the “subscription” event category. All such events can be found in the Reports → Events section of your Talkable Dashboard. Here is an example:
<!-- Begin Talkable integration code -->
<script>
window._talkableq = window._talkableq || []
window._talkableq.push(['register_event', {
event: {
event_category: 'subscription',
event_number: 'ev1938579813',
subtotal: '89',
coupon_code: 'SAVE20'
},
customer: {
email: 'customer1@example.com'
}
}]);
</script>
<!-- End Talkable integration code -->
Note
Please make sure you’ve added Talkable Initialization Script to your header or any template spanning every page.
One-time purchases should go under the “purchase” event category. You can find all purchases in the Reports → Purchases section of your Talkable Dashboard. Here is an example:
<!-- Begin Talkable integration code -->
<script>
window._talkableq = window._talkableq || []
window._talkableq.push(['register_event', {
event: {
event_category: 'purchase',
event_number: 'ev1938579814',
subtotal: '34.5',
coupon_code: null
},
customer: {
email: 'customer2@example.com'
}
}]);
</script>
<!-- End Talkable integration code -->
Note
All recurring subscription purchases should be passed to Talkable as well, to ensure
data integrity. If recurring transactions occur on the backend, follow the
Origin API (see “Create an event” section).
Available properties¶
Note
All PII params support data encryption. Find more about Params Encryption.
Here is a list of available properties each event can include:
Property |
Description |
|---|---|
event |
An event data:
|
customer |
A person who issued an event:
|
campaign_tags |
Campaign tags are used to manually choose which campaign to show once the event has been tracked successfully (optional). Each Talkable campaign supports multiple tags, you can list them
as an array: You can control campaign tags inside Campaign Rules. Each Talkable campaign can have different tags. Alternatively, you can use Campaign Placements feature to set up routing in your Talkable Dashboard instead of controlling it through the JS integration on your end. Campaign Placements are easy to change, no code changes are needed on your end. |
custom_properties |
Custom key-value data that can be attached to a person (optional). It can be used for segmentation for example: you can code up custom criteria to show relevant campaigns to each segment. Alternatively, custom properties can be used for an advanced referral reward logics. Any valid JS object is allowed. Object value should always be a string. Example: |