앱스토어 국가 코드와 스토어프런트 ID

01각 값의 용도

세 가지 값은 세 가지 다른 일을 하며, 이를 섞어 쓰는 것이 빈 결과의 흔한 원인입니다.

• 국가 코드 — 공개 iTunes 엔드포인트가 country=로 받는 두 글자 코드. /search와 /lookup이 이해하는 값입니다.
• 스토어프런트 헤더 — X-Apple-Store-Front 요청 헤더의 값이며 <id>,29 형태입니다. ,29 접미사는 플랫폼 부분이며, ID만 담은 헤더는 조용히 아무것도 돌려주지 않습니다.
• 기본 언어 — Apple이 그 스토어프런트에서 받아들이는 lang= 값. 유효하지 않은 값은 곧바로 거부되지만, 유효하되 잘못된 값은 결과를 그 언어로 읽기 때문에 순위 모습이 조용히 바뀝니다.

02각 행을 검증한 방법

1. 검색 힌트. X-Apple-Store-Front 헤더를 붙여 힌트 요청을 보냅니다. 실제 스토어프런트는 추천 검색어 10개를 돌려주고, 지어낸 ID는 0개를 돌려줍니다. 잘못된 ID를 잡아내는 검사입니다.
2. 언어. lang=을 붙여 lookup을 보냅니다. Apple은 유효하지 않은 값을 명시적으로 거부합니다: Invalid value(s) for key(s): [language]. 후보는 현지 언어부터 시도하고 처음 받아들여진 값을 채택합니다.
3. 국가. 같은 lookup을 country=로 보냅니다. 유효하지 않은 코드는 같은 방식으로 거부됩니다. /search 대신 /lookup을 쓰는 데는 이유가 있습니다. /search는 호출 제한이 엄격해서 130개국 정도를 물으면 Apple이 403을 돌려주고, 403은 “그 국가에 결과 없음”과 구분되지 않습니다.

세 검사를 모두 통과한 행만 공개합니다. ID 자체는 서로 일치하고 이미 실서비스에서 운영 중인 27개 스토어프런트와도 일치하는 독립된 공개 목록 두 개에서 가져왔습니다. 하지만 목록끼리 일치한다고 증거가 되지는 않으므로 하나하나 다시 측정했습니다.

03제외된 2개

방글라데시(bd)와 리히텐슈타인(li)은 돌아다니는 목록에 스토어프런트 ID와 함께 올라 있고, 두 코드 모두 Apple이 오류 없이 받아들입니다. 그래도 실패합니다. 힌트 요청은 검색어 0개를 돌려주고, 알려진 앱을 lookup하면 "resultCount":0이 돌아옵니다.

04175개 스토어프런트 전체

05같은 목록을 언어별로 보기

위의 표는 스토어프런트에서 언어로 읽습니다. ASO 결정은 보통 반대 방향으로 내려집니다. 텍스트를 한 번 쓰면 몇 개의 스토어프런트가 그것을 읽을까요? 175개 스토어프런트는 둘 이상의 스토어프런트를 담당하는 언어 슬롯 13개로 나뉘며, 슬롯마다 전용 페이지가 있습니다.

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

06앱스토어 국가 코드와 스토어프런트 ID의 차이

두 값은 서로 다르며, 실패한 요청 대부분이 이 둘을 섞어 씁니다. 국가 코드는 두 글자 코드이고, 스토어프런트 ID는 Apple의 여섯 자리 숫자로 헤더에 ,29 접미사를 붙여 보냅니다.

영국은 uk가 아니라 gb입니다. 스토어프런트가 무엇인지는 스토어프런트를, 스토어프런트별로 순위를 읽는 방법은 App Store 키워드 순위 추적을 참고하세요.

다음 읽을거리