หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ข้อมูลตําแหน่งที่ตั้งทางภูมิศาสตร์สามารถใช้เพื่อ กําหนดเป้าหมายตามตําแหน่งที่ตั้ง เช่น แสดงโฆษณาให้กับผู้คนในประเทศ/ภูมิภาค รัฐ/จังหวัด เขต พื้นที่เขตเมือง (พื้นที่ Microsoft Market ในสหรัฐอเมริกา) รหัสไปรษณีย์ หรือเมืองที่ระบุ คุณสามารถเรียกใช้การดําเนินการ GetGeoLocationsFileUrl เพื่อรับ URL ไฟล์ชั่วคราวที่สามารถใช้เพื่อดาวน์โหลดข้อมูลตําแหน่งที่ตั้งทางภูมิศาสตร์ล่าสุด
หมายเหตุ
ตั้งแต่วันที่ 31 พฤษภาคม 2025 หน้าพอร์ทัลนักพัฒนาจะถูกเลิกใช้และแทนที่ด้วยเวอร์ชันใหม่ที่นี่ โปรดอัปเดตบุ๊กมาร์กของคุณ และเริ่มใช้หน้าใหม่เพื่อหลีกเลี่ยงการหยุดชะงัก สําหรับคําถามหรือความช่วยเหลือ โปรดติดต่อฝ่ายสนับสนุน
คุณยังสามารถดูข้อมูลตําแหน่งที่ตั้งได้จากพอร์ทัลนักพัฒนา Microsoft Advertising คุณต้องลงชื่อเข้าใช้พอร์ทัลนักพัฒนาด้วยผู้ใช้บัญชี Microsoft ที่มีข้อมูลประจําตัว Microsoft Advertising
หมายเหตุ
แนวทางปฏิบัติที่ดีที่สุดคือ คุณควรดาวน์โหลดไฟล์แทนการเปิดไฟล์ผ่านแอปพลิเคชัน เช่น Microsoft Excel โดยตรง ถ้าคุณดูข้อมูลตําแหน่งที่ตั้งในตัวแก้ไขข้อความ ตรวจสอบให้แน่ใจว่าได้ใช้การเข้ารหัส UTF-8 แทน ANSI มิฉะนั้นอักขระบางตัวจะไม่แสดงอย่างถูกต้อง
สําหรับตัวอย่างโค้ดที่แสดงวิธีการดาวน์โหลดโค้ดตําแหน่งที่ตั้งทางภูมิศาสตร์ ให้ดูตัวอย่างโค้ดตําแหน่งที่ตั้งทางภูมิศาสตร์
รูปแบบไฟล์ โค้ดตําแหน่งที่ตั้ง
ไฟล์ค่าที่คั่นด้วยจุลภาค (CSV) จะมีข้อมูลที่จัดระเบียบในส่วนหัวคอลัมน์ที่ไม่ได้แปลเป็นภาษาท้องถิ่นต่อไปนี้ เฉพาะชื่อที่ใช้แสดงของ Bing เท่านั้นที่จะถูกแปลเป็นภาษาท้องถิ่น ทั้งนี้ขึ้นอยู่กับ URL ของไฟล์ที่ใช้ด้านบน
สิ่งสำคัญ
คอลัมน์ใหม่อาจถูกเพิ่มได้ตลอดเวลา ดังนั้นการใช้งานของคุณต้องละเว้นคอลัมน์ที่ไม่รู้จัก
เราไม่รับประกันลําดับของตําแหน่งที่ตั้ง คุณจึงไม่ควรขึ้นต่อกันกับลําดับการจัดเรียงหรือลําดับชั้นของคอลัมน์ที่รับรู้
รูปแบบไฟล์เวอร์ชัน 2.0
ถ้าคุณระบุ เวอร์ชัน เป็น 2.0 เมื่อเรียกใช้การดําเนินการ GetGeoLocationsFileUrl ข้อมูลต่อไปนี้จะพร้อมใช้งานในไฟล์ที่ดาวน์โหลด ขณะนี้ Bing Ads API สนับสนุนเฉพาะรูปแบบไฟล์เวอร์ชัน 2.0 เท่านั้น
| ชื่อคอลัมน์ | คำอธิบาย |
|---|---|
| ID ตําแหน่งที่ตั้ง | ตัวระบุระบบ Microsoft Advertising ที่ไม่ซ้ํากันสําหรับตําแหน่งที่ตั้ง คุณต้องใช้ค่านี้เพื่อตั้งค่าเกณฑ์ตําแหน่งที่ตั้ง |
| ชื่อที่ใช้แสดงของ Bing | ชื่อที่เลือกได้ซึ่งคุณสามารถใช้เพื่อแสดงข้อมูลตําแหน่งที่ตั้ง ตัวอย่างเช่น กับผู้ใช้แอปพลิเคชันของคุณ แถบแนวตั้งใช้เพื่อแยกคอมโพเนนต์ของตําแหน่งที่ตั้งจากเฉพาะมากที่สุดไปน้อยที่สุด ตัวอย่างเช่น ซีแอตเทิล|วอชิงตัน|สหรัฐอเมริกา องค์ประกอบที่เฉพาะเจาะจงที่สุดคือเมืองซีแอตเทิลภายในรัฐวอชิงตันของสหรัฐอเมริกา ID ตําแหน่งที่ตั้งหลายรายการสามารถมีชื่อที่ใช้แสดงเดียวกันได้ คุณต้องไม่ใช้ชื่อที่แสดงสําหรับสิ่งอื่นนอกเหนือจากงานนําเสนอ ตัวอย่างเช่น ไม่ถือว่าเป็นลําดับชั้นใดๆ หรือขึ้นต่อกันกับชื่อที่แสดง |
| ชนิดของตําแหน่งที่ตั้ง | กําหนดชนิดย่อยของตําแหน่งที่ตั้ง (เช่น เมือง เขต ประเทศ พื้นที่เขตเมือง รหัสไปรษณีย์ หรือรัฐ) ที่สอดคล้องกับคอลัมน์ ID ตําแหน่งที่ตั้ง สถานที่ใกล้เคียงกําลังจะมาเร็วๆ นี้ คุณสามารถเพิ่มชนิดย่อยของตําแหน่งที่ตั้งใหม่ได้ตลอดเวลา ชนิดตําแหน่งที่ตั้งสําหรับ ID ตําแหน่งที่ตั้งที่ระบุมักจะไม่เปลี่ยนแปลง |
| แทนที่ | สงวนไว้สําหรับใช้ในอนาคตเพื่อระบุตําแหน่งที่ตั้งที่จะถูกแทนที่ด้วยตําแหน่งที่ตั้งในแถวนี้ |
| สถานะ | ระบุว่าตําแหน่งที่ตั้งในแถวนี้ใช้งานอยู่ รอการเลิกใช้ หรือเลิกใช้แล้ว - ใช้งานอยู่: คุณสามารถกําหนดเป้าหมายหรือยกเว้นตําแหน่งที่ตั้งได้ - รอการเลิกใช้: เครื่องมือการจัดส่งยังคงใช้ตําแหน่งที่ตั้งดังกล่าวสําหรับการกําหนดเป้าหมายหรือการยกเว้น อย่างไรก็ตาม ตําแหน่งที่ตั้งจะถูกเลิกใช้ภายใน 30 วันถัดไป - ไม่สนับสนุน: เกณฑ์สถานที่ตั้งไม่ได้ใช้สําหรับกําหนดเป้าหมายหรือการยกเว้นอีกต่อไป เกณฑ์ตําแหน่งที่ตั้งที่ไม่ได้รับการสนับสนุนยังคงสามารถเรียกใช้ผ่านทาง API ของ Bing Ads ได้ เช่น GetCampaignCriterionsByIds แต่คุณไม่สามารถเพิ่มหรืออัปเดตเกณฑ์ตําแหน่งที่ตั้งที่เลิกใช้แล้วได้ โปรดพิจารณาเรียกการดําเนินการ GetGeoLocationsFileUrl หนึ่งถึงสองครั้งในแต่ละเดือนเพื่อตรวจสอบว่าเนื้อหาของไฟล์มีการเปลี่ยนแปลงหรือไม่ เช่น สถานะ คุณไม่จําเป็นต้องดาวน์โหลดทั้งไฟล์ ยกเว้นค่า LastModifiedTimeUtc ที่ส่งกลับมีการเปลี่ยนแปลงตั้งแต่ครั้งสุดท้ายที่คุณซิงค์ข้อมูลตําแหน่งที่ตั้ง |
| รหัสตําแหน่งที่ตั้ง AdWords | รหัสตําแหน่งที่ตั้งของ Google Ads ที่ตรงกับรหัสตําแหน่งที่ตั้งทางภูมิศาสตร์ของ Microsoft Advertising มากที่สุด คุณสามารถใช้สําหรับการแมปตําแหน่งที่ตั้งของ Microsoft Advertising กับตําแหน่งที่ตั้ง Google Ads โดยประมาณ ค่านี้เป็นการประมาณฮิวริสติกที่สามารถใช้เพื่อทําการแมปตําแหน่งที่ตั้งทางภูมิศาสตร์ของ Google Ads และ Microsoft Advertising เขตข้อมูลจะว่างเปล่า ถ้าไม่ได้แมปตําแหน่งที่ตั้ง |
รหัสประเทศ
ในบางบริบท API ต้องใช้สตริงรหัสประเทศ เช่น สําหรับที่อยู่ทางธุรกิจของวัตถุ AdvertiserAccount รหัสประเทศต่อไปนี้ได้รับการสนับสนุนโดย Microsoft Advertising
| รหัสประเทศ | ชื่อประเทศ/ภูมิภาค |
|---|---|
| AF | อัฟกานิสถาน |
| AL | แอลเบเนีย |
| DZ | อัลจีเรีย |
| AS | ซามัวอเมริกัน |
| โฆษณา | อันดอร์รา |
| AO | แองโกลา |
| AI | แองกวิลลา |
| เอคิว | แอนตาร์กติกา |
| AG | แอนติกาและบาร์บูดา |
| AR | อาร์เจนตินา |
| AM | อาร์เมเนีย |
| AW | อารูบา |
| AU | ออสเตรเลีย |
| ที่ | ออสเตรีย |
| AZ | อาเซอร์ไบจัน |
| BS | บาฮามาส |
| BH | บาห์เรน |
| BD | บังคลาเทศ |
| บีบี | บาร์เบโดส |
| โดย | เบลารุส |
| เป็น | เบลเยียม |
| BZ | เบลีซ |
| BJ | เบนิน |
| BM | เบอร์มิวดา |
| BT | ภูฏาน |
| BO | โบลิเวีย |
| องค์ | โบแนร์, คูราเซา, ซาบา, ซินท์อุสตาติอุส, ซินท์มาร์เทิน |
| ปริญญาตรี | บอสเนียแอนด์เฮอร์เซโกวิน่า |
| BW | บอตสวานา |
| BR | บราซิล |
| บีเอ็น | บรูไน |
| บีจี | บัลแกเรีย |
| บีเอฟ | บูร์กินาฟาโซ |
| BI | บุรุนดี |
| CV | คาโบเวร์เดอ |
| KH | กัมพูชา |
| ซม. | แคเมอรูน |
| CA | แคนาดา |
| KY | หมู่เกาะเคย์แมน |
| ซีเอฟ | สาธารณรัฐแอฟริกากลาง |
| ทีดี | ชาด |
| CL | ชิลี |
| CN | จีน |
| CX | เกาะคริสต์มาส |
| CC | หมู่เกาะโคคอส (คีลลิง) |
| CO | โคลัมเบีย |
| กม. | คอโมโรส |
| CG | คองโก |
| ซีดี | คองโก (สาธารณรัฐประชาธิปไตย) |
| ซีเค | หมู่เกาะคุก |
| CR | คอสตาริกา |
| CI | โกตดิวัวร์ |
| HR | โครเอเชีย |
| CY | ไซปรัส |
| CZ | สาธารณรัฐเช็ก |
| ดีเค | เดนมาร์ก |
| ดีเจ | จิบูตี |
| ดีเอ็ม | โดมินิกา |
| ทํา | สาธารณรัฐโดมินิกัน |
| EC | เอกวาดอร์ |
| EG | อียิปต์ |
| SV | เอลซัลวาดอร์ |
| จีคิว | อิเควทอเรียลกินี |
| เอ้อ | เอริเทรีย |
| EE | เอสโตเนีย |
| ET | เอธิโอเปีย |
| เอฟเค | หมู่เกาะฟอล์กแลนด์ |
| FO | หมู่เกาะแฟโร |
| FJ | หมู่เกาะฟิจิ |
| FI | ฟินแลนด์ |
| ฝรั่งเศส | ฝรั่งเศส |
| จีเอฟ | เฟรนช์เกียนา |
| พีเอฟ | เฟรนช์โปลินีเซีย |
| GA | กาบอง |
| จีเอ็ม | แกมเบีย |
| จี | จอร์เจีย |
| DE | เยอรมนี |
| จีเอช | กานา |
| GI | ยิบรอลตาร์ |
| GR | กรีซ |
| จีแอล | กรีนแลนด์ |
| จีดี | เกรเนดา |
| จีพีช | กวาเดอลูป |
| GU | กวม |
| จีที | กัวเตมาลา |
| จีเอ็น | กินี |
| GW | Guinea-Bissau |
| GY | กายอานา |
| HT | เฮติ |
| เอชเอ็น | ฮอนดูรัส |
| ฮ่องกง | ฮ่องกง SAR |
| หู | ฮังการี |
| คือ | ไอซ์แลนด์ |
| ใน | อินเดีย |
| รหัส | อินโดนีเซีย |
| ไอคิว | อิรัก |
| IE | ไอร์แลนด์ |
| อิลลินอยส์ | อิสราเอล |
| ไอที | อิตาลี |
| เจเอ็ม | จาไมก้า |
| JP | ญี่ปุ่น |
| JO | จอร์แดน |
| KZ | คาซัคสถาน |
| KE | เคนยา |
| KI | คิริบาส |
| เกาหลี | เกาหลี |
| KW | คูเวต |
| กิโลกรัม | คีร์กีสถาน |
| แอลเอ | ลาว |
| LV | ลัตเวีย |
| ปอนด์ | เลบานอน |
| แอลเอส | เลโซโท |
| แอลเอ | ไลบีเรีย |
| LY | ลิเบีย |
| LI | ลิกเตนสไตน์ |
| LT | ลิทัวเนีย |
| ลู | ลักเซมเบิร์ก |
| MO | มาเก๊า SAR |
| เอ็มเค | มาซิโดเนียเหนือ อดีตสาธารณรัฐยูโกสลาฟ |
| เอ็มจี | มาดากัสการ์ |
| เมกะวัตต์ | มาลาวี |
| ของฉัน | มาเลเซีย |
| เอ็มวี | มัลดีฟส์ |
| ML | มาลี |
| MT | มอลตา |
| MH | หมู่เกาะมาร์แชลล์ |
| MQ | มาร์ตินีก |
| นาย | มอริเตเนีย |
| MU | มอริเชียส |
| YT | มายอต |
| MX | เม็กซิโก |
| เอฟเอ็ม | ไมโครนีเซีย |
| MD | มอลโดวา |
| MC | โมนาโก |
| มินนิโซตา | มองโกเลีย |
| ฉัน | มอนเตเนโกร |
| MS | มอนต์เซอร์รัต |
| MA | โมร็อกโก |
| MZ | โมซัมบิก |
| มม. | พม่า |
| NA | นามิเบีย |
| เอ็นอาร์ | นาอูรู |
| NP | เนปาล |
| NL | เนเธอร์แลนด์ |
| NC | นิวแคลิโดเนีย |
| นิวซีแลนด์ | นิวซีแลนด์ |
| NI | นิการากัว |
| NE | ไนเจอร์ |
| เอ็นจี | ไนจีเรีย |
| NU | นีอูเอ |
| เอ็นเอฟ | เกาะนอร์ฟอล์ก |
| MP | หมู่เกาะนอร์เทิร์นมาเรียนา |
| ไม่ | นอร์เวย์ |
| OM | โอมาน |
| พีเค | ปากีสถาน |
| PW | ปาเลา |
| ปล. | หน่วยงานปาเลสไตน์ |
| PA | ปานามา |
| พีจี | ปาปัวนิวกีนี |
| PY | ปารากวัย |
| PE | เปรู |
| พีเอช | ฟิลิปปินส์ |
| พีเอ็น | หมู่เกาะพิตแคร์น |
| PL | โปแลนด์ |
| พีที | โปรตุเกส |
| ประชาสัมพันธ์ | เปอร์โตริโก |
| ถามตอบ | กาตาร์ |
| RE | เรอูนียง |
| RO | โรมาเนีย |
| RU | รัสเซีย |
| RW | รวันดา |
| SH | เซนต์เฮเลนา |
| เคเอ็น | เซนต์คิตส์และเนวิส |
| แอลซี | เซนต์ลูเซีย |
| PM | แซงปีแยร์และมีเกอลง |
| วีซี | เซนต์วินเซนต์และเกรนาดีนส์ |
| WS | ซามัว |
| SM | ซานมารีโน |
| ST | เซาตูเมและปรินซิปี |
| SA | ซาอุดิอาระเบีย |
| SN | เซเนกัล |
| อาร์เอส | เซอร์เบีย |
| SC | เซเชลส์ |
| SL | เซียร์ราลีโอน |
| สิงคโปร์ | สิงคโปร์ |
| SK | สโลวาเกีย |
| SI | สโลวีเนีย |
| เอสบี | หมู่เกาะโซโลมอน |
| ดังนั้น | โซมาเลีย |
| ZA | แอฟริกาใต้ |
| ES | สเปน |
| แอลเค | ศรีลังกา |
| SR | ซูรินาเม |
| SZ | สวาซิแลนด์ |
| SE | สวีเดน |
| CH | สวิตเซอร์แลนด์ |
| TW | ไต้หวัน |
| ทีเจ | ทาจิกิสถาน |
| TZ | แทนซาเนีย |
| TH | ประเทศไทย |
| TL | Timor-Leste |
| ทีจี | โตโก |
| ทีเค | Tokelau |
| ถึง | ตองกา |
| TT | ตรินิแดดและโตเบโก |
| TN | ตูนีเซีย |
| ทีอาร์ | ตุรกี |
| ทีเอ็ม | เติร์กเมนิสถาน |
| ทีซี | หมู่เกาะเติกส์และหมู่เกาะเคคอส |
| ทีวี | ตูวาลู |
| UG | ยูกันดา |
| ยูเอเอ | ยูเครน |
| AE | สหรัฐอาหรับเอมิเรตส์ |
| GB | สหราชอาณาจักร |
| สหรัฐอเมริกา | สหรัฐอเมริกา |
| UY | อุรุกวัย |
| อุซ | อุซเบกิสถาน |
| VU | วานูอาตู |
| VA | นครวาติกัน |
| VE | เวเนซุเอลา |
| เวียดนาม | เวียดนาม |
| วีจี | หมู่เกาะเวอร์จิน บริติช |
| VI | หมู่เกาะเวอร์จิน สหรัฐอเมริกา |
| WF | วาลลิสและฟุตูนา |
| เย้ | เยเมน |
| ZM | แซมเบีย |
| ZW | ซิมบาบเว |