Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Incorporate PubCID doc #2525

Closed
patmmccann opened this issue Nov 19, 2020 · 11 comments
Closed

Incorporate PubCID doc #2525

patmmccann opened this issue Nov 19, 2020 · 11 comments
Assignees

Comments

@patmmccann
Copy link
Collaborator

It seems publishers are largely unaware of the prebid functionality for pubcid beyond the prebid.js id submodule. We should encapsulate https://publishersupport.conversantmedia.com/products/pubcid-pubs https://wordpress.org/plugins/publisher-common-id/ https://github.com/conversant/pubcid.js and https://github.com/conversant/pubcid_drupal into the prebid docs website.

@jdwieland8282
Copy link
Member

These assets have been added to the Prebid GIT repo:

I haven't started documenting them, I'm probably not the right person to do that anyway.

@jdwieland8282 jdwieland8282 self-assigned this Jan 15, 2021
@patmmccann
Copy link
Collaborator Author

Why can't the existing doc be imported from Conversant?

@gglas
Copy link

gglas commented Apr 26, 2021

@jdwieland8282 is there someone we can loop in from Epsilon / Conversant to help us keep docs in sync? Maybe we could tag them here?

@patmmccann
Copy link
Collaborator Author

@smenzer don't your clients suffer from the same concern as those installing pubcid server? Should doc be added for your module as well?

@smenzer
Copy link
Collaborator

smenzer commented Apr 26, 2021

Publisher's can definitely use our ID outside of just the prebid.js user id module and there are server-side integrations we support with them. I'd be happy to add documentation here if you think it's valuable, or point to our docs site.

@jdwieland8282
Copy link
Member

jdwieland8282 commented Apr 26, 2021

@pycnvr do you have any documentation for the wordpress and drupal apps you can add to:

@pycnvr
Copy link
Contributor

pycnvr commented Apr 26, 2021

Hi guys,

The most detailed doc for the Wordpress plugin is on the plugin page mentioned above https://wordpress.org/plugins/publisher-common-id/. That covers general usage and installation. I can fill in anything that may be unclear.

There isn't as much doc on the Drupal plugin, unfortunately.

@jdwieland8282
Copy link
Member

Thanks @pycnvr.

@patmmccann & @gglas, the doc for the wordpress plugin were included with the wordpress plugin moved over to the prebid/pubcommon-wordpress repo. Here: https://github.com/prebid/pubcommon-wordpress/blob/master/README.md

Same for the drupal plugin, here: https://github.com/prebid/pubcommon-drupal/blob/master/readme.md

@patmmccann
Copy link
Collaborator Author

The doc at https://publishersupport.conversantmedia.com/products/pubcid-pubs is much more extensive and addresses the why, the wordpress plugin doc is more the how. The doc at https://publishersupport.conversantmedia.com/products/pubcid-pubs is much more pressing to find a home for on prebid.org so that publishers quickly get routed to better explanation about why pubcid server is important at all.

@jdwieland8282
Copy link
Member

got it thanks @patmmccann , we will address this in our next sprint.

jdwieland8282 added a commit that referenced this issue Jul 21, 2021
adding docs from Conversant's site as requested in #2525
@jdwieland8282
Copy link
Member

#3137

jdwieland8282 added a commit that referenced this issue Jul 27, 2021
* Update userId.md

updating the table and text of Sharedid (FKA pubcommon's) entry in the user id section.

* Update sharedid.md

adding docs from Conversant's site as requested in #2525

* Update userId.md

updating sharedid examples to include a #3 describing the setConfig when a server is used

* Update sharedid.md

adding text around docuement.cookie use in safari

* Update sharedid.md

renaming user id module section and updating desc in table to prebid.js

* Update sharedid.md

noting that Pubcid script has a high technical cost and a variable revenue benifit

* Update sharedid.md

renaming pubcid server to SharedId Server

* Update sharedid.md

adding a comment to pixelURL clarifying what this param should be used for.

* Update sharedid.md

updating when sharedid script is appropriate

* Update sharedid.md

updating pubcid server to SharedId Server

* Update sharedid.md

updating pubcid server to SharedId Server

* Update userId.md

adding a link to sharedid.html

* Update userId.md

adding a second link to sharedid.html

* Update sharedid.md

adding additional language sharedid servers benefits wrt safari

* changing link to relative

* another link

* wordsmithing

* consistency and wordsmithing

* Update sharedid.md

adding text to CMS description.

* more wordsmithing

- The term "sharedId server" confused me. I changed most of these to "endpoint" instead of server.
- Clarified the term "plugin", which has a meaning in PBJS that's quite different than the usage here.
- Removed duplicate exhortations to use the weird "endpoint" thing.

Co-authored-by: bretg <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants