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에 인증서를 제출하는 방법에 관한 정보가 제공됩니다.
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eGoogle uses IP geolocation to provide coarse location data in bid requests, prioritizing user privacy by generalizing the location.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGeo\u003c/code\u003e object contains civil location fields (country, region, etc.) and geographical coordinates (lat, lon, accuracy) representing the same location.\u003c/p\u003e\n"],["\u003cp\u003eFor custom geolocation targeting, utilize the \u003ccode\u003elat\u003c/code\u003e, \u003ccode\u003elon\u003c/code\u003e, and \u003ccode\u003eaccuracy\u003c/code\u003e fields for spatial lookups instead of the truncated \u003ccode\u003eip\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egeo_criteria_id\u003c/code\u003e and associated geo-table are deprecated; migrate to the \u003ccode\u003eGeo\u003c/code\u003e object for location information.\u003c/p\u003e\n"],["\u003cp\u003eWhile some locations may appear in reports, they might be non-targetable due to advertising regulations, like those in China.\u003c/p\u003e\n"]]],[],null,["# Geographical Targeting\n\nGoogle provides geolocation information through the\n[`Geo`](/authorized-buyers/rtb/openrtb-guide#geo) object. This document\ndescribes higher-level details of how Google populates geolocation in bid\nrequests and suggests best practices for its use.\n| **Note:** The `BidRequest.device.geo.ext.geo_criteria_id` field is deprecated; we encourage using the `Geo` object instead.\n\nHow the Geo object is populated\n-------------------------------\n\nGoogle only supports geolocation information describing the location of the\ndevice on which the ad would be rendered, which is exposed in\n`BidRequest.device.geo`. This location information is only obtained from IP\ngeolocation, never from GPS or other sources.\n\nPrivacy protections\n-------------------\n\nIn order to protect user privacy, Google only provides a coarse geolocation that\nis shared by a sufficiently large number of users, generalizing detected\nlocation as necessary.\n\nLocation representations\n------------------------\n\nThe `Geo` object supports two separate representations of location -- civil\nlocation and geographical coordinates.\n\nCivil locations are represented by the following fields:\n\n- `country`\n- `region`\n- `metro`\n- `city`\n- `zip`\n\nGeographical coordinates are represented by the following fields:\n\n- `lat`\n- `lon`\n- `accuracy`\n\nBoth representations contain the same location and accuracy. For example, if a\nbid request populates `BidRequest.device.geo` with city-level precision, then\nthe `lat` and `lon` fields will contain the latitude and longitude of the\ncenterpoint of the identified city, and `accuracy` will be the radius of a\ncircle with the same area as that city. Google also limits the precision of the\n`lat` and `lon` fields to 0.01 degrees.\n\n### Best practices for geolocation targeting\n\nFor bidders that need custom geolocation data we recommend using the approximate\n`lat`, `lon` and `accuracy` fields for performing spatial geolocation lookups.\nWe don't recommend the use of the `BidRequest.device.ip` field for geolocation,\nsince Google only shares the IP address in truncated form; the use of truncated\nIP addresses for geolocation can result in somewhat inaccurate results.\n\nThe Geo Table (Deprecated)\n--------------------------\n\n| **Caution:** Google strongly recommends using `BidRequest.device.geo` instead. Support for the geo criteria ID has been temporarily added with the `BidRequest.device.geo.ext.geo_criteria_id` extension in order to simplify migration from the obsolete Google RTB protocol. Support for this extension can be removed at any time after May 1st, 2025.\n\nThe `BidRequest.device.geo.ext.geo_criteria_id` field represents geolocation as\na numeric identifier, which is mapped to a geolocation in **geo-table.csv**\navailable for download in the\n[Reference tables section](/authorized-buyers/rtb/data#reference-tables-click-to-download-csvs)\nof the Protos \\& Reference Data page. **This field and the corresponding table\nare now deprecated** . You can use `BidRequest.device.geo` to get similar\ngeolocation information.\n\nAs an example, if a bid request populates `geo` with city-level precision, then\nthe `geo_criteria_id` will contain the code for the corresponding city. You can\nuse that ID to locate a record in the geo table.\n\n### Columns\n\nCriteria ID\n: Unique and persistent assigned ID. In the API, these criteria are of type\n [`Location`](/adwords/api/docs/reference/latest/CampaignCriterionService.Location).\n\nName\n: Best available English name of the geo target.\n\nCanonical Name\n: The constructed fully qualified English name consisting of the target's own\n name, and that of its parent and country. This field is meant only for\n disambiguating similar target names--it's not supported in\n [LocationCriterionService](/adwords/api/docs/reference/latest/LocationCriterionService)\n (use location names or criteria IDs instead).\n\nParent ID\n: The criteria ID of a parent. This field is included for legacy support,\n and the IDs may not be consistent across datasets. Canonical names is the\n preferred method of constructing hierarchies.\n\nRegion Code\n: The ISO 3166-2 region code for the state or province target, if one exists.\n\nCountry Code\n: The ISO-3166-1 alpha-2 country code that is associated with the target.\n\nTarget Type\n\n: Allowable values:\n\n - Airport\n - Arrondissement\n - Autonomous Community\n - Borough\n - Canton\n - City\n - City Region\n - Congressional District\n - Country\n - County\n - Department\n - District\n - DMA region\n - Governorate\n - Metro\n - Municipality\n - National Park\n - Neighborhood\n - Okrug\n - Other\n - Postal Code\n - Prefecture\n - Province\n - Region\n - State\n - Territory\n - TV Region\n - Union Territory\n - University\n\n### Non-targetable locations\n\n| **Note:** Some countries or territories are not targetable, but may appear in reports based on the user's area of interest or physical location.\n\nDue to advertising regulations and laws of the People's Republic of China, you\nmay be asked to provide certificates and licenses if you are advertising certain\ncategories of products in China. You do not need to submit certificates until\nafter your account has been activated. Once your account is active, you will be\nprovided with information on how to submit certificates to Google."]]
