地理位置數據可用於定位目標，例如向特定國家/地區、州/省、縣、都市區域 (microsoft 市場區域中的人員顯示廣告 美國) 、郵政編碼或城市。 您可以呼叫 GetGeoLocationsFileUrl 作業來取得可用來下載最新地理位置數據的暫存盤 URL。 您也可以從 Microsoft Advertising 開發人員入口網站取得位置數據。 您必須以具有 Microsoft Advertising 認證的 Microsoft 帳戶使用者登入開發人員入口網站。
注意事項
最佳做法是下載檔，而不是直接透過 Microsoft Excel 之類的應用程式加以開啟。 如果您在文本編輯器中檢視位置數據，請務必使用UTF-8編碼，而不是ANSI，否則某些字元將無法正確顯示。
如需示範如何下載地理位置程式代碼的程式碼範例，請參閱 地理位置程式碼範例。
位置代碼檔案格式
CSV) 檔案 (逗號分隔值包含下列非本地化數據行標題中組織的數據。 只有 Bing 顯示名稱會根據上面使用的檔案 URL 進行當地語系化。
重要事項
您可以隨時新增新的資料行，因此您的實作必須忽略未知的數據行。
不保證位置的順序，因此您不應該對任何感知到的數據行排序順序或階層採取相依性。
檔案格式 2.0 版
如果您在呼叫 GetGeoLocationsFileUrl 作業時將 Version 指定為 2.0，則下載的檔案中會提供下列數據。 Bing 廣告 API 目前僅支援檔案格式 2.0 版。
| 欄名稱 | 描述 |
|---|---|
| 位置標識碼 | 位置的唯一 Microsoft Advertising 系統標識碼。 您必須使用此值來設定位置準則。 |
| Bing 顯示名稱 | 您可以用來顯示位置資料的選擇性名稱，例如應用程式的使用者。 垂直線可用來區隔位置元件與大部分到最不特定的位置元件。 例如，指定的西雅圖|Washington|美國 最特定的元件是位於 美國 華盛頓州內的西雅圖市。 多個位置識別碼可以有相同的顯示名稱。 您不得將顯示名稱用於簡報以外的任何專案，例如不要假設任何階層或對顯示名稱採取任何相依性。 |
| 位置類型 | 決定與 [位置標識符] 數據行對應的位置子類型 (例如 City、County、Country、MetroArea、PostalCode 或 State) 。 鄰近位置即將推出。 您可以隨時新增位置子類型。 指定位置識別碼的位置類型很少會變更。 |
| 取代 | 保留供日後使用，以指出此數據列中的位置會取代哪個位置。 |
| 狀態 | 指出此數據列中的位置為作用中、暫止淘汰或已被取代。 - 作用中：您可以將目標設為目標或排除位置。 - 暫止淘汰：傳遞引擎仍會使用該位置作為目標或排除專案;不過，該位置將在未來 30 天內淘汰。 - 已淘汰：位置準則不再用於目標或排除專案。 您仍然可以透過 Bing 廣告 API 擷取已被取代的位置準則，例如 GetCampaignCriterionsByIds，但您無法新增或更新已被取代的位置準則。 請考慮每個月呼叫 GetGeoLocationsFileUrl 作業一次或兩次，以判斷檔案的內容是否已變更，例如狀態。 除非上次同步處理位置數據之後傳回的 LastModifiedTimeUtc 值已變更，否則您應該不需要下載整個檔案。 |
| AdWords 位置標識碼 | 最接近 Microsoft Advertising 地理位置識別碼的 Google Ads 位置識別碼。 您可以使用此選項，將 Microsoft Advertising 位置對應至預估的 Google Ads 位置。 此值是啟發學習法估計，可用來對應Google Ads和 Microsoft Advertising 地理位置。 如果位置未對應，欄位會是空的。 |
國家/地區代碼
在某些內容中，API 需要國家/地區代碼字串，例如，針對 一個 PublisherAccount 物件的商務位址。 Microsoft Advertising 支援下列國家/地區代碼。
| 國碼 | 國家/地區名稱 |
|---|---|
| Af | 阿富汗 |
| 鋁 | 阿爾巴尼亞 |
| Dz | 阿爾及利亞 |
| AS | 美屬薩摩亞 |
| 廣告 | 安道爾 |
| 坳 | 安哥拉 |
| 艾 | 安奎拉 |
| Aq | 南極洲 |
| 銀 | 安地卡及巴布達 |
| Ar | 阿根廷 |
| 是 | 亞美尼亞 |
| AW | 荷屬阿魯巴 |
| 金 | 澳洲 |
| AT | 奧地利 |
| Az | 亞塞拜然 |
| Bs | 巴哈馬， |
| Bh | 巴林 |
| 屋宇 署 | 孟加拉 |
| Bb | 巴貝多 |
| BY | 白俄羅斯 |
| BE | 比利時 |
| Bz | 貝里斯 |
| 北京 | 貝南 |
| Bm | 百慕達 |
| Bt | 不丹 |
| 博 | 玻利維亞 |
| AN | Bonaire、Curaçao、Saba、Sint Eustatius、Sint Maarten |
| 八 | 波士尼亞與赫塞哥維納 |
| Bw | 波札那 |
| Br | 巴西 |
| 億 | 汶萊 |
| BG | 保加利亞 |
| 高爐 | 布吉納法索 |
| BI | 蒲隆地 |
| CV | Cabo Verde |
| Kh | 柬埔寨 |
| 釐米 | 喀麥隆 |
| CA | 加拿大 |
| 肯塔基州 | 開曼群島 |
| Cf | 中非共和國 |
| Td | 查德 |
| Cl | 智利 |
| 快遞 之 家 | 中國 |
| 殘雪 | 聖誕島 |
| 副本 | 科克斯 (基靈) 群島 |
| CO | 哥倫比亞 |
| 公里 | 葛摩 |
| Cg | 剛果 |
| Cd | 剛果民主共和國 |
| Ck | 庫克群島 |
| 鉻 | 哥斯大黎加 |
| 詞 | 科特迪瓦 (象牙海岸) |
| 人力資源 | 克羅埃西亞 |
| CY | 賽普勒斯 |
| Cz | 捷克共和國 |
| DK | 丹麥 |
| Dj | 吉布地 |
| Dm | 多米尼克 |
| DO | 多明尼加 |
| 電子商務 | 厄瓜多 |
| EG | 埃及 |
| SV | 薩爾瓦多 |
| Gq | 赤道幾內亞 |
| ER | 厄利垂亞 |
| Ee | 愛沙尼亞 |
| Et | 衣索比亞 |
| Fk | 福克蘭群島 |
| 佛 | 法羅群島 |
| 福建 | 馬來群島 |
| FI | 芬蘭 |
| FR | 法國 |
| 女朋友 | 法屬圭亞那 |
| PF | 法屬玻里尼西亞 |
| Ga | 加彭 |
| 通用汽車 | 甘比亞， |
| 通用電氣 | 喬治亞 |
| DE | 德國 |
| Gh | 迦納 |
| Gi | 直布羅陀 |
| GR | 希臘 |
| Gl | 格陵蘭 |
| Gd | 格瑞那達 |
| Gp | 瓜地洛普 |
| 古 | 關島 |
| 燃氣輪機 | 瓜地馬拉 |
| Gn | 幾內亞 |
| Gw | 幾內亞比索 |
| Gy | 蓋亞那 |
| HT | 海地 |
| Hn | 宏都拉斯 |
| 香港 | 香港特別行政區 |
| 胡 | 匈牙利 |
| 是 | 冰島 |
| IN | 印度 |
| 識別碼 | 印尼 |
| 智商 | 伊拉克 |
| IE | 愛爾蘭 |
| I l | 以色列 |
| IT | 義大利 |
| Jm | 牙買加 |
| Jp | 日本 |
| 喬 | 約旦 |
| KZ | 哈薩克 |
| 科 | 肯亞 |
| K i | 吉里巴斯 |
| KR | 韓國 |
| 千瓦 | 科威特 |
| 公斤 | 吉爾吉斯 |
| 洛杉磯 | 寮國 |
| 低壓 | 拉脫維亞 |
| 磅 | 黎巴嫩 |
| LS | 賴索托 |
| Lr | 賴比瑞亞 |
| LY | 利比亞 |
| 李 | 列支敦斯登 |
| LT | 立陶宛 |
| 路 | 盧森堡 |
| 莫 | 澳門特別行政區 |
| Mk | 北馬其頓，前馬其頓共和國 |
| 鎂 | 馬達加斯加 |
| M w | 馬拉威 |
| 我 | 馬來西亞 |
| Mv | 馬爾地夫 |
| 毫升 | 馬利 |
| MT | 馬爾他 |
| MH | 馬紹爾群島 |
| Mq | 馬丁尼克 |
| 先生 | 茅利塔尼亞 |
| 木 | 模里西斯 |
| 劉日東 | 馬約特島 |
| MX | 墨西哥 |
| 調頻 | 密克羅尼西亞 |
| Md | 摩爾多瓦 |
| Mc | 摩納哥 |
| 錳 | 蒙古 |
| 我 | 蒙特內哥羅 |
| 女士 | 蒙哲臘 |
| 馬 | 摩洛哥 |
| Mz | 莫三比克 |
| 毫米 | 緬甸 |
| NA | 納米比亞 |
| 星期日 | 諾魯 |
| Np | 尼泊爾 |
| NL | 荷蘭 |
| 數控 | 新喀里多尼亞 |
| 紐西蘭 | 紐西蘭 |
| 鎳 | 尼加拉瓜 |
| NE | 尼日 |
| 議員 | 奈及利亞 |
| 女 | 紐埃島 |
| Nf | 諾福克島 |
| Mp | 北馬利安納群島 |
| 否 | 挪威 |
| Om | 阿曼 |
| Pk | 巴基斯坦 |
| PW | 帛琉 |
| Ps | 巴勒斯坦民族權力機構 |
| Pa | 巴拿馬 |
| Pg | 巴布亞紐幾內亞 |
| PY | 巴拉圭 |
| 體育 | 秘魯 |
| PH | 菲律賓 |
| Pn | 皮特肯群島 |
| PL | 波蘭 |
| 鉑 | 葡萄牙 |
| 公關 | 波多黎各 |
| Qa | 卡達 |
| RE | 留尼汪 |
| Ro | 羅馬尼亞 |
| 如 | 俄羅斯 |
| 烏爾曼 | 盧安達 |
| Sh | 聖赫勒拿島 |
| KN | 聖克里斯多福及尼維斯 |
| 立法會 | 聖露西亞 |
| 下午 | 聖皮埃與密克隆群島 |
| Vc | 聖文森及格瑞那丁 |
| Ws | 薩摩亞 |
| Sm | 聖馬利諾 |
| 聖 | Sao Tomé 和 Príncipe |
| Sa | 沙烏地阿拉伯 |
| 錫 | 塞內加爾 |
| Rs | 塞爾維亞 |
| Sc | 塞席爾 |
| SL | 獅子山 |
| S g | 新加坡 |
| Sk | 斯洛伐克 |
| 四 | 斯洛維尼亞 |
| 某人 | 索羅門群島 |
| 所以 | 索馬利亞 |
| 咱 | 南非 |
| ES | 西班牙 |
| 路 | 斯里蘭卡 |
| 鍶 | 蘇利南 |
| 深圳 | 史瓦濟蘭 |
| SE | 瑞典 |
| CH | 瑞士 |
| TW | 台灣 |
| Tj | 塔吉克 |
| TZ | 坦尚尼亞 |
| TH | 泰國 |
| Tl | 東帝汶 |
| Tg | 多哥 |
| TK | 托克勞群島 |
| TO | 東加 |
| TT | 千里達及托巴哥 |
| Tn | 突尼西亞 |
| Tr | Türkiye |
| Tm | 土庫曼 |
| Tc | 土克斯及開科斯群島 |
| 電視 | 吐瓦魯 |
| Ug | 烏干達 |
| Ua | 烏克蘭 |
| Ae | 阿拉伯聯合大公國 |
| G b | 英國 |
| 美國 | 美國 |
| UY | 烏拉圭 |
| UZ | 烏茲別克 |
| Vu | 萬那杜 |
| Va | 梵蒂岡 |
| VE | 委內瑞拉 |
| VN | 越南 |
| Vg | 維京群島、英國 |
| 六 | 美屬維京群島 |
| WF | 瓦利斯群島和富圖那群島 |
| 你們 | 葉門 |
| Zm | 尚比亞 |
| ZW | 辛巴威 |