diff --git a/src/_data/catalog/destinations_private.yml b/src/_data/catalog/destinations_private.yml index 9b3c3fcf77..c4dadc6229 100644 --- a/src/_data/catalog/destinations_private.yml +++ b/src/_data/catalog/destinations_private.yml @@ -1,5 +1,5 @@ # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT -# destination data last updated 2024-10-29 +# destination data last updated 2024-10-31 items: - id: 54521fd925e721e32a72eee1 display_name: Pardot @@ -799,3 +799,544 @@ items: '@path': $.traits enable_batching: true trigger: type = "track" or type = "identify" + - id: 6683e1d5e37fd84efcf3bbef + display_name: First Party Dv360 + name: First Party Dv360 + slug: first-party-dv360 + previous_names: + - First Party Dv360 + url: connections/destinations/catalog/first-party-dv360 + website: http://www.segment.com + status: PRIVATE_BUILDING + logo: + url: >- + https://cdn-devcenter.segment.com/da053d87-a568-4bae-827f-857f7f4b2aba.svg + mark: + url: >- + https://cdn-devcenter.segment.com/31811060-3f10-46b0-94de-bf299beb94a4.svg + methods: + track: true + identify: false + group: false + alias: false + screen: false + page: false + platforms: + browser: true + mobile: false + server: true + warehouse: false + cloudAppObject: false + components: [] + browserUnbundlingSupported: false + browserUnbundlingPublic: false + replay: false + settings: [] + actions: + - id: pMRu4ozQwh3SzjYycCzDfn + name: Add to List + slug: addToList + description: Adds to list + platform: CLOUD + hidden: false + defaultTrigger: null + fields: [] + - id: kjEdc2dNCshXomx9VDnp9 + name: Remove Customer Match Members - Mobile Device Id List + slug: removeFromAudMobileDeviceId + description: >- + Remove customer match members in Google Display & Video 360 Mobile + Device Id List Audience. + platform: CLOUD + hidden: false + defaultTrigger: event = "Audience Entered" + fields: + - id: dRiii61cWqivpbMNjxGUKL + sortOrder: 0 + fieldKey: mobileDeviceIds + label: Mobile Device IDs + type: STRING + description: >- + A list of mobile device IDs defining Customer Match audience + members. The size of mobileDeviceIds mustn't be greater than + 500,000. + placeholder: '' + defaultValue: + '@path': $.context.traits.mobileDeviceIds + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: ppDfvVSHs3wpC3Ycoh2gUu + sortOrder: 1 + fieldKey: external_id + label: External ID + type: STRING + description: The ID of the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.external_audience_id + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: 6w8gbwpX2zANVtazbjtfMc + sortOrder: 2 + fieldKey: advertiser_id + label: Advertiser ID + type: STRING + description: The Advertiser ID associated with the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.audience_settings.advertiserId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: 81favwMqHXmAecMuLmXGo6 + sortOrder: 3 + fieldKey: enable_batching + label: Enable Batching + type: BOOLEAN + description: Enable batching of requests. + placeholder: '' + defaultValue: true + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: tuBG56koj3PdEWoMt7j8Xv + sortOrder: 4 + fieldKey: batch_size + label: Batch Size + type: NUMBER + description: >- + Maximum number of events to include in each batch. Actual batch + sizes may be lower. + placeholder: '' + defaultValue: 500000 + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: texVBBbJ5ZvG5eBR49wLoL + name: Edit Customer Match Members - Mobile Device Id List + slug: addToAudMobileDeviceId + description: >- + Add or update customer match members in Google Display & Video 360 + Mobile Device Id List Audience. + platform: CLOUD + hidden: false + defaultTrigger: event = "Audience Entered" + fields: + - id: 8hSAZXT5u7knkEUGKLpe8A + sortOrder: 0 + fieldKey: mobileDeviceIds + label: Mobile Device IDs + type: STRING + description: >- + A list of mobile device IDs defining Customer Match audience + members. The size of mobileDeviceIds mustn't be greater than + 500,000. + placeholder: '' + defaultValue: + '@path': $.context.traits.mobileDeviceIds + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 2KfCTSk2bzm1Br7DZ5d9jM + sortOrder: 1 + fieldKey: external_id + label: External ID + type: STRING + description: The ID of the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.external_audience_id + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: 9ecWScNV2vuWrFNgfoHf1 + sortOrder: 2 + fieldKey: advertiser_id + label: Advertiser ID + type: STRING + description: The Advertiser ID associated with the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.audience_settings.advertiserId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: gpaqTHscj6acVK5x12WsMV + sortOrder: 3 + fieldKey: enable_batching + label: Enable Batching + type: BOOLEAN + description: Enable batching of requests. + placeholder: '' + defaultValue: true + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: 4p4wD9VF3j7GSp3TvBMLHB + sortOrder: 4 + fieldKey: batch_size + label: Batch Size + type: NUMBER + description: >- + Maximum number of events to include in each batch. Actual batch + sizes may be lower. + placeholder: '' + defaultValue: 500000 + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: u4XdrL4XCgThQLiwKZKC7e + name: Edit Customer Match Members - Contact Info List + slug: addToAudContactInfo + description: >- + Add or update customer match members in Google Display & Video 360 + Contact Info List Audience. + platform: CLOUD + hidden: false + defaultTrigger: event = "Audience Entered" + fields: + - id: 8Ry596bd6tBhdH2ErcXZUS + sortOrder: 0 + fieldKey: emails + label: Emails + type: STRING + description: >- + A list of the user's emails. If not already hashed, the system + will hash them before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.emails + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: zCC3pVDww1k3bwsYeU3ak + sortOrder: 1 + fieldKey: phoneNumbers + label: Phone Numbers + type: STRING + description: >- + A list of the user's phone numbers. If not already hashed, the + system will hash them before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.phoneNumbers + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 9JQTx74mEBTAMwcUjfKo93 + sortOrder: 2 + fieldKey: zipCodes + label: ZIP Codes + type: STRING + description: A list of the user's zip codes. + placeholder: '' + defaultValue: + '@path': $.context.traits.zipCodes + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: qPeGF7HX6EhNJpQoRwNmnN + sortOrder: 3 + fieldKey: firstName + label: First Name + type: STRING + description: >- + The user's first name. If not already hashed, the system will hash + it before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.firstName + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 2NGtbSMELmDoTmdQGWb8jH + sortOrder: 4 + fieldKey: lastName + label: Last Name + type: STRING + description: >- + The user's last name. If not already hashed, the system will hash + it before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.lastName + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: w8BbkKZShNdnyc2uASpB4Z + sortOrder: 5 + fieldKey: countryCode + label: Country Code + type: STRING + description: The country code of the user. + placeholder: '' + defaultValue: + '@path': $.context.traits..countryCode + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: wA4Syt8pYqUASr9cAQEWvA + sortOrder: 6 + fieldKey: external_id + label: External ID + type: STRING + description: The ID of the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.external_audience_id + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: hqpDxsMA2C4r8TdNiyaGtM + sortOrder: 7 + fieldKey: advertiser_id + label: Advertiser ID + type: STRING + description: The Advertiser ID associated with the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.audience_settings.advertiserId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: v3qUWULxzJDrdjTUgSpigZ + sortOrder: 8 + fieldKey: enable_batching + label: Enable Batching + type: BOOLEAN + description: Enable batching of requests. + placeholder: '' + defaultValue: true + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: ndYdVUnqzCJfyzoVPKay9F + sortOrder: 9 + fieldKey: batch_size + label: Batch Size + type: NUMBER + description: >- + Maximum number of events to include in each batch. Actual batch + sizes may be lower. + placeholder: '' + defaultValue: 500000 + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: vykfWPGTjXpdHZiaaSUYRC + name: Remove Customer Match Members - Contact Info List + slug: removeFromAudContactInfo + description: >- + Remove customer match members in Google Display & Video 360 Contact + Info List Audience. + platform: CLOUD + hidden: false + defaultTrigger: event = "Audience Exited" + fields: + - id: eEkzo7KFjZZ5SY6MYsGNsa + sortOrder: 0 + fieldKey: emails + label: Emails + type: STRING + description: >- + A list of the user's emails. If not already hashed, the system + will hash them before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.emails + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: umefzMMP12tpbD2oopGbPv + sortOrder: 1 + fieldKey: phoneNumbers + label: Phone Numbers + type: STRING + description: >- + A list of the user's phone numbers. If not already hashed, the + system will hash them before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.phoneNumbers + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 3sx6yoo2rwgRPCB5WYDZCb + sortOrder: 2 + fieldKey: zipCodes + label: ZIP Codes + type: STRING + description: A list of the user's zip codes. + placeholder: '' + defaultValue: + '@path': $.context.traits.zipCodes + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: jeiJHUQawC7xqWmAnxJp3Z + sortOrder: 3 + fieldKey: firstName + label: First Name + type: STRING + description: >- + The user's first name. If not already hashed, the system will hash + it before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.firstName + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: 9KEVS8t6JhY8474QVZcKiF + sortOrder: 4 + fieldKey: lastName + label: Last Name + type: STRING + description: >- + The user's last name. If not already hashed, the system will hash + it before use. + placeholder: '' + defaultValue: + '@path': $.context.traits.lastName + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: kUE2RG2AqX2LGqcykzFbUU + sortOrder: 5 + fieldKey: countryCode + label: Country Code + type: STRING + description: The country code of the user. + placeholder: '' + defaultValue: + '@path': $.context.traits..countryCode + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + - id: xfEU7m8dxHehcuUBoLj7SS + sortOrder: 6 + fieldKey: external_id + label: External ID + type: STRING + description: The ID of the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.external_audience_id + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: o4hCVmsRy2dkqCxAvYk2ZX + sortOrder: 7 + fieldKey: advertiser_id + label: Advertiser ID + type: STRING + description: The Advertiser ID associated with the DV360 Audience. + placeholder: '' + defaultValue: + '@path': $.context.personas.audience_settings.advertiserId + required: false + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: mYacAw9gXNbCxHdS5JioJF + sortOrder: 8 + fieldKey: enable_batching + label: Enable Batching + type: BOOLEAN + description: Enable batching of requests. + placeholder: '' + defaultValue: true + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + - id: 4yLRfKRg9qcv6JR87whu9H + sortOrder: 9 + fieldKey: batch_size + label: Batch Size + type: NUMBER + description: >- + Maximum number of events to include in each batch. Actual batch + sizes may be lower. + placeholder: '' + defaultValue: 500000 + required: true + multiple: false + choices: null + dynamic: false + allowNull: false + hidden: true + presets: [] diff --git a/src/_data/sidenav/strat.yml b/src/_data/sidenav/strat.yml index 9fc64cf428..51d8852447 100644 --- a/src/_data/sidenav/strat.yml +++ b/src/_data/sidenav/strat.yml @@ -77,6 +77,8 @@ sections: title: Google Ads Remarketing Lists destination (Personas) - path: /connections/destinations/catalog/actions-display-video-360 title: Display and Video 360 (Actions) Destination + - path: /connections/destinations/catalog/actions-first-party-dv360 + title: First Party Display and Video 360 (Actions) Destination - slug: salesforce diff --git a/src/connections/destinations/catalog/actions-first-party-dv360/index.md b/src/connections/destinations/catalog/actions-first-party-dv360/index.md new file mode 100644 index 0000000000..446d7efd16 --- /dev/null +++ b/src/connections/destinations/catalog/actions-first-party-dv360/index.md @@ -0,0 +1,78 @@ +--- +title: First Party Display and Video 360 (Actions) Destination +strat: google +hide-settings: true +id: 6683e1d5e37fd84efcf3bbef +engage: true +--- + +Google’s [Display & Video (DV360)](https://marketingplatform.google.com/about/display-video-360/){:target="_blank"} is an end-to-end campaign management tool that enables enterprise customers to plan, measure, and run display and video advertisements. Segment’s integration with DV360 enables Segment customers to sync audiences created in Engage with DV360 for centralized audience management and improved retargeting. + +This destination is different from the existing DV360 Actions as it allows you to upload [contact info](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfo){:target="_blank"} and the [mobile device ID](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#mobiledeviceidlist){:target="_blank"}. + +This destination can only be used with Engage. + +## Setup +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. + +### Enable the destination + +To enable the First Party DV 360 destionation: +1. Navigate to **Engage > Engage Settings > Destinations > Add Destination** in your Segment workspace. +2. Search for *First Party DV360* and click **Add destination**. +3. Navigate to **Connections > Destinations** and search for the **First Party DV 360** destination you created. +4. Select the **Mappings** tab and click **+ New Mapping**. +5. Select the action you'd like to use. You can choose from: + + Option | Details + ------ | -------- + Edit Customer Match Members - Contact Info List | Add or update customer match members in Contact Info List Audience. + Edit Customer Match Members - Mobile Device Id List | Add or update customer match members in Mobile Device Id List Audience. + Remove Customer Match Members - Contact Info List | Remove customer match members from the Contact Info List Audience. + Remove Customer Match Members - Mobile Device Id List | Remove customer match members from the Mobile Device Id List Audience. + + * Select either **Customer Info List** or **Mobile Device Id List** depending on what audience type you use. + * Select **Edit Customer Match Members** to add or update users to an audience. + * Select **Remove Customer Match Members** to remove users from an audience. + * If you want to create actions for both Customer Info List and Mobile Device Id List, you can create all 4 mappings. +6. Switch the toggle to enable the destination. + + +### Create an audience + +To create an audience in your destination: +1. Navigate to **Engage > Audiences** and click **+New audience**. +2. Fill out the audience seetings. + * If you want to use Mobile Device ID Lists, ensure to fill out your app ID. + * Make sure you enabled track calls. +3. Click **Save**. +4. You should see an audience populate in your DV360 account. If you don't immediately see this, it can take up to a couple of hours for your audience to populate. +5. Switch the toggle to **Connect to destination**. +6. Navigate to **Connections > Destinations** and select the First Party DV360 destination. +7. Select the **Mappings** tab. +8. Click **+ New Mapping** and select **Remove from Audience**. +9. Click **Save**. +10. Enable the mapping. + +## Consent mode +[Consent mode](https://support.google.com/analytics/answer/9976101?hl=en){:target="_blank"} is a feature provided by Google in the context of its products, particularly the Gtag library and Google Analytics. As of March 6, 2024, Google announced that consent mode must function for European Economic Area (EEA) users, otherwise data from EEA users won't process. + +Consent mode in the Gtag library and Google Analytics is designed to help website owners comply with privacy regulations, such as the General Data Protection Regulation (GDPR) in the European Union. It allows website owners to adjust how these tools use and collect data based on user consent. + +With consent mode, you can configure your website to dynamically adjust the tracking behavior of the Gtag library and Google Analytics based on the user's consent status. If a user provides consent to data processing, both the Gtag library and Google Analytics can collect and use that data for analysis. If a user doesn't provide consent, both tools limit data collection to essential functions, helping businesses respect user privacy preferences. + +Segment automatically sends consent as `TRUE` for this destination. Segment uses the [bulk-uploader workflow](https://developers.google.com/authorized-buyers/rtb/bulk-uploader#workflow){:target="_blank"} which requires consented data. Ensure all audiences and journeys are connected to consented audiences. + +{% include components/actions-fields.html %} + +## Data requirements +Based on Google’s documentation, make sure you send the correct required identifiers: +* [Contact info list requirements](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#contactinfo){:target="_blank"} + * For example, you must send first name, last name, ZIP code, and country code all together and not just one. Make sure all phone numbers are in [E.164 format](https://en.wikipedia.org/wiki/E.164){:target="_blank"}. +* [Mobile ID Requirements](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#mobiledeviceidlist){:target="_blank"} + + +## FAQs + +#### When will my data appear in DV360? +When you complete the connection between Segment and DV360, it can take from 24 to 48 hours for Google to create the user list. This must complete before Segment can begin to sync users into that list.