Skip to content

Commit 9a7af97

Browse files
authored
Merge pull request #7711 from segmentio/fix-podsights-destination-email
Update Podsights destination support email [SECOPS-15401]
2 parents e30efe0 + 6a25365 commit 9a7af97

File tree

1 file changed

+26
-25
lines changed
  • src/connections/destinations/catalog/podsights

1 file changed

+26
-25
lines changed

src/connections/destinations/catalog/podsights/index.md

Lines changed: 26 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -3,37 +3,35 @@ rewrite: true
33
title: Podsights Destination
44
id: 5d25eddde3ff660001b3adda
55
---
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.
127

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”}.
139

1410

11+
## Getting started
1512

1613
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.
2117

2218
Once you start sending data to the Podsights' Destination it will take up to 20 minutes to appear in the Podsights pixel debugger.
2319

2420
## Page
2521

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:
2723

2824
```js
2925
analytics.page()
3026
```
3127

32-
Page calls will be sent to Podsights as a `view` event.
28+
Segment sends Page events to Podsights as `view` events.
3329

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.
3531

36-
```js
32+
Here’s the minimum required structure for a Page call:
33+
34+
```json
3735
{
3836
"type": "page",
3937
"context": {
@@ -49,14 +47,14 @@ Podsights is an attribution platform, and as such, we need more context about th
4947
}
5048
```
5149

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.
5452

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 required fields are missing (especially if you're sending events server-side), Podsights will return a `400` HTTP error.
5654

5755
## Track
5856

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:
6058

6159
```js
6260
analytics.track('Order Completed', {
@@ -67,19 +65,22 @@ analytics.track('Order Completed', {
6765
});
6866
```
6967

70-
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:
7269

7370
* [Signed Up](/docs/connections/spec/b2b-saas/#signed-up) as `lead`
7471
* [Product Viewed](/docs/connections/spec/ecommerce/v2/#product-viewed) as `product`
7572
* [Product Added](/docs/connections/spec/ecommerce/v2/#product-added) as `addtocart`
7673
* [Checkout Started](/docs/connections/spec/ecommerce/v2/#checkout-started) as `checkout`
7774
* [Order Completed](/docs/connections/spec/ecommerce/v2/#order-completed) as `purchase`
7875

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:
8177

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:
82+
83+
```json
8384
{
8485
"type": "track",
8586
"context": {
@@ -97,7 +98,7 @@ Analytics.js [automatically collects context fields](/docs/connections/spec/comm
9798
}
9899
```
99100

100-
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.
101102

102103
## 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

Comments
 (0)