Google では、OpenRTB と Google の両方のプロトコルに共通の Geo
オブジェクトを通じて位置情報を提供します。このドキュメントでは、Google が入札リクエストで位置情報を入力する仕組みについて詳細に説明し、おすすめの方法を紹介します。
Geo オブジェクトへのデータ入力方法
Google は、IP の位置情報のみからデバイスの位置情報を入手します。GPS などの情報源から調達することはありません。OpenRTB の仕様では、ユーザー(自宅の住所など)とデバイス(広告が表示されるデバイスの場所)の個別の位置情報をサポートしていますが、Google では後者のみをサポートしています。そのため、Google プロトコルの BidRequest.geo
には Geo
オブジェクトが 1 つだけ含まれます。OpenRTB の場合は、Device.geo
フィールドにのみ値が入力されます。
Geo
オブジェクト フィールドは、両方のプロトコルで同じように設定されます。次のフィールドは Geo
オブジェクトの OpenRTB バリアントにのみ存在し、regionfips104
、lastfix
、type
、ipservice
のいずれかのプロトコルで Google によって入力されることはありません。上記のサポートされていないフィールドのほとんどは、代替の場所ソースに関連しています。
プライバシー保護
ユーザーのプライバシーを保護するため、Google では十分な数のユーザーが共有する大まかな位置情報のみを提供し、必要に応じて、検出された位置情報を一般化しています。
位置情報の表現
Geo
オブジェクトは、位置の 2 つの個別の表現(行政区域と地理座標)をサポートしています。
行政区域は、次のフィールドで表されます。
country
region
metro
city
zip
地理座標は次のフィールドで表されます。
lat
lon
accuracy
Google プロトコルと OpenRTB プロトコルはどちらも、同じ場所と精度が格納されています。たとえば、入札リクエストで Geo
に都市レベルの精度が入力される場合、lat
フィールドと lon
フィールドには識別された都市の中心点の緯度と経度が含まれ、accuracy
はその都市と同じ面積の円の半径になります。また、lat
フィールドと lon
フィールドの精度は 0.01 度に制限されています。
地域ターゲティングに関するおすすめの方法
カスタムの位置情報を必要とするビッダーの場合は、おおよその位置情報のルックアップに、おおよその lat
、lon
、accuracy
フィールドを使用することをおすすめします。Google では短縮された形式の IP アドレスのみを共有するため、位置情報に ip
フィールドを使用することはおすすめしません。位置情報に短縮された IP アドレスを使用すると、結果が多少不正確になる可能性があります。
地域テーブル
geo_criteria_id
フィールドは、位置情報を数値識別子で表します。これは、geo-table.csv 内の位置情報にマッピングされています。この位置情報は、「プロトコルと参照データ」ページの
「リファレンス テーブル」セクションからダウンロードできます。このフィールドと対応するテーブルのサポートは終了しました。上記の Geo
フィールドを使用して、同様の位置情報を取得できます。たとえば、入札リクエストで Geo
に都市レベルの精度が入力されている場合、geo_criteria_id
には対応する都市のコードが格納されています。この ID を使用して、地域テーブル内のレコードを見つけることができます。
列
- 条件 ID
- 永続的に割り当てられる固有の ID です。API では、これらの条件は
Location
型です。 - 名前
- ターゲット地域に付けることができる最適な英語の名前です。
- 正規名
- ターゲット地域の名前と、その地域が属する親地域と国の名前がすべて正規の英語名で含まれます。このフィールドは、類似したターゲット地域名を区別することのみを目的とするもので、LocationCriterionService ではサポートされていません(代わりに地域名や条件 ID を使用してください)。
- 親 ID
- 親項目の条件 ID です。このフィールドは以前のサポートのために含まれているため、データセット間で ID が一致しない場合があります。階層を構築するには正規名を使用することをおすすめします。
- 地域コード
- 都道府県の ISO 3166-2 地域コード(存在する場合)。
- Country Code
- ターゲット地域に関連付けられる国コード(ISO-3166-1 alpha-2)です。
- ターゲット タイプ
次の値が許可されます。
- 空港
- 区
- 自治体
- 特別区
- 小郡
- 都市
- 都市地域
- 下院選挙区
- 国
- 郡
- 県
- 地区
- DMA 地域
- 行政区域
- Metro
- 地方自治体
- 国立公園
- 大字
- 管区
- Other
- 郵便番号
- 都道府県
- 州
- リージョン
- 状態
- 地域
- テレビ地域
- 連邦直轄領
- 大学
ターゲットに設定できない場所
中華人民共和国の広告規制と法律により、特定のカテゴリの商品を中国で宣伝する場合、認定証およびライセンスの提出を求められる場合があります。アカウントが有効になるまで、証明書を送信する必要はありません。アカウントが有効になると、Google に証明書を送信する方法に関する情報が表示されます。