Google จะให้ข้อมูลตำแหน่งทางภูมิศาสตร์ผ่านออบเจ็กต์ Geo
ซึ่งเป็นเรื่องปกติสำหรับโปรโตคอล OpenRTB และ Google เอกสารนี้จะอธิบายถึงรายละเอียดในระดับสูงเกี่ยวกับวิธีที่ Google ป้อนข้อมูลตำแหน่งทางภูมิศาสตร์ในคำขอราคาเสนอ และแนะนำแนวทางปฏิบัติแนะนำสำหรับการใช้งาน
วิธีที่ระบบสร้างออบเจ็กต์ทางภูมิศาสตร์
Google ดึงข้อมูลตำแหน่งของอุปกรณ์จากตำแหน่งทางภูมิศาสตร์ของ IP เท่านั้น ไม่ใช่จาก GPS หรือแหล่งที่มาอื่นๆ แม้ว่าข้อกำหนด OpenRTB จะรองรับตำแหน่งทางภูมิศาสตร์สำหรับผู้ใช้ (เช่น ที่อยู่บ้าน) และอุปกรณ์ (ที่ที่อุปกรณ์จะวางโฆษณา) แยกต่างหาก แต่ Google จะรองรับเฉพาะตำแหน่งหลังเท่านั้น ดังนั้น โปรโตคอลของ Google จะมีออบเจ็กต์ Geo
เพียง 1 รายการใน BidRequest.geo
และสำหรับ OpenRTB Google จะแสดงข้อมูลในช่อง Device.geo
เท่านั้น
ช่องออบเจ็กต์ Geo
ช่องได้รับการป้อนข้อมูลให้เหมือนกันสำหรับทั้ง 2 โปรโตคอล ช่องต่อไปนี้จะมีอยู่ในตัวแปร OpenRTB ของออบเจ็กต์ Geo
เท่านั้น และ Google จะไม่ป้อนข้อมูลในช่องเหล่านี้ไม่ว่าในโปรโตคอลใดทั้ง 2 อย่าง ได้แก่ regionfips104
, lastfix
, type
และ ipservice
ช่องที่ไม่รองรับส่วนใหญ่ข้างต้นจะเกี่ยวข้องกับแหล่งที่มาของตำแหน่งอื่นๆ
การคุ้มครองความเป็นส่วนตัว
เพื่อปกป้องความเป็นส่วนตัวของผู้ใช้ 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 ที่มีการตัดให้สั้นลงสำหรับตำแหน่งทางภูมิศาสตร์อาจทำให้ผลลัพธ์คลาดเคลื่อนได้บ้าง
ตารางภูมิศาสตร์
ช่อง geo_criteria_id
แสดงตำแหน่งทางภูมิศาสตร์เป็นตัวระบุแบบตัวเลข ซึ่งแมปกับตำแหน่งทางภูมิศาสตร์ใน geo-table.csv ซึ่งพร้อมให้ดาวน์โหลดได้ที่
ส่วนตารางอ้างอิงของหน้า Protos และข้อมูลอ้างอิง เราเลิกใช้งานช่องนี้และตารางที่เกี่ยวข้องแล้ว คุณสามารถใช้ช่อง Geo
ที่อธิบายไว้ด้านบนเพื่อรับข้อมูลตำแหน่งทางภูมิศาสตร์ที่คล้ายกันได้ ตัวอย่างเช่น หากคำขอราคาเสนอมี Geo
ป้อนข้อมูลด้วยความแม่นยำระดับเมือง geo_criteria_id
จะมีรหัสสำหรับเมืองที่ตรงกัน คุณจะใช้รหัสดังกล่าวเพื่อค้นหาระเบียนในตารางภูมิศาสตร์ได้
คอลัมน์
- รหัสเกณฑ์
- รหัสที่กำหนดที่ไม่ซ้ำกันและถาวร ใน API เกณฑ์เหล่านี้เป็นประเภท
Location
- ชื่อ
- ชื่อภาษาอังกฤษที่ดีที่สุดของเป้าหมายทางภูมิศาสตร์
- ชื่อ Canonical
- ชื่อภาษาอังกฤษที่สมบูรณ์ในตัวเอง ซึ่งประกอบด้วยชื่อของเป้าหมายเอง รวมถึงชื่อระดับบนสุดและประเทศของเป้าหมาย ช่องนี้มีไว้สำหรับอธิบายชื่อเป้าหมายที่คล้ายกันเท่านั้น โดยไม่รองรับใน LocationCriterionService (ใช้ชื่อสถานที่ตั้งหรือรหัสเกณฑ์แทน)
- รหัสระดับบนสุด
- รหัสเกณฑ์ของผู้ปกครอง ช่องนี้มีไว้สําหรับการสนับสนุนเดิม และรหัสในชุดข้อมูลต่างๆ อาจไม่ตรงกัน ชื่อ Canonical เป็นวิธีที่แนะนำในการสร้างลำดับชั้น
- รหัสภูมิภาค
- รหัสภูมิภาค ISO 3166-2 สำหรับเป้าหมายระดับรัฐหรือจังหวัด หากมี
- รหัสประเทศ
- รหัสประเทศ ISO-3166-1 alpha-2 ที่เชื่อมโยงกับเป้าหมาย
- ประเภทเป้าหมาย
ค่าที่อนุญาตมีดังนี้
- สนามบิน
- เขต
- ชุมชนปกครองตนเอง
- เขตเมือง
- กวางตุ้ง
- เมือง
- เขตในตัวเมือง
- เขตการเลือกตั้ง
- ประเทศ
- อำเภอ
- แผนก
- เขต
- ภูมิภาค DMA
- รัฐ
- รถไฟใต้ดิน
- เทศบาล
- อุทยานแห่งชาติ
- ย่าน
- ภาคปกครองตนเอง
- อื่นๆ
- รหัสไปรษณีย์
- เขตปกครอง
- จังหวัด
- ภูมิภาค
- รัฐ
- เขตแดน
- เขตการส่งสัญญาณโทรทัศน์
- ดินแดนสหภาพ
- มหาวิทยาลัย
สถานที่ตั้งที่กำหนดเป้าหมายไม่ได้
สาธารณรัฐประชาชนจีนมีกฎหมายและกฎข้อบังคับด้านการโฆษณา ที่กำหนดให้คุณต้องแสดงใบรับรองหรือใบอนุญาตเมื่อคุณโฆษณาผลิตภัณฑ์บางประเภทในประเทศจีน คุณไม่ต้องส่งใบรับรองจนกว่า บัญชีจะเปิดใช้งานแล้ว เมื่อบัญชีใช้งานได้แล้ว คุณจะได้รับข้อมูลเกี่ยวกับวิธีการส่งใบรับรองไปยัง Google