Google ให้ข้อมูลตำแหน่งทางภูมิศาสตร์ผ่านออบเจ็กต์ Geo
ซึ่งโดยทั่วไปจะใช้ทั้งในโปรโตคอล OpenRTB และ Google เอกสารนี้จะพูดถึงรายละเอียดในระดับสูงเกี่ยวกับวิธีที่ Google สร้างตำแหน่งทางภูมิศาสตร์ในคำขอราคาเสนอ และแนะนำแนวทางปฏิบัติแนะนำสำหรับการใช้งาน
วิธีสร้างวัตถุทางภูมิศาสตร์
Google จะระบุแหล่งที่มาของอุปกรณ์จากตำแหน่งทางภูมิศาสตร์ของ IP เท่านั้น ไม่ได้มาจาก GPS หรือแหล่งที่มาอื่นๆ แม้ว่าข้อกำหนด OpenRTB จะรองรับตำแหน่งทางภูมิศาสตร์ที่แยกกันสำหรับผู้ใช้ (เช่น ที่อยู่บ้าน) และอุปกรณ์ (ตำแหน่งที่จะวางอุปกรณ์เมื่อมีการวางโฆษณา) แต่ Google จะรองรับเฉพาะตัวเลือกหลัง ดังนั้น การใช้งาน OpenRTB ของ Google จะเติมเพียง BidRequest.device.geo
และโปรโตคอล Google RTB ที่เลิกใช้งานแล้วจะรองรับเฉพาะช่อง BidRequest.geo
ที่อ้างอิงตำแหน่งอุปกรณ์
การคุ้มครองความเป็นส่วนตัว
Google จะให้เพียงตำแหน่งทางภูมิศาสตร์คร่าวๆ ซึ่งผู้ใช้จํานวนมากแชร์ไว้ ซึ่งเป็นข้อมูลทั่วไปแก่สถานที่ที่ตรวจพบเท่านั้นเพื่อปกป้องความเป็นส่วนตัวของผู้ใช้
การนำเสนอสถานที่ตั้ง
ออบเจ็กต์ Geo
รองรับการนำเสนอตำแหน่ง 2 แบบแยกกัน ได้แก่ ตำแหน่งพลเรือนและพิกัดทางภูมิศาสตร์
สถานที่ราชการจะแสดงด้วยฟิลด์ต่อไปนี้
country
region
metro
city
zip
พิกัดทางภูมิศาสตร์จะแสดงด้วยฟิลด์ต่อไปนี้
lat
lon
accuracy
ในโปรโตคอล Google และ OpenRTB การแสดงตัวแทนทั้ง 2 แบบจะมีตำแหน่งและความแม่นยำเหมือนกัน ตัวอย่างเช่น หากคำขอราคาเสนอใส่ค่าความแม่นยำของระดับเมือง Geo
ช่อง lat
และ lon
จะมีละติจูดและลองจิจูดของจุดศูนย์กลางของเมืองที่ระบุ และ accuracy
จะเป็นรัศมีของวงกลมที่มีพื้นที่เดียวกันกับเมืองนั้น Google ยังจำกัดความแม่นยำของช่อง lat
และ lon
ไว้ที่ 0.01 องศาด้วย
แนวทางปฏิบัติแนะนำสำหรับการกำหนดเป้าหมายตามตำแหน่งทางภูมิศาสตร์
สำหรับผู้เสนอราคาที่ต้องการข้อมูลตำแหน่งทางภูมิศาสตร์ที่กำหนดเอง เราขอแนะนำให้ใช้ช่อง lat
, lon
และ accuracy
โดยประมาณสำหรับการค้นหาตำแหน่งทางภูมิศาสตร์
เราไม่แนะนำให้ใช้ช่อง ip
สำหรับการระบุตำแหน่งทางภูมิศาสตร์ เนื่องจาก Google แชร์เฉพาะที่อยู่ IP ในรูปแบบที่มีการตัดทอนเท่านั้น การใช้ที่อยู่ IP ที่มีการตัดทอนสำหรับตำแหน่งทางภูมิศาสตร์อาจทำให้ผลลัพธ์ค่อนข้างไม่ถูกต้อง
ตารางภูมิศาสตร์ (เลิกใช้งาน)
ช่อง BidRequest.geo_criteria_id
ของโปรโตคอล Google RTB ที่เลิกใช้งานแล้วจะใช้ตำแหน่งทางภูมิศาสตร์เป็นตัวระบุตัวเลข ซึ่งแมปกับตำแหน่งทางภูมิศาสตร์ใน geo-table.csv ซึ่งมีให้ดาวน์โหลดในส่วนตารางอ้างอิงของหน้า Protos และข้อมูลอ้างอิง มีการเลิกใช้งานช่องนี้และตารางที่เกี่ยวข้องแล้ว ใช้ช่อง Geo
เพื่อรับข้อมูลตำแหน่งทางภูมิศาสตร์ที่คล้ายกัน
ตัวอย่างเช่น หากคำขอราคาเสนอมีการเติมข้อมูลความแม่นยำระดับเมือง Geo
ไว้ geo_criteria_id
จะมีรหัสของเมืองที่เกี่ยวข้อง
โดยคุณสามารถใช้รหัสดังกล่าวเพื่อค้นหาระเบียนในตารางทางภูมิศาสตร์ได้
คอลัมน์
- รหัสเกณฑ์
- รหัสที่ไม่ซ้ำและเป็นรหัสถาวรที่กำหนด ใน API เกณฑ์เหล่านี้จะเป็นประเภท
Location
- ชื่อ
- ชื่อภาษาอังกฤษที่ดีที่สุดของเป้าหมายทางภูมิศาสตร์
- Canonical Name
- ชื่อภาษาอังกฤษที่มีคุณสมบัติครบถ้วน ซึ่งประกอบไปด้วยชื่อของเป้าหมายเอง และชื่อระดับบนสุดและประเทศของเป้าหมาย ช่องนี้ใช้เพื่ออธิบายชื่อเป้าหมายที่คล้ายกันเท่านั้น โดยยังไม่รองรับใน LocationCriterionService (ใช้ชื่อสถานที่ตั้งหรือรหัสเกณฑ์แทน)
- รหัสระดับบนสุด
- รหัสเกณฑ์ของผู้ปกครอง ช่องนี้มีไว้สําหรับการสนับสนุนเดิม และรหัสอาจไม่สอดคล้องกันในชุดข้อมูล ชื่อ Canonical เป็นวิธีการที่แนะนำในการสร้างลำดับชั้น
- รหัสภูมิภาค
- รหัสภูมิภาค ISO 3166-2 ของเป้าหมายรัฐหรือจังหวัด (หากมี)
- รหัสประเทศ
- รหัสประเทศ ISO-3166-1 alpha-2 ที่เชื่อมโยงกับเป้าหมาย
- ประเภทเป้าหมาย
ค่าที่อนุญาต:
- สนามบิน
- เขต
- ชุมชนปกครองตนเอง
- เขตเมือง
- กวางตุ้ง
- เมือง
- เขตในตัวเมือง
- เขตการเลือกตั้ง
- ประเทศ
- อำเภอ
- แผนก
- เขต
- ภูมิภาค DMA
- รัฐ
- รถไฟใต้ดิน
- เทศบาล
- อุทยานแห่งชาติ
- ย่าน
- ภาคปกครองตนเอง
- อื่นๆ
- รหัสไปรษณีย์
- เขตปกครอง
- จังหวัด
- ภูมิภาค
- รัฐ
- เขตแดน
- เขตการส่งสัญญาณโทรทัศน์
- ดินแดนสหภาพ
- มหาวิทยาลัย
สถานที่ที่กำหนดเป้าหมายไม่ได้
สาธารณรัฐประชาชนจีนมีกฎหมายและกฎข้อบังคับด้านการโฆษณาที่กำหนดให้คุณต้องแสดงใบรับรองหรือใบอนุญาตเมื่อคุณโฆษณาผลิตภัณฑ์บางประเภทในประเทศจีน คุณไม่จำเป็นต้องส่งใบรับรองจนกว่าบัญชีของคุณจะเปิดใช้งาน เมื่อบัญชีใช้งานได้แล้ว คุณจะได้รับข้อมูลเกี่ยวกับวิธีส่งใบรับรองไปยัง Google