地理的位置情報データは、特定の国/地域、都道府県、郡、メトロエリア (米国の Microsoft Market Area)、郵便番号、市区町村のユーザーに広告を表示する場合など、位置情報のターゲット設定に使用できます。 GetGeoLocationsFileUrl 操作を呼び出して、最新の地理的な場所のデータをダウンロードするために使用できる一時ファイル URL を取得できます。 Microsoft Advertising 開発者ポータルから場所データを取得することもできます。 Microsoft Advertising 資格情報を持つ Microsoft アカウント ユーザーを使用して開発者ポータルにサインインする必要があります。
注:
ベスト プラクティスとして、ファイルは、Microsoft Excel などのアプリケーションを介して直接開くのではなく、ダウンロードする必要があります。 テキスト エディターで場所データを表示する場合は、ANSI ではなく UTF-8 エンコードを使用してください。それ以外の場合、一部の文字は正確に表示されません。
地理的な場所コードをダウンロードする方法を示すコード例については、「 地理的な場所のコード例」を参照してください。
場所コードファイルの形式
コンマ区切り値 (CSV) ファイルには、次のローカライズされていない列見出しに整理されたデータが含まれています。 上記で使用したファイル URL に応じて、Bing表示名のみがローカライズされます。
重要
新しい列はいつでも追加できるため、実装では不明な列を無視する必要があります。
場所の順序は保証されないため、認識される列の並べ替え順序や階層に依存しないようにしてください。
ファイル形式バージョン 2.0
GetGeoLocationsFileUrl 操作を呼び出すときにバージョンを 2.0 として指定した場合、ダウンロードしたファイルで次のデータを使用できます。 Bing Ads API では現在、ファイル形式バージョン 2.0 のみがサポートされています。
| 列名 | 説明 |
|---|---|
| 場所 ID | 場所の一意の Microsoft Advertising システム識別子。 場所の条件を設定するには、この値を使用する必要があります。 |
| Bing表示名 | アプリケーションのユーザーなど、場所データを表示するために使用できる省略可能な名前。 垂直バーは、位置コンポーネントを最も具体的なものから最も具体的なものまで分離するために使用されます。 たとえば、Seattle|ワシントン|米国最も具体的なコンポーネントは、米国のワシントン州内のシアトル市です。 複数の場所 ID に同じ表示名を付けることができます。 表示名はプレゼンテーション以外には使用しないでください。たとえば、階層を想定したり、表示名に依存関係を設定したりしないでください。 |
| 場所の種類 | Location Id 列に対応する場所のサブタイプ (市区町村、郡、国、MetroArea、PostalCode、State など) を決定します。 近隣の場所は近日公開予定です。 新しい場所のサブタイプはいつでも追加できます。 特定の場所 ID の場所の種類が変更されることはほとんどありません。 |
| 置き換えます | この行の場所に置き換えられる場所または場所を示すために、将来使用するために予約されています。 |
| 状態 | この行の場所がアクティブか、保留中の非推奨か、非推奨かを示します。 - アクティブ: 場所をターゲットにするか除外できます。 - 非推奨の保留中: 場所は引き続き配信エンジンによってターゲットまたは除外に使用されます。ただし、場所は今後 30 日以内に非推奨になります。 - 非推奨: ターゲットまたは除外に場所の条件が使用されなくなりました。 非推奨の場所条件は、Bing広告 API ( GetCampaignCriterionsByIds など) を介して引き続き取得できますが、非推奨の場所条件を追加または更新することはできません。 GetGeoLocationsFileUrl 操作を毎月 1 回または 2 回呼び出して、ファイルの内容 (状態など) が変更されたかどうかを判断することを検討してください。 前回の場所データの同期以降に返された LastModifiedTimeUtc 値が変更されていない限り、ファイル全体をダウンロードする必要はありません。 |
| AdWords の位置情報 ID | Microsoft 広告の地理的位置情報 ID に最も近い Google 広告の位置情報 ID。 これは、Microsoft 広告の場所を推定 Google 広告の場所にマッピングするために使用できます。 この値は、Google 広告と Microsoft 広告の地理的な場所のマッピングに使用できるヒューリスティックな見積もりです。 場所がマップされていない場合、フィールドは空です。 |
国コード
一部のコンテキストでは、API には国コード文字列 ( たとえば、AdvertiserAccount オブジェクトのビジネス アドレス) が必要です。 Microsoft Advertising では、次の国コードがサポートされています。
| Country Code | 国/地域名 |
|---|---|
| Af | アフガニスタン |
| アル | アルバニア |
| アルジェリア | アルジェリア |
| AS | 米領サモア |
| 広告 | アンドラ |
| Ao | アンゴラ |
| Ai | アンギラ |
| Aq | 南極大陸 |
| Ag | アンティグア バーブーダ |
| Ar | アルゼンチン |
| 午前 | アルメニア |
| Aw | アルバ |
| Au | オーストラリア |
| AT | オーストリア |
| アリゾナ 州 | アゼルバイジャン |
| Bs | バハマ、 |
| Bh | バーレーン |
| Bd | バングラデシュ |
| Bb | バルバドス |
| BY | ベラルーシ |
| Bve | ベルギー |
| Bz | ベリーズ |
| Bj | ベナン |
| Bm | バミューダ諸島 |
| Bt | ブータン |
| ボー | ボリビア |
| AN | ボネール、キュラソー、サバ、シント・ユースタティウス、シント・マールテン |
| Ba | ボスニア・ヘルツェゴビナ |
| Bw | ボツワナ |
| Br | ブラジル |
| Bn | ブルネイ |
| BG | ブルガリア |
| Bf | ブルキナファソ |
| Bi | ブルンジ |
| CV | カーボベルデ |
| 瀬 | カンボジア |
| Cm | カメルーン |
| CA | カナダ |
| ケンタッキー 州 | ケイマン諸島 |
| Cf | 中央アフリカ共和国 |
| Td | チャド |
| Cl | チリ |
| Cn | 中国 |
| Cx | クリスマス島 |
| CC | ココス諸島 |
| 共同 | コロンビア |
| Km | コモロ |
| Cg | コンゴ |
| Cd | コンゴ民主共和国 |
| Ck | クック諸島 |
| Cr | コスタリカ |
| CI | Ivory Coast (Côte d'Ivoire) |
| HR | クロアチア |
| Cy | キプロス |
| Cz | チェコ共和国 |
| DK | デンマーク |
| Dj | ジブチ |
| Dm | ドミニカ |
| DO | ドミニカ共和国 |
| Ec | エクアドル |
| 例えば | エジプト |
| SV | エルサルバドル |
| Gq | 赤道ギニア |
| ER | エリトリア |
| EE | エストニア |
| Et | エチオピア |
| Fk | フォークランド諸島 |
| FO | フェロー諸島 |
| Fj | フィジー諸島 |
| FI | フィンランド |
| FR | フランス |
| Gf | フランス領ギアナ |
| Pf | フランス領ポリネシア |
| GA | ガボン |
| Gm | ガンビア、 |
| Ge | ジョージア |
| DE | ドイツ |
| Gh | ガーナ |
| Gi | ジブラルタル |
| GR | ギリシャ |
| Gl | グリーンランド |
| Gd | グレナダ |
| Gp | グアドループ |
| 区 | グアム |
| GT | グアテマラ |
| Gn | ギニア |
| Gw | ギニアビサウ |
| Gy | ガイアナ |
| Ht | ハイチ |
| Hn | ホンジュラス |
| Hk | 香港 |
| 胡 | ハンガリー |
| は | アイスランド |
| IN | インド |
| ID | インドネシア |
| IQ | イラク |
| IE | アイルランド |
| イリノイ | イスラエル |
| IT | イタリア |
| Jm | ジャマイカ |
| Jp | 日本 |
| ジョー | ヨルダン |
| カザフスタン | カザフスタン |
| 柯 | ケニア |
| 氣 | キリバス |
| Kr | 韓国 |
| Kw | クウェート |
| Kg | キルギスタン |
| La | ラオス |
| Lv | ラトビア |
| ポンド | レバノン |
| Ls | レソト |
| Lr | リベリア |
| Ly | リビア |
| 李 | リヒテンシュタイン |
| 中尉 | リトアニア |
| Lu | ルクセンブルク |
| Mo | マカオ特別行政区 |
| Mk | 北マケドニア旧ユーゴスラビア共和国 |
| Mg | マダガスカル |
| Mw | マラウイ |
| 私の | マレーシア |
| Mv | モルディブ |
| Ml | マリ |
| 山 | マルタ |
| Mh | マーシャル諸島 |
| Mq | マルティニーク島 |
| 氏 | モーリタニア |
| Mu | モーリシャス |
| Yt | マイヨット |
| MX | メキシコ |
| Fm | ミクロネシア |
| Md | モルドバ |
| Mc | モナコ |
| ミネソタ | モンゴル |
| 私 | モンテネグロ |
| さん | モントセラト |
| Ma | モロッコ |
| Mz | モザンビーク |
| MM | ミャンマー |
| 該当なし | ナミビア |
| Nr | ナウル |
| Np | ネパール |
| NL | オランダ |
| Nc | ニューカレドニア |
| Nz | ニュージーランド |
| Ni | ニカラグア |
| NE | ニジェール |
| Ng | ナイジェリア |
| ニュー | ニウエ |
| Nf | ノーフォーク島 |
| Mp | 北マリアナ諸島 |
| 動作しない | ノルウェー |
| Om | オマーン |
| Pk | パキスタン |
| PW | パラオ |
| Ps | パレスチナ自治政府 |
| Pa | パナマ |
| Pg | パプアニューギニア |
| Py | パラグアイ |
| Pe | ペルー |
| PH | フィリピン |
| Pn | ピトケアン諸島 |
| PL | ポーランド |
| Pt | ポルトガル |
| Pr | プエルトリコ |
| Qa | カタール |
| 再 | レユニオン |
| Ro | ルーマニア |
| Ru | ロシア |
| Rw | ルワンダ |
| Sh | セントヘレナ島 |
| Kn | セントクリストファー ネイビス |
| Lc | セントルシア |
| Pm | サンピエール島/ミクロン島 |
| Vc | セントビンセント グレナディーン |
| Ws | サモア |
| Sm | サンマリノ |
| 聖 | サントメとプリンシペ |
| SA | サウジアラビア |
| Sn | セネガル |
| Rs | セルビア |
| Sc | セーシェル |
| SL | シエラレオネ |
| Sg | シンガポール |
| Sk | スロバキア |
| Si | スロベニア |
| Sb | ソロモン諸島 |
| だから | ソマリア |
| 座 | 南アフリカ |
| Es | スペイン |
| Lk | スリランカ |
| シニア | スリナム |
| Sz | スワジランド |
| SE | スウェーデン |
| Ch | スイス |
| Tw | 台湾 |
| Tj | タジキスタン |
| Tz | Tanzania |
| 番目 | タイ |
| Tl | ティモール・レステ |
| Tg | トーゴ |
| TK | トケラウ諸島 |
| TO | トンガ |
| TT | トリニダード・トバゴ |
| テネシー | チュニジア |
| Tr | Türkiye |
| Tm | トルクメニスタン |
| Tc | タークス カイコス諸島 |
| TV | ツバル |
| Ug | ウガンダ |
| Ua | ウクライナ |
| Ae | アラブ首長国連邦 |
| Gb | 英国 |
| US | 米国 |
| ウルグアイ | ウルグアイ |
| Uz | ウズベキスタン |
| Vu | バヌアツ |
| バージニア 州 | バチカン市国 |
| Ve | ベネズエラ |
| Vn | ベトナム |
| Vg | ヴァージン諸島、イギリス |
| Vi | バージン諸島、アメリカ合衆国 |
| Wf | ウォリス フツナ |
| あなたがた | イエメン |
| ザンビア | ザンビア |
| ZW | ジンバブエ |