Visão geral: Configure e envie um evento in-app relacionado à assinatura para registrar assinaturas e renovações de assinatura. Observação: Este é um recurso legado. Saiba mais sobre o novo mecanismo de receita de assinaturas, totalmente automático e aprimorado mecanismo de receita de assinaturas.
Evento de assinatura in-app
Os aplicativos geralmente precisam verificar o status da assinatura para habilitar recursos específicos da assinatura. Você pode usar esse mecanismo para enviar eventos relacionados à assinatura para a AppsFlyer. Quando o aplicativo detecta uma compra ou renovação de assinatura, ele pode enviar o evento.
Aviso
Se um usuário assina, mas não abre o aplicativo por mais de um mês, a assinatura não é contabilizada como um evento. Por exemplo, um usuário assina pelo seu site, mas depois não abre o aplicativo. Se o usuário não abrir o aplicativo por mais de um mês após assinar, a assinatura não é contabilizada.
Verificar o status da assinatura no aplicativo
O aplicativo pode se comunicar com seus servidores ou receber notificações push com dados sobre assinaturas.
Você pode configurar seu aplicativo para verificar o status da assinatura. Há duas maneiras de fazer isso:
- O aplicativo verifica o status da assinatura e os dados relacionados (ativa ou inativa, tipo de assinatura, data de expiração etc.)
- O aplicativo recebe uma notificação push sobre uma compra ou renovação de assinatura.
Dica
Para aplicativos Android: você pode usar as notificações em tempo real para desenvolvedores do Android para notificar o aplicativo sobre renovações em tempo real.
Para aplicativos iOS: o StoreKit oferece a você observadores da fila de pagamentos e de transações. Você pode usá-los para verificar uma compra ou renovação de assinatura. Consulte a documentação da Apple sobre finalização de transações para mais informações.
Nota
A validação de recibos não é compatível com o registro de assinaturas.
Enviar um evento in-app relacionado à assinatura
Quando o aplicativo tiver os dados relevantes relacionados à assinatura, as etapas a seguir deverão ocorrer:
- O aplicativo verifica se a assinatura é uma compra ou uma renovação.
- O aplicativo coleta os dados relevantes (receita, content_id, compra ou renovação etc.).
- O aplicativo envia o evento de assinatura para a AppsFlyer usando o SDK.
Exemplo de evento de assinatura
| Nome do parâmetro | Tipo de valor esperado | Exemplo de valor | A descrição |
|---|---|---|---|
| af_revenue | float | 200 | A receita associada à assinatura |
| af_currency | string | USD, GBP | A moeda do pagamento |
| af_content_id | string | 092, monthly_subscription | O nome ou código da assinatura |
| renovação | booleano | true, false | se a assinatura é nova ou renovada |
Exemplos de código de evento
O trecho de código abaixo demonstra como configurar e enviar o evento usando o SDK.
Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE, 200);
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD");
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "092");
eventValue.put("renewal", true);
AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.SUBSCRIBE, eventValue);
[[AppsFlyerLib shared] logEvent:(AFEventSubscribe) withValues: @{
AFEventParamRevenue: @200,
AFEventParamCurrency: @"USD",
AFEventParamContentId: @"092",
@"renewal": @TRUE
}];AppsFlyerLib.shared().logEvent(AFEventSubscribe, withValues: [
AFEventParamRevenue: 200,
AFEventParamCurrency: "USD",
AFEventParamContentId: "092",
"renewal": true
]);Dictionary<string, string> SubscriptionEvent = new Dictionary<string, string>();
SubscriptionEvent.Add("af_revenue", "200");
SubscriptionEvent.Add("af_currency", "USD");
SubscriptionEvent.Add("af_content_id", "092");
SubscriptionEvent.Add("renewal", "true");
AppsFlyer.sendEvent("af_subscribe", SubscriptionEvent);Nota
É altamente recomendável que você associe as assinaturas aos clientes. Para isso, não se esqueça de definir o ID de usuário do cliente. Definir o ID de usuário do cliente é a sua forma de associar seus clientes aos usuários do seu aplicativo, conforme eles aparecem na AppsFlyer. Ao definir o ID de usuário do cliente, você garante que qualquer evento, incluindo os eventos relacionados à assinatura, seja enviado com o ID de usuário do cliente.
This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.