वीडियो: 2019 की वर्कशॉप में, सबसे सही तरीकों के बारे में दी गई जानकारी देखें
इस गाइड में, कुछ ऐसे सबसे सही तरीकों के बारे में बताया गया है जिन्हें लागू करके, अपने ऐप्लिकेशन की परफ़ॉर्मेंस और काम करने की क्षमता को ऑप्टिमाइज़ किया जा सकता है.
खाते का लगातार रखरखाव करना
यह पक्का करने के लिए कि आपका ऐप्लिकेशन बिना किसी रुकावट के काम करता रहे:
एपीआई केंद्र में, डेवलपर के संपर्क ईमेल को अप-टू-डेट रखें. हम आपसे संपर्क करने के लिए, इस ईमेल पते का इस्तेमाल करते हैं. अगर हम एपीआई के नियम और शर्तों के पालन के बारे में आपसे संपर्क नहीं कर पाते हैं, तो आपको बिना बताए, एपीआई का ऐक्सेस रद्द किया जा सकता है. किसी व्यक्ति या ऐसे खाते से जुड़े निजी ईमेल पते का इस्तेमाल न करें जिसकी निगरानी नहीं की जाती. एपीआई केंद्र देखने के लिए, आपको अपने मैनेजर खाते में लॉग इन करना होगा.
प्रॉडक्ट में होने वाले बदलाव, रखरखाव के लिए डाउनटाइम, बंद होने की तारीख वगैरह जैसी समस्याओं के बारे में जानकारी पाने के लिए, हमारे
अपने ऐप्लिकेशन को Google Ads API नियम और शर्तों (टीऐंडसी) के मुताबिक रखें. ज़रूरत पड़ने पर, टोकन की समीक्षा और नीति के मुताबिक होने की पुष्टि करने वाली टीम, आपसे संपर्क ईमेल का इस्तेमाल करके संपर्क करेगी. अगर आपके पास टीऐंडसी के बारे में कोई सवाल या शिकायत है, तो समीक्षा करने वाली टीम से संपर्क किया जा सकता है. इसके लिए, डेवलपर टोकन के लिए आपके आवेदन की समीक्षा करते समय, टीम की ओर से भेजे गए ईमेल का जवाब दें.
ऑप्टिमाइज़ेशन
बैच कार्रवाइयां करके अपने ऐप्लिकेशन को ऑप्टिमाइज़ किया जा सकता है. साथ ही, अगर ज़रूरी हो, तो कम जानकारी वाले ऑब्जेक्ट भेजे जा सकते हैं.
बैच कार्रवाइयां
एपीआई से अनुरोध करने पर, कई तरह की तय लागतें लगती हैं. जैसे, नेटवर्क की राउंड-ट्रिप में लगने वाला समय, सीरियलाइज़ेशन और डीसीरियलाइज़ेशन की प्रोसेसिंग, और बैक-एंड सिस्टम को कॉल करना. इन निश्चित लागतों के असर को कम करने और कुल परफ़ॉर्मेंस को बेहतर बनाने के लिए, एपीआई में ज़्यादातर बदलाव करने वाले तरीके, कार्रवाइयों की एक कलेक्शन को स्वीकार करने के लिए डिज़ाइन किए गए हैं. हर अनुरोध में कई कार्रवाइयों को बैच करके, अनुरोधों की संख्या और उनसे जुड़ी तय लागतों को कम किया जा सकता है. अगर हो सके, तो सिर्फ़ एक कार्रवाई वाले अनुरोध न करें.
उदाहरण के लिए, मान लें कि आपको कई विज्ञापन ग्रुप वाले किसी कैंपेन में 50,000 कीवर्ड जोड़ने हैं. हर कीवर्ड के लिए 50,000 अनुरोध करने के बजाय, हर अनुरोध में 500 कीवर्ड जोड़कर 100 अनुरोध करें. इसके अलावा, हर अनुरोध में 5,000 कीवर्ड जोड़कर सिर्फ़ 10 अनुरोध किए जा सकते हैं. किसी अनुरोध में की जा सकने वाली कार्रवाइयों की संख्या की सीमाएं होती हैं. इसलिए, बेहतर परफ़ॉर्मेंस पाने के लिए, आपको बैच के साइज़ में बदलाव करना पड़ सकता है.
कम जानकारी वाले ऑब्जेक्ट भेजना
ऑब्जेक्ट को एपीआई पर भेजने पर, फ़ील्ड को डीसीरियलाइज़, पुष्टि, और डेटाबेस में सेव करना होता है. सिर्फ़ कुछ फ़ील्ड अपडेट करने के लिए, पूरे ऑब्जेक्ट को पास करने से प्रोसेसिंग में ज़्यादा समय लग सकता है और परफ़ॉर्मेंस कम हो सकती है.
इस समस्या को कम करने के लिए, Google Ads API में कम जानकारी वाले अपडेट की सुविधा है. इससे, किसी ऑब्जेक्ट में सिर्फ़ उन फ़ील्ड को भरा जा सकता है जिनमें बदलाव करना है या जो ज़रूरी हैं. कम जानकारी वाले अपडेट, तेज़ी से प्रोसेस होते हैं और इनमें गड़बड़ियां होने की संभावना कम होती है.
update_mask (इसे FieldMask भी कहा जाता है) में शामिल न किए गए फ़ील्ड में कोई बदलाव नहीं होता.
उदाहरण के लिए, कीवर्ड-लेवल की बिड अपडेट करने वाला कोई ऐप्लिकेशन, कम जानकारी वाले अपडेट का इस्तेमाल करके फ़ायदा पा सकता है. ऐसा इसलिए, क्योंकि इसमें सिर्फ़ विज्ञापन ग्रुप आईडी, क्राइटेरियन आईडी, और बिड फ़ील्ड भरने की ज़रूरत होगी.
गड़बड़ी ठीक करना और उसे मैनेज करना
डेवलपमेंट के दौरान, आपको गड़बड़ियां दिख सकती हैं. इस सेक्शन में, अपने ऐप्लिकेशन में गड़बड़ी को मैनेज करने की सुविधा जोड़ने के लिए, ध्यान में रखने वाली बातों और रणनीतियों के बारे में बताया गया है. गड़बड़ियों को मैनेज करने के बारे में ज़्यादा जानकारी पाने के लिए, समस्या हल करने की गाइड देखें.
अनुरोध के सोर्स की पहचान करना
कुछ ऐप्लिकेशन मुख्य रूप से इंटरैक्टिव होते हैं. ये यूज़र इंटरफ़ेस (यूआई) में, उपयोगकर्ता की ओर से शुरू की गई कार्रवाइयों के जवाब में सीधे एपीआई कॉल करते हैं. अन्य ऐप्लिकेशन मुख्य रूप से ऑफ़लाइन काम करते हैं. ये समय-समय पर होने वाली बैक-एंड प्रोसेस के तहत, एपीआई कॉल करते हैं. कई ऐप्लिकेशन, इन दोनों तरीकों का इस्तेमाल करते हैं. गड़बड़ी को मैनेज करने के बारे में सोचते समय, अलग-अलग तरह के इन अनुरोधों की पहचान करना मददगार साबित हो सकता है.
उपयोगकर्ता की ओर से शुरू किए गए अनुरोधों के लिए, आपकी मुख्य प्राथमिकता यह होनी चाहिए कि उपयोगकर्ताओं को अच्छा अनुभव मिले. यूज़र इंटरफ़ेस (यूआई) में, उपयोगकर्ता को ज़्यादा से ज़्यादा जानकारी देने के लिए, हुई गड़बड़ी के बारे में बताएं. उपयोगकर्ताओं को गड़बड़ी ठीक करने के लिए आसान तरीके बताएं. इसके लिए, नीचे दिए गए सुझाव देखें.
बैक-एंड पर शुरू किए गए अनुरोधों के लिए, अपने ऐप्लिकेशन में होने वाली अलग-अलग तरह की गड़बड़ियों को ठीक करने के लिए हैंडलर लागू करें. कभी-कभार होने वाली या पहले कभी न हुई गड़बड़ियों को ठीक करने के लिए, हमेशा डिफ़ॉल्ट हैंडलर शामिल करें. डिफ़ॉल्ट हैंडलर के लिए, गड़बड़ी वाली कार्रवाई और गड़बड़ी को किसी ऑपरेटर की समीक्षा के लिए, क्यू में जोड़ना एक अच्छा तरीका है. इससे ऑपरेटर, गड़बड़ी को ठीक करने का सही तरीका तय कर सकता है.
गड़बड़ी के टाइप की पहचान करना
Google Ads API में गड़बड़ी के टाइप के बीच अंतर जानना, गड़बड़ी को ठीक करने की मज़बूत सुविधा बनाने के लिए ज़रूरी है. गड़बड़ी के कुछ सबसे सामान्य टाइप यहां दिए गए हैं:
- पुष्टि करने से जुड़ी गड़बड़ियां
- फिर से कोशिश करने से जुड़ी गड़बड़ियां
- पुष्टि करने से जुड़ी गड़बड़ियां
- सिंक करने से जुड़ी गड़बड़ियां
ज़्यादा जानकारी के लिए, गड़बड़ी के टाइप और आम तौर पर होने वाली गड़बड़ियां देखें.
बैक एंड को सिंक करना
अगर आपके ऐप्लिकेशन के उपयोगकर्ताओं के पास Google Ads खातों का मैन्युअल ऐक्सेस है, तो वे ऐसे बदलाव कर सकते हैं जिनके बारे में आपके ऐप्लिकेशन को पता नहीं होता. इससे, आपके ऐप्लिकेशन का लोकल डेटाबेस सिंक से बाहर हो सकता है. गड़बड़ी के टाइप के बारे में हमारी गाइड में बताया गया है कि सिंक करने से जुड़ी गड़बड़ियां होने पर, उन्हें ठीक किया जा सकता है. हालांकि, उन्हें होने से रोकने की कोशिश भी की जा सकती है. गड़बड़ियों को होने से रोकने के लिए, एक रणनीति यह है कि अपने सभी खातों पर हर रात सिंक करने का काम किया जाए. इससे, आपके खातों में मौजूद Google Ads ऑब्जेक्ट को वापस पाया जा सकता है और आपके लोकल डेटाबेस से उनकी तुलना की जा सकती है.
गड़बड़ियों को लॉग करना
डीबग करने और निगरानी करने के लिए, सभी गड़बड़ियों को लॉग किया जाना चाहिए. कम से कम, अनुरोध आईडी, गड़बड़ी की वजह बनने वाली कार्रवाइयों, और गड़बड़ी को लॉग करें. लॉग करने के लिए अन्य जानकारी में, ग्राहक आईडी, एपीआई सेवा, राउंड-ट्रिप अनुरोध में लगने वाला समय, फिर से कोशिश करने की संख्या, और रॉ अनुरोध और रिस्पॉन्स शामिल हैं.
रुझानों पर नज़र बनाए रखें
एपीआई में होने वाली गड़बड़ियों के रुझानों पर नज़र रखें, ताकि अपने ऐप्लिकेशन में मौजूद समस्याओं का पता लगाया जा सके और उन्हें ठीक किया जा सके. अपना समाधान बनाएं या उपलब्ध कई कमर्शियल टूल में से किसी एक का इस्तेमाल करें. ये टूल, आपके लॉग का इस्तेमाल करके इंटरैक्टिव डैशबोर्ड बना सकते हैं और अपने-आप अलर्ट भेज सकते हैं.
डेवलेपमेंट
डेवलपमेंट के दौरान, टेस्ट खातों का इस्तेमाल करें.
टेस्ट खातों का इस्तेमाल करना
टेस्ट खाते, Google Ads के ऐसे खाते होते हैं जिनसे विज्ञापन नहीं दिखाए जाते. Google Ads API के साथ प्रयोग करने और यह जांचने के लिए, टेस्ट खाते का इस्तेमाल किया जा सकता है कि आपके ऐप्लिकेशन की कनेक्टिविटी, कैंपेन मैनेजमेंट लॉजिक या अन्य प्रोसेसिंग, उम्मीद के मुताबिक काम कर रही है या नहीं. टेस्ट खाते पर डेवलपर टोकन का इस्तेमाल करने के लिए, उसे मंज़ूरी मिलने की ज़रूरत नहीं होती. इसलिए, डेवलपर टोकन का अनुरोध करने के तुरंत बाद, Google Ads API के साथ डेवलपमेंट शुरू किया जा सकता है. भले ही, आपके ऐप्लिकेशन की समीक्षा न हुई हो.