หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ข้อมูลตําแหน่งที่ตั้งทางภูมิศาสตร์สามารถใช้เพื่อ การกําหนดเป้าหมายตําแหน่งที่ตั้ง เช่น แสดงโฆษณาต่อบุคคลในประเทศ/ภูมิภาค ที่ระบุ รัฐ/จังหวัด เขต พื้นที่รถไฟใต้ดิน (Microsoft Market Area ในสหรัฐอเมริกา), รหัสไปรษณีย์ หรือเมือง คุณสามารถเรียกใช้การดําเนินการ GetGeoLocationsFileUrl เพื่อรับ URL ไฟล์ชั่วคราวที่สามารถใช้เพื่อดาวน์โหลดข้อมูลตําแหน่งที่ตั้งทางภูมิศาสตร์ล่าสุดได้ คุณยังสามารถรับข้อมูลตําแหน่งที่ตั้งจาก พอร์ทัลนักพัฒนาโฆษณาของ Microsoft ได้ คุณต้องลงชื่อเข้าใช้พอร์ทัลนักพัฒนาด้วยผู้ใช้บัญชี 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 ชื่อที่ใช้แสดง | ชื่อทางเลือกที่คุณสามารถใช้เพื่อแสดงข้อมูลตําแหน่งที่ตั้ง ตัวอย่างเช่น สําหรับผู้ใช้แอปพลิเคชันของคุณ แถบแนวตั้งถูกใช้เพื่อแยกคอมโพเนนต์ตําแหน่งที่ตั้งจากส่วนใหญ่ไปเฉพาะเจาะจงน้อยที่สุด ตัวอย่างเช่น ซีแอตเทิลที่กําหนด|วอชิงตัน|สหรัฐอเมริกาองค์ประกอบที่เฉพาะเจาะจงที่สุดคือเมืองซีแอตเทิลภายในรัฐวอชิงตันของสหรัฐอเมริกา รหัสตําแหน่งที่ตั้งหลายรายการสามารถมีชื่อที่ใช้แสดงเดียวกันได้ คุณต้องไม่ใช้ชื่อที่ใช้แสดงสําหรับสิ่งอื่นใดนอกเหนือจากการนําเสนอ ตัวอย่างเช่น อย่าสันนิษฐานว่าลําดับชั้นใด ๆ หรือใช้การอ้างอิงใด ๆ กับชื่อที่แสดง |
| ชนิดของตําแหน่งที่ตั้ง | กําหนดชนิดย่อยของตําแหน่งที่ตั้ง (เช่น เมือง เขต ประเทศ MetroArea รหัสไปรษณีย์ หรือรัฐ) ที่สอดคล้องกับคอลัมน์ ID ตําแหน่งที่ตั้ง สถานที่ใกล้เคียงจะมาในเร็ว ๆ นี้ สามารถเพิ่มชนิดย่อยของตําแหน่งที่ตั้งใหม่ได้ตลอดเวลา ไม่ค่อยมีการเปลี่ยนแปลงชนิดของตําแหน่งที่ตั้งสําหรับ ID ตําแหน่งที่ตั้งที่ระบุ |
| แทน | สงวนไว้สําหรับใช้ในอนาคตเพื่อระบุว่าตําแหน่งที่ตั้งใดจะถูกแทนที่ด้วยตําแหน่งที่ตั้งในแถวนี้ |
| สถานะ | ระบุว่าตําแหน่งที่ตั้งในแถวนี้ใช้งานอยู่ - ใช้งานอยู่: คุณสามารถกําหนดเป้าหมายหรือแยกตําแหน่งที่ตั้งออกได้ - การเลิกใช้ที่ค้างอยู่: ตําแหน่งที่ตั้งยังคงถูกใช้โดยเครื่องมือจัดส่งสําหรับการกําหนดเป้าหมายหรือการยกเว้น อย่างไรก็ตาม จะมีการเลิกใช้ตําแหน่งที่ตั้งภายใน 30 วันถัดไป - ไม่สนับสนุน: เกณฑ์สถานที่ตั้งไม่ได้ใช้สําหรับการกําหนดเป้าหมายหรือการยกเว้นอีกต่อไป เกณฑ์ตําแหน่งที่ตั้งที่เลิกใช้แล้วจะยังคงถูกเรียกใช้ผ่าน Bing Ads API เช่น GetCampaignCriterionsByIds แต่คุณไม่สามารถเพิ่มหรืออัปเดตเกณฑ์ตําแหน่งที่ตั้งที่ไม่สนับสนุนได้ โปรดพิจารณาเรียกใช้การดําเนินการ GetGeoLocationsFileUrl หนึ่งหรือสองครั้งในแต่ละเดือนเพื่อตรวจสอบว่าเนื้อหาของไฟล์มีการเปลี่ยนแปลงหรือไม่ เช่น สถานะ คุณไม่ควรต้องดาวน์โหลดไฟล์ทั้งหมด เว้นแต่ว่าค่า LastModifiedTimeUtc ที่ส่งกลับมามีการเปลี่ยนแปลงตั้งแต่ครั้งสุดท้ายที่คุณซิงค์ข้อมูลตําแหน่งที่ตั้ง |
| ID ตําแหน่งที่ตั้งของ AdWords | ID ตําแหน่ง Google Ads ที่ตรงกับ ID ตําแหน่งที่ตั้งทางภูมิศาสตร์ Microsoft Advertising มากที่สุด คุณสามารถใช้ข้อมูลนี้ในการแมปตําแหน่งที่ตั้งการโฆษณาของ Microsoft ไปยังตําแหน่งโฆษณา Google โดยประมาณได้ ค่านี้เป็นการประมาณฮิวริสติกที่สามารถใช้สําหรับการแมปโฆษณา Google และตําแหน่งที่ตั้งทางภูมิศาสตร์ Microsoft Advertising ได้ ฟิลด์จะว่างเปล่าถ้าไม่ได้แมปตําแหน่งที่ตั้งไว้ |
รหัสประเทศ
ในบางบริบท API จําเป็นต้องมีสตริงรหัสประเทศ เช่น สําหรับที่อยู่ธุรกิจของวัตถุ AdvertiserAccount รหัสประเทศต่อไปนี้ได้รับการสนับสนุนโดยการโฆษณาของ Microsoft
| รหัสประเทศ | ชื่อประเทศ/ภูมิภาค |
|---|---|
| Af | อัฟกานิสถาน |
| อัล | อัลบาเนีย |
| DZ | อัลจีเรีย |
| เป็น | อเมริกันซามัว |
| โฆษณา | อันดอร์รา |
| อ่าว | แอ งโก ลา |
| Ai | แองกวิลลา |
| AQ | แอนตาร์กติกา |
| Ag | แอนติกาและบาร์บูดา |
| Ar | อาร์เจนติน่า |
| AM | อาร์เมเนีย |
| AW | อารูบา |
| Th | ออสเตรเลีย |
| ที่ | ออสเตรีย |
| Az | อาเซอร์ไบจัน |
| บี | บาฮามาส |
| Bh | บาห์เรน |
| Bd | บัง กลา เทศ |
| บี บี | บาร์เบโดส |
| โดย | เบลารุส |
| สามารถ | เบลเยียม |
| BZ | เบลีซ |
| Bj | เบนิน |
| Bm | เบอร์มิวดา |
| Bt | ภูฏาน |
| บ่อ | โบลิเวีย |
| AN | โบแนร์, คูราเซา, ซาบา, ซินต์ อูสตาเทียส, ซินต์ มาร์เทิน |
| บา | บอสเนียแอนด์เฮอร์เซโกวิน่า |
| Bw | บอตสวานา |
| Br | บราซิล |
| BN | บรูไน |
| Bg | บัลแกเรีย |
| Bf | บูร์กินาฟาโซ |
| Bi | บุรุนดี |
| Cv | คาโบเวร์เดอ |
| Kh | กัมพูชา |
| ซม | แคเมอรูน |
| Ca | แคนาดา |
| Ky | หมู่เกาะเคย์แมน |
| Cf | สาธารณรัฐแอฟริกากลาง |
| Td | ชาด |
| Cl | ชิลี |
| Cn | จีน |
| Cx | เกาะคริสต์มาส |
| Cc | หมู่เกาะโคคอส (คีลิง) |
| Co | โคลัมเบีย |
| กม | คอโมรอส |
| Cg | คองโก |
| Cd | คองโก (DRC) |
| Ck | หมู่เกาะคุก |
| Cr | คอสตาริก้า |
| Ci | โกตดิวัวร์ |
| ชั่วโมง | โครเอเชีย |
| Cy | ไซปรัส |
| Cz | สาธารณรัฐเชก |
| Dk | เดนมาร์ก |
| ดีเจ | จิบูตี |
| Dm | โดมินิกา |
| ทำ | สาธารณรัฐโดมินิกัน |
| Ec | เอกวาดอร์ |
| เช่น | อียิปต์ |
| SV | เอลซัลวาดอร์ |
| GQ | อิเควทอเรียลกินี |
| เอ้อ | เอริเทรีย |
| Ee | เอสโทเนีย |
| ET | เอธิโอเปีย |
| FK | หมู่เกาะฟอล์กแลนด์ |
| FO | หมู่เกาะแฟโร |
| FJ | หมู่เกาะฟิจิ |
| FI | ฟินแลนด์ |
| Fr | ฝรั่งเศส |
| Gf | เฟรนช์เกียนา |
| Pf | เฟรนช์โปลินีเซีย |
| Ga | กาบอง |
| กรัม | แกมเบีย |
| Ge | จอร์เจีย |
| เด | เยอรมนี |
| Gh | กานา |
| จิ | ยิบรอลตาร์ |
| กลุ่ม | กรีซ |
| Gl | กรีนแลนด์ |
| Gd | เกรนาดา |
| Gp | กวาเดอลูป |
| กู | กวม |
| Gt | กัวเตมาลา |
| GN | กินี |
| Gw | Guinea-Bissau |
| GY | กายอานา |
| Ht | เฮติ |
| Hn | ฮอนดูรัส |
| Hk | เขตบริหารพิเศษฮ่องกง |
| หู | ฮังการี |
| IS | ไอซ์แลนด์ |
| นิ้ว | อินเดีย |
| Id | อินโดนีเซีย |
| IQ | อิรัก |
| Ie | ไอร์แลนด์ |
| Il | อิสราเอล |
| IT | อิตาลี |
| Jm | จาไมก้า |
| Jp | ญี่ปุ่น |
| Jo | จอร์แดน |
| KZ | คาซัคสถาน |
| Ke | เคนย่า |
| กี่ | คิริบาติ |
| Kr | เกาหลี |
| กิโลวัตต์ | คูเวต |
| กิโลกรัม | คีร์กีสถาน |
| ลา | ลาว |
| Lv | ลัตเวีย |
| ปอนด์ | เลบานอน |
| Ls | เลโซโท |
| LR | ไลบีเรีย |
| LY | ลิเบีย |
| หลี่ | ลิกเตนสไตน์ |
| ลิตร | ลิธัวเนีย |
| Lu | ลักเซมเบิร์ก |
| Mo | เขตยานมาเก๊า |
| Mk | สาธารณรัฐยูโกสลาเวียตอนเหนือ |
| มิลลิกรัม | มาดากัสการ์ |
| Mw | มาลาวี |
| ของฉัน | มาเลเซีย |
| Mv | มัลดีฟส์ |
| Ml | มาลี |
| ภู เขา | มอลตา |
| MH | หมู่เกาะมาร์แชลล์ |
| MQ | มาร์ตินิก |
| นาย | มอริเตเนีย |
| Mu | มอริเชียส |
| Yt | มายอต |
| Mx | เม็กซิโก |
| Fm | ไมโครนีเซีย |
| Md | มอลโดวา |
| Mc | โมนาโก |
| Mn | มองโกเลีย |
| ฉัน | มอน เต เน โกร |
| นางสาว | มอนต์เซอร์รัต |
| Ma | โมร็อคโค |
| MZ | โมซัมบิก |
| มม | พม่า |
| นา | นามิเบีย |
| Nr | นาอูรู |
| NP | เนปาล |
| Nl | เนเธอร์แลนด์ |
| Nc | นิวแคลิโดเนีย |
| Th | นิวซีแลนด์ |
| นิ | นิการากัว |
| ยเน | ไนเจอร์ |
| Ng | ไนจีเรีย |
| นู | นีอุเอะ |
| Nf | เกาะนอร์ฟอล์ก |
| Mp | หมู่เกาะนอร์เทิร์นมาเรียนา |
| ไม่ใช่ | นอร์เวย์ |
| ออม | โอมาน |
| Pk | ปากีสถาน |
| PW | ปาเลา |
| Ps | ปาเลสไตน์ |
| ป่า | ปานามา |
| Pg | ปาปัวนิวกินี |
| PY | ปารากวัย |
| Pe | เปรู |
| Ph | ฟิลิปปินส์ |
| Pn | หมู่เกาะพิตแคร์น |
| Pl | โปแลนด์ |
| พ | โปรตุเกส |
| ประชา สัมพันธ์ | เปอร์โตริโก |
| QA | กาตาร์ |
| ใหม่ | วันรวมตัว |
| Ro | โรมาเนีย |
| Ru | รัสเซีย |
| Rw | รวันดา |
| Sh | เซนต์เฮเลนา |
| KN | เซนต์คิตส์และเนวิส |
| Lc | เซนต์ลูเซีย |
| PM | แซงปีแยร์และมีเกอลง |
| Vc | เซนต์วินเซนต์และเกรนาดีนส์ |
| Ws | ซามัว |
| เอส เอ็ม | ซานมารีโน |
| เซนต์ | เซาตูเมและปรินซิเป |
| Sa | ซาอุดิอาระเบีย |
| Sn | เซเนกัล |
| Rs | เซอร์เบียแอนด์มอนเทเนโกร |
| Sc | เซเชลส์ |
| SL | เซียร์ราลีโอน |
| Sg | สิงคโปร์ |
| Sk | สโลวาเกีย |
| ซี | สโลวีเนีย |
| Sb | หมู่เกาะโซโลมอน |
| ดัง นั้น | โซมาเลีย |
| ZA | แอฟริกาใต้ |
| Es | สเปน |
| แอล เค | ศรีลังกา |
| Sr | ซูรินาม |
| SZ | สวาซิแลนด์ |
| SE | สวีเดน |
| Ch | สวิตเซอร์แลนด์ |
| Tw | ไต้หวัน |
| TJ | ทาจิกิสถาน |
| TZ | แทนซาเนีย |
| TH | ไทย |
| Tl | Timor-Leste |
| Tg | โตโก |
| TK | โตเคเลา |
| ถึง | ตองกา |
| Tt | ตรินิแดดและโตเบโก |
| Tn | ตูนิเซีย |
| Tr | Türkiye |
| Tm | เติร์กเมนิสถาน |
| Tc | หมู่เกาะเติกส์และเคคอส |
| ทีวี | Tuvalu |
| UG | ยูกันดา |
| Ua | ยูเครน |
| Ae | สหรัฐอาหรับเอมิเรตส์ |
| Gb | สหราชอาณาจักร |
| เรา | สหรัฐอเมริกา |
| UY | อุรุกวัย |
| UZ | อุซเบกิสถาน |
| VU | วานูอาตู |
| Va | นครรัฐวาติกัน |
| VE | เวเนซุเอลา |
| VN | เวียดนาม |
| VG | หมู่เกาะบริติชเวอร์จิน |
| VI | หมู่เกาะเวอร์จินของสหรัฐอเมริกา |
| Wf | วาลลิสและฟุตูนา |
| เย | เยเมน |
| ZM | แซมเบีย |
| ZW | ซิมบาบเว |