Códigos de país de los storefronts del App Store

01Cómo se usan los valores

Tres valores distintos hacen tres trabajos distintos, y confundirlos es la causa habitual de un resultado vacío:

• Código de país: el código de dos letras que los endpoints públicos de iTunes aceptan como country=. Es lo que entienden /search y /lookup.
• Cabecera de storefront: el valor de la cabecera de solicitud X-Apple-Store-Front, con la forma <id>,29. El sufijo ,29 es la parte de plataforma; una cabecera con el ID solo no devuelve nada, sin avisar.
• Idioma predeterminado: el valor de lang= que Apple acepta para ese storefront. Uno no válido se rechaza directamente; uno válido pero equivocado cambia en silencio cómo se ve el ranking, porque los resultados se leen en ese idioma.

02Cómo se verificó cada fila

1. Sugerencias de búsqueda. Se envía una solicitud de sugerencias con la cabecera X-Apple-Store-Front. Un storefront real devuelve 10 términos sugeridos; un ID inventado devuelve 0. Esta es la comprobación que detecta un ID erróneo.
2. Idioma. Se hace un lookup con lang=. Apple rechaza explícitamente un valor no válido: Invalid value(s) for key(s): [language]. Los candidatos se prueban empezando por el idioma local y se conserva el primero aceptado.
3. País. Se hace el mismo lookup con country=. Un código no válido se rechaza del mismo modo. Se usa /lookup en lugar de /search a propósito: /search tiene un límite de solicitudes tan estricto que preguntar por 130 países hace que Apple devuelva 403, y un 403 no se distingue de “sin resultados en ese país”.

Una fila solo se publica si pasa las tres. Los propios ID salieron de dos listas públicas independientes que coinciden entre sí y con los 27 storefronts que ya funcionan en producción, pero la coincidencia entre listas no es evidencia, así que cada uno se mide igualmente.

03Los 2 que se descartaron

Bangladés (bd) y Liechtenstein (li) aparecen en las listas que circulan con ID de storefront, y Apple acepta ambos códigos sin error. Aun así fallan: la solicitud de sugerencias devuelve 0 términos, y un lookup de una app conocida devuelve "resultCount":0.

04Los 175 storefronts

05La misma lista, leída por idioma

La tabla de arriba va de storefront a idioma. La decisión de ASO suele ir en sentido contrario: escribe el texto una vez, ¿cuántos storefronts lo leen? Los 175 storefronts se reparten en 13 huecos de idioma que cubren más de un storefront, y cada hueco tiene su propia 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 del App Store frente a ID de storefront

Son dos valores distintos y la mayoría de las solicitudes fallidas los confunden. El código de país es el código de dos letras; el ID de storefront es el número de seis dígitos de Apple, que se envía en la cabecera con el sufijo ,29:

El Reino Unido es gb, no uk. Para saber qué es un storefront, consulte storefront; para ver cómo se lee la posición por storefront, seguimiento de posiciones de palabras clave en App Store.

Sigue leyendo