Google은 Geo
객체를 통해 위치정보를 제공합니다. 이 문서에서는 Google이 입찰 요청에 위치정보를 채우는 방법을 상위 수준으로 자세히 설명하고 이를 사용하는 데 관한 권장사항을 제안합니다.
Geo 객체가 채워지는 방식
Google은 광고가 렌더링될 기기의 위치를 설명하는 위치정보만 지원하며, 이 위치정보는 BidRequest.device.geo
에 노출됩니다. 이 위치 정보는 GPS나 다른 소스가 아닌 IP 위치정보에서만 얻을 수 있습니다.
개인 정보 보호
Google은 사용자 개인 정보를 보호하기 위해 충분히 많은 수의 사용자가 공유하는 대략적인 위치만 제공하며, 필요한 경우 감지된 위치를 일반화합니다.
위치 표현
Geo
객체는 두 가지 위치 표현(민간 위치 및 지리적 좌표)을 지원합니다.
민간 위치는 다음 필드로 표시됩니다.
country
region
metro
city
zip
지리적 좌표는 다음 필드로 표시됩니다.
lat
lon
accuracy
두 표현 모두 동일한 위치와 정확도를 포함합니다. 예를 들어 입찰 요청에서 BidRequest.device.geo
를 도시 수준의 정밀도로 채우면 lat
및 lon
필드에 식별된 도시의 중심점의 위도와 경도가 포함되고 accuracy
는 해당 도시와 면적이 동일한 원의 반지름이 됩니다. 또한 Google은 lat
및 lon
필드의 정밀도를 0.01도(deg)로 제한합니다.
위치 타겟팅 권장사항
맞춤 위치정보 데이터가 필요한 입찰자의 경우 공간 위치정보 조회를 실행할 때 대략적인 lat
, lon
, accuracy
필드를 사용하는 것이 좋습니다.
Google은 IP 주소를 잘린 형식으로만 공유하므로 위치정보 획득에 BidRequest.device.ip
필드를 사용하지 않는 것이 좋습니다. 위치정보 획득에 잘린 IP 주소를 사용하면 다소 부정확한 결과가 나올 수 있습니다.
Geo 테이블 (지원 중단됨)
BidRequest.device.geo.ext.geo_criteria_id
필드는 지역을 숫자 식별자로 나타내며, 이는 Protos 및 참조 데이터 페이지의 참조 표 섹션에서 다운로드할 수 있는 geo-table.csv의 지역 위치에 매핑됩니다. 이 필드와 해당 테이블은 현재 지원 중단되었습니다. BidRequest.device.geo
을 사용하여 유사한 위치정보를 가져올 수 있습니다.
예를 들어 입찰 요청에서 geo
를 도시 수준의 정밀도로 채우면 geo_criteria_id
에 해당 도시의 코드가 포함됩니다. 이 ID를 사용하여 지역 테이블에서 레코드를 찾을 수 있습니다.
열
- 기준 ID
- 고유하고 영구적으로 할당된 ID입니다. API에서 이러한 기준은
Location
유형입니다. - 이름
- 사용 가능한 가장 적합한 지역 타겟의 영어 이름입니다.
- 표준 이름
- 타겟 자체 이름, 상위 요소 및 국가 이름으로 구성된 정규화된 전체 영어 이름입니다. 이 필드는 유사한 타겟 이름을 구분하는 데만 사용됩니다. LocationCriterionService에서는 지원되지 않습니다(대신 위치 이름 또는 기준 ID 사용).
- 상위 ID
- 상위 요소의 기준 ID입니다. 이 필드는 기존 지원을 위해 포함되어 있으며 데이터 세트 간에 ID가 일관되지 않을 수 있습니다. 계층 구조를 구성하는 데는 표준 이름이 권장됩니다.
- 지역 코드
- 타겟 주 또는 현의 ISO 3166-2 지역 코드입니다(있는 경우).
- 국가 코드
- 타겟과 연결된 ISO-3166-1 alpha-2 국가 코드입니다.
- 타겟 유형
허용되는 값:
- 공항
- 아롱디스망
- 자치지구
- 자치구
- 주
- 도시
- 도시 지역
- 하원의원 선거구
- 국가
- 카운티
- 도
- 구
- DMA 지역
- 행정 단위
- METRO
- 지방 자치체
- 국립공원
- 동네
- 자치구역
- 기타
- 우편번호
- 현
- 도
- 지역
- 주
- 지역
- TV 수신지역
- 연방 직할지
- 대학교
타겟팅할 수 없는 위치
중화인민공화국의 광고 규정 및 법률에 따라 중국에서 특정 제품 카테고리를 광고하는 경우 인증서 및 라이선스를 제공하라는 요청을 받을 수 있습니다. 계정이 활성화될 때까지 인증서를 제출할 필요가 없습니다. 계정이 활성화되면 Google에 인증서를 제출하는 방법에 관한 정보가 제공됩니다.