Códigos de país dos storefronts da App Store

01Como os valores são usados

Três valores diferentes fazem três trabalhos diferentes, e confundi-los é a causa comum de um resultado vazio:

• Código de país — o código de duas letras que os endpoints públicos do iTunes recebem como country=. É o que /search e /lookup entendem.
• Cabeçalho de storefront — o valor do cabeçalho de requisição X-Apple-Store-Front, no formato <id>,29. O sufixo ,29 é a parte da plataforma; um cabeçalho com o ID puro devolve nada, em silêncio.
• Idioma padrão — o valor lang= que a Apple aceita para aquele storefront. Um valor inválido é rejeitado na hora; um válido mas errado muda discretamente como o ranking aparece, porque os resultados são lidos naquele idioma.

02Como cada linha foi verificada

1. Sugestões de busca. Uma requisição de sugestões é enviada com o cabeçalho X-Apple-Store-Front. Um storefront real devolve 10 termos sugeridos; um ID inventado devolve 0. Essa é a verificação que pega um ID errado.
2. Idioma. Um lookup é feito com lang=. A Apple rejeita um valor inválido de forma explícita: Invalid value(s) for key(s): [language]. Os candidatos são testados começando pelo idioma local, e o primeiro aceito é mantido.
3. País. O mesmo lookup é feito com country=. Um código inválido é rejeitado do mesmo jeito. /lookup é usado em vez de /search de propósito: o /search tem um limite de requisições tão rígido que perguntar sobre 130 países faz a Apple devolver 403, e um 403 é indistinguível de “nenhum resultado naquele país”.

Uma linha só é publicada se passar nas três. Os IDs em si vieram de duas listas públicas independentes que concordam entre si e com os 27 storefronts que já rodam em produção — mas concordância entre listas não é prova, então cada um é medido mesmo assim.

03Os 2 que foram descartados

Bangladesh (bd) e Liechtenstein (li) aparecem nas listas que circulam com IDs de storefront, e os dois códigos são aceitos pela Apple sem erro. Mesmo assim falham: a requisição de sugestões devolve 0 termos, e um lookup de um app conhecido devolve "resultCount":0.

04Todos os 175 storefronts

05A mesma lista, lida por idioma

A tabela acima vai do storefront ao idioma. A decisão de ASO normalmente vai no sentido contrário: você escreve o texto uma vez — quantos storefronts o leem? Os 175 storefronts se dividem em 13 espaços de idioma que cobrem mais de um storefront, e cada espaço tem a sua própria página.

• en-GB — 85 storefronts
• es-MX — 17 storefronts
• ar-SA — 11 storefronts
• fr-FR — 9 storefronts
• ru-RU — 6 storefronts
• de-DE — 3 storefronts
• en-US — 3 storefronts
• el-GR — 2 storefronts
• en-AU — 2 storefronts
• nl-NL — 2 storefronts
• pt-PT — 2 storefronts
• ro-RO — 2 storefronts
• zh-HK — 2 storefronts

06Código de país da App Store vs. ID de storefront

São dois valores diferentes, e a maioria das requisições que falham confunde os dois. O código de país é o código de duas letras; o ID de storefront é o número de seis dígitos da Apple, enviado no cabeçalho com o sufixo ,29:

O Reino Unido é gb, não uk. Para entender o que é um storefront, veja storefront; para saber como a posição é lida por storefront, rastreamento de posições de palavras-chave na App Store.

Leia também