Práticas recomendadas

Para maximizar o engajamento do leitor e as taxas de conversão (CVR) da vinculação de contas, os editores precisam seguir estas práticas recomendadas de implementação. A análise das publicações de melhor performance revela que uma estratégia de invocação automática combinada a um cronograma disciplinado de espera para reengajamento gera as maiores taxas de sucesso.

Estratégia de invocação

Recomendamos adotar um modelo principal de invocação automática, com uma invocação secundária opcional acionada por botão para leitores conectados.

Principal: invocação automática

Acione automaticamente a solicitação de vinculação de assinatura no momento de maior desbloqueio de valor:

• Pós-compra: imediatamente após uma compra de assinatura interna, ao fechar o modal de confirmação.
• Login do usuário: quando os assinantes atuais fazem login para acessar conteúdo restrito por paywall (como parte de uma estratégia de reconexão).

Secundário: invocação acionada por botão

Para leitores conectados que ainda não vincularam as contas, mostre um botão ou call-to-action (CTA) de vinculação persistente e não intrusivo:

• Cabeçalho ou rodapé do artigo: coloque um botão de vinculação em um cabeçalho ou rodapé fixo do artigo ao lado dos ícones de compartilhamento em redes sociais. Os leitores autenticados acessam principalmente as páginas de detalhes do artigo. Por isso, ancorar a CTA diretamente no conteúdo consumido maximiza as oportunidades de vinculação.
• Página de gerenciamento de assinaturas: promova a vinculação de assinaturas na página de gerenciamento de assinaturas ou da conta do leitor com uma explicação dos benefícios de vincular a Conta do Google.

Lógica de reengajamento e tempo de recarga

Não trate a vinculação de assinaturas como uma solicitação única. Se um leitor dispensar ou recusar a solicitação de vinculação, implemente um período de espera recorrente antes de apresentar a CTA novamente.

• Período de espera recomendado: implemente um período de espera de 30 a 45 dias (ou menos, dependendo da preferência da sua publicação) depois que um usuário dispensa ou rejeita o aviso antes de mostrar novamente.

Detectando rejeição com eventListener

Para implementar a lógica de reengajamento e de espera, use swg.js eventManager para detectar quando um usuário fecha ou rejeita a caixa de diálogo de vinculação de assinaturas sem vincular. Consulte as definições de eventos no GitHub para ver a lista completa de eventos de análise.

Observação: no tempo de execução do navegador (swg.js), o self.SWG não exporta o enum AnalyticsEvent diretamente. Em vez disso, event.eventType emite IDs numéricos correspondentes aos valores de enumeração do protobuf (por exemplo, 1086 para ACTION_SUBSCRIPTION_LINKING_CLOSE e 2005 para EVENT_SUBSCRIPTION_LINKING_FAILED).

Quando um evento de rejeição ou dispensa ocorre, armazene um carimbo de data/hora no banco de dados da conta para suprimir a nova solicitação automática até que o período de espera expire.

// 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();
    }
  });
});

Sincronizar direitos de leitor periodicamente

Além de atualizar os direitos imediatamente quando um evento de assinatura ocorre (como uma nova compra, renovação, upgrade ou cancelamento), implemente um job de sincronização periódica do lado do servidor.

• Sincronização regular em lote: execute um job recorrente programado (como uma tarefa cron diária ou semanal) usando o método de API updateReaderEntitlements para atualizar o status de todos os leitores ativos.
• Consistência de dados: uma sincronização periódica garante que seu banco de dados e os sistemas do Google permaneçam alinhados, corrigindo discrepâncias causadas por falhas temporárias de rede, eventos de webhook perdidos ou tokens de assinatura expirados.

Importante: o expire_time máximo permitido é de 398 dias a partir do momento da chamada de API. Mesmo que o status de assinatura de um assinante nunca mude (como uma assinatura vitalícia ou de renovação automática), é necessário chamar updateReaderEntitlements periodicamente para estender o expire_time. Caso contrário, o direito vai expirar e o link da assinatura será removido após 398 dias.

Para detalhes completos sobre a implementação e exemplos de código, consulte o guia Sincronizar direitos do usuário.

Verificar a performance no Search Console

Monitore o impacto direto e a integridade da sua integração do Subscription Linking usando o Google Search Console.

• Acompanhe as métricas de engajamento: meça cliques, impressões e taxas de cliques (CTR) dos artigos destacados para assinantes. Para isso, abra os relatórios de performance do Search Console e filtre pelo tipo de aspecto da pesquisa Conteúdo por assinatura (consulte os relatórios de aspecto da pesquisa).
• Monitore a integridade dos dados estruturados: use o relatório de pesquisa aprimorada para Conteúdo assinado e identifique e resolva erros de sintaxe ou validação na marcação de dados estruturados nas páginas da sua publicação.