From 5ae5f06183d39644bda5f2a0d5d24d49d28c67cc Mon Sep 17 00:00:00 2001
From: tom-win87 <76440079+tom-win87@users.noreply.github.com>
Date: Thu, 18 Apr 2024 09:45:07 -0400
Subject: [PATCH] readme update
---
.DS_Store | Bin 0 -> 6148 bytes
README.md | 147 ++++++++++++
docs/MSPS_signatories.md | 55 +++++
images/logo.png | Bin 0 -> 31243 bytes
tizen-example/config.xml | 13 +
tizen-example/css/style.css | 75 ++++++
tizen-example/icon.png | Bin 0 -> 5167 bytes
tizen-example/images/tizen_32.png | Bin 0 -> 12848 bytes
tizen-example/index.html | 221 +++++++++++++++++
tizen-example/js/main.js | 16 ++
tizen-example/js/navigation.js | 92 ++++++++
tizen-example/tizen_guide.md | 44 ++++
webOS-example/appinfo.json | 11 +
webOS-example/icon.png | Bin 0 -> 5570 bytes
webOS-example/index.html | 223 ++++++++++++++++++
webOS-example/js/events_handler.js | 60 +++++
webOS-example/js/main.js | 2 +
webOS-example/js/navigation.js | 110 +++++++++
webOS-example/largeIcon.png | Bin 0 -> 14871 bytes
webOS-example/webOSTVjs-1.2.0/LICENSE-2.0.txt | 202 ++++++++++++++++
webOS-example/webOSTVjs-1.2.0/webOSTV-dev.js | 1 +
webOS-example/webOSTVjs-1.2.0/webOSTV.js | 1 +
webOS-example/webos_guide.md | 34 +++
23 files changed, 1307 insertions(+)
create mode 100644 .DS_Store
create mode 100644 README.md
create mode 100644 docs/MSPS_signatories.md
create mode 100644 images/logo.png
create mode 100644 tizen-example/config.xml
create mode 100644 tizen-example/css/style.css
create mode 100644 tizen-example/icon.png
create mode 100644 tizen-example/images/tizen_32.png
create mode 100644 tizen-example/index.html
create mode 100644 tizen-example/js/main.js
create mode 100644 tizen-example/js/navigation.js
create mode 100644 tizen-example/tizen_guide.md
create mode 100644 webOS-example/appinfo.json
create mode 100644 webOS-example/icon.png
create mode 100644 webOS-example/index.html
create mode 100644 webOS-example/js/events_handler.js
create mode 100644 webOS-example/js/main.js
create mode 100644 webOS-example/js/navigation.js
create mode 100644 webOS-example/largeIcon.png
create mode 100644 webOS-example/webOSTVjs-1.2.0/LICENSE-2.0.txt
create mode 100644 webOS-example/webOSTVjs-1.2.0/webOSTV-dev.js
create mode 100644 webOS-example/webOSTVjs-1.2.0/webOSTV.js
create mode 100644 webOS-example/webos_guide.md
diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..077ec534d19b6f6527bf07c593316e324c8964b8
GIT binary patch
literal 6148
zcmeHKJ5Iwu5Pb`g2%DIw|t96={b5
z%7DDP4yGtD!D`3*YkYZ;B;%|YGrs#;pS^#6yj^VO=Ed|!e|g{fHk!H1YJ9a`RZGry
zjubCgp~4I~`nctjWmvO6qqUC&BlRxIYU@ryPw28;n?U{4v)6Rvx*r~9*Q83V?^?-`KuA)*S#igiGLbg=Oy
z0I@@}7xtx=keo;{R;&ZkLvbOM7*d^<7%rsK9%)>xSO*O0a9VsgUD;`c;{58IKl0&l
zaX@R00b^jBfx|HD$^C!%ef__kWFuq17}zTYTqjABA-AM=Yio0I*GAMks))qZ0h<(d
i{8h|Yxr$GzUTBY`LyQ&cfV5ETN5IoyjWO`24157@)JpjP
literal 0
HcmV?d00001
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ec2ff3e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,147 @@
+
+
+Sourcepoint's HTML5 OTT solution allows you to surface a Sourcepoint CMP message on devices such as Tizen and webOS for supported regulatory frameworks.
+
+# Table of Contents
+
+- [Implementation overview](#implementation-overview)
+- [Supported campaigns](#supported-campaigns)
+- [Resurface OTT message](#resurface-ott-message)
+- [Global Privacy Platform (GPP) Multi-State Privacy (MSPS) support](#global-privacy-platform-gpp-multi-state-privacy-msps-support)
+- [APIs](#apis)
+
+## Implementation overview
+
+Every implementation requires a bundle of scripts that must be added to your `index.html` file in order to surface the appropriate message configured in the Sourcepoint portal.
+
+- [Stub file(s)](#stub-files)
+- [Client configuration script](#client-configuration-script)
+- [URL to messaging library](#url-to-messaging-library)
+
+### Stub file(s)
+
+The first part implementation script(s) contains the IAB stub functions. The stub functions set up the IAB privacy string object `__tcfapi` (for GDPR TCF campaigns) or `__uspapi` (for U.S. Privacy (Legacy) campaigns), respectively.
+
+This makes it available on queue to be called and released when needed. It is important to have these stub file(s) in the first position to avoid errors and failure of service.
+
+> Note: There is no stub file when configuring a GDPR Standard campaign for your project.
+
+```javascript
+// GDPR TCF stub file. Example only. Please use stub file generated in Sourcepoint portal as it may have changed.
+
+```
+
+```javascript
+// US Privacy (Legacy) stub file. Example only. Please use stub file generated in Sourcepoint portal as it may have changed.
+
+```
+
+```javascript
+// US Multi-State Privacy stub file. Example only. Please use stub file generated in Sourcepoint portal as it may have changed.
+window.__gpp_addFrame=function(e){if(!window.frames[e])if(document.body){var t=document.createElement("iframe");t.style.cssText="display:none",t.name=e,document.body.appendChild(t)}else window.setTimeout(window.__gpp_addFrame,10,e)},window.__gpp_stub=function(){var e=arguments;if(__gpp.queue=__gpp.queue||[],__gpp.events=__gpp.events||[],!e.length||1==e.length&&"queue"==e[0])return __gpp.queue;if(1==e.length&&"events"==e[0])return __gpp.events;var t=e[0],p=e.length>1?e[1]:null,s=e.length>2?e[2]:null;if("ping"===t)p({gppVersion:"1.1",cmpStatus:"stub",cmpDisplayStatus:"hidden",signalStatus:"not ready",supportedAPIs:["2:tcfeuv2","5:tcfcav1","6:uspv1","7:usnatv1","8:uscav1","9:usvav1","10:uscov1","11:usutv1","12:usctv1"],cmpId:0,sectionList:[],applicableSections:[],gppString:"",parsedSections:{}},!0);else if("addEventListener"===t){"lastId"in __gpp||(__gpp.lastId=0),__gpp.lastId++;var n=__gpp.lastId;__gpp.events.push({id:n,callback:p,parameter:s}),p({eventName:"listenerRegistered",listenerId:n,data:!0,pingData:{gppVersion:"1.1",cmpStatus:"stub",cmpDisplayStatus:"hidden",signalStatus:"not ready",supportedAPIs:["2:tcfeuv2","5:tcfcav1","6:uspv1","7:usnatv1","8:uscav1","9:usvav1","10:uscov1","11:usutv1","12:usctv1"],cmpId:0,sectionList:[],applicableSections:[],gppString:"",parsedSections:{}}},!0)}else if("removeEventListener"===t){for(var a=!1,i=0;i<__gpp.events.length;i++)if(__gpp.events[i].id==s){__gpp.events.splice(i,1),a=!0;break}p({eventName:"listenerRemoved",listenerId:s,data:a,pingData:{gppVersion:"1.1",cmpStatus:"stub",cmpDisplayStatus:"hidden",signalStatus:"not ready",supportedAPIs:["2:tcfeuv2","5:tcfcav1","6:uspv1","7:usnatv1","8:uscav1","9:usvav1","10:uscov1","11:usutv1","12:usctv1"],cmpId:0,sectionList:[],applicableSections:[],gppString:"",parsedSections:{}}},!0)}else"hasSection"===t?p(!1,!0):"getSection"===t||"getField"===t?p(null,!0):__gpp.queue.push([].slice.apply(e))},window.__gpp_msghandler=function(e){var t="string"==typeof e.data;try{var p=t?JSON.parse(e.data):e.data}catch(e){p=null}if("object"==typeof p&&null!==p&&"__gppCall"in p){var s=p.__gppCall;window.__gpp(s.command,(function(p,n){var a={__gppReturn:{returnValue:p,success:n,callId:s.callId}};e.source.postMessage(t?JSON.stringify(a):a,"*")}),"parameter"in s?s.parameter:null,"version"in s?s.version:"1.1")}},"__gpp"in window&&"function"==typeof window.__gpp||(window.__gpp=window.__gpp_stub,window.addEventListener("message",window.__gpp_msghandler,!1),window.__gpp_addFrame("__gppLocator"));
+
+```
+
+### Client configuration script
+
+### URL to messaging library
+
+## Supported campaigns
+
+Campaign are surfaced on yout HTML5 device by adding campaign objects to your configuration
+
+The following Sourcepoint campaigns are supported via our HTML5 OTT solution:
+
+| **Config object** | **Campaign** |
+| ----------------- | ------------------------- |
+| `gdpr: {}` | GDPR TCF or GDPR Standard |
+| `ccpa: {}` | U.S. Privacy (Legacy) |
+
+> U.S. Multi-State Privacy campaigns are currently not supported for HTML5 OTT devices. If your organization needs to support the Global Privacy Platform (GPP) Multi-State Privacy (MSPS) framework, you will need to configure a U.S. Privacy (Legacy) campaign to do so. [Click here](#us-multi-state-privacy-campaign-support) for more information about this configuration.
+
+## Resurface OTT message
+
+The privacy manager JavaScript code is a snippet that is added to your project and allows an end-user to resurface a privacy manager. Using this link/button, end-users can directly manage their consent preferences on an ongoing basis without having to re-encounter your organization's first layer message.
+
+Load the OTT message on demand by [retrieving the OTT message ID](https://docs.sourcepoint.com/hc/en-us/articles/20806618675603-Resurface-OTT-message) from the Sourcepoint portal and pass it to the `loadNativeOtt` function.
+
+```javascript
+//GDPR
+window._sp_.gdpr.loadNativeOtt(GDPR_OTT_ID);
+
+//U.S. Privacy (Legacy)
+window._sp_.ccpa.loadNativeOtt(USP_LEGACY_OTT_ID);
+```
+
+Attach the `loadNativeOtt` function to an event handler on your project. Most organizations who implement this function will attach it to `onclick` event of an element.
+
+```javascript
+//GDPR
+
+
+//U.S. Privacy (Legacy)
+
+```
+
+## Global Privacy Platform (GPP) Multi-State Privacy (MSPS) support
+
+In the Sourcepoint portal, U.S. Multi-State Privacy campaigns are created to support the Global Privacy Platform (GPP) Multi-State Privacy (MSPS) framework. Currently, U.S. Multi-State Privacy campaigns are not supported in Sourcepoint's HTML5 OTT solution.
+
+If your organization wishes to support the Global Privacy Platform (GPP) Multi-State Privacy (MSPS) framework you will need to specifically configure a U.S. Privacy (Legacy) campaign to do so.
+
+> Once successfully, configured Sourcepoint will enable the Multi-State Privacy String (MSPS) alongside the U.S. Privacy String. The MSPS can be acessed via the [GPP API](https://sourcepoint-public-api.readme.io/reference/iab-global-privacy-platform-gpp-api).
Please be aware that this solution will only set the [U.S. National Privacy section of the MSPS](https://sourcepoint-public-api.readme.io/reference/us-national-privacy-section) and will not set values for sensitive data categories.
+
+Add the GPP stub file in addition to the U.S. Privacy - CCPA stub file to `index.html`.
+
+```javascript
+//Example only. Please use stub file generated in Sourcepoint portal as it may have changed.
+
+```
+
+Add the `includeGppApi` parameter to the `ccpa` object in your client configuration and set one of the following flag(s) depending on your organization's use case. [Click here](docs/MSPS_signatories.md) for more information on each attribute, possible values, and examples for signatories and non-signatories of the MSPA.
+
+If `includeGppApi` is set to `true`, the following MSPA arguments will be set accordingly:
+
+- `MspaCoveredTransaction`: `"no"`
+- `MspaOptOutOptionMode`: `"na"`
+- `MspaServiceProviderMode`: `"na"`
+
+```
+window._sp_queue = [];
+window._sp_ = {
+ config: {
+ accountId: 1584,
+ baseEndpoint: 'https://cdn.privacy-mgmt.com',
+ ccpa: {
+ includeGppApi: true
+ },
+ propertyHref: 'https://www.testdemo.com',
+```
+
+Optionally, your organization can customize support for the MSPS by configuring the MSPA attributes as part of the GPP config.
+
+```
+window._sp_queue = [];
+window._sp_ = {
+ config: {
+ accountId: 1584,
+ baseEndpoint: 'https://cdn.privacy-mgmt.com',
+ ccpa: {
+ includeGppApi: {
+ "MspaCoveredTransaction": "yes",
+ "MspaOptOutOptionMode": "yes",
+ "MspaServiceProviderMode": "no"
+ }
+ },
+ propertyHref: 'https://www.testdemo.com',
+```
+
+## APIs
+
+Find comprehensive guides and documentation to help you start working with Sourcepoint's public APIs as quickly as possible for different regulatory frameworks in our [API Hub](https://sourcepoint-public-api.readme.io/reference/welcome-to-the-sourcepoint-api-hub).
diff --git a/docs/MSPS_signatories.md b/docs/MSPS_signatories.md
new file mode 100644
index 0000000..4066f41
--- /dev/null
+++ b/docs/MSPS_signatories.md
@@ -0,0 +1,55 @@
+The IAB Tech Lab's Global Privacy Platform's (GPP) Multi-State Privacy String (MSPS) is a signal that notifies downstream partners that participating publishers have provided end-users with specific notice and choice over data processing activities on their properties.
+
+Your organization will need to configure the following attributes as part of the GPP config:
+
+| Attribute | Possible values | Description |
+| ------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MspaCoveredTransaction` | `yes` `no` | Publisher or Advertiser, as applicable, is a signatory to the IAB Multistate Service Provider Agreement (MSPA), as may be amended from time to time, and declares that the transaction is a “Covered Transaction” as defined in the MSPA.
The configured value for the flag will translate to the following in the MSPS: `yes` = 1 `no` = 2 |
+| `MspaOptOutOptionMode` | `na` `yes` `no` | Publisher or Advertiser, as applicable, has enabled “Opt-Out Option Mode” for the “Covered Transaction,” as such terms are defined in the MSPA.
The configured value for the flag will translate to the following in the MSPS: `na` = 0 `yes` = 1 `no` = 2 |
+| `MspaServiceProviderMode` | `na` `yes` `no` | Publisher or Advertiser, as applicable, has enabled “Service Provider Mode” for the “Covered Transaction,” as such terms are defined in the MSPA.
+
+Sourcepoint's HTML5 OTT solution allows you to surface a Sourcepoint CMP message on devices such as Tizen and webOS for supported regulatory frameworks.
+
+# Table of Contents
+
+- [Implementation overview](#implementation-overview)
+- [Supported campaigns](#supported-campaigns)
+- [Resurface OTT message](#resurface-ott-message)
+- [Global Privacy Platform (GPP) Multi-State Privacy (MSPS) support](#global-privacy-platform-gpp-multi-state-privacy-msps-support)
+- [APIs](#apis)
+
+## Implementation overview
+
+Every implementation requires a bundle of scripts that must be added to your `index.html` file in order to surface the appropriate message configured in the Sourcepoint portal.
+
+- [Stub file(s)](#stub-files)
+- [Client configuration script](#client-configuration-script)
+- [URL to messaging library](#url-to-messaging-library)
+
+### Stub file(s)
+
+The first part implementation script(s) contains the IAB stub functions. The stub functions set up the IAB privacy string object `__tcfapi` (for GDPR TCF campaigns) or `__uspapi` (for U.S. Privacy (Legacy) campaigns), respectively.
+
+This makes it available on queue to be called and released when needed. It is important to have these stub file(s) in the first position to avoid errors and failure of service.
+
+> Note: There is no stub file when configuring a GDPR Standard campaign for your project.
+
+```javascript
+// GDPR TCF stub file. Example only. Please use stub file generated in Sourcepoint portal as it may have changed.
+
+```
+
+```javascript
+// US Privacy (Legacy) stub file. Example only. Please use stub file generated in Sourcepoint portal as it may have changed.
+
+```
+
+```javascript
+// US Multi-State Privacy stub file. Example only. Please use stub file generated in Sourcepoint portal as it may have changed.
+window.__gpp_addFrame=function(e){if(!window.frames[e])if(document.body){var t=document.createElement("iframe");t.style.cssText="display:none",t.name=e,document.body.appendChild(t)}else window.setTimeout(window.__gpp_addFrame,10,e)},window.__gpp_stub=function(){var e=arguments;if(__gpp.queue=__gpp.queue||[],__gpp.events=__gpp.events||[],!e.length||1==e.length&&"queue"==e[0])return __gpp.queue;if(1==e.length&&"events"==e[0])return __gpp.events;var t=e[0],p=e.length>1?e[1]:null,s=e.length>2?e[2]:null;if("ping"===t)p({gppVersion:"1.1",cmpStatus:"stub",cmpDisplayStatus:"hidden",signalStatus:"not ready",supportedAPIs:["2:tcfeuv2","5:tcfcav1","6:uspv1","7:usnatv1","8:uscav1","9:usvav1","10:uscov1","11:usutv1","12:usctv1"],cmpId:0,sectionList:[],applicableSections:[],gppString:"",parsedSections:{}},!0);else if("addEventListener"===t){"lastId"in __gpp||(__gpp.lastId=0),__gpp.lastId++;var n=__gpp.lastId;__gpp.events.push({id:n,callback:p,parameter:s}),p({eventName:"listenerRegistered",listenerId:n,data:!0,pingData:{gppVersion:"1.1",cmpStatus:"stub",cmpDisplayStatus:"hidden",signalStatus:"not ready",supportedAPIs:["2:tcfeuv2","5:tcfcav1","6:uspv1","7:usnatv1","8:uscav1","9:usvav1","10:uscov1","11:usutv1","12:usctv1"],cmpId:0,sectionList:[],applicableSections:[],gppString:"",parsedSections:{}}},!0)}else if("removeEventListener"===t){for(var a=!1,i=0;i<__gpp.events.length;i++)if(__gpp.events[i].id==s){__gpp.events.splice(i,1),a=!0;break}p({eventName:"listenerRemoved",listenerId:s,data:a,pingData:{gppVersion:"1.1",cmpStatus:"stub",cmpDisplayStatus:"hidden",signalStatus:"not ready",supportedAPIs:["2:tcfeuv2","5:tcfcav1","6:uspv1","7:usnatv1","8:uscav1","9:usvav1","10:uscov1","11:usutv1","12:usctv1"],cmpId:0,sectionList:[],applicableSections:[],gppString:"",parsedSections:{}}},!0)}else"hasSection"===t?p(!1,!0):"getSection"===t||"getField"===t?p(null,!0):__gpp.queue.push([].slice.apply(e))},window.__gpp_msghandler=function(e){var t="string"==typeof e.data;try{var p=t?JSON.parse(e.data):e.data}catch(e){p=null}if("object"==typeof p&&null!==p&&"__gppCall"in p){var s=p.__gppCall;window.__gpp(s.command,(function(p,n){var a={__gppReturn:{returnValue:p,success:n,callId:s.callId}};e.source.postMessage(t?JSON.stringify(a):a,"*")}),"parameter"in s?s.parameter:null,"version"in s?s.version:"1.1")}},"__gpp"in window&&"function"==typeof window.__gpp||(window.__gpp=window.__gpp_stub,window.addEventListener("message",window.__gpp_msghandler,!1),window.__gpp_addFrame("__gppLocator"));
+
+```
+
+### Client configuration script
+
+### URL to messaging library
+
+## Supported campaigns
+
+Campaign are surfaced on yout HTML5 device by adding campaign objects to your configuration
+
+The following Sourcepoint campaigns are supported via our HTML5 OTT solution:
+
+| **Config object** | **Campaign** |
+| ----------------- | ------------------------- |
+| `gdpr: {}` | GDPR TCF or GDPR Standard |
+| `ccpa: {}` | U.S. Privacy (Legacy) |
+
+> U.S. Multi-State Privacy campaigns are currently not supported for HTML5 OTT devices. If your organization needs to support the Global Privacy Platform (GPP) Multi-State Privacy (MSPS) framework, you will need to configure a U.S. Privacy (Legacy) campaign to do so. [Click here](#us-multi-state-privacy-campaign-support) for more information about this configuration.
+
+## Resurface OTT message
+
+The privacy manager JavaScript code is a snippet that is added to your project and allows an end-user to resurface a privacy manager. Using this link/button, end-users can directly manage their consent preferences on an ongoing basis without having to re-encounter your organization's first layer message.
+
+Load the OTT message on demand by [retrieving the OTT message ID](https://docs.sourcepoint.com/hc/en-us/articles/20806618675603-Resurface-OTT-message) from the Sourcepoint portal and pass it to the `loadNativeOtt` function.
+
+```javascript
+//GDPR
+window._sp_.gdpr.loadNativeOtt(GDPR_OTT_ID);
+
+//U.S. Privacy (Legacy)
+window._sp_.ccpa.loadNativeOtt(USP_LEGACY_OTT_ID);
+```
+
+Attach the `loadNativeOtt` function to an event handler on your project. Most organizations who implement this function will attach it to `onclick` event of an element.
+
+```javascript
+//GDPR
+
+
+//U.S. Privacy (Legacy)
+
+```
+
+## Global Privacy Platform (GPP) Multi-State Privacy (MSPS) support
+
+In the Sourcepoint portal, U.S. Multi-State Privacy campaigns are created to support the Global Privacy Platform (GPP) Multi-State Privacy (MSPS) framework. Currently, U.S. Multi-State Privacy campaigns are not supported in Sourcepoint's HTML5 OTT solution.
+
+If your organization wishes to support the Global Privacy Platform (GPP) Multi-State Privacy (MSPS) framework you will need to specifically configure a U.S. Privacy (Legacy) campaign to do so.
+
+> Once successfully, configured Sourcepoint will enable the Multi-State Privacy String (MSPS) alongside the U.S. Privacy String. The MSPS can be acessed via the [GPP API](https://sourcepoint-public-api.readme.io/reference/iab-global-privacy-platform-gpp-api).