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