From db8f3bb16f1bf76d3d5fcb8fddb7a2dd7ba4796a Mon Sep 17 00:00:00 2001
From: G15N <ggammelin@adagio.io>
Date: Fri, 17 Feb 2023 09:55:25 +0100
Subject: [PATCH] Adagio: add user-sync config recommends

---
 dev-docs/bidders/adagio.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md
index d3a19b3ef5..7f44a91b36 100644
--- a/dev-docs/bidders/adagio.md
+++ b/dev-docs/bidders/adagio.md
@@ -21,6 +21,26 @@ sidebarType: 1
 
 The Adagio bidder adapter requires setup and approval from the Adagio team. Please reach out to [contact@adagio.io](mailto:contact@adagio.io) for more information.
 
+### Configuration
+
+#### User Sync
+
+Adagio strongly recommends enabling user syncing through iFrames. This functionality improves DSP user match rates and increases the bid rate and bid price. Make sure to call `pbjs.setConfig()` only once. This configuration is optional in Prebid, but required by Adagio.
+
+```js
+// https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing
+pbjs.setConfig({
+  userSync: {
+    filterSettings: {
+      iframe: {
+        bidders: ['adagio'],
+        filter: 'include'
+      }
+    }
+  }
+});
+```
+
 ### Bidder Settings
 
 The Adagio bid adapter uses browser local storage. Since Prebid.js 7.x, the access to it must be explicitly set.