Se você deseja baixar avaliações da App Store, você tem acesso ao aplicativo do qual deseja baixar as avaliações ou não.
Neste post, vamos analisar soluções e estratégias para acessar as avaliações da App Store em ambos os casos, avaliando preço, tempo e escalabilidade em cada caso.
Mas primeiro, há algumas coisas que você precisa saber antes de mergulharmos nas soluções de exportação de dados da App Store.
Como as avaliações do iOS realmente funcionam
Se você está procurando avaliações na loja de aplicativos, você pode ou não saber que existem dois objetos diferentes em jogo:
- Avaliações
- Classificações
Em uma plataforma como o Google Meu Negócio, existe um único objeto chamado avaliação. E ele tem ou não tem conteúdo.
No iOS, é um pouquinho diferente.
Uma avaliação sem conteúdo torna-se uma classificação. E um objeto de avaliação tem conteúdo e uma classificação associados a ele.
O problema é que as classificações são quase sempre indisponíveis. Qualquer um que afirme dar acesso às classificações está mentindo ou inventando coisas a partir de informações agregadas disponíveis publicamente.
Você pode meio que fazer engenharia reversa usando as informações que eles fornecem em páginas de aplicativos disponíveis publicamente, assim como abaixo 👇
Algumas APIs até vendem esses dados.
Sendo realista, é altamente não confiável, e eu recomendaria olhar apenas para as avaliações. As avaliações devem ser um subconjunto representativo das classificações, e são muito mais fáceis de usar e medir com precisão.
Uma palavra sobre países e idiomas
Você também pode saber que um aplicativo está listado em uma lista selecionada de países na App Store.
Alguns aplicativos estarão disponíveis em todos os países possíveis, enquanto outros estarão disponíveis apenas na Coreia, ou nos EUA, ou na França, ou em qualquer combinação dos 116 países disponíveis na loja.
Existem algumas pegadinhas em relação à localização geográfica na App Store, sendo a principal delas que as avaliações estão associadas a um país, mas não a um idioma.
Eu não encontrei um endpoint "global" e suspeito que simplesmente não exista um.
Isso significa que você precisa buscar avaliações de cada país para obter todas as avaliações. Você também pode decidir buscar apenas alguns países, mas pode estar perdendo algumas avaliações.
Existem 116 países na App Store.
Aqui está uma lista.
Você pode baixá-lo como um CSV aqui.
Como encontrar um ID de Aplicativo.
Em quase todas as soluções listadas abaixo, o ID do aplicativo é necessário para poder acessar as avaliações corretas. Incluindo sua própria API App Store Connect.
#1 Encontrando o ID do seu aplicativo no painel do App Store Connect
Se você tiver acesso ao painel do APp Store Connect, está tudo bem.
É bem simples, faça login no console, selecione o aplicativo certo e encontre o ID da Apple.
#2 Encontrando o ID do seu aplicativo na App Store pública
O ID também está nos URLs públicos nas páginas públicas geradas pela App Store. Você pode ir para a App Store, pesquisar e encontrar seu aplicativo e extrair o ID do URL
Por exemplo, para o Instagram, o URL se parece com este https://apps.apple.com/us/app/instagram/id389801252, e o ID é a parte depois de “id”, então 389801252.
Eu pessoalmente odeio usar a pesquisa deles, então costumo pesquisar no Google com um filtro de site simples.
A busca por instagram seria: site:apps.apple.com instagram.
#3 Encontrando o ID de qualquer aplicativo programaticamente
Você também pode aproveitar o programa de pesquisa do iTunes da Apple programaticamente se precisar encontrar muitos IDs de aplicativos. Tudo isso é público e documentado pela Apple aqui.
Para pesquisar, use o seguinte:
Se você estiver pesquisando aplicativos móveis, a entidade é “software”.
A consulta é seu termo de pesquisa, codificado em URL.
E o código do país é um código ISO 3166-1 (de 2 letras) para o país. Observe que este não é o padrão usado pela App Store Connect API por algum motivo (eles usam códigos de 3 letras).
Curiosidade: os IDs dos aplicativos são chamados de “trackIDs” nesse endpoint (legado do iTunes).
#1 Usando a API App Store Connect da Apple
Isso só funciona se você tiver acesso à API do App Store Connect e se o aplicativo do qual você espera baixar as avaliações for um ao qual você tenha acesso.
Se não, você pode pular este primeiro método.
Usar sua própria API essencialmente apresenta três vantagens
- Você pode postar respostas de volta através da mesma conexão API
- Você pode esperar esquemas de dados consistentes e confiáveis ao longo do tempo. Isso é importante se você planeja monitorar suas avaliações pesquisando regularmente, por exemplo.
- Você pode acessar avaliações em todas as regiões em uma única chamada de API. Chegaremos lá, mas você não pode fazer isso com outras soluções.
O problema é que você terá que se tornar técnico.
Para autenticar com a API do App Store Connect da Apple, você precisará assinar JSON Web Tokens (JWTs). Isso está bem documentado aqui e, se você tiver experiência com JWTs, deve ser bem direto.
Mas se você é um profissional de marketing não técnico procurando baixar uma lista de suas avaliações, pode ser mais fácil passar por uma solução de terceiros.
#2 Usando a API não documentada da Apple
Não documentado é um exagero neste momento, já que este URL está por toda a internet. Se você está procurando dados de baixo nível e não tem medo de configurar alguns proxies, pode tentar isso você mesmo facilmente.
A principal desvantagem aqui é que você precisará verificar cada um dos 116 países na loja em busca de avaliações, o que pode levar um tempo. Aqui está a lista de países com seus códigos novamente para referência.
To scrap App Store reviews, you can leverage this endpoint: `https://itunes.apple.com/{countryCode}/rss/customerreviews/page={page}/sortBy={sort}/id={app_id}/json`
Ele retornará até 50 avaliações por vez, em formato JSON. Bem direto, na verdade.
Existem 4 parâmetros para personalizar sua consulta
- countryCode: Consulte a lista de países acima para obter uma lista completa.
- página: Você precisará implementar a lógica de paginação se quiser obter todas as avaliações disponíveis. Cada página retorna 50 avaliações
- sortBy: A ordem de classificação que você deseja. Provavelmente pode receber alguns valores, mas mostRecent funciona, então por que usar outra coisa?
- app_id: Você pode obter o ID do aplicativo na página do aplicativo no seu navegador. Por exemplo, o ID do aplicativo da Shopify é 324684580
E pronto.
Você obterá uma saída JSON bem pesada com 50 avaliações, informações de paginação no objeto "link" e alguns outros pontos de dados.
Tudo o que resta é despejar a saída em seu analisador JSON favorito e escrever um wrapper.
Armadilhas para ficar de olho
Se você começar a atingir o endpoint sem nenhum tipo de throttling, ele começará a ficar mais lento nas respostas, o que eventualmente leva a timeouts ou erros 403.
Você fica tentando descobrir onde errou para recomeçar no lugar certo. Sem graça.
Com um pouco de throttling, você conseguirá manter respostas rápidas e, no final das contas, é muito mais rápido. Um caso clássico de se colocar no lugar de quem você está raspando.
Use um IP demais (incluindo IPs residenciais limpos se você estiver fazendo isso localmente) e você receberá 403s por alguns minutos ou horas. Você precisará de algum tipo de lógica ou serviço de rotação de proxy se quiser lidar com grandes volumes de avaliações. Os proxies de servidor funcionam muito bem, é realmente apenas uma questão de a Apple se proteger contra scraping agressivo.
A maneira mais fácil de contornar isso é usar APIs de scraping como o Scrapingbee, mas isso pode acabar sendo bastante caro.
Bibliotecas e pacotes
Existem algumas bibliotecas que podem te poupar tempo aqui.
Esta biblioteca python aproveita esse mesmo endpoint e lida com a paginação para você. Esta biblioteca node adapta a biblioteca python para node e também adiciona alguns extras, como o histograma de classificações (que é... no mínimo, não confiável).
#3 Usando as exportações de avaliações do Reviewflowz
Se você não consegue – ou não está com vontade – de escrever um script que percorra 116 países, gire proxies, envolva o JSON da Apple em algo um pouco mais prático, deduplique avaliações em tempo real (a mesma avaliação pode estar em vários países), detecte o idioma, etc., nós temos o que você precisa.
Nossas exportações Pay As You Go permitem que você baixe avaliações de qualquer aplicativo, em qualquer país, em segundos.
Pesquise um aplicativo, selecione o que você deseja e exporte.
Você pode baixar uma amostra de 25 linhas para verificar como o arquivo se parece e se tem tudo o que você precisa, e depois comprar a exportação por $0,10 / linha.
Se você tem um alto volume ou requisitos específicos, sinta-se à vontade para entrar em contato, geralmente podemos ajudar ou recomendar outra pessoa que possa ajudar.
Português
Français
Deutsch
Español
Nederlands
Italiano
English