Skip to content

Commit f4d2072

Browse files
rvadera12rchinn1
andauthored
Apply suggestions from code review
Co-authored-by: rchinn-segment <[email protected]>
1 parent 75b26b1 commit f4d2072

File tree

1 file changed

+24
-25
lines changed
  • src/connections/destinations/catalog/actions-display-video-360

1 file changed

+24
-25
lines changed

src/connections/destinations/catalog/actions-display-video-360/index.md

Lines changed: 24 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Google's [Display & Video (DV360)](https://marketingplatform.google.com/about/di
1515
> info ""
1616
> **Note**: You can connect to a Google Ad Manager account. For more information, see [4. Create an audience and finish DV360 configuration](#4-create-an-audience-and-finish-dv360-configuration) below. When filling out the `User-Role Granted` selected `Publisher` if you place to connect to Google Ad Manager.
1717
18-
Segment's integration with DV360 enables Segment customers to sync audiences created in Engage with DV360 to enable centralized audience management and improved retargeting.
18+
Segment's integration with DV360 enables Segment customers to sync audiences created in Engage with DV360 for centralized audience management and improved retargeting.
1919

2020
> warning ""
2121
> You must meet certain implementation criteria to use the DV360 integration:
@@ -27,7 +27,8 @@ Segment's integration with DV360 enables Segment customers to sync audiences cre
2727
2828
## Details
2929

30-
> info Caution: for users detected to originate from US states with privacy restrictions, using a Google User ID to populate user lists is deprecated, and will be eventually sunset. It's recommended that bidders populate user lists with their hosted match data for these users.
30+
> info ""
31+
> For users detected to originate from US states with privacy restrictions, using a Google User ID to populate user lists is deprecated, and will be eventually sunset. It's recommended that bidders populate user lists with their hosted match data for these users.
3132
3233
- **Audience appears as**: An audience list with the name of your Engage Audience on the **DV360 All Audiences** screen
3334
- **Destination rate limit**: None
@@ -58,20 +59,20 @@ The Segment DV360 integration uses two components, the [DoubleClick Floodlight t
5859
Segment users must add this tag to their web properties. The tag performs several functions, but when enabled for the DV360 integration, it allows Segment to send information about users directly to Google client-side.
5960

6061
> info ""
61-
> **Note**: This component is required only if you want to sync audiences based on web traffic.
62+
> This component is required only if you want to sync audiences based on web traffic.
6263
6364
### DV360 destination
6465

65-
The DV360 destination syncs audience data between Segment and Google Display & Video 360. For more information about enabling the DV360 destination, see [Set up](#set-up) below.
66+
The DV360 destination syncs audience data between Segment and Google Display & Video 360. For more information about enabling the DV360 destination, [view the setup instructions below](#set-up) below.
6667

67-
## Set up
68+
## Setup
6869

69-
Configuring this integration requires action by both you in your Segment workspace, and Google in your Google Marketing Platform account. As a result, the time required to finish configuration and set up can vary.
70+
Configuring this integration requires action by both you in your Segment workspace, and Google in your Google Marketing Platform account. As a result, the time required to finish configuration and setup can vary.
7071

7172
### Configure client integration for web traffic
7273

7374
> info ""
74-
> **Note**: This step is necessary only if you want to use Google User IDs to build audiences based on website traffic. If you plan to use mobile identifiers only, continue to [Enable and configure the DV360 destination](enable-and-configure-the-dv360-destination).
75+
> This step is necessary only if you want to use Google User IDs to build audiences based on website traffic. If you plan to use mobile identifiers only, continue to [Enable and configure the DV360 destination](enable-and-configure-the-dv360-destination).
7576
7677
Segment requires the [DoubleClick Floodlight](/docs/connections/destinations/catalog/doubleclick-floodlight/) tag on your website to enable the creation of audiences based on website traffic. This allows Segment to send Google the appropriate identifier (typically `anonymousId`) for users that are in an audience. Google stores these identifiers on its servers and matches them against `google_id`.
7778

@@ -81,18 +82,18 @@ To configure DoubleClick Floodlight:
8182
> **Prerequisite**: Create a [JavaScript Website](/docs/connections/sources/catalog/libraries/website/javascript/) source in your Segment workspace if one does not exist. Ensure that this source is configured to track visitors to your website. For more information about configuring Javascript sources, see the [Analytics.js Quickstart guide](/docs/connections/sources/catalog/libraries/website/javascript/quickstart/).
8283
8384
1. In your workspace, visit the **Catalog** and search for the **DoubleClick Floodlight** destination.
84-
2. Connect your JavaScript Website source to the DoubleClick Floodlight destination, and configure the following settings:
85+
2. Connect your JavaScript website source to the DoubleClick Floodlight destination, and configure the following settings:
8586
1. **Get DoubleClickID**: `On`
8687
2. **Google Network Id**: `segment`
87-
3. Your [Segment Write Key](/docs/connections/find-writekey/). You can retrieve your write key from the Settings tab on the Source.
88+
3. Your [Segment Write Key](/docs/connections/find-writekey/). You can retrieve your write key from the Settings tab in the source.
8889
4. **DoubleClick Advertiser ID**
8990
- If you use DoubleClick Floodlight for DV360 only, enter `DV360`.
9091
- If you use DoubleClick Floodlight for other use cases in addition to DV360, enter the Advertiser ID from your Doubleclick Floodlight account.
9192
3. Switch the toggle to enable the destination.
9293

9394
### Enable and configure the DV360 destination
9495

95-
1. From your Segment workspace, go to **Engage Engage Settings DestinationsAdd Destination** and then Search **Display and Video 360 (Actions)**.
96+
1. From your Segment workspace, navigate to **Engage > Engage Settings > Destinations > Add Destination**, then search for **Display and Video 360 (Actions)**.
9697
2. Authenticate using OAuth.
9798
3. Switch the toggle to enable the destination.
9899
4. Navigate to the **Mappings** tab, click **Add Mapping** and select **Add to Audience**.
@@ -101,38 +102,36 @@ To configure DoubleClick Floodlight:
101102
7. Click **Save** and make sure you enable the mapping.
102103

103104
> info ""
104-
> **Note**: The destination does not have configurable settings until you create an audience, described [here](#create-an-audience-and-finish-dv360-configuration)
105+
> The destination does not have configurable settings until you create an audience, described [here](#create-an-audience-and-finish-dv360-configuration).
105106
106107
### Create an audience and finish DV360 configuration
107108

108-
Create an [Audience](/docs/personas/audiences) in a new or existing Engage space. After you create the audience, you can select the Display & Video 360 (Actions) destination you created before.
109+
[Create an audience](/docs/personas/audiences) in a new or existing Engage space. After you create the audience, you can select the Display & Video 360 (Actions) destination you created before.
109110

110111
> info ""
111-
> **Note**: These settings are tied to a single audience. Each additional audience you send to DV360 requires you to input these values.
112+
> These settings are tied to a single audience. Each additional audience you send to DV360 requires you to input these values.
112113
113114
When you select the destination, you're prompted to complete the destination settings:
114115

115116
| Setting | Description |
116117
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
117118
| Account Type | The type of DV360 account used to sync. Either `Advertiser`, `Partner`, or `Publisher`. **Note:** Select `Publisher` only if you plan to connect to Google Ad Manager. |
118-
| Advertiser ID | The ID of your DV360 Advertiser account. Can be found in your Google Account under Advertiser Settings Basic Details Advertiser ID. {:target="_blank"}. |
119+
| Advertiser ID | The ID of your DV360 Advertiser account. Can be found in your Google Account under **Advertiser Settings > Basic Details > Advertiser ID**. |
119120

120121
Also toggle on the Send Track setting.
121122

122-
> info ""
123123

124124
After you complete the set up process, allow up to 24 hours for Google to create the new audience list. Once the list is created, Segment can begin to sync users to that list. Google may require additional time to process the initial audience additions. The entire first sync to DV360 may require 24-48 hours to complete. As a result, the first few audience syncs after you create the audience may fail.
125125

126-
Extra information from the API (settings, connection modes, etc.) are automatically pulled in here.
127126
{% include content/sync-frequency-note.md %}
128127

129128
## Migrate from Personas Google Display & Video 360 Destination
130129

131130
Segment will copy all of your existing Personas Display & Video 360 Destination configurations to Display and Video 360 (Actions). Once the migration is completed , you will be notified by email.
132131

133-
The sole mandatory action involves **re-authenticating** for each migrated Personans Display & Video 360 Destination. While you may already possess OAuth credentials, it is essential to undergo reauthentication. This step is necessary to seamlessly integrate new audiences or implement updates to existing ones.
132+
The sole mandatory action involves **re-authenticating** for each migrated Personans Display & Video 360 destination. While you may already possess OAuth credentials, it is essential to undergo reauthentication. This step is necessary to seamlessly integrate new audiences or implement updates to existing ones.
134133

135-
We are disabling all existing Personas Display and Video 360 destinations. You can still access your existing configuration, but please refrain from enabling the destination, as it is set to be deprecated. You will no longer be able to create new instances of Personas Display and Video 360.
134+
Segment is disabling all existing Personas Display and Video 360 destinations. You can still access your existing configuration, but please refrain from enabling the destination, as it is set to be deprecated. You will no longer be able to create new instances of Personas Display and Video 360.
136135

137136
<img width="799" alt="image" src="https://github.com/segmentio/segment-docs/assets/89420099/37022665-a39e-4696-a23a-97bcafd9cecf">
138137

@@ -153,7 +152,7 @@ When you complete the connection between Segment and DV360, it can take from 24
153152
Google's [documentation](https://developers.google.com/authorized-buyers/rtb/downloads/cookie-bulk-upload-proto){:target="_blank"} provides information about the accepted identifiers for this integration.
154153

155154

156-
- To use DV360 with web traffic, you must collect `anonymous_id` through the client-side `analytics.js` Source.
155+
- To use DV360 with web traffic, you must collect `anonymous_id` through the client-side `analytics.js` source.
157156
- To use DV360 with mobile traffic, you must collect `IDFA`s through Segment's mobile sources.
158157

159158

@@ -173,25 +172,25 @@ As a result, you must have Doubleclick Floodlight and the DV360 integration in p
173172

174173
To help reduce the difference between Engage and DV360 audience sizes, Segment recommends that you deselect the `Historical Backfill` option when you create the audience that syncs to DV360.
175174

176-
#### Impact to third-party cookies: Browser Policies
175+
#### Impact to third-party cookies: browser policies
177176

178177
The DV360 integration for web traffic relies on Doubleclick Floodlight, which itself relies on a `google_user_id` cookie. While this cookie is “yours”, browsers treat this as a third-party cookie because it is served from Google's servers, and not the same domain as your website. As browsers become more privacy-oriented, they block third-party cookies by default.
179178

180179
Users who visit your website in Firefox and Safari, and who do not specifically allow third-party cookies, are not identifiable by Doubleclick Floodlight (`google_user_id`). This prevents Google from identifying a match between an `anon_id` sent from Segment, and results in lower match rates.
181180

182-
#### Impact to third-party cookies: Adblockers
181+
#### Impact to third-party cookies: adblockers
183182

184183
All browser-based adblocking software intentionally blocks most third-party cookies, including the Doubleclick Floodlight cookie necessary for identification. As a result, Google cannot match users who employ adblocking software in their browsers.
185184

186-
#### IDFA impact: Recent Apple announcements
185+
#### IDFA impact: recent Apple announcements
187186

188187
Apple has announced an updated privacy policy that, while not rolled out yet, impacts the way businesses collect IDFA data. When enacted, this privacy policy will significantly reduce the percentage of users for which IDFA data is collected. This change will result in lower match rates, as both Segment and Google will see a decline in the number of IDFA values sent by Segment, and matched by Google.
189188

190189
#### Invalid Google IDs
191190

192191
Sometimes, Google denies IDFA or `google_user_id` values when they consider them to be invalid or inactive.
193192

194-
#### Modifying Lists Configuration in DV360
193+
#### Modifying list configuration in DV360
195194

196195
Any changes to a DV360 list's configuration (for example, modifying the membership expiration from 540 days to a value that matches the time window on the audience) is **very risky** and **will likely** cause mismatches between Engage audiences and the lists in Google. Segment ensures that the integration works successfully only if there are no changes made to the configurations in DV360. DV360 lists are created with parameters that are known to be compatible with Engage. Configurations that differ from Segment's can cause mismatches by removing more users than intended, or by not accepting valid uploads.
197196

@@ -206,7 +205,7 @@ Engage syncs every IDFA or `anonymous_id` value for each user in an audience. Wh
206205
The most common cause of matches not appearing in DV360 is an error with Doubleclick Floodlight. From the website where tracking is enabled, open the Network inspector, and confirm that outgoing requests to `idsync.segment.com` appear.
207206

208207

209-
### How does third-party cookie eradication impact the DV360 Destination?
208+
### How does third-party cookie eradication impact the DV360 destination?
210209

211210
Google Chrome has committed to replacing third-party cookies with an alternative, but has not announced a timeframe for that alternative. Segment will not update this integration until these updates from Google are announced.
212211

@@ -217,7 +216,7 @@ No. YouTube (through DV360) does not support the type of lists that Segment prov
217216

218217
### Why do I see destination settings after I add my audience, but not when I first enable the destination?
219218

220-
The DV360 Destination works on a per-audience basis. This enables you to:
219+
The DV360 destination works on a per-audience basis. This enables you to:
221220

222221
- Send data from different audiences to different DV360 accounts.
223222
- Send data to Google Ad Manager with the same destination.

0 commit comments

Comments
 (0)