De informatiestroom

Een stroomdiagram dat laat zien hoe gegevens worden doorgegeven van een site van een uitgever naar de API voor het koppelen van abonnementen, eerst via .linkSubscription() in de browser en daarna via UpdateReaderEntitlements() op de server.

Afbeelding 1. Sequentiediagram voor de gegevensstroom op hoog niveau tijdens het proces voor het koppelen van abonnementen.

Als je de functie voor het koppelen van abonnementen wilt implementeren, moet de site van een uitgever aan de clientzijde JavaScript gebruiken om het koppelen voor lezers te starten en een service aan de serverzijde om de toegangsrechten van lezers te beheren. Beide systemen gebruiken informatie van de gehoste webpagina, de instellingen van het Uitgeverscentrum van je publicatie en de informatie van het GCP-serviceaccount.

Het koppelen van een abonnement doorlopen

  1. Lezers met een betaald abonnement of bijdragerechten komen naar je website.
  2. Je code aan de clientzijde gebruikt swg.js om lezers de mogelijkheid te bieden hun uitgeversaccount aan hun Google-account te koppelen, zodat ze de voordelen van de koppeling kunnen ontvangen via een knop of een call-to-action die je ontwerpt en op je website plaatst.
  3. Nadat de call-to-action is geactiveerd (hetzij expliciet via een klik, hetzij impliciet als gevolg van een andere actie of status), loggen lezers in op hun Google-account (of selecteren ze een van de acties die momenteel actief zijn) en verlenen de uitgever toestemming om de informatie van de lezers aan hun Google-account te koppelen. De uitgever maakt een door de uitgever verstrekte ID (PPID) voor de lezer als onderdeel van het verzoek, dat wordt opgeslagen met het Google-account van de lezer en wordt gebruikt voor daaropvolgende API-interacties.
  4. Nadat lezers toestemming hebben gegeven, worden ze teruggestuurd naar de site van de uitgever. De uitgever kan Google nu laten weten op welke toegangsrechten de lezer recht heeft.
  5. (Asynchroon) Uitgevers sturen Google informatie voor alle lezers die hun account hebben gekoppeld. Daarbij gebruiken ze hun PPID's om het record van Google over de PPID van de toegangsrechten te updaten. Het Google-record van een PPID-toegangsrecht(en) moet actueel worden gehouden, omdat deze records worden verwijderd als ze verouderd zijn. Een record wordt 30 dagen na de vervaldatum oud en wordt daarna definitief verwijderd.

Voordelen

Als lezers de site van een uitgever bezoeken waarop de koppeling van abonnementen is geïntegreerd en ze een abonnement of bijdrage op deze site hebben betaald, kunnen die lezers hun uitgeversaccount aan hun Google-account koppelen. Deze lezers komen dan in aanmerking voor een betere zichtbaarheid van de content van deze publicatie in Google-producten, zoals Google Zoeken en Discover. Zo kunnen lezers de hoeveelheid content maximaliseren uit de publicaties waarvoor ze hebben betaald. Lezers kunnen hun uitgeversaccount op elk gewenst moment ontkoppelen van hun Google-account of via een door de uitgever verstrekte actie.

Overzicht van de lezersvoordelen

  1. Lezers zoeken naar content, nieuws of niet-nieuws en krijgen de lijst 'Van je abonnementen' te zien.
  2. Lezers werken met Discover (via hun Android-startscherm of op iOS in de Google-app, Chrome of via een startschermwidget) en kunnen 'Van je abonnementen' zien als gedeelte in Discover. Een paar screenshots tonen de module 'Van je abonnementen' op een pagina met zoekresultaten

Afbeelding 2. Screenshot van de module 'Van je abonnementen' op een pagina met zoekresultaten op desktop en mobiel.

Uitgeversvoordelen van een gekoppeld abonnement

  • Efficiëntere instelling aan de serverzijde voor de lange termijn voor accountbeheer
  • Vereist geen openbaar eindpunt voor OAuth-IdP en toegangsrechten, omdat eerdere versies van de koppeling voor abonnementen vereist zijn
  • Verbeterde gebruikersengagement en -behoud door de content van de publicatie beter zichtbaar te maken op de zoekresultatenpagina's van Google.