Best practice

Per massimizzare il coinvolgimento dei lettori e i tassi di conversione del collegamento degli account (CVR), i publisher dovrebbero seguire queste best practice di implementazione. L'analisi delle pubblicazioni con il rendimento migliore rivela che una strategia di invocazione automatica combinata con una pianificazione di cooldown di riattivazione disciplinata genera i tassi di successo più elevati.

Strategia di invocazione

Ti consigliamo di adottare un modello di invocazione automatica principale, con un'invocazione secondaria facoltativa attivata dal pulsante per i lettori che hanno eseguito l'accesso.

Principale: invocazione automatica

Attiva automaticamente la richiesta di collegamento degli abbonamenti nel momento di sblocco di valore più alto:

• Post-acquisto: immediatamente dopo l'acquisto di un abbonamento interno, alla chiusura del modale di conferma.
• Accesso utente: al momento dell'accesso dell'utente quando gli abbonati esistenti accedono ai contenuti protetti da paywall (nell'ambito di una strategia di riattivazione).

Secondaria: invocazione attivata dal pulsante

Per i lettori che hanno eseguito l'accesso e non hanno ancora collegato i propri account, mostra un pulsante di collegamento o un invito all'azione (CTA) persistente e non intrusivo:

• Intestazione o piè di pagina dell'articolo: inserisci un pulsante di collegamento in una barra di intestazione o piè di pagina dell'articolo fissa accanto alle icone di condivisione sui social. I lettori autenticati accedono principalmente alle pagine dei dettagli degli articoli, pertanto l'ancoraggio del CTA direttamente ai contenuti consumati massimizza le opportunità di collegamento.
• Pagina di gestione dell'abbonamento: promuovi il collegamento degli abbonamenti nella pagina di gestione dell'account o dell'abbonamento del lettore con una spiegazione dei vantaggi del collegamento del suo Account Google.

Logica di riattivazione e cooldown

Non trattare il collegamento degli abbonamenti come una richiesta una tantum. Se un lettore ignora o rifiuta la richiesta di collegamento, implementa un periodo di cooldown ricorrente prima di presentare nuovamente il CTA.

• Periodo di cooldown consigliato: implementa un periodo di attesa di 30-45 giorni (o meno, a seconda delle preferenze della tua pubblicazione) prima di riproporre la richiesta a un utente che l'ha ignorata o rifiutata.

Rilevare il rifiuto con eventListener

Per implementare la logica di riattivazione e cooldown, utilizza swg.js eventManager per rilevare quando un utente chiude o rifiuta la finestra di dialogo di collegamento degli abbonamenti senza collegare gli account. Per l'elenco completo degli eventi di dati e analisi, consulta le definizioni degli eventi su GitHub.

Nota: nel runtime del browser (swg.js), self.SWG non esporta direttamente l'enumerazione AnalyticsEvent. Al contrario, event.eventType emette ID numerici corrispondenti ai valori dell'enumerazione protobuf (ad esempio, 1086 per ACTION_SUBSCRIPTION_LINKING_CLOSE e 2005 per EVENT_SUBSCRIPTION_LINKING_FAILED).

Quando si verifica un evento di rifiuto o ignoramento, memorizza un timestamp nel database dell'account per sopprimere la riproposizione automatica della richiesta fino alla scadenza del periodo di cooldown.

// AnalyticsEvent numeric IDs from api_messages.ts
// list of the events: https://github.com/subscriptions-project/swg-js/blob/main/src/proto/api_messages.ts#L32
const ACTION_SUBSCRIPTION_LINKING_CLOSE = 1086;
const EVENT_SUBSCRIPTION_LINKING_FAILED = 2005;

subscriptions.getEventManager().then(manager => {
  manager.registerEventListener((event) => {
    // Inspect the analytics event
    console.log("Analytics event: ", event);

    // If the event indicates the user closed or rejected the linking prompt,
    // record the timestamp to enforce your 30-45 day cooldown schedule.
    if (event.eventType === ACTION_SUBSCRIPTION_LINKING_CLOSE ||
        event.eventType === EVENT_SUBSCRIPTION_LINKING_FAILED) {
      // Record rejection timestamp for cooldown suppression
      recordLinkingRejectionTimestamp();
    }
  });
});

Sincronizzare periodicamente i diritti dei lettori

Oltre ad aggiornare immediatamente i diritti quando si verifica un evento di abbonamento (ad esempio un nuovo acquisto, un rinnovo, un upgrade o un annullamento), implementa un job di sincronizzazione periodica lato server.

• Sincronizzazione batch regolare: esegui un job pianificato ricorrente (ad esempio un'attività cron giornaliera o settimanale) utilizzando il metodo API updateReaderEntitlements per aggiornare lo stato di tutti i lettori attivi.
• Coerenza dei dati: una sincronizzazione periodica garantisce che il database e i sistemi di Google rimangano allineati, correggendo eventuali discrepanze causate da errori di rete temporanei, eventi webhook mancanti o token di abbonamento scaduti.

Importante: Il valore expire_time massimo consentito è di 398 giorni dal momento della chiamata API. Anche se lo stato di abbonamento di un abbonato non cambia mai (ad esempio un abbonamento a vita o con rinnovo automatico), devi chiamare updateReaderEntitlements periodicamente per estendere expire_time. In caso contrario, il diritto scadrà e il link di abbonamento verrà eliminato dopo 398 giorni.

Per dettagli completi sull'implementazione ed esempi di codice, consulta la guida Sincronizzare i diritti utente.

Controllare il rendimento su Search Console

Puoi monitorare l'impatto diretto e l'integrità dell'integrazione del collegamento degli abbonamenti utilizzando Google Search Console.

• Monitorare le metriche di coinvolgimento: misura clic, impressioni e percentuali di clic (CTR) per gli articoli degli abbonati in evidenza aprendo i report sul rendimento di Search Console e filtrando per il tipo di aspetto nella ricerca Contenuti in abbonamento (vedi report sull'aspetto nella ricerca).
• Monitorare l'integrità dei dati strutturati: utilizza il report sui risultati avanzati per Contenuti in abbonamento per identificare e risolvere eventuali errori di sintassi o di convalida nel markup dei dati strutturati nelle pagine della tua pubblicazione.