Google को जब भी यह पता चलता है कि रीयल-टाइम बिडिंग नीलामी में, आपकी डेटा सेगमेंट का इस्तेमाल करके सबसे ज़्यादा बिड लगाई गई है और इससे इंप्रेशन मिला है, तब आपको इंप्रेशन की सूचनाएं मिल सकती हैं. Google का सुझाव है कि आप इंप्रेशन की सूचनाओं को इंटिग्रेट करें, ताकि आपको यह पता चल सके कि आपके डेटा सेगमेंट का इस्तेमाल कैसे किया जा रहा है. इंप्रेशन की सूचनाएं पाने की सुविधा चालू करने के लिए, अपने खाता मैनेजर से संपर्क करें.
इंप्रेशन नोटिफ़िकेशन एंडपॉइंट कॉन्फ़िगर करना
इंप्रेशन की सूचनाएं पाने के लिए, आपको एक एचटीटीपी एंडपॉइंट बनाना होगा. साथ ही, उसका यूआरएल Google के साथ शेयर करना होगा. इनमें से किसी एक विकल्प का इस्तेमाल करके, उस यूआरएल को सेट किया जा सकता है जिस पर इंप्रेशन की सूचनाएं भेजी जाती हैं:
- रीयल-टाइम में चुने गए हर कॉलआउट के लिए, इंप्रेशन सूचना एंडपॉइंट यूआरएल सेट करें.
SegmentResponse.burlफ़ील्ड में जानकारी भरकर, आपको मिलने वाले हर रीयल-टाइम क्यूरेशन कॉलआउट के लिए, इंप्रेशन सूचनाओं के लिए इस्तेमाल किया गया यूआरएल डाइनैमिक तौर पर सेट किया जा सकता है.- किसी रीयल-टाइम में चुने गए प्रॉडक्ट के कॉलआउट के लिए, आपको
SegmentResponse.burlफ़ील्ड सेट करना होगा, ताकि आपको उस कॉलआउट के लिए इंप्रेशन की सूचना मिल सके. अगरSegmentResponse.burlफ़ील्ड में कोई वैल्यू नहीं डाली गई है, तो उस कॉलआउट के लिए कोई सूचना नहीं भेजी जाएगी. भले ही,SegmentResponse.burlफ़ील्ड को पहले के कॉलआउट में सेट किया गया हो.
- खाते के लेवल पर, इंप्रेशन सूचना के एंडपॉइंट यूआरएल को सेट करें.
- अपने खाते के लिए, खाता-लेवल पर इंप्रेशन सूचना एंडपॉइंट यूआरएल सेट किया जा सकता है. इसके लिए, अपने खाता मैनेजर से संपर्क करें. अगर आपके एंडपॉइंट यूआरएल में अक्सर बदलाव नहीं होता है, तो यह तरीका सबसे सही है.
- सभी रीयल-टाइम क्युरेशन कॉलआउट, खाता लेवल पर कॉन्फ़िगर किए गए इंप्रेशन सूचना यूआरएल का इस्तेमाल करेंगे. हालांकि, किसी रीयल-टाइम क्युरेशन कॉलआउट के लिए
SegmentResponse.burlफ़ील्ड सेट करके, खाता लेवल के यूआरएल को बदला जा सकता है.
इंप्रेशन की सूचना को पार्स करना
इंप्रेशन सूचना में भेजी गई जानकारी, इंप्रेशन सूचना के एंडपॉइंट यूआरएल के कॉन्फ़िगरेशन पर निर्भर करती है. आपके एंडपॉइंट यूआरएल में क्वेरी पैरामीटर शामिल हो सकते हैं. साथ ही, इसमें मैक्रो का इस्तेमाल किया जा सकता है. इससे यह पता चलता है कि इंप्रेशन जनरेट करने वाली सबसे ज़्यादा बिड ने आपके डेटा सेगमेंट का इस्तेमाल कैसे किया.
मैक्रो के बड़े होने का तरीका समझना
अगर आपने अपने एंडपॉइंट यूआरएल को इस तरह कॉन्फ़िगर किया है कि उसमें एक या उससे ज़्यादा क्वेरी पैरामीटर शामिल हों और उन्हें मैक्रो पर सेट किया गया हो, तो आपके एंडपॉइंट को भेजी गई इंप्रेशन सूचनाएं उन मैक्रो को बड़ा करेंगी. साथ ही, मैक्रो को उनकी वैल्यू से बदल देंगी.
उदाहरण के लिए, इंप्रेशन सूचना के एंडपॉइंट यूआरएल को इस तरह कॉन्फ़िगर किया जा सकता है:
https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}
इंप्रेशन की सूचना मिलने पर, मैक्रो बदल दिए जाएंगे. इससे यूआरएल कुछ इस तरह दिखेगा:
https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2
इस्तेमाल किए जा सकने वाले मैक्रो के बारे में जानें
यहां दी गई मैक्रो, इंप्रेशन की सूचना देने वाले एंडपॉइंट यूआरएल के क्वेरी पैरामीटर में शामिल की जा सकती हैं. इन मैक्रो की जगह, जीतने वाली बिड से जुड़ी वैल्यू का इस्तेमाल किया जाता है. इस बिड में आपके एक या उससे ज़्यादा डेटा सेगमेंट का योगदान होता है.
| मैक्रो | ब्यौरा |
|---|---|
${SR_ID}
|
यह एक यूनीक स्ट्रिंग आईडी होता है. यह रीयल-टाइम में प्रॉडक्ट की जानकारी दिखाने वाले कॉलआउट के लिए, SegmentRequest.segment_request_id फ़ील्ड के बराबर होता है. इससे उस सेगमेंट के अनुरोध का पता चलता है जिसके जवाब में आपने एक या उससे ज़्यादा डेटा सेगमेंट आईडी दिए थे. इन आईडी की वजह से, आपको बिडिंग में जीत मिली. |
${SEGMENT_IDS}
|
स्ट्रिंग डेटा सेगमेंट आईडी की सूची. ये आईडी, जीतने वाली बिड में शामिल थे. सूची में मौजूद हर आइटम को "|" वर्ण से अलग किया जाता है. उदाहरण के लिए, इसे वैल्यू की सूची में इस तरह से बढ़ाया जा सकता है:
"segmentId1|segmentId2|segmentId3"
सूची में मौजूद हर डेटा सेगमेंट आईडी, Marketplace API में मौजूद
curators.dataSegments संसाधन के संसाधन आईडी को दिखाता है. |
${AUCTION_PRICE}
|
नीलामी जीतने की कीमत को दिखाने वाली स्ट्रिंग.
कीमत, एक इंप्रेशन की लागत (सीपीआई) होती है. इसे डॉलर माइक्रोज़ में दिखाया जाता है. उदाहरण के लिए, अगर रीयल-टाइम बिडिंग की बिड 5 डॉलर सीपीएम है, तो रीयल-टाइम क्यूरेशन के इंप्रेशन की सूचना में ${AUCTION_PRICE} मैक्रो, 5000 माइक्रो-यूएसडी सीपीआई में बदल जाएगा. |
${DEAL_ID}
|
नीलामी जीतने वाले डील या पैकेज का आईडी. यह एक डील या पैकेज है. यह आपके एक या उससे ज़्यादा डेटा सेगमेंट आईडी को टारगेट करता है. इसकी पहचान ${SEGMENT_IDS} मैक्रो से की जा सकती है. |
${BUYER_SEAT_ID}
|
खरीदार की उस सीट का आईडी जिसने इंप्रेशन जीता है. इसे बिडर ने जीतने वाली बिड में तय किया था. उदाहरण के लिए, खरीदार की सीट, एजेंसियां या विज्ञापन देने वाले लोग या कंपनियां हो सकती हैं. |
अगले चरण
- रीयल-टाइम क्युरेशन प्रोटोकॉल का रेफ़रंस: जानें कि रीयल-टाइम क्युरेशन में इस्तेमाल किए जाने वाले अनुरोधों और जवाबों को कैसे स्ट्रक्चर किया जाता है.
- रीयल-टाइम में कॉन्टेंट को व्यवस्थित करने के अनुरोधों को पार्स करना: रीयल-टाइम में कॉन्टेंट को व्यवस्थित करने के अनुरोधों को पार्स करने का तरीका जानें.
- रीयल-टाइम में जवाब जनरेट करने की सुविधा बनाना: रीयल-टाइम में जवाब जनरेट करने की सुविधा बनाने का तरीका जानें.