ÃÛ¶¹ÊÓÆµ

2.5.3 Create and configure a custom webhook

Create your custom webhook

Go to . You already used this application in Exercise 2.3.6 Destinations SDK

If you haven’t used that service yet, create an account and then create a workspace. Once the workspace is created, you’ll see something similar to this.

Click copy to copy the url. You’ll need to specify this url in the next exercise. The URL in this example is https://eodts05snjmjz67.m.pipedream.net.

demo

This website has now created this webhook for you, and you’ll be able to configure this webhook in your Event Forwarding property to start testing the forwarding of events.

Update your Event Forwarding property: Create a Data Element

Go to and go to Event Forwarding. Search your Event Forwarding property and click it to open it.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

In the left menu, go to Data Elements. Click Create New Data Element.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ll then see a new data element to configure.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

Make the following selection:

  • As the Name, enter XDM Event.
  • As the Extension, select Core.
  • As the Data Element Type, select Path.
  • As the Path, select Read data from XDM (arc.event.xdm). By selecting this path, you’ll be filtering out the XDM section from the event payload that is sent by the website or mobile app into the ÃÛ¶¹ÊÓÆµ Edge.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ll now have this. Click Save.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

NOTE
In the above path, a reference is made to arc. arc stands for ÃÛ¶¹ÊÓÆµ Resource Context and arc always stands for the highest available object that is available in the Server Side context. Enrichments and transformations may be added to that arc object using ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Server functions.
In the above path, a reference is made to event. event stands for a unique event and ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Server will always evaluate every event individually. Sometimes, you may see a reference to events in the payload sent by Web SDK Client Side, but in ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Server, every event is evaluated individually.

Update your ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Server property: Create a Rule

In the left menu, go to Rules. Click Create New Rule.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ll then see a new rule to configure. Enter the Name: All Pages. For this exercise, you won’t need to configure a condition. Instead, you’ll setup an action. Click the + Add button under Actions.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ll then see this. Make the following selection:

  • Select the Extension: ÃÛ¶¹ÊÓÆµ Cloud Connector.
  • Select the Action Type: Make Fetch Call.

That should give you this Name: ÃÛ¶¹ÊÓÆµ Cloud Connector - Make Fetch Call. You should now see this:

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

Next, configure the following:

  • Change the request method from GET to POST
  • Enter the URL of the custom webhook you created in one of the previous steps, which looks like this: https://eodts05snjmjz67.m.pipedream.net

You should now have this. Next, go to Body.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ll then see this. Click the data element icon as indicated below.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

In the popup, select the data element XDM Event which you created in the previous step. Click Select.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ll then see this. Click Keep Changes.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ll then see this. Click Save.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

You’ve now configured your first rule in an Event Forwarding property. Go to Publishing Flow to publish your changes.
Open your Development library Main by clicking Edit as indicated.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

Click the Add All Changed Resources button, after which you’ll see your Rule and Data Element appear in this library. Next, click Save & Build for Development. Your changes are now being deployed.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

After a couple of minutes, you’ll see that the deployment is done and ready to be tested.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection SSF

Test your configuration

Go to . After logging in with your ÃÛ¶¹ÊÓÆµ ID, you’ll see this. Click the 3 dots … on your website project and then click Run to open it.

DSN

You’ll then see your demo website open up. Select the URL and copy it to your clipboard.

DSN

Open a new incognito browser window.

DSN

Paste the URL of your demo website, which you copied in the previous step. You’ll then be asked to login using your ÃÛ¶¹ÊÓÆµ ID.

DSN

Select your account type and complete the login process.

DSN

You’ll then see your website loaded in an incognito browser window. For every exercise, you’ll need to use a fresh, incognito browser window to load your demo website URL.

DSN

When you open up your browser Developer View, you can inspect Network requests as indicated below. When you use the filter interact, you’ll see the network requests that are sent by ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Client to the ÃÛ¶¹ÊÓÆµ Edge.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Setup

If you select the raw payload, go to and paste the payload. Click Minify / Beautify. You’ll then see the JSON payload, the events object and the xdm object. In one of the previous steps, when you defined the Data Element, you used the reference arc.event.xdm, which will result in you parsing out the xdm object of this payload.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Setup

Switch your view to your custom webhook which you used in one of the previous steps. You should now have a view similar to this one, with network requests being shown in the left menu. You’re seeing the xdm payload that was filter out of the network request that was shown above.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Setup

Scroll down a bit in the payload to find the page name, which in this case is home.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Setup

If you now navigate across the website, you’ll see additional network requests becoming available on this custom webhook in real-time.

ÃÛ¶¹ÊÓÆµ Experience Platform Data Collection Setup

You’ve now configured the server side Event Forwarding of Web SDK/XDM payloads to an external custom webhook. In the next exercises, you’ll configure a similar approach, and you’ll be sending that same data towards Google Cloud Platform and AWS.

Next Step: 2.5.4 Forward events to GCP Pub/Sub

Go Back to Module 2.5

Go Back to All Modules

recommendation-more-help
aeafc5b5-cd01-4e88-8d47-d76c18d7d349