From 8981b12cc8b8a5e9a070eafc0a62bdca1511c90f Mon Sep 17 00:00:00 2001 From: Varadarajan V <109586712+varadarajan-tw@users.noreply.github.com> Date: Wed, 30 Apr 2025 13:15:22 +0530 Subject: [PATCH 1/4] [Bing Ads] Add consent mode instructions --- .../destinations/catalog/bing-ads/index.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/src/connections/destinations/catalog/bing-ads/index.md b/src/connections/destinations/catalog/bing-ads/index.md index 96980cb2a5..8050a2474b 100644 --- a/src/connections/destinations/catalog/bing-ads/index.md +++ b/src/connections/destinations/catalog/bing-ads/index.md @@ -98,6 +98,18 @@ analytics.track('Order Completed', { | Category | `category` property | | Action | Always set to `track` | +## Implementing consent mode + +Starting May 5, 2025, Microsoft is enforcing consent mode for clients with end users in European Economic Area (EEA), the United Kingdom, and Switzerland. To learn more about setting consent mode and FAQ, refer Microsoft docs [here](https://help.ads.microsoft.com/?FromAdsEmail=1#apex/ads/en/60341/1). Microsoft currently is enforcing only the `ad_storage` consent signal [docs](https://help.ads.microsoft.com/?FromAdsEmail=1#apex/ads/en/60341/1/#exp46). + +To send these consent signals via Microsoft Bing Ads destination: + +1. Navigate to **Settings** page of the destination. +2. Turn on the `Enable Consent` mode setting. If not turned on, Microsoft Bing Ads destination won't send consent signal. +3. Select `ALLOWED` or `DENIED` as the `Default Ads Storage Consent State`. This will be the default consent signal state when the page loads. You can then toggle consent state by passing consent signals via track event. +4. If you are a Segment [Consent Management](https://segment.com/docs/privacy/consent-management/) user, specify the consent category to lookup `ad_storage` consent state using the `Ad Storage Consent Category` setting. +5. If you are not a Segment consent management user, specify the properties field through which you want toggle consent setting with in `Ad Storage Consent Property Mapping` setting. For example, if you wish to toggle `ad_storage` consent state based `properties.ad_storage`, set the value to `ad_storage` and make sure you are `properties.ad_storage` in your track event is set to `granted` or `denied`. + ## Troubleshooting From cef0ebdac59a947f30a42290a76997575075e3cd Mon Sep 17 00:00:00 2001 From: Varadarajan V <109586712+varadarajan-tw@users.noreply.github.com> Date: Wed, 30 Apr 2025 17:41:38 +0530 Subject: [PATCH 2/4] mention that page event is also supported --- src/connections/destinations/catalog/bing-ads/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/connections/destinations/catalog/bing-ads/index.md b/src/connections/destinations/catalog/bing-ads/index.md index 8050a2474b..a2921a2d46 100644 --- a/src/connections/destinations/catalog/bing-ads/index.md +++ b/src/connections/destinations/catalog/bing-ads/index.md @@ -106,9 +106,9 @@ To send these consent signals via Microsoft Bing Ads destination: 1. Navigate to **Settings** page of the destination. 2. Turn on the `Enable Consent` mode setting. If not turned on, Microsoft Bing Ads destination won't send consent signal. -3. Select `ALLOWED` or `DENIED` as the `Default Ads Storage Consent State`. This will be the default consent signal state when the page loads. You can then toggle consent state by passing consent signals via track event. +3. Select `ALLOWED` or `DENIED` as the `Default Ads Storage Consent State`. This will be the default consent signal state when the page loads. You can then toggle consent state by passing consent signals via track or page event. 4. If you are a Segment [Consent Management](https://segment.com/docs/privacy/consent-management/) user, specify the consent category to lookup `ad_storage` consent state using the `Ad Storage Consent Category` setting. -5. If you are not a Segment consent management user, specify the properties field through which you want toggle consent setting with in `Ad Storage Consent Property Mapping` setting. For example, if you wish to toggle `ad_storage` consent state based `properties.ad_storage`, set the value to `ad_storage` and make sure you are `properties.ad_storage` in your track event is set to `granted` or `denied`. +5. If you are not a Segment consent management user, specify the properties field through which you want toggle consent setting with in `Ad Storage Consent Property Mapping` setting. For example, if you wish to toggle `ad_storage` consent state based `properties.ad_storage`, set the value to `ad_storage` and make sure you are `properties.ad_storage` in your track or page event is set to `granted` or `denied`. ## Troubleshooting From 810a7e82c0ac9decfd0d8c2c781c9a25cca14090 Mon Sep 17 00:00:00 2001 From: Varadarajan V <109586712+varadarajan-tw@users.noreply.github.com> Date: Thu, 1 May 2025 14:45:15 +0530 Subject: [PATCH 3/4] Apply suggestions from code review Co-authored-by: stayseesong <83784848+stayseesong@users.noreply.github.com> --- .../destinations/catalog/bing-ads/index.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/src/connections/destinations/catalog/bing-ads/index.md b/src/connections/destinations/catalog/bing-ads/index.md index a2921a2d46..3fa6c44888 100644 --- a/src/connections/destinations/catalog/bing-ads/index.md +++ b/src/connections/destinations/catalog/bing-ads/index.md @@ -98,17 +98,18 @@ analytics.track('Order Completed', { | Category | `category` property | | Action | Always set to `track` | -## Implementing consent mode +## Consent mode -Starting May 5, 2025, Microsoft is enforcing consent mode for clients with end users in European Economic Area (EEA), the United Kingdom, and Switzerland. To learn more about setting consent mode and FAQ, refer Microsoft docs [here](https://help.ads.microsoft.com/?FromAdsEmail=1#apex/ads/en/60341/1). Microsoft currently is enforcing only the `ad_storage` consent signal [docs](https://help.ads.microsoft.com/?FromAdsEmail=1#apex/ads/en/60341/1/#exp46). +Starting May 5, 2025, Microsoft is enforcing the use of consent mode for clients with end users in the European Economic Area (EEA), the United Kingdom, and Switzerland. To learn more about setting consent mode, refer to the [Microsoft docs](https://help.ads.microsoft.com/?FromAdsEmail=1#apex/ads/en/60341/1){:target="_blank"}. Microsoft is currently only enforcing the [`ad_storage` value](https://help.ads.microsoft.com/?FromAdsEmail=1#apex/ads/en/60341/1/#exp46){:target="_blank"}. -To send these consent signals via Microsoft Bing Ads destination: +To send consent signals using the Microsoft Bing Ads destination: -1. Navigate to **Settings** page of the destination. -2. Turn on the `Enable Consent` mode setting. If not turned on, Microsoft Bing Ads destination won't send consent signal. -3. Select `ALLOWED` or `DENIED` as the `Default Ads Storage Consent State`. This will be the default consent signal state when the page loads. You can then toggle consent state by passing consent signals via track or page event. -4. If you are a Segment [Consent Management](https://segment.com/docs/privacy/consent-management/) user, specify the consent category to lookup `ad_storage` consent state using the `Ad Storage Consent Category` setting. -5. If you are not a Segment consent management user, specify the properties field through which you want toggle consent setting with in `Ad Storage Consent Property Mapping` setting. For example, if you wish to toggle `ad_storage` consent state based `properties.ad_storage`, set the value to `ad_storage` and make sure you are `properties.ad_storage` in your track or page event is set to `granted` or `denied`. +1. Navigate to **Connections > Destinations** and select the Microsoft Bing Ads destination. +2. Select the **Settings** tab for the destination. +3. Turn on the **Enable Consent** mode setting. If it is turned off, the Microsoft Bing Ads destination won't send the consent signal. +4. Select **ALLOWED** or **DENIED** as the **Default Ads Storage Consent State**. This will be the default consent signal state when the page loads. You can toggle the consent state by passing consent signals using the Track or Page event. +5. If you're using Segment [Consent Management](/docs/privacy/consent-management/), specify the consent category to look up the `ad_storage` consent state using the **Ad Storage Consent Category** setting. +6. If you're not a Segment consent management user, specify the properties field through which you want to toggle the consent setting with the `Ad Storage Consent Property Mapping` setting. For example, if you wish to toggle `ad_storage` consent state based `properties.ad_storage`, set the value to `ad_storage` and make sure the `properties.ad_storage` in your track or page event is set to `granted` or `denied`. ## Troubleshooting From a0a8a9f08acf706d698c6d965022ed2a60c64f56 Mon Sep 17 00:00:00 2001 From: stayseesong <83784848+stayseesong@users.noreply.github.com> Date: Thu, 1 May 2025 10:54:11 -0700 Subject: [PATCH 4/4] Update index.md --- src/connections/destinations/catalog/bing-ads/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/connections/destinations/catalog/bing-ads/index.md b/src/connections/destinations/catalog/bing-ads/index.md index 3fa6c44888..539d2a7381 100644 --- a/src/connections/destinations/catalog/bing-ads/index.md +++ b/src/connections/destinations/catalog/bing-ads/index.md @@ -106,7 +106,7 @@ To send consent signals using the Microsoft Bing Ads destination: 1. Navigate to **Connections > Destinations** and select the Microsoft Bing Ads destination. 2. Select the **Settings** tab for the destination. -3. Turn on the **Enable Consent** mode setting. If it is turned off, the Microsoft Bing Ads destination won't send the consent signal. +3. Turn on the **Enable Consent** setting. If it is turned off, the Microsoft Bing Ads destination won't send the consent signal. 4. Select **ALLOWED** or **DENIED** as the **Default Ads Storage Consent State**. This will be the default consent signal state when the page loads. You can toggle the consent state by passing consent signals using the Track or Page event. 5. If you're using Segment [Consent Management](/docs/privacy/consent-management/), specify the consent category to look up the `ad_storage` consent state using the **Ad Storage Consent Category** setting. 6. If you're not a Segment consent management user, specify the properties field through which you want to toggle the consent setting with the `Ad Storage Consent Property Mapping` setting. For example, if you wish to toggle `ad_storage` consent state based `properties.ad_storage`, set the value to `ad_storage` and make sure the `properties.ad_storage` in your track or page event is set to `granted` or `denied`.