वीडियो: साल 2019 के वर्कशॉप में, सबसे सही तरीकों के बारे में बताई गई बातचीत देखें
इस गाइड में, ऐप्लिकेशन की परफ़ॉर्मेंस को ऑप्टिमाइज़ करने के लिए, सबसे सही तरीके बताए गए हैं.
खाते का लगातार रखरखाव करना
यह पक्का करने के लिए कि आपका ऐप्लिकेशन बिना किसी रुकावट के काम करता रहे:
एपीआई सेंटर में, डेवलपर के संपर्क ईमेल पते को अप-टू-डेट रखें. हम आपसे संपर्क करने के लिए, इस नाम का इस्तेमाल करते हैं. अगर एपीआई के नियमों और शर्तों का पालन करने के बारे में हम आपसे संपर्क नहीं कर पाते हैं, तो आपके एपीआई ऐक्सेस को आपकी जानकारी के बिना रद्द किया जा सकता है. किसी व्यक्ति या निगरानी में न रखे गए खाते से जुड़े निजी ईमेल पते का इस्तेमाल करने से बचें. एपीआई केंद्र देखने के लिए, आपको अपने मैनेजर खाते में लॉग इन करना होगा.
प्रॉडक्ट में होने वाले बदलावों, रखरखाव के लिए डाउनटाइम, और सेवा बंद होने की तारीखों जैसी समस्याओं के बारे में जानने के लिए,
Google Ads API की टीम, इस फ़ोरम को नियमित तौर पर मॉनिटर करती है. इसलिए, यह एपीआई से जुड़े सवाल पूछने के लिए सबसे सही जगह है.
- अपने ऐप्लिकेशन को 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 का इस्तेमाल करके ऐप्लिकेशन डेवलप करना शुरू किया जा सकता है. ऐसा, ऐप्लिकेशन की समीक्षा होने से पहले भी किया जा सकता है.