Skip to content

Latest commit

 

History

History
79 lines (52 loc) · 3.96 KB

extole.md

File metadata and controls

79 lines (52 loc) · 3.96 KB
Raw
description
Step-by-step guide to ingest your event data from Extole into RudderStack.

Extole

Extole is a popular referral marketing tool that lets you offer an integrated, optimized, and effective customer experience for your audience. It allows you to create personalized marketing campaigns aimed at boosting your customer acquisition and conversion rates.

You can send your Extole events to RudderStack by simply adding a webhook pointing to RudderStack. These events includes the reward specific events reward_earned,reward_fulfilled,reward_sent along with other custom events from extole.

This guide helps you in setting up Extole as a source in RudderStack.

Getting Started

In order to add Extole as a source in RudderStack, please follow these steps:

  • From your RudderStack dashboard, click on Add Source. From the list of sources, select Extole, as shown:

Choose Extole as a source

  • Enter the name of your source, and click on Next.

Extole Source

  • Head over to your Extole account and select the program you want to use for RudderStack to ingest your data. Then, navigate to the Tech Center section from the sidebar and then select Rewards WebHook and create a new Reward Webhook in the view as shown below:

Extole WebHook

  • In the URL text box, add a URL pointing to RudderStack in the following format: <DATA_PLANE_URL>/v1/webhook?writeKey=<YOUR_EXTOLE_SOURCE_WRITE_KEY>

An example URL should like the following:

https://hosted.rudderlabs.com/v1/webhook?writeKey=1qI4k72gLvHwg2mz24xPCv8gGGK

{% hint style="warning" %} Make sure you add the writeKey as query parameter to the URL. This is required to prevent the webhook from failing in case of an invalid write key. {% endhint %}

  • Finally, save the endpoint.

RudderStack Event Transformation

The events from Extole are ingested into RudderStack after converting it into a RudderStack-compatible event format. For example, the event_id set by Extole is set as properties.eventId.

The events sent by Extole are converted into a Rudderstack track call with a designated name and properties as the entire event received from Extole.

The event name of the events generated by Extole is kept the same while mapping to the Rudderstack event name.

RudderStack populates the following properties from 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

{% hint style="warning" %} All the properties of Extole Events other than reward_earned, reward_fulfilled, reward_sent which are sent to Rudderstack will be directly mapped to the Rudderstack event properties. {% endhint %}

Contact Us

If you come across any issues while configuring Extole as a source with RudderStack, please feel free to contact us. You can also start a conversation on our Slack channel - we will be happy to talk to you!