तीसरे पक्ष के ऐप्लिकेशन को ट्रैक करने के लिए डीडीएम इंटिग्रेशन

यहां दिए गए एंड-टू-एंड फ़्लो में, विज्ञापन देने वाले व्यक्ति या कंपनी के सेटअप और तीसरे पक्ष के ज़रूरी तरीके के बारे में बताया गया है. इनकी मदद से, तीसरे पक्ष के ऐप्लिकेशन ट्रैकिंग समाधान का इस्तेमाल करके, DoubleClick के खरीदारी पक्ष के प्रॉडक्ट पर कैंपेन चलाया जा सकता है.

DoubleClick Digital Marketing के बारे में सामान्य जानकारी और ऐप्लिकेशन में एट्रिब्यूशन की सुविधाओं के बारे में खास जानकारी पाने के लिए, DoubleClick Digital Marketing का बैकग्राउंड पेज देखें.

1. विज्ञापन देने वाला व्यक्ति या कंपनी, DDM में कन्वर्ज़न इवेंट सेट अप करती है. इससे इंस्टॉल या कन्वर्ज़न (सिर्फ़ Bid Manager - कन्वर्ज़न पिक्सल) (Campaign Manager - फ़्लडलाइट ऐक्टिविटी) को दिखाया जा सकता है.

2. विज्ञापन देने वाला व्यक्ति या कंपनी, तीसरे पक्ष के इंटरफ़ेस में DDM कन्वर्ज़न इवेंट को "लिंक" करती है. साथ ही, ऐसे मुख्य वैरिएबल उपलब्ध कराती है जिनसे विज्ञापन देने वाले व्यक्ति या कंपनी और कन्वर्ज़न गतिविधि ग्रुप की पहचान होती है.

   • src, विज्ञापन देने वाले व्यक्ति या कंपनी का वह आईडी है जो Floodlight गतिविधि का सोर्स है.
   • cat गतिविधि टैग स्ट्रिंग है. इसका इस्तेमाल Floodlight सर्वर, उस गतिविधि ग्रुप की पहचान करने के लिए करते हैं जिससे गतिविधि जुड़ी है.
   • type ग्रुप टैग स्ट्रिंग है. इससे उस ऐक्टिविटी ग्रुप की पहचान होती है जिससे Floodlight ऐक्टिविटी जुड़ी है.
   • u1, u2, ... (अगर उपलब्ध हो), कस्टम Floodlight वैरिएबल की वैल्यू के मुख्य कॉम्पोनेंट होते हैं.

3. विज्ञापन देने वाला व्यक्ति या कंपनी, डीएमए की शर्तों का पालन करने के लिए, सहमति से जुड़ा डेटा इकट्ठा करने के लिए वैरिएबल जोड़ती है.

   • eea का इस्तेमाल, ईईए के उपयोगकर्ताओं की पहचान करने के लिए किया जाता है.
     • eea=0 से पता चलता है कि उपयोगकर्ता ईईए से नहीं है.
     • eea=1 से पता चलता है कि उपयोगकर्ता ईईए से है.
   • ad_user_data, विज्ञापन दिखाने के मकसद से उपयोगकर्ता के डेटा का इस्तेमाल करने के लिए सहमति का फ़्लैग है.
     • इस प्रॉपर्टी को सिर्फ़ तब सेट किया जाना चाहिए, जब eea=1
     • ad_user_data=0 से पता चलता है कि उपयोगकर्ता ने विज्ञापन दिखाने के मकसद से, Google को उपयोगकर्ता के लेवल का डेटा ट्रांसफ़र करने की सहमति नहीं दी है.
     • ad_user_data=1 से पता चलता है कि उपयोगकर्ता ने विज्ञापन दिखाने के मकसद से, Google को उपयोगकर्ता के लेवल का डेटा ट्रांसफ़र करने की सहमति दी है.
   • npa का इस्तेमाल, दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए किया जाता है.
     • npa=0 से पता चलता है कि उपयोगकर्ता ने दिलचस्पी के मुताबिक विज्ञापन दिखाने के लिए सहमति दी है.
     • npa=1 से पता चलता है कि उपयोगकर्ता ने मनमुताबिक बनाने की सुविधा के लिए सहमति नहीं दी है.
   • test_request_reason=dma का इस्तेमाल डीएमए पैरामीटर की जांच करने के लिए किया जा सकता है
     • यह फ़ंक्शन, डीएमए के सभी पैरामीटर की पुष्टि करता है और चेतावनियां दिखाता है.
     • यह फ़र्ज़ी क्लिक के साथ कई जवाब दिखाता है.
     • यह कुकी, कन्वर्ज़न को टेस्ट कन्वर्ज़न के तौर पर लॉग करती है.

4. इसके अलावा, विज्ञापन देने वाले व्यक्ति या कंपनी को तीसरे पक्षों को अपना खास अनुमति टोकन देना होगा:

   token, ऐडवर्टाइज़र के लिए खास तौर पर बनाई गई अल्फ़ान्यूमेरिक स्ट्रिंग है. इसे DDM को किए जाने वाले हर सर्वर अनुरोध के साथ पास करना ज़रूरी है.

5. विज्ञापन देने वाला व्यक्ति या कंपनी, ऐप्लिकेशन में विज्ञापन दिखाने वाला कैंपेन चलाती है. इसमें विज्ञापन टैग, रीयल-टाइम बिडिंग एक्सचेंज पर DBM या सीधे तौर पर खरीदे गए मीडिया पर DCM दिखाता है.

6. एंड यूज़र को विज्ञापन दिखते हैं और वह उन पर क्लिक करता है. इन विज्ञापनों को DDM लॉग करता है.

7. जब कोई व्यक्ति ऐप्लिकेशन इंस्टॉल करता है या "गेम खेलना" जैसे कन्वर्ज़न इवेंट को पूरा करता है, तो तीसरे पक्ष के सर्वर, ऐप्लिकेशन की हर गतिविधि पर DDM को "पिंग" करते हैं:

   ईईए में शामिल नहीं होने वाले उपयोगकर्ता के लिए यूआरएल का उदाहरण

   https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
   

   ईईए में रहने वाले उपयोगकर्ता के लिए यूआरएल का उदाहरण

   https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
   

   कहां:

   • src, विज्ञापन देने वाले व्यक्ति या कंपनी का वह आईडी है जो Floodlight गतिविधि का सोर्स है.
   • cat गतिविधि टैग स्ट्रिंग है. इसका इस्तेमाल Floodlight सर्वर, उस गतिविधि ग्रुप की पहचान करने के लिए करते हैं जिससे गतिविधि जुड़ी है.
   • type ग्रुप टैग स्ट्रिंग है. इससे उस ऐक्टिविटी ग्रुप की पहचान होती है जिससे Floodlight ऐक्टिविटी जुड़ी है.
   • ord एक रैंडम नंबर है. इसका इस्तेमाल, Floodlight टैग को यूनीक बनाने के लिए किया जाता है.
   • u1, u2, ... (अगर उपलब्ध हो), कस्टम Floodlight वैरिएबल की मुख्य वैल्यू होती हैं.
   • eea यह पता लगाती है कि उपयोगकर्ता ईईए में है या नहीं.
   • ad_user_data कुकी से यह पता चलता है कि उपयोगकर्ता ने कुकी और मेज़रमेंट के लिए सहमति दी है या नहीं.
   • npa कुकी से यह पता चलता है कि उपयोगकर्ता ने दिलचस्पी के मुताबिक अनुभव पाने के लिए सहमति दी है या नहीं.

   एचटीटीपी पोस्ट में JSON पेलोड के ज़रिए भेजे गए अन्य पैरामीटर के साथ:

   {
     "app": {
       "bundle": "com.rovio.angrybirds"
     },
     "device": {
       "ua": "Mozilla/5.0 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
       "ip": "108.176.57.230",
       "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
       "lmt": 1
     }
   }
   

   और विज्ञापन देने वाले व्यक्ति या कंपनी के ऑथराइज़ेशन टोकन को एचटीटीपी ऑथराइज़ेशन हेडर में पास किया जाता है:

   Authorization: Token token="[advertiser authorization token string]"
   

   कहां:

   • app (ज़रूरी है) वह JSON ऑब्जेक्ट है जो उस ऐप्लिकेशन के बारे में बताता है जहां कन्वर्ज़न गतिविधि हुई थी. अगर कन्वर्ज़न गतिविधि वाला ऐप्लिकेशन उपलब्ध नहीं है, तो app: {} का इस्तेमाल करें.
   • bundle (अगर उपलब्ध हो) ऐप्लिकेशन ऑब्जेक्ट फ़ील्ड है. इसमें Play Store के बंडल के नाम या App Store के आईडी की स्ट्रिंग वैल्यू होती है.
   • device, JSON ऑब्जेक्ट है. यह उस डिवाइस के बारे में बताता है जिस पर कन्वर्ज़न गतिविधि हुई थी.
   • ua, डिवाइस ऑब्जेक्ट फ़ील्ड है. यह उस ऐप्लिकेशन के उपयोगकर्ता एजेंट की स्ट्रिंग को दिखाता है जहां गतिविधि रिकॉर्ड की गई थी. यह पैरामीटर ज़रूरी है.
   • ip (अगर उपलब्ध हो), डिवाइस को असाइन किया गया डिवाइस का IPv4 पता होता है. यह पैरामीटर ज़रूरी है.
   • didmd5, अपरकेस किए गए IDFA या Google Play विज्ञापन आईडी की MD5-हैश स्ट्रिंग है.
   • lmt एक पूर्णांक है. अगर उपयोगकर्ता ने IDFA या विज्ञापन आईडी के लिए, "विज्ञापन ट्रैकिंग को सीमित करने" की सुविधा चालू की है, तो इसकी वैल्यू 1 होती है. अगर इसे सेट नहीं किया गया है, तो इसकी वैल्यू 0 होती है.

   डीडीएम, JSON फ़ॉर्मैट में जवाब देगा. इसमें यह जानकारी होगी कि कन्वर्ज़न इवेंट को DCM से दिखाए गए व्यू या क्लिक के लिए एट्रिब्यूट किया गया है या नहीं. अगर "हां", तो इवेंट के बारे में अतिरिक्त जानकारी (पिछला व्यू या क्लिक):

   • विज्ञापन आईडी
   • साइट आईडी
   • प्लेसमेंट आईडी
   • क्रिएटिव आईडी
   • टाइमस्टैम्प

   JSON फ़ॉर्मैट में जवाब का उदाहरण:

   {
     "attributed": 1,  // Whether the conversion can be attributed to a DCM event.
     "last_impression_ad_id":283641088,
     "last_impression_site_id":1408067,
     "last_impression_placement_id":107616368,
     "last_impression_creative_id":60162352,
     "last_impression_timestamp":1415647607,
     "last_click_ad_id":283641088,
     "last_click_site_id":1408067,
     "last_click_placement_id":107616368,
     "last_click_creative_id":60162352,
     "last_click_timestamp":1415647657,
     "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A",
     "cps": <cps>,
     "ad_events": [
       <ad event objects>
     ],
     "warnings": [<warning strings>],
     "errors": [<error strings>],
   }
   

   कहां:

   • attributed की वैल्यू 1 होती है. ऐसा तब होता है, जब कन्वर्ज़न को किसी इंप्रेशन या क्लिक के लिए एट्रिब्यूट किया जा सकता है. अगर कन्वर्ज़न को एट्रिब्यूट नहीं किया जा सकता, तो इसकी वैल्यू 0 होती है.
   • last_impression_ad_id (if attributed = 1) is the ad ID for the last impression.
   • last_impression_site_id (if attributed = 1) आखिरी इंप्रेशन के लिए साइट आईडी है.
   • last_impression_placement_id (if attributed = 1) आखिरी इंप्रेशन के लिए प्लेसमेंट आईडी है.
   • last_impression_creative_id (if attributed = 1) is the creative ID for the last impression.
   • last_click_ad_id (if attributed = 1 and a click was attributed) is the ad ID for the last click.
   • last_click_site_id (if attributed = 1 and a click was attributed) is the site ID for the last click.
   • last_click_placement_id (if attributed = 1 and a click was attributed) लास्ट क्लिक के लिए प्लेसमेंट आईडी है.
   • last_click_creative_id (if attributed = 1 and a click was attributed) is the creative ID for the last click.
   • last_click_exclid, %eiid! मैक्रो का इस्तेमाल करके पॉप्युलेट किए गए यूनीक क्लिक आईडी से मेल खाता है

   मार्च 2024 में डीएमए लागू होने के बाद, ये फ़ील्ड भी उपलब्ध होंगे:

   • cps से पता चलता है कि इवेंट किस कोर प्लैटफ़ॉर्म सेवा से जुड़ा है
     • a : विज्ञापन
     • m : Maps
     • p : Play Store
     • s : खोजें
     • h : Shopping
     • y : YouTube
   • ad_events, ad_event ऑब्जेक्ट का एक कलेक्शन है. इसमें सभी कन्वर्ज़न इवेंट शामिल होते हैं.
     • ad_event ऑब्जेक्ट में ये फ़ील्ड होते हैं:
     • product_type एक स्ट्रिंग है. यह कन्वर्ज़न के लिए ज़िम्मेदार प्रॉडक्ट की जानकारी देती है. यह DCM या DBM होगा.
     • interaction_type उस इंटरैक्शन का टाइप है जिसकी वजह से इवेंट ट्रिगर हुआ. impression या click.
     • conversion_metric, एट्रिब्यूशन के लिए इस्तेमाल की जाने वाली कन्वर्ज़न मेट्रिक है. conversion या view_through_conversion.
     • timestamp वह UNIX टाइमस्टैंप है जब विज्ञापन इवेंट हुआ था. इसमें माइक्रोसेकंड तक की जानकारी होती है. इस वैल्यू का इस्तेमाल, लास्ट-क्लिक एट्रिब्यूशन के लिए किया जाना चाहिए.
     • campaign_type से उस कैंपेन के टाइप का पता चलता है जिसकी वजह से विज्ञापन इवेंट जनरेट हुआ.
     • line_item_id (सिर्फ़ DBM के लिए), DBM लाइन आइटम आईडी है. इससे विज्ञापन इवेंट जनरेट हुआ.
     • line_item_name (सिर्फ़ DBM के लिए), DBM लाइन आइटम का नाम है. इस लाइन आइटम की वजह से विज्ञापन इवेंट जनरेट हुआ.
     • placement_id (सिर्फ़ DCM के लिए) यह DCM प्लेसमेंट टैग आईडी है, जिसने विज्ञापन इवेंट जनरेट किया.
     • placement_name (सिर्फ़ DCM के लिए), विज्ञापन इवेंट जनरेट करने वाले DCM प्लेसमेंट टैग का नाम है.
     • external_customer_id विज्ञापन देने वाले व्यक्ति या कंपनी का वह आइडेंटिफ़ायर है जिसके पास उस कैंपेन का मालिकाना हक है जिससे विज्ञापन इवेंट जनरेट हुआ.
       • अगर product DBM है, तो यह फ़ील्ड DBM विज्ञापन देने वाले व्यक्ति या कंपनी का आईडी दिखाता है.
       • अगर product DCM है, तो यह फ़ील्ड DCM विज्ञापन देने वाले व्यक्ति या कंपनी का आईडी दिखाता है.
     • creative_id, उस क्रिएटिव विज्ञापन यूनिट का आईडी है जिसने विज्ञापन इवेंट जनरेट किया.
       • अगर product DBM है, तो यह फ़ील्ड DBM क्रिएटिव आईडी को दिखाता है.
       • अगर product DCM है, तो यह फ़ील्ड DCM क्रिएटिव आईडी को दिखाता है.
     • exchange_id (सिर्फ़ DBM), उस एक्सचेंज का आईडी होता है जिसने DBM विज्ञापन दिखाया.
     • insertion_order_id (सिर्फ़ DBM के लिए) DBM इंसर्शन ऑर्डर आईडी है.
     • site_id (सिर्फ़ DCM के लिए) विज्ञापन इवेंट के लिए DCM साइट आईडी है.
     • cps से पता चलता है कि विज्ञापन इवेंट, कोर प्लैटफ़ॉर्म की किस सेवा से जुड़ा है. ज़्यादा जानकारी के लिए, दस्तावेज़ में पहले दिए गए cps फ़ील्ड के बारे में पूरी जानकारी देखें.
   • warnings, कन्वर्ज़न इवेंट से मिली चेतावनियों का एक कलेक्शन है.

   • errors, एचटीटीपी गड़बड़ी कोड के साथ कन्वर्ज़न इवेंट से जनरेट हुई गड़बड़ियों का एक कलेक्शन है. ये गड़बड़ियां इन स्थितियों में जनरेट होती हैं:

     • HTTP 204 अगर अनुरोध का कोटा खत्म हो गया है.
     • HTTP 400 जब अनुरोध को अमान्य माना जाता है. उदाहरण के लिए, ज़रूरी पैरामीटर मौजूद न होने पर और सर्वर ने पिक्सल ट्रैकिंग का इस्तेमाल किया हो.
     • HTTP 401 अगर ऑथराइज़ेशन टोकन अमान्य है.
     • HTTP 404 पर क्लिक करें.

   विज्ञापन देने वाला व्यक्ति या कंपनी, आपके सिस्टम में कैंपेन की रिपोर्ट देख पाएगी. साथ ही, विज्ञापन देने वाला व्यक्ति या कंपनी, DCM में भी कन्वर्ज़न रिपोर्ट देख पाएगी. इन रिपोर्ट में वही पैरामीटर होंगे जो आपके सिस्टम में मौजूद रिपोर्ट में हैं.

   मार्च 2024 में डीएमए लागू होने के बाद, जवाब के अन्य उदाहरण

   एट्रिब्यूट किए गए कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का उदाहरण. इसमें कन्वर्ज़न को Search Network और YouTube विज्ञापन इंटरैक्शन, दोनों के लिए एट्रिब्यूट किया गया है. हालांकि, Search Network और YouTube CPS के बीच 5(2)(b) + 5(2)(c) क्रॉस-यूज़ की सहमति नहीं दी गई है:

   {
     attributed: 1,
     last_impression_ad_id: 283641088,
     last_impression_site_id: 1408067,
     last_impression_placement_id: 107616368,
     last_impression_creative_id: 60162352,
     last_impression_timestamp: 1415647607,
     last_click_ad_id: 283641088,
     last_click_site_id: 1408067,
     last_click_placement_id: 107616368,
     last_click_creative_id: 60162352,
     last_click_timestamp: 1415647655,
     last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
     cps: "s",
     ad_events: [{
         cps : "s",
         product_type: "DCM",
         interaction_type: "click",
         ad_event_type: "click",
         campaign_type: "Display",
         placement_id: 107616368,
         placement_name: "TEST PLACEMENT NAME",
         external_customer_id: 7480542,
         creative_id: 60162352,
         timestamp: 1415647655.123456,
         site_id: 1408067,
         }, {
         cps : "s",
         product_type:"DCM",
         interaction_type: "impression",
         ad_event_type: "impression",
         campaign_type: "Display",
         placement_id: 107616368,
         placement_name: "TEST PLACEMENT NAME",
         external_customer_id: 7480542,
         creative_id: 60162352,
         timestamp: 1415647607.123456,
         site_id: 1408067
         },{
         cps : "y",
         product_type: "DCM",
         ad_event_type: "click",
         campaign_type: "Display",
         placement_id: 107616370,
         placement_name: "Placement on Youtube",
         external_customer_id: 7480542,
         creative_id: 6016444,
         timestamp: 14344344.123456,
         site_id: 140806
         },
     ]}
   

   DBM कैंपेन के लिए, कन्वर्ज़न ट्रैकिंग की पुष्टि करने वाले जवाब का उदाहरण:

   {
     attributed: 1,
     last_click_ad_id: 283641088,
     last_click_site_id: 1408067,
     last_click_placement_id: 107616368,
     last_click_creative_id :60162352,
     last_click_timestamp: 1415647655,
     last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
     cps: "y",
     ad_events: [{
       product_type: "DBM",
       interaction_type: "click",
       ad_event_type: "click",
       campaign_type: "Display",
       line_item_id: 123456789,
       line_item_name: "TEST LINE ITEM NAME",
       external_customer_id: 2550,
       creative_id: 512333,
       exchange_id: 132,
       insertion_order_id: 523423,
       timestamp: 1432681913.123456
       cps: "y"
     },
     {
       product_type: "DCM",
       interaction_type: "click",
       campaign_type: "Display",
       placement_id: 9342323,
       placement_name: "TEST PLACEMENT NAME",
       external_customer_id: 7480542,
       creative_id: 8234234,
       timestamp: 1432681913.123456,
       cps: "y"
     }
   ]}