Google, Geo
ऑब्जेक्ट के ज़रिए जगह की जानकारी उपलब्ध कराता है. यह जानकारी, OpenRTB और Google प्रोटोकॉल, दोनों के लिए सामान्य होती है. इस दस्तावेज़ में इस बारे में बेहतर जानकारी दी गई है कि Google, बिड रिक्वेस्ट में भौगोलिक स्थान की जानकारी कैसे अपने-आप भरता है. साथ ही, इसके इस्तेमाल के सबसे सही तरीके भी बताते हैं.
जियो ऑब्जेक्ट को पॉप्युलेट करने का तरीका
Google सिर्फ़ आईपी जियोलोकेशन से डिवाइस की जगह की जानकारी इकट्ठा करता है, जीपीएस या अन्य सोर्स से नहीं. OpenRTB के स्पेसिफ़िकेशन के हिसाब से, उपयोगकर्ता के लिए अलग-अलग भौगोलिक स्थान (जैसे कि घर का पता) और डिवाइस (जहां विज्ञापन दिखाए जाने के दौरान डिवाइस है) काम करता है. हालांकि, Google सिर्फ़ बाद वाले जियोलोकेशन के साथ काम करता है. ऐसे में, Google प्रोटोकॉल में BidRequest.geo
में सिर्फ़ एक Geo
ऑब्जेक्ट शामिल होता है. साथ ही, OpenRTB के लिए, Google सिर्फ़ Device.geo
फ़ील्ड में अपने-आप जानकारी भरता है.
दोनों प्रोटोकॉल के लिए, Geo
ऑब्जेक्ट फ़ील्ड एक जैसे तरीके से भरे जाते हैं. ये फ़ील्ड, Geo
ऑब्जेक्ट के सिर्फ़ OpenRTB वैरिएंट में मौजूद होते हैं. Google इन्हें किसी भी प्रोटोकॉल में कभी भी अपने-आप नहीं भरता: regionfips104
, lastfix
, type
, और ipservice
. ऊपर काम न करने वाले ज़्यादातर फ़ील्ड, वैकल्पिक जगह की जानकारी के सोर्स से जुड़े हैं.
निजता सुरक्षा
उपयोगकर्ता की निजता की सुरक्षा करने के लिए, Google सिर्फ़ एक अनुमानित भौगोलिक जगह उपलब्ध कराता है जिसे बहुत ज़्यादा उपयोगकर्ताओं के साथ शेयर किया जाता है. इस तरह, ज़रूरी होने पर पता लगाई गई जगह की जानकारी को सामान्य रूप से समझा जाता है.
जगह की जानकारी का डेटा
Geo
ऑब्जेक्ट, जगह को दो अलग-अलग तरीके से दिखाता है - सिविल लोकेशन और भौगोलिक निर्देशांक.
सिविल जगहों को नीचे दिए गए फ़ील्ड से दिखाया जाता है:
country
region
metro
city
zip
भौगोलिक निर्देशांक, इन फ़ील्ड से दिखाए जाते हैं:
lat
lon
accuracy
Google और OpenRTB प्रोटोकॉल, दोनों में, दोनों में एक जैसी जगह और सटीक जानकारी होती है. उदाहरण के लिए, अगर कोई बिड रिक्वेस्ट, Geo
में शहर के लेवल पर सटीक जानकारी भरती है, तो lat
और lon
फ़ील्ड में, चुने गए शहर के सेंटरपॉइंट के अक्षांश और देशांतर होंगे. साथ ही, accuracy
एक सर्कल का दायरा होगा, जिसका इलाका उस शहर के इलाके जैसा होगा. Google, lat
और lon
फ़ील्ड की सटीक जानकारी को भी 0.01 डिग्री पर सीमित करता है.
जियोलोकेशन टारगेटिंग के लिए सबसे सही तरीके
हमारा सुझाव है कि बोली लगाने वाले जिन लोगों को जगह के हिसाब से भौगोलिक डेटा की ज़रूरत है उन्हें जगह के हिसाब से भौगोलिक जगह का पता लगाने के लिए,
lat
, lon
, और accuracy
फ़ील्ड का इस्तेमाल करने का सुझाव दिया जाता है.
हम भौगोलिक स्थान के लिए ip
फ़ील्ड का इस्तेमाल करने का सुझाव नहीं देते हैं, क्योंकि Google सिर्फ़ आईपी पते को छोटा करके दिखाता है. जियोलोकेशन के लिए छोटे किए गए आईपी पतों का इस्तेमाल करने से नतीजे गलत हो सकते हैं.
जियो टेबल
geo_criteria_id
फ़ील्ड, जियोलोकेशन को न्यूमेरिक आइडेंटिफ़ायर के तौर पर दिखाता है. इसे geo-table.csv में किसी भौगोलिक स्थान के साथ मैप किया जाता है, जो प्रोटो और रेफ़रंस डेटा पेज के
रेफ़रंस टेबल सेक्शन पर डाउनलोड के लिए उपलब्ध है. यह फ़ील्ड और इससे जुड़ी टेबल अब बंद कर दी गई है–ऊपर बताई गई जगह से जुड़ी जानकारी पाने के लिए, Geo
फ़ील्ड का इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर किसी बिड रिक्वेस्ट में
Geo
को शहर के लेवल पर सटीक तरीके से भरा गया है, तो geo_criteria_id
में उससे जुड़े शहर का कोड होगा. उस आईडी का इस्तेमाल करके जियो टेबल में
रिकॉर्ड ढूंढा जा सकता है.
कॉलम
- मानदंड आईडी
- असाइन किया गया खास और स्थायी आईडी. एपीआई में, ये शर्तें
Location
टाइप के हैं. - नाम
- भौगोलिक रूप से टारगेट किए जाने वाले देश के लिए सबसे अच्छा अंग्रेज़ी नाम.
- कैननिकल नाम
- पूरी तरह क्वालिफ़ाइड अंग्रेज़ी नाम, जिसमें टारगेट का अपना नाम और उसके पैरंट और देश का नाम शामिल हो. यह फ़ील्ड सिर्फ़ मिलते-जुलते टारगेट के नामों को साफ़ करने के लिए है--यह LocationCriterionService में काम नहीं करता (इसके बजाय जगह के नाम या मानदंड आईडी का इस्तेमाल करें).
- पैरंट आईडी
- पैरंट का मानदंड आईडी. यह फ़ील्ड लेगसी सपोर्ट के लिए शामिल किया गया है. हो सकता है कि सभी डेटासेट में आईडी एक जैसी न हों. कैननिकल नाम, हैरारकी बनाने का ज़्यादा पसंदीदा तरीका है.
- इलाके का कोड
- टारगेट किए गए राज्य या प्रांत के लिए ISO 3166-2 क्षेत्र कोड, अगर कोई राज्य या प्रांत मौजूद है.
- देश का कोड
- ISO-3166-1 alpha-2 देश का कोड है, जो टारगेट से जुड़ा हुआ है.
- टारगेट का टाइप
मंज़ूर की जा सकने वाली वैल्यू:
- हवाई अड्डा
- एरोंदिस्मेंट
- ऑटोनोमस कम्यूनिटी
- नगर
- कैंटॉन
- शहर
- शहर का इलाका
- कॉन्ग्रेशनल डिस्ट्रिक्ट
- देश
- जिला
- विभाग
- ज़िला
- DMA क्षेत्र
- गवर्नरेट
- मेट्रो
- नगरपालिका
- नैशनल पार्क
- पड़ोस
- ऑक्रग
- अन्य
- पिन कोड
- प्रीफ़ेक्चर
- प्रांत
- इलाका
- स्थिति
- देश/इलाका
- टीवी ब्रॉडकास्ट का क्षेत्र
- केंद्र शासित प्रदेश
- यूनिवर्सिटी
टारगेट नहीं की जा सकने वाली जगहें
चीनी जनवादी गणराज्य के विज्ञापन नियमों और कानूनों के कारण, चीन में कुछ विशिष्ट श्रेणी के प्रॉडक्ट का विज्ञापन करने पर आपसे प्रमाणपत्र और लाइसेंस माँगने के लिए कहा जा सकता है. आपका खाता चालू होने के बाद ही, आपको प्रमाणपत्र सबमिट करने की ज़रूरत नहीं है. खाता चालू होने के बाद, आपको Google को सर्टिफ़िकेट सबमिट करने का तरीका बताया जाएगा.