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/podsights/index.md
+26-25Lines changed: 26 additions & 25 deletions
Original file line number
Diff line number
Diff line change
@@ -3,37 +3,35 @@ rewrite: true
3
3
title: Podsights Destination
4
4
id: 5d25eddde3ff660001b3adda
5
5
---
6
-
[Podsights](https://podsights.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} measures the effectiveness of podcast advertising. Through integrations with podcast hosting providers, matches downloads with on-site actions, providing advertisers household-level attribution.
7
-
8
-
This destination is maintained by Podsights. For any issues with the destination, [contact the Podsights Support team](mailto:[email protected]).
9
-
10
-
11
-
## Getting Started
6
+
[Podsights](https://podsights.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} measures the effectiveness of podcast advertising. Through integrations with podcast hosting providers, Podsights matches podcast downloads with on-site actions to provide household-level attribution.
12
7
8
+
This destination is maintained by Podsights. For any issues with the destination, [contact the Podsights/Spotify support team](https://adshelp.spotify.com/HelpCenter/s/contactsupport?language=en_US){:target="_blank”}.
13
9
14
10
11
+
## Getting started
15
12
16
13
1. From the Segment web app, click **Catalog**.
17
-
2. Search for "Podsights" in the Catalog, select it, and choose which of your sources to connect the destination to.
18
-
3. Visit your [Podsights dashboard](https://analytics.podsights.com){:target="_blank"} and navigate to Manage > Pixels. Copy your Pixel ID which will be your Segment "API Key".
19
-
4. Drop the Pixel ID in the "API Key" field in your Segment Settings UI.
20
-
14
+
2. Search for "Podsights", select it, and choose the source you'd like to connect.
15
+
3. Visit your [Podsights dashboard](https://analytics.podsights.com){:target="_blank"}, go to **Manage > Pixels**, then copy your Pixel ID. This is your Segment API Key.
16
+
4. Paste the Pixel ID into the **API Key** field in your Segment destination settings.
21
17
22
18
Once you start sending data to the Podsights' Destination it will take up to 20 minutes to appear in the Podsights pixel debugger.
23
19
24
20
## Page
25
21
26
-
If you're not familiar with the Segment Specs, take a look to understand what the [Page method](/docs/connections/spec/page/) does. An example call would look like:
22
+
If you're not familiar with the Segment Spec, take a look to understand what the [Page method](/docs/connections/spec/page/) does. An example call would look like:
27
23
28
24
```js
29
25
analytics.page()
30
26
```
31
27
32
-
Page calls will be sent to Podsights as a `view`event.
28
+
Segment sends Page events to Podsights as `view`events.
33
29
34
-
Podsights is an attribution platform, and as such, we need more context about the visitor than just a User ID. Analytics.js [automatically collects context fields](/docs/connections/spec/common/#context-fields-automatically-collected). Podsights requires certain context fields and properties for page calls. Below is an example of a raw JSON payload that contains the minimum requirements.
30
+
Podsights needs additional context for attribution, including certain fields inside the `context` and `properties` objects. Analytics.js [automatically collects these fields](/docs/connections/spec/common/#context-fields-automatically-collected), but you must provide them manually when sending events server-side.
35
31
36
-
```js
32
+
Here’s the minimum required structure for a Page call:
33
+
34
+
```json
37
35
{
38
36
"type": "page",
39
37
"context": {
@@ -49,14 +47,14 @@ Podsights is an attribution platform, and as such, we need more context about th
49
47
}
50
48
```
51
49
52
-
For page events Podsights requires a `context` object that contains a `userAgent` and an `ip` field and a `properties` object that contains a `referrer` and a `url` field.
53
-
As you can see in the page event's raw JSON payload above.
50
+
For page events, Podsights requires a `context` object that contains a `userAgent` and an `ip` field and a `properties` object that contains a `referrer` and a `url` field.
51
+
As you can see in the page event's raw JSON payload.
54
52
55
-
The `context` and `properties` object are required, along with the fields in them. If you're using Segment server-side you must send these attributes. Otherwise Podsights will return a `400 HTTP Error`.
53
+
If any of these requiredfields are missing (especially if you're sending events server-side), Podsights will return a `400` HTTP error.
56
54
57
55
## Track
58
56
59
-
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/connections/spec/track/) does. An example call would look like:
57
+
If you're not familiar with the Segment Spec, take a look to understand what the [Track method](/docs/connections/spec/track/) does. An example call would look like:
Track calls will be mapped to Podsights events. Podsights' support the following from the Segment Spec:
71
-
68
+
Track calls will be mapped to Podsights events. Podsights supports the following from the Segment Spec:
72
69
73
70
*[Signed Up](/docs/connections/spec/b2b-saas/#signed-up) as `lead`
74
71
*[Product Viewed](/docs/connections/spec/ecommerce/v2/#product-viewed) as `product`
75
72
*[Product Added](/docs/connections/spec/ecommerce/v2/#product-added) as `addtocart`
76
73
*[Checkout Started](/docs/connections/spec/ecommerce/v2/#checkout-started) as `checkout`
77
74
*[Order Completed](/docs/connections/spec/ecommerce/v2/#order-completed) as `purchase`
78
75
79
-
For track events Podsights requires a `context` object that contains a `userAgent` and an `ip` Podsights also requires a `page` object that contains a `referrer` and a `url` field.
80
-
Analytics.js [automatically collects context fields](/docs/connections/spec/common/#context-fields-automatically-collected). Podsights requires certain context fields for track calls. Below is an example of a raw JSON payload that contains the minimum requirements.
76
+
Track calls must include:
81
77
82
-
```js
78
+
- a `context` object with `userAgent` and `ip`
79
+
- a `context.page` object with `referrer` and `url`
80
+
81
+
These fields are required whether they're sent through Analytics.js or server-side. Here’s a minimum working example:
The `context` and `page` object are required, along with the fields in them. If you're using Segment server-side you must send these attributes. Otherwise Podsights will return a `400 HTTP Error`.
101
+
If you're using Segment server-side, you must send these attributes. Otherwise, Podsights will return a `400` HTTP error.
101
102
102
103
## Server
103
-
Podsights does not support server-side events out of the box, but you can send server-side events if you follow the requirements of page and track events outlined in the sections for each call.
104
+
Podsights doesn’t support server-side events by default. However, you can send server-side events as long as you include all the required context and page fields described in the Page and Track sections on this page.
0 commit comments