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