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.
- 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.
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.
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:
1analytics.identify('userId12345', {2firstName: 'Bob',3lastName: 'Dole',4email: 'bob.dole@example.com',5company: 'Initech',6employees: 2347});
1analytics.identify('userId12345', {2firstName: 'Bob',3lastName: 'Dole',4email: 'bob.dole@example.com',5company: 'Initech',6employees: 234,7referral_code: "ERTYUS"8});
Every time you make an Identify call with an included userId:
- Rehook verifies that the
userIdexists. - If the
userIddoes not exist, Rehook adds the user as a Customer to the Rehook database and matches user properties with the Segmenttraitssent in the Identify call payload. - If the
userIdexists, Rehook updates the user properties for the Customer against the Segmenttraitssent in the Identify call payload. - If
referral_codeis 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
userIdfield is required. Rehook drops Identify calls without a userId. - If a call is made with
anonymousID, Rehook drops the Identify call. - If
referral_codematches with anotheruserId, Rehook drops the Identify call.
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:
1analytics.track('Product Viewed', {2userId: "userId12345",3product_id: '507f1f779439011',4name: 'Monopoly: 3rd Edition',5price: 18.99,6url: 'https://www.example.com/product/path',7image_url: 'https://www.example.com/product/path.jpg'8});
1analytics.track('signup', {2userId: "userId12345",3referral_code: 'ERTYUS'4});
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
userIdfield is required. Rehook drops Track calls without auserId. - If a call is made with
anonymousId, Rehook drops the Track call. - The
referral_codefield is required if event name is set as a conversion event in Rehook.
Your Rehook API Key
Your Rehook API Secret
Build your own Mappings. Combine supported triggers with the following Rehook-supported actions:
Mapping limits per destination
Send the identify event to create or update the customer in rehook.
Identify User is a Cloud action. The default Trigger is type = "identify"
The unique user identifier set by you
Optional
Properties to set on the user profile
Optional
The referral code of the user
Send the Track event to rehook.
Track Event is a Cloud action. The default Trigger is type = "track"
The name of the event being performed.
The unique user identifier set by you
Optional
An object of key-value pairs that represent event properties to be sent along with the event.
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.
Segment lets you change these destination settings from the Segment app without having to touch any code.
Your Rehook API Key
Your Rehook API Secret