> ## 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.
# Obtenha mais avaliações na loja de aplicativos
> Solicite aos usuários uma avaliação na App Store ou Google Play usando mensagens in-app do OneSignal com prompts de avaliação nativos do iOS e Android, reduzindo o atrito e aumentando as classificações.
Use as mensagens in-app do OneSignal para solicitar aos usuários uma avaliação na App Store ou Google Play sem sair do aplicativo. Este tutorial cobre abordagens sem código e que requerem código.
## Configuração
### 1. Criar a mensagem
Navegue até **Messages > In-App > New In-App** ou abra o modelo de Avaliação da App Store existente.
Adicione um Action ID ao seu botão de avaliação:
### 2. Adicionar o gatilho
O gatilho controla quando a mensagem é exibida. Você pode usar uma abordagem sem código ou baseada em código.
**Sem código**: Configure o Público para segmentar os usuários dos quais deseja avaliações — por exemplo, usuários com muitas sessões que usaram o aplicativo por muito tempo.
**Baseado em código**: Use o método `addTrigger` do SDK para exibir a mensagem programaticamente com base nas ações do usuário. Evite mostrar o prompt quando o usuário estiver no meio de uma tarefa importante.
Neste exemplo, a chave **In-App Trigger** é `ask_for_review` com um valor de `show`. A chave e o valor podem ser qualquer coisa, mas devem corresponder ao que você passa para `addTrigger`:
`OneSignal.InAppMessages.addTrigger("ask_for_review", "show");`
### 3. Lidar com a solicitação de avaliação da loja de aplicativos
Você pode direcionar os usuários a deixar uma avaliação com uma abordagem sem código ou baseada em código.
1. Atualize o segmento para usar o filtro "Device Type is Android".
2. Duplique a mensagem in-app e atualize o segmento da cópia para usar o filtro "Device Type is iOS". Você deve ter duas mensagens in-app com dois segmentos separados.
3. Adicione uma [URL Click Action](./iam-click-actions) ao botão "Review Now" vinculando à listagem da sua loja de aplicativos:
* **Android**: `https://play.google.com/store/apps/details?id=YOUR_PACKAGE_NAME` — consulte [Linking to Google Play](https://developer.android.com/distribute/marketing-tools/linking-to-google-play.html)
* **iOS**: `https://apps.apple.com/app/idYOUR_APP_STORE_ID?action=write-review` — consulte [Requesting App Store Reviews](https://developer.apple.com/documentation/storekit/requesting_app_store_reviews)
Use o método `InAppMessages.addClickListener` do SDK para detectar quando o botão de avaliação é clicado (verificando o Action ID), e então chame a API de avaliação nativa do iOS ou Android para apresentar o modal de classificação.
```dart theme={null}
OneSignal.InAppMessages.addClickListener((event) async {
if (event.result.actionId == 'review') {
if (await inAppReview.isAvailable()) {
inAppReview.requestReview();
}
}
});
```
Este exemplo usa o pacote Flutter [in\_app\_review](https://pub.dev/packages/in_app_review). Adapte para sua plataforma — consulte [RequestReviewAction](https://developer.apple.com/documentation/storekit/requestreviewaction) para iOS ou a [Google Play In-App Reviews API](https://developer.android.com/guide/playcore/in-app-review) para Android.
### 4. Agendar e habilitar
A Apple exibe o prompt de avaliação nativo no máximo três vezes dentro de um período de 365 dias. O Google Play impõe uma cota com limite de tempo, mas não publica o limite exato — chamar a API mais de uma vez em um curto período (menos de um mês) pode não exibir um diálogo.
Para se manter dentro desses limites, defina o agendamento do seu in-app para exibir uma vez a cada 17 semanas:
Para aumentar as avaliações positivas, segmente usuários que tiveram uma ótima experiência — por exemplo, usuários com muitas sessões ou aqueles que deram feedback positivo por meio de uma mensagem in-app anterior. Defina [tags](./add-user-data-tags) nesses usuários e crie um segmento para usar como público do seu prompt de avaliação.
***
## FAQ
### Com que frequência o prompt de avaliação nativo da Apple pode aparecer?
A Apple exibe o prompt `RequestReviewAction` no máximo três vezes por período de 365 dias por usuário. Isso é imposto pelo sistema — seu aplicativo não precisa rastrear a contagem. Consulte [Requesting App Store Reviews](https://developer.apple.com/documentation/storekit/requesting_app_store_reviews).
### Com que frequência o prompt de avaliação nativo do Google pode aparecer?
O Google Play impõe uma cota, mas não publica o limite exato. Chamar `launchReviewFlow` mais de uma vez em um curto período (menos de um mês) pode não exibir o diálogo. A cota é um detalhe de implementação que o Google pode alterar sem aviso. Consulte [In-App Reviews quotas](https://developer.android.com/guide/playcore/in-app-review#quotas).
### Posso usar isso com aplicativos não nativos (Flutter, React Native, Expo)?
Sim. Use um plugin específico da plataforma para chamar a API de avaliação nativa — por exemplo, [in\_app\_review](https://pub.dev/packages/in_app_review) para Flutter ou [StoreReview](https://docs.expo.dev/versions/latest/sdk/storereview/) para Expo. A mensagem in-app do OneSignal e o listener de clique funcionam da mesma forma independentemente do framework.
***
Configure ações de clique de URL, prompt de permissão, tag, resultado e personalizadas em elementos de mensagens in-app.
Marque usuários com base no comportamento para criar segmentos de mensagens direcionadas.