From 05551f2c68927eb44fe86c4e9f8b5836be3411f9 Mon Sep 17 00:00:00 2001 From: massadmin <58946787+massadmin@users.noreply.github.com> Date: Wed, 21 Jul 2021 17:15:51 +0300 Subject: [PATCH 1/7] Added hosted integration link --- dev-docs/modules/mass.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/dev-docs/modules/mass.md b/dev-docs/modules/mass.md index d447773ca3..75a80027ed 100644 --- a/dev-docs/modules/mass.md +++ b/dev-docs/modules/mass.md @@ -139,6 +139,9 @@ pbjs.que.push(function() { ## Integration Example +There are two options to view the integration example: + +### Option 1 - Your own development environment To view the integration example: 1) in your cli run: @@ -152,3 +155,6 @@ gulp serve --modules=ixBidAdapter,mass ``` http://localhost:9999/integrationExamples/mass/index.html ``` + +### Option 2 - Hosted online +Mass Platform Limited hosts an official integration and demo page that can be found using the following link: http://demo.massplatform.com/ix/prebid/ From 9743378690db83799d08c62c5892b807935f52ec Mon Sep 17 00:00:00 2001 From: massadmin <58946787+massadmin@users.noreply.github.com> Date: Wed, 21 Jul 2021 17:56:00 +0300 Subject: [PATCH 2/7] Update mass.md --- dev-docs/modules/mass.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/dev-docs/modules/mass.md b/dev-docs/modules/mass.md index 75a80027ed..608413bed5 100644 --- a/dev-docs/modules/mass.md +++ b/dev-docs/modules/mass.md @@ -157,4 +157,25 @@ http://localhost:9999/integrationExamples/mass/index.html ``` ### Option 2 - Hosted online -Mass Platform Limited hosts an official integration and demo page that can be found using the following link: http://demo.massplatform.com/ix/prebid/ +Mass Platform Limited hosts an official integration and demo page that can be accessed using the following link: http://demo.massplatform.com/ix/prebid/ + +## Testing MASS +Testing requires valid bids to be returned to Prebid. To assist with this process, we recommend to use the MASS Bid Simulation tool found at https://github.com/massplatform/bidsim. Your Exchange partner might be able to assist you with other specialist tools and browser plugins to achieve similar resuls. + +The instructions below assume that you have followed the installation instructions for the MASS Bidsim tool found at https://github.com/massplatform/bidsim/blob/master/README.md. + +### Testing using MASS compliant tags +The bidsim tool ships with working DSP example tags that can be found under the bidsim/tags folder. + +A quick way to test the Integration test page in combination with the official bootloader is to use one of the following command: +``` +node bidsim --inject --bid 2000 --width 300 --height 250 --dealid 'MASS' --tag "tags/inskin-housead-desktop.js" -o https://demo.massplatform.net/ix/prebid +``` +### For third-party technology companies +Third-parties that wish to integrate with the official MASS bootloader can get started by running the following command: +``` +node bidsim --inject --bid 2000 --width 300 --height 250 --dealid 'MASS' --tag "tags/test.js" -o https://demo.massplatform.net/ix/prebid +``` + +Explanation: The tags/test.js tag calls a reference endpoint for developer that can be accessed here: https://demo.massplatform.net/reference/endpoint.js. +When running the above command to invoke this reference endpoint, you will see all the params that MASS collected and passed onto your endpoint. This includes inputs, parsed inputs, tag parameters and MASS/Provider specific configuration. From b5a9a587ce169021b45795350362d4b7ee14d500 Mon Sep 17 00:00:00 2001 From: massadmin <58946787+massadmin@users.noreply.github.com> Date: Wed, 21 Jul 2021 17:56:35 +0300 Subject: [PATCH 3/7] Update mass.md --- dev-docs/modules/mass.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/modules/mass.md b/dev-docs/modules/mass.md index 608413bed5..84efb4ab01 100644 --- a/dev-docs/modules/mass.md +++ b/dev-docs/modules/mass.md @@ -167,7 +167,7 @@ The instructions below assume that you have followed the installation instructio ### Testing using MASS compliant tags The bidsim tool ships with working DSP example tags that can be found under the bidsim/tags folder. -A quick way to test the Integration test page in combination with the official bootloader is to use one of the following command: +A quick way to test the Integration test page in combination with the official bootloader is to use the following command: ``` node bidsim --inject --bid 2000 --width 300 --height 250 --dealid 'MASS' --tag "tags/inskin-housead-desktop.js" -o https://demo.massplatform.net/ix/prebid ``` From dbd06da0cae4e0b2cca8f9d83b6b2ea380021685 Mon Sep 17 00:00:00 2001 From: massadmin <58946787+massadmin@users.noreply.github.com> Date: Wed, 21 Jul 2021 17:59:33 +0300 Subject: [PATCH 4/7] Update mass.md --- dev-docs/modules/mass.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/dev-docs/modules/mass.md b/dev-docs/modules/mass.md index 84efb4ab01..12823cae80 100644 --- a/dev-docs/modules/mass.md +++ b/dev-docs/modules/mass.md @@ -177,5 +177,8 @@ Third-parties that wish to integrate with the official MASS bootloader can get s node bidsim --inject --bid 2000 --width 300 --height 250 --dealid 'MASS' --tag "tags/test.js" -o https://demo.massplatform.net/ix/prebid ``` -Explanation: The tags/test.js tag calls a reference endpoint for developer that can be accessed here: https://demo.massplatform.net/reference/endpoint.js. +Explanation: The tags/test.js tag calls a reference endpoint for developers that can be accessed here: https://demo.massplatform.net/reference/endpoint.js. When running the above command to invoke this reference endpoint, you will see all the params that MASS collected and passed onto your endpoint. This includes inputs, parsed inputs, tag parameters and MASS/Provider specific configuration. + +### Testing on live sites +Any sites that have been MASS configured will work with the bidsim tool. This is a convenient way to test whether your publisher ad server and slot is correctly configured. From d30fb237876e51cdde163a11cc86b658ea1d4076 Mon Sep 17 00:00:00 2001 From: massadmin <58946787+massadmin@users.noreply.github.com> Date: Wed, 21 Jul 2021 18:03:54 +0300 Subject: [PATCH 5/7] Update mass.md --- dev-docs/modules/mass.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/modules/mass.md b/dev-docs/modules/mass.md index 12823cae80..516e376bc3 100644 --- a/dev-docs/modules/mass.md +++ b/dev-docs/modules/mass.md @@ -178,7 +178,7 @@ node bidsim --inject --bid 2000 --width 300 --height 250 --dealid 'MASS' --tag " ``` Explanation: The tags/test.js tag calls a reference endpoint for developers that can be accessed here: https://demo.massplatform.net/reference/endpoint.js. -When running the above command to invoke this reference endpoint, you will see all the params that MASS collected and passed onto your endpoint. This includes inputs, parsed inputs, tag parameters and MASS/Provider specific configuration. +When running the above command to invoke this reference endpoint, you will see all the params that MASS collected and passed onto your endpoint. This includes inputs, parsed inputs, tag parameters and MASS/Provider specific configurations. ### Testing on live sites Any sites that have been MASS configured will work with the bidsim tool. This is a convenient way to test whether your publisher ad server and slot is correctly configured. From ec09009035a73daff28ddd4d03cb9553492ad92f Mon Sep 17 00:00:00 2001 From: massadmin <58946787+massadmin@users.noreply.github.com> Date: Wed, 28 Jul 2021 22:04:55 +0300 Subject: [PATCH 6/7] Amended build instructions --- dev-docs/modules/mass.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/dev-docs/modules/mass.md b/dev-docs/modules/mass.md index 516e376bc3..ef910d9a6b 100644 --- a/dev-docs/modules/mass.md +++ b/dev-docs/modules/mass.md @@ -144,16 +144,16 @@ There are two options to view the integration example: ### Option 1 - Your own development environment To view the integration example: -1) in your cli run: +1) Build Prebid using the following required options ``` -gulp serve --modules=ixBidAdapter,mass +gulp build --modules=ixBidAdapter,mass ``` -2) in your browser, navigate to: +2) Use a http server with a valid hostname to access its content. It is not advices to run the bid simulation using localhost or 127.0.0.1 ``` -http://localhost:9999/integrationExamples/mass/index.html +http://hostname/integrationExamples/mass/index.html ``` ### Option 2 - Hosted online From 569c8136dc204c28af81a48437d08cd9dac36e79 Mon Sep 17 00:00:00 2001 From: massadmin <58946787+massadmin@users.noreply.github.com> Date: Tue, 17 Aug 2021 21:31:39 +0300 Subject: [PATCH 7/7] Fixed typos and mistakes --- dev-docs/modules/mass.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/dev-docs/modules/mass.md b/dev-docs/modules/mass.md index ef910d9a6b..eba3a6898b 100644 --- a/dev-docs/modules/mass.md +++ b/dev-docs/modules/mass.md @@ -150,7 +150,7 @@ To view the integration example: gulp build --modules=ixBidAdapter,mass ``` -2) Use a http server with a valid hostname to access its content. It is not advices to run the bid simulation using localhost or 127.0.0.1 +2) Use a http server with a valid hostname to access its content. It is not advised to run the bid simulation using localhost or 127.0.0.1 ``` http://hostname/integrationExamples/mass/index.html @@ -160,7 +160,7 @@ http://hostname/integrationExamples/mass/index.html Mass Platform Limited hosts an official integration and demo page that can be accessed using the following link: http://demo.massplatform.com/ix/prebid/ ## Testing MASS -Testing requires valid bids to be returned to Prebid. To assist with this process, we recommend to use the MASS Bid Simulation tool found at https://github.com/massplatform/bidsim. Your Exchange partner might be able to assist you with other specialist tools and browser plugins to achieve similar resuls. +Testing requires valid bids to be returned to Prebid. To assist with this process, we recommend you use the MASS Bid Simulation tool found at https://github.com/massplatform/bidsim. Your Exchange partner might be able to assist you with other specialist tools and browser plugins to achieve similar resuls. The instructions below assume that you have followed the installation instructions for the MASS Bidsim tool found at https://github.com/massplatform/bidsim/blob/master/README.md. @@ -181,4 +181,4 @@ Explanation: The tags/test.js tag calls a reference endpoint for developers that When running the above command to invoke this reference endpoint, you will see all the params that MASS collected and passed onto your endpoint. This includes inputs, parsed inputs, tag parameters and MASS/Provider specific configurations. ### Testing on live sites -Any sites that have been MASS configured will work with the bidsim tool. This is a convenient way to test whether your publisher ad server and slot is correctly configured. +Any sites that have been MASS configured will work with the Bidsim tool. This is a convenient way to test whether your publisher ad server and slot is correctly configured.