Por que meu link da App Store deu 404 e a página mostrava capturas de 2018

Por Nesim Razon, desenvolvedor Android independente · 2026-11-16

#Notas de desenvolvimento#iOS

Um dos meus apps, um app de resultados de loteria para a Turquia, está na App Store desde 2018. Neste mês ele finalmente ganhou uma versão moderna para iPhone. Depois disso duas coisas me surpreenderam: o link da loja não funcionava para a maioria das pessoas e a página já aprovada ainda mostrava as capturas antigas de 2018. As duas tinham causas simples. Isto é o que eu vi, e tudo o que segue é o que aconteceu no meu caso, não uma regra geral sobre como a Apple funciona.

O link que mostrava "não encontrado"

Eu precisava do link da loja para o formulário "vincule seu app" de uma rede de anúncios, e também queria colocá-lo no meu site. Usei a forma genérica, apps.apple.com/app/id<ID>. No meu próprio celular funcionava. Ao testar de outros lugares, e quando o formulário da rede de anúncios tentou encontrar o app, ele dizia que o app não foi encontrado.

Pelo que pude ver, esse link genérico envia cada visitante para a loja da própria região. Meu app estava disponível apenas na loja da Turquia. Para um visitante cuja região de loja era outra, a página a que chegava não tinha esse app, então ele recebia um 404.

A correção: colocar o país no link

A forma com país, apps.apple.com/tr/app/id<ID>, funcionou com todos os que testei, porque aponta para a única loja onde o app existe. O formulário da rede de anúncios também encontrou o app ao usar esse link.

No meu site adicionei um pequeno ajuste. A entrada de um app na configuração pode ser escrita como "tr:<ID>" em vez de apenas "<ID>", e a geração do site então produz o link com país. Entradas sem prefixo continuam gerando o link genérico. É uma mudança minúscula, mas me poupa de corrigir a mesma coisa à mão em cada página.

Um jeito rápido de ver em quais lojas seu app está

A Apple tem um ponto de consulta público: itunes.apple.com/lookup?id=<ID>&country=<cc>. Para cada código de país de duas letras ele devolve um JSON com resultCount. Nas minhas verificações o valor era 1 onde o app aparecia e 0 onde não aparecia. Percorrer uma lista de países e ver como você está leva segundos e não exige login.

Também executei a consulta para um segundo app meu, recém-lançado. Ele apareceu em cerca de metade das lojas que testei: Estados Unidos, Reino Unido, Canadá, Austrália, Turquia e mais algumas. Ainda não aparecia nos países da UE.

Não aparecer pode significar coisas diferentes

As lojas da UE que faltavam coincidiam com algo que vi no App Store Connect, um item de conformidade chamado "Digital Services Act" (Lei de Serviços Digitais) com o status "In Review" (em análise), abrangendo 27 países e regiões. Ele trata da verificação de comerciante. Então, nesse app, a lacuna era muito provavelmente uma análise de conformidade, algo que não consigo resolver mudando uma configuração.

Foi isso que levei dali. Um resultado 0 para um país pode significar pelo menos três coisas diferentes:

• O país não está selecionado nas configurações de disponibilidade do app.
• A versão ainda está se propagando e ainda não chegou àquela loja.
• Há uma análise de conformidade pendente para aquela região.

A segunda surpresa: capturas de 2018

Depois que a versão nova foi aprovada e publicada, abri a página da loja e as capturas ainda eram as antigas de 2018. Consultei a API de novo. A lista screenshotUrls tinha sete imagens, todas no formato antigo, mais estreito, de 9:16. Meu novo conjunto de 6,9 polegadas não estava lá.

O Media Manager do App Store Connect mostrava o motivo. Minhas capturas novas estavam na seção obrigatória para os celulares mais recentes, "iPhone with Dynamic Island (medium display)". Mas os conjuntos antigos de versões anteriores continuavam presentes em outros tamanhos de dispositivo, como "iPhone with Face ID (medium display)" e "iPhone with Home Button (large display)". No meu caso, a página usava esses conjuntos antigos, e não o novo.

Corrigir exigiu uma versão nova

As capturas de uma versão que já está publicada não podiam ser editadas. Então criei a versão 4.0.1, apaguei lá os conjuntos antigos e deixei só o novo.

Uma versão nova também precisa de um build com esse número de versão, então tive de compilar e enviar um binário novo só para trocar as imagens. É um jeito lento de substituir capturas, mas não encontrei outra opção para uma versão publicada.

Descrevo isso como funcionou para mim. Não testei se outros tamanhos se comportam do mesmo jeito em todas as páginas.

O que eu faria diferente

Disso saem dois hábitos pequenos. Primeiro, quando adiciono uma versão moderna para iPhone a uma página antiga, agora limpo todos os conjuntos de tamanhos de dispositivo antigos antes de enviar, e não só a seção que parece obrigatória. Segundo, depois de cada lançamento verifico a página pública de verdade e a API de consulta, e não apenas as telas do App Store Connect, porque elas me mostraram coisas diferentes.

Com os links, agora uso a forma com país sempre que um app não está disponível no mundo todo, e executo a consulta para um punhado de países antes de enviar um link a alguém, inclusive a uma rede de anúncios.