Introduction
BlueConic powers your data-driven business processes to accelerate growth. It is a CDP that makes it easy for a marketeer to personalize the online journey of users.
MoEngage <> BlueConic
BlueConic provides a unified view of the customer. Paired with the capabilities to activate that data inside Moengage, it can be used to drive your business growth together. With the MoEngage and BlueConic integration, you can:
- Forward users and events from BlueConic to MoEngage
- Create or update users in Blueconic from MoEngage
Integration
library_add_check |
Prerequisites
|
Step 1: Configure MoEngage connection on Blueconic
- On your Blueconic app dashboard, go to the Connections tab.
- Click on "Add Connection" >> Webhook connection.
- Give your connection a name, "MoEngage".
Step 2: Configure webhook for inbound users and events to MoEngage
To configure inbound events to MoEngage, you need to set up "Requests sent by BlueConic".
- Select the BlueConic segments for which this request will be triggered.
- Next, you need to select the triggers for this webhook. This can either be:
- A profile property value changes - select which property change will trigger this webhook.
- A Timeline event occurs - select which event will trigger this webhook.
- Once your trigger is selected, you need to select your authorization method. For MoEngage, you need to choose "Add credentials via webhook request (step 4)".
- Finally, you need to configure the webhook request according to MoEngage's User or Event API payload structures:
Field | Description |
Request URL |
User API URL:
Event API URL:
|
Method | POST |
Request Headers |
|
Request Body |
The Request Body will depend on the type of call you're making to MoEngage. Below is an example of the User API: { "type": "customer", "customer_id": "{{email}}", "attributes": { "name":"{{fullname}}", "moe_ip_country": "{{geo_country_name}}" } } |
- Once you're done with the configurations as per your requirement, you can choose to "Test the webhook". You can set sample values and click on the "Send test request" button to send a request to MoEngage.
Step 3: Configure webhook for outbound users from MoEngage
With MoEngage Connector Campaigns, you can forward user properties to Blueconic when an event is captured inside MoEngage.
Step A: Set up a MoEngage Connector Campaign to Blueconic
To create a connector campaign on MoEngage,
- Navigate to Create Campaign >> Connectors >> Custom and choose the delivery type most suitable to your needs. For this example, we will select "Event Triggered" and select the event as "Purchased".
- On step 2 of the campaign:
Call the BlueConic API
To send your user attributes to BlueConic, use the POST
method and configure the payload.
- Select the method as POST
- URL: On your BlueConic dashboard, you will find the request URL when you're setting up the incoming request.
- URL Parameters:
-
property
:email
- Get the "matching" URL parameters from your Blueconic dashboard. -
email
:{{UserAttribute['Email (Standard)']}}
- Get the "matching" URL parameters from your Blueconic dashboard. -
apiKey
:<your_api_key>
- Get your API Key from your Blueconic dashboard. -
createProfile
:true
- Here you can allow the creation of profile by choosing either True or False. -
legislation
:GDPR
- You can select to use or not use a legislation. Use 'none' for no legislation.
-
- Headers
-
X-BlueConic-APIKey
:<api_key>
- Get this from your Blueconic Dashboard. -
Content-Type
:application/json
-
- Body:
Type @ to personalize your payload.
{ "fullname": "{{UserAttribute['Name']}}, "country": "{{UserAttribute['Locale Country']}}" }
- Refer to the Blueconic API documentation for more information.
Preview your request
At this point, your campaign should be ready to test and send. You can also test your connector configuration using the Test functionality available in Step 2 of Create Connector Campaign.
You can go ahead and Publish the campaign.
Step B: Set up the incoming webhooks in BlueConic
- Go to the MoEngage connection you set up inside BlueConic, and select "Receive incoming requests".
- Select the BlueConic identifier to match from the requests. In our connector example above, we have chosen "Email".
- Next, select the Authentication method as "API key". You can refer to the request headers and set them up during the configuration of MoEngage Connector Campaigns.
- BlueConic will also show you your Request URL that you need to enter while setting up the connector campaign on MoEngage, along with the URL parameters you need to pass.
- Finally, you need to configure the incoming webhook request. Based on the attributes you set up in the payload of your Connector Campaign, you can set up the mapping:
Step 4: Enable the connection on BlueConic
- On your BlueConic dashboard, check the goals you want to enable.
- You also need to enable the connection by setting it to "On":