Rehook Destination
Rehook is a powerful and dedicated user-incentivization solution that enables businesses to reward and engage users without depending on tech teams. With an elegant and easy-to-use interface, Rehook is designed to help you run user-promotion campaigns that are flexible, customizable and scalable.
This destination is maintained by Rehook. For any issues with the destination, contact the Rehook Support team.
Getting started
- From the Destinations catalog page in the Segment App, click Add Destination.
- Search for Rehook in the Destinations Catalog, and select the Rehook destination.
- Select which Source should send data to the Rehook destination.
- Open the Rehook Dashboard and navigate to Settings > API Keys & Secret Key. Copy your key.
- Open the Segment app and paste the API Key & Secret Key in the Rehook destination settings page.
Supported methods
Rehook’s destination is designed to support the following Segment Spec methods. Because this is an Actions Destination, you can also map other Segment methods.
Identify
If you’re not familiar with the Segment Spec, take a moment to understand what the Identify method does. An example call looks like this:
Example 1:
analytics.identify('userId12345', {
firstName: 'Bob',
lastName: 'Dole',
email: 'bob.dole@example.com',
company: 'Initech',
employees: 234
});
Example 2:
analytics.identify('userId12345', {
firstName: 'Bob',
lastName: 'Dole',
email: 'bob.dole@example.com',
company: 'Initech',
employees: 234,
referral_code: "ERTYUS"
});
Every time you make an Identify call with an included userId
:
- Rehook verifies that the
userId
exists. - If the
userId
does not exist, Rehook adds the user as a Customer to the Rehook database and matches user properties with the Segmenttraits
sent in the Identify call payload. - If the
userId
exists, Rehook updates the user properties for the Customer against the Segmenttraits
sent in the Identify call payload. - If
referral_code
is unique, Rehook updates the user properties in its database.
All of the traits recognized by Segment are translated and matched with the Rehook Customer user properties. These fields are automatically created or mapped for a Customer in Rehook and are available for personalization and advanced segmentation.
How Rehook handles incoming userId and referral_code in Identify calls:
- The
userId
field is required. Rehook drops Identify calls without a userId. - If a call is made with
anonymousID
, Rehook drops the Identify call. - If
referral_code
matches with anotheruserId
, Rehook drops the Identify call.
Track
If you’re not familiar with the Segment Spec, take a moment to understand what the Track method does.
An example call looks like this:
Example 1:
analytics.track('Product Viewed', {
userId: "userId12345",
product_id: '507f1f779439011',
name: 'Monopoly: 3rd Edition',
price: 18.99,
url: 'https://www.example.com/product/path',
image_url: 'https://www.example.com/product/path.jpg'
});
Example 2:
analytics.track('signup', {
userId: "userId12345",
referral_code: 'ERTYUS'
});
Segment sends Track calls to Rehook as a Custom Event. When you make a Track call, Segment sends the event to Rehook with the event name and all properties that you specified.
How Rehook handles incoming userId and referral_code in Track calls:
- The
userId
field is required. Rehook drops Track calls without auserId
. - If a call is made with
anonymousId
, Rehook drops the Track call. - The
referral_code
field is required if event name is set as a conversion event in Rehook.
Destination Settings
Setting | Description |
---|---|
Api Key | Required. Your Rehook API Key |
Api Secret | Required. Your Rehook API Secret |
Available Actions
Build your own Mappings. Combine supported triggers with the following Rehook-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Identify User
Send the identify event to create or update the customer in rehook.
Identify User is a Cloud action. The default Trigger is: type = "identify"
Field | Description |
---|---|
Source ID* | Type: STRING The unique user identifier set by you |
User Metadata | Type: OBJECT Properties to set on the user profile |
Referral Code | Type: STRING The referral code of the user |
Track Event
Send the Track event to rehook.
Track Event is a Cloud action. The default Trigger is: type = "track"
Field | Description |
---|---|
Event Name* | Type: STRING The name of the event being performed. |
Source ID* | Type: STRING The unique user identifier set by you |
Event Properties | Type: OBJECT An object of key-value pairs that represent event properties to be sent along with the event. |
Engage
You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo.
For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true
. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Engage sets that value to false
.
When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.
Real-time to batch destination sync frequency
Real-time audience syncs to Rehook may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.
Settings
Segment lets you change these destination settings from the Segment app without having to touch any code.
Setting | Description |
---|---|
Api Key (required) |
string . Your Rehook API Key |
Api Secret (required) |
string . Your Rehook API Secret |
This page was last modified: 23 Aug 2023
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!