Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

Se você é um publisher com conteúdo baseado em tópicos ou um site de eCommerce rastreando interesse em produtos, pode segmentar seus usuários com base nos dados personalizados nas notificações com as quais eles interagem. Com o OneSignal, você pode fazer isso usando Tags. Ao marcar usuários quando eles clicam em uma notificação—com base em metadados que você define no payload da notificação—você pode criar segmentos ricos e orientados por comportamento.

​
1. Adicione o código

Use os manipuladores de eventos de notificação do SDK do OneSignal para detectar quando uma notificação é aberta. Nesse manipulador, extraia seus dados personalizados do payload e use addTag ou addTags para armazená-los. Neste exemplo, marcamos o usuário com um "notification_topic" dos dados personalizados. Você pode adicionar quaisquer outros campos que desejar—como categoria, tipo de produto ou campanha. 
OneSignal.setNotificationOpenedHandler(
  new OneSignal.OSNotificationOpenedHandler() {
    @Override
    public void notificationOpened(OSNotificationOpenedResult result) {
      JSONObject data = result.getNotification().getAdditionalData();
      Log.i("OneSignalExample", "Notification Data: " + data);

      if (data != null) {
        String topic = data.optString("notification_topic", null);
        if (topic != null)
          OneSignal.User.addTag("notification_topic", topic);

        // Add more tags from custom data if needed
        String category = data.optString("category", null);
        if (category != null)
          OneSignal.User.addTag("notification_category", category);
      }
    }
  }
);
```swift Swift
let notificationOpenedBlock: OSHandleNotificationActionBlock = { result in
let payload: OSNotificationPayload? = result?.notification.payload
let additionalData = payload?.additionalData

if let topic = additionalData?["notification_topic"] as? String {
  OneSignal.User.addTags(["notification_topic": topic])
}

if let category = additionalData?["category"] as? String {
  OneSignal.User.addTags(["notification_category": category])
}

// Add more tags from custom data if needed
}

​
2. Adicione dados personalizados às suas notificações

Ao criar uma notificação, você simplesmente adiciona alguns Dados Adicionais à notificação usando nosso Dashboard ou parâmetro data da API. Este será o tópico da notificação e o que você usa para segmentar usuários. Tópicos comuns seriam “notícias”, “entretenimento”, “política”, “finanças”, “tecnologia”, etc.

​
3. Segmente com base nas tags

Você agora pode criar segmentos com base nos valores de dados personalizados em que os usuários clicaram. Exemplo: Usuários que clicaram em um tópico de finanças
  • Chave: notification_topic
  • Condição: equals
  • Valor: finance

​
4. Envie notificações com os dados personalizados

Agora, sempre que os usuários clicarem na notificação, eles serão automaticamente marcados com:
  1. a data (timestamp unix) em que clicaram na notificação
  2. o tópico da notificação e quantas vezes no total esse tópico foi clicado
Você agora pode segmentar assinantes com base nesses dados.