Extole
2 minute read
Extole is a popular referral marketing tool. It enables you to offer an integrated, optimized, and effective customer experience for your audience.
You can now send your Extole events to RudderStack by adding a webhook that points to RudderStack. These events include the reward-specific events such as reward_earned,reward_fulfilled,reward_sent, etc. along with other Extole custom events.
This guide will help you in setting up Extole as a source in RudderStack.
Get started
- Go to your RudderStack dashboard and click Add Source. From the list of Event Streams sources, select Extole.
- Assign a name to your source and click Continue.
- Your Extole source is now configured. Go to the Settings tab of the source and note the Webhook URL:
- Go to your Extole account and select the program you want to use for RudderStack to ingest your data.
- Navigate to the Tech Center section from the sidebar and then select Rewards WebHooks.
- Click the New Reward Webhook option as seen in the following image:
- In the URL text box, add the webhook URL obtained in Step 3. The URL should be of the following format:
<DATA_PLANE_URL>/v1/webhook?writeKey=<WRITE_KEY>Make sure to:
- Replace
<DATA_PLANE_URL>with the data plane URL associated with your RudderStack workspace.- Add the source write key obtained in Step 3 as a query parameter to the URL. This is required to prevent the webhook from failing.
- Validate the endpoint before proceeding.
- Save the endpoint.
Event transformation
RudderStack ingests the Extole events and converts them to the RudderStack’s track call with the designated event name and associated properties. For example, Extole’s event_id is converted and set to properties.eventId.
RudderStack retains the Extole event name during the mapping.
RudderStack populates the following properties from the Extole event payload to the RudderStack event:
| Extole Property | RudderStack Property |
|---|---|
event_id, | properties.eventId |
event_time | originalTimestamp |
reward_id | properties.rewardId |
reward_supplier_name | properties.rewardSupplierName |
reward_supplier_id | properties.rewardSupplierId |
partner_reward_supplier_id | properties.partnerRewardSupplierId |
reward_supplier_type | properties.partnerRewardSupplierType |
person_id | properties.personId |
partner_user_id | properties.partnerUserId, userId, context.traits.userId |
face_value | properties.faceValue |
face_value_type | properties.faceValueType |
message | properties.message |
partner_reward_id | properties.partnerRewardId |
email | properties.email |
data | properties.data |
schema_version | properties.schemaVersion |
All the Extole event properties (exceptreward_earned,reward_fulfilled, andreward_sent) sent to RudderStack are directly mapped to the RudderStack event properties.
