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