You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-webhook-extensible/reddit-ads-conversion-api-integration-recipe.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Reddit Ads Conversion API Integration Recipe
3
3
---
4
4
5
-
This recipe will guide you through setting up a custom destination for Reddit Ads Conversion API using Segment’s Extensible Webhooks feature. By following these steps, you can integrate your data source with Reddit Ads Conversion API without writing any code.
5
+
This recipe will guide you through setting up a custom destination for [Reddit Ads Conversion API](https://ads.reddit.com/){:target="_blank"} using Segment’s [Extensible Webhooks](https://segment.com/docs/connections/destinations/catalog/actions-webhook-extensible/){:target="_blank"} feature. By following these steps, you can integrate your data source with Reddit Ads Conversion API without writing any code.
6
6
7
7
## Prerequisites
8
8
@@ -15,10 +15,10 @@ To integrate Reddit Ads Conversion with Segment, ensure you have the following:
15
15
16
16
## Getting started
17
17
18
-
### 1. Navigate to the Extensible Webhook destination
18
+
### 1. Navigate to the Extensible Webhooks destination
19
19
20
20
1. In your Segment workspace, go to **Catalog** > **Destinations**.
21
-
2. Use the search bar to search for **Extensible Webhook** and select **Add destination**.
21
+
2. Use the search bar to search for "Extensible Webhook" and select **Add destination**.
22
22
23
23
### 2. Select the data source
24
24
@@ -48,13 +48,13 @@ The conversion access token provides a bearer token that can be added to the hea
48
48
2. Select **Conversions API**.
49
49
3. Click **Generate Access Token** to generate your token. Copy and make a note of it.
50
50
51
-
Once you have the conversion token, go back to your destination in your Segment workspace. In **Settings**, go to **Authorization Settings** and select “No Auth” as the authentication method.
51
+
Once you have the conversion token, go back to your destination in your Segment workspace. In Settings, go to Authorization Settings and select **No Auth** as the authentication method.
52
52
53
53
### 5. Perform data mapping
54
54
55
55
#### Data transformation
56
56
57
-
The Reddit Conversion API expects data in a nested format. To format the payload correctly, you will need to write an insert function that appends a new property, for example `body`.
57
+
The Reddit Conversion API expects data in a nested format. To format the payload correctly, you will need to write an insert function that appends a new property, for example "body".
58
58
59
59
This will have the following structure:
60
60
@@ -126,14 +126,14 @@ It’s also recommended that you include the `email`, `ip_address`, `uuid`, and
126
126
127
127
To map data from your destination to Reddit Ads:
128
128
129
-
1. Create a new mapping in the **Mappings** tab, select the **Send** action.
129
+
1. Create a new mapping in the Mappings tab, select the **Send** action.
130
130
2. Define the event trigger by selecting the events you want to send to Reddit Ads Conversion API using the Event name filters.
131
-
3. (Optional) Add enrichment entities as necessary.
131
+
3. (Optional) Add enrichment entities as needed.
132
132
4. Fill out mapping fields:
133
-
1. To specify the URL, go to your Reddit Ads account, navigate to **Pixel configuration** to find your Pixel ID. The format of the URL should be https://ads-api.reddit.com/api/v2.0/conversions/events/{{YOURPICEL_ID}}
134
-
2. Specify the headers.
135
-
- Set up Authorization using the Bearer Token generated in the previous step.
136
-
- Specify the Content Type that the Conversion API expects.
133
+
1. To specify the URL, go to your Reddit Ads account, navigate to **Pixel configuration** to find your Pixel ID. The format of the URL should be `https://ads-api.reddit.com/api/v2.0/conversions/events/{{YOURPIXEL_ID}}`, with your pixel ID being at the end of the URL.
134
+
2. Specify the headers:
135
+
- Set up Authorization using the bearer token generated in the previous step.
136
+
- Specify the content type that the Conversion API expects.
137
137
5. Use the mapping interface and search for the “body” parameter that was created in the insert function to select the transformed object that can be sent as the event body.
0 commit comments