{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"a3c936067e4fdf42f8e1c3fd44aa2f89"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"c1d63a4b-5b47-4cc5-b13d-89770ace7f39"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Functionality","type":"text"}]},{"type":"paragraph","content":[{"text":"When working with GDPR users, a publisher may need to get consent for other vendors other than the IAB-compliant ones, e.g. when using some special analytics tool or other product from a company that is not registered in the IAB Global Vendor List. The function ","type":"text"},{"text":"setCustomVendors","type":"text","marks":[{"type":"code"}]},{"text":" is used to configure AdConsent with an additional list of custom vendors to get consent for them. This will only work when using the standalone version of AdConsent, otherwise, if AdConsent is served by AdEngine it’s required to check with the account manager for them to add the custom vendors to the list.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Syntax","type":"text"}]},{"type":"paragraph","content":[{"text":"function adconsent.gdpr()","type":"text","marks":[{"type":"code"}]}]},{"type":"table","attrs":{"layout":"default","localId":"1b8fbe96-31ae-425c-818c-88c352ceb095"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"argument name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"value","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"command","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"'setCustomVendors'","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"parameter","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"object","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"CustomVendorsList","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"CustomVendorsList","type":"text","marks":[{"type":"code"}]},{"text":" list holding the custom vendors properties.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[122.0]},"content":[{"type":"paragraph","content":[{"text":"callback","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[102.0]},"content":[{"type":"paragraph","content":[{"text":"function","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"✔️","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[183.0]},"content":[{"type":"paragraph","content":[{"text":"function(message:JSON, success:boolean)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[196.0]},"content":[{"type":"paragraph","content":[{"text":"The callback function that is called with the function call result.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"CustomVendorsList","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"CustomVendorsList = [\n {\n id: ,\n name: ,\n description: ,\n policyUrl: \n },\n {\n id: ,\n name: ,\n description: ,\n policyUrl: \n },\n ...\n {\n id: ,\n name: ,\n description: ,\n policyUrl: \n }\n]","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"CustomVendorsList.id","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The custom vendor id that has to be unique among all items in the list.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"CustomVendorsList.name","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"String holding the vendor name.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"CustomVendorsList.description","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"String holding a description for this vendor, e.g., what kind of business they conduct, their values, etc. It's not mandatory to have a vendor description (the field can be set as an empty string), but having more complete info for the vendor may raise the odds of having positive consent for it.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"CustomVendorsList.policyUrl","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"String holding the vendor privacy policy link.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Description","type":"text"}]},{"type":"paragraph","content":[{"text":"When enabling a list of custom vendors, AdConsent adds these new vendors to the end of the non-IAB Vendors field under the ","type":"text"},{"text":"Vendors","type":"text","marks":[{"type":"code"}]},{"text":" tab in the ","type":"text"},{"text":"Customise choices","type":"text","marks":[{"type":"code"}]},{"text":" view, as shown in the picture below:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":825,"id":"78827681-f9d1-4323-b257-b173cf983101","collection":"contentId-668205057","type":"file","height":530}}]},{"type":"paragraph","content":[{"text":"After the user gives consent, this can be checked for the custom vendors by using the function ","type":"text"},{"text":"getCustomVendorsConsent ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/667975751"}}]},{"text":"and then set whatever behavior should be expected in case of having or not having consent for these vendors.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Scope","type":"text"}]},{"type":"paragraph","content":[{"text":"The function must be called before AdConsent shows the GUI. Calls, after AdConsent has shown the GUI, will be ignored.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Enable one custom vendor called Veritass","type":"text"}]},{"type":"codeBlock","content":[{"text":"adconsent.gdpr('setCustomVendors', [\n {\n id: 1,\n name: \"Veritass\",\n description: \"Veritass' mission is simply to provide you an example on how to create a custom vendor.\",\n policyUrl: \"https://www.veritass.com/privacy_policy\"\n }\n]);","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Enable 3 custom vendors called Veritass, Bing, and YANIAB","type":"text"}]},{"type":"codeBlock","content":[{"text":"adconsent.gdpr('setCustomVendors', [\n {\n id: 1,\n name: \"Veritass\",\n description: \"Veritass' mission is simply to provide you an example on how to create a custom vendor.\",\n policyUrl: \"https://www.veritass.com/privacy_policy\"\n },\n {\n id: 2,\n name: \"Bing\",\n description: \"Bing helps you turn information into action, making it faster and easier to go from searching to doing.\",\n policyUrl: \"https://about.ads.microsoft.com/en-us/resources/policies/microsoft-advertising-privacy-policy\"\n },\n {\n id: 3,\n name: \"YANIAB\",\n description: \"Yet another non-IAB vendor.\",\n policyUrl: \"https://yaniab.com/privacy-policy\"\n }\n]);","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported