सबसे अच्छे तरीके

वीडियो: साल 2019 की वर्कशॉप में, सबसे सही तरीकों के बारे में बात करने वाले वीडियो देखें

इस गाइड में कुछ ऐसे सबसे सही तरीकों के बारे में बताया गया है जिन्हें लागू करके, अपने ऐप्लिकेशन की परफ़ॉर्मेंस और परफ़ॉर्मेंस को ऑप्टिमाइज़ किया जा सकता है.

लगातार रखरखाव

यह पक्का करने के लिए कि आपका ऐप्लिकेशन बिना किसी रुकावट के चलता रहे:

  • एपीआई सेंटर में अपने डेवलपर से संपर्क करने के ईमेल को अप-टू-डेट रखें. हम आपसे संपर्क करने के लिए इस उपनाम का इस्तेमाल करते हैं. अगर एपीआई के नियमों और शर्तों के पालन के सिलसिले में हम आपसे संपर्क नहीं कर पाए, तो आपकी जानकारी के बिना एपीआई का ऐक्सेस रद्द किया जा सकता है. किसी व्यक्ति या बिना निगरानी वाले खाते से जुड़े निजी ईमेल पते का इस्तेमाल करने से बचें.

  • प्रॉडक्ट में बदलाव, रखरखाव का बंद समय, सेवा बंद होने की तारीख वगैरह जैसी समस्याओं के बारे में जानकारी पाने के लिए, हमारे

Google Ads API टीम नियमित तौर पर फ़ोरम की निगरानी करती है. इस वजह से, यह एपीआई से जुड़े सवाल पोस्ट करने के लिए बेहतर जगह है.

  • अपना ऐप्लिकेशन, Google Ads API के नियमों और शर्तों (नियम और शर्तें) का पालन करते रहें. ज़रूरत पड़ने पर, टोकन की समीक्षा और अनुपालन करने वाली टीम आपके ईमेल पते का इस्तेमाल करके आपसे संपर्क करेगी. अगर नियमों और शर्तों को लेकर आपका कोई सवाल है या आपको कोई समस्या आ रही है, तो समीक्षा टीम से संपर्क करें. इसके लिए, डेवलपर टोकन के आवेदन की समीक्षा करते समय आपको भेजे गए ईमेल का जवाब दें.

ऑप्टिमाइज़ेशन

बैच कार्रवाइयां

एपीआई से अनुरोध करने पर कई तय लागत आती हैं. जैसे, दोतरफ़ा यात्रा के लिए नेटवर्क इंतज़ार का समय, सीरियलाइज़ेशन, और डीसीरियलाइज़ेशन से जुड़ी प्रोसेसिंग, और बैक-एंड सिस्टम को कॉल करना. इन तय कीमतों के असर को कम करने और परफ़ॉर्मेंस को बेहतर बनाने के लिए, एपीआई के ज़्यादातर बदलाव करने के तरीकों को इस तरह से डिज़ाइन किया गया है कि कई तरह की कार्रवाइयां स्वीकार की जा सकें. हर अनुरोध में कई कार्रवाइयों के बैच बनाकर, अपने अनुरोधों की संख्या और उनसे जुड़ी तय लागत को कम किया जा सकता है. अगर हो सके, तो सिर्फ़ एक कार्रवाई से अनुरोध करें.

उदाहरण के लिए, मान लें कि कई विज्ञापन ग्रुप के किसी कैंपेन में 50,000 कीवर्ड जोड़े जा रहे हैं. 1 कीवर्ड से 50,000 अनुरोध करने के बजाय, 500 कीवर्ड से 100 अनुरोध करें या हर अनुरोध के लिए 5,000 कीवर्ड वाले 10 अनुरोध करें. किसी अनुरोध में मंज़ूर की गई कार्रवाइयों की संख्या सीमित होती है. इसलिए, बेहतर परफ़ॉर्मेंस पाने के लिए आपको बैच का साइज़ बदलना पड़ सकता है.

स्पार्स ऑब्जेक्ट भेजें

जब ऑब्जेक्ट को एपीआई में भेजा जाता है, तो फ़ील्ड को डीसीरियलाइज़, पुष्टि, और डेटाबेस में सेव करना ज़रूरी है. जब आपको सिर्फ़ कुछ फ़ील्ड अपडेट करने हों, तब पूरे ऑब्जेक्ट को पास करने से, प्रोसेस करने में ज़्यादा समय लग सकता है और परफ़ॉर्मेंस में कमी आ सकती है. इसे कम करने के लिए, Google Ads API खास जानकारी से जुड़े अपडेट के साथ काम करता है. इससे आपको सिर्फ़ उस ऑब्जेक्ट के फ़ील्ड में बदलाव करने की सुविधा मिलती है जिसे आपको बदलना है या ज़रूरी है. स्पार्स अपडेट ज़्यादा तेज़ी से प्रोसेस होते हैं और इनसे गड़बड़ियां होने की संभावना कम होती है. जो फ़ील्ड अपडेट_mask (जिसे FieldMask भी कहा जाता है) में नहीं हैं उनमें कोई बदलाव नहीं होता.

उदाहरण के लिए, कीवर्ड-लेवल की बिड अपडेट करने वाले ऐप्लिकेशन को स्पार्स अपडेट का इस्तेमाल करने से फ़ायदा हो सकता है, क्योंकि सिर्फ़ विज्ञापन ग्रुप आईडी, शर्त आईडी, और बिड फ़ील्ड में जानकारी भरी जानी चाहिए.

गड़बड़ियों को ठीक करना और मैनेज करना

डेवलपमेंट के दौरान, हो सकता है कि आपको गड़बड़ियों का सामना करना पड़े. इस सेक्शन में, अपने ऐप्लिकेशन में गड़बड़ियों को मैनेज करने से जुड़ी ज़रूरी बातों और रणनीतियों के बारे में बताया गया है. इस सेक्शन के अलावा, गड़बड़ियों को मैनेज करने के बारे में ज़्यादा जानकारी पाने के लिए, समस्या हल करने वाली गाइड देखें.

अनुरोध स्रोतों में अंतर बताएं

कुछ ऐप्लिकेशन मुख्य रूप से इंटरैक्टिव होते हैं और ये उपयोगकर्ता की शुरू की गई कार्रवाइयों के जवाब में सीधे एपीआई कॉल जारी करते हैं. कुछ कंपनियां मुख्य रूप से ऑफ़लाइन काम करती हैं और समय-समय पर होने वाली बैक-एंड प्रोसेस के तहत एपीआई कॉल जारी करती हैं. कई ऐप्लिकेशन में इन दोनों को जोड़ा जाता है. गड़बड़ी के मैनेजमेंट के बारे में सोचते समय, इन अलग-अलग तरह के अनुरोधों में अंतर करना मददगार हो सकता है.

उपयोगकर्ताओं के किए गए अनुरोधों के लिए, आपकी मुख्य चिंता यह होनी चाहिए कि उपयोगकर्ताओं को अच्छा अनुभव मिलना चाहिए. उपयोगकर्ता को यूज़र इंटरफ़ेस (यूआई) में ज़्यादा से ज़्यादा जानकारी देने के लिए, हुई गड़बड़ी का इस्तेमाल करें. उन्हें इस गड़बड़ी को ठीक करने के आसान तरीके बताएं (नीचे दिए गए सुझावों को देखें).

बैक एंड पर शुरू किए गए अनुरोधों के लिए, अपने ऐप्लिकेशन से मिलने वाली अलग-अलग तरह की गड़बड़ियों के लिए हैंडलर लागू करें. कभी-कभी होने वाली या पहले नहीं मिली गड़बड़ियों को ठीक करने के लिए, हमेशा एक डिफ़ॉल्ट हैंडलर शामिल करें. डिफ़ॉल्ट हैंडलर के लिए एक अच्छा तरीका यह है कि नाकामयाब कार्रवाई और गड़बड़ी को किसी ह्यूमन ऑपरेटर की सूची में जोड़ा जाए, ताकि इसकी समीक्षा की जा सके और सही समस्या का हल निकाला जा सके.

गड़बड़ियों के टाइप में अंतर बताएं

गड़बड़ियों को बेहतर तरीके से मैनेज करने के लिए, Google Ads API में अलग-अलग तरह की गड़बड़ियों के बीच के अंतर को समझना ज़रूरी है. गड़बड़ी के कुछ सामान्य टाइप यहां दिए गए हैं:

  1. पुष्टि करने से जुड़ी गड़बड़ियां
  2. फिर से कोशिश की जा सकने वाली गड़बड़ियां
  3. पुष्टि से जुड़ी गड़बड़ियां
  4. सिंक से जुड़ी गड़बड़ियां

ज़्यादा जानकारी के लिए, गड़बड़ी के टाइप और सामान्य गड़बड़ियां देखें.

पिछली बार सिंक करें

अगर आपके ऐप्लिकेशन के उपयोगकर्ताओं के पास Google Ads खातों का मैन्युअल ऐक्सेस है, तो वे ऐसे बदलाव कर सकते हैं जिनके बारे में आपको ऐप्लिकेशन को जानकारी नहीं है. इस वजह से, आपके ऐप्लिकेशन का स्थानीय डेटाबेस सिंक नहीं हो पाएगा. जैसा कि हमारी गड़बड़ी के टाइप गाइड में बताया गया है, सिंक से जुड़ी गड़बड़ियां होने पर उन्हें ठीक किया जा सकता है. हालांकि, उन्हें रोका भी जा सकता है. इसकी एक बेहतर रणनीति है कि आप अपने सभी खातों में हर रात सिंक का काम करें, अपने खातों में Google Ads ऑब्जेक्ट वापस पाएं, और अपने स्थानीय डेटाबेस से उनकी तुलना करें.

लॉग की गड़बड़ियां

डीबग करने और मॉनिटर करने की सुविधा को आसान बनाने के लिए, सभी गड़बड़ियों को लॉग किया जाना चाहिए. कम से कम, अनुरोध आईडी, गड़बड़ी की वजह बताने वाली कार्रवाइयों, और गड़बड़ी को लॉग करें. लॉग करने के लिए अन्य जानकारी में ग्राहक आईडी, एपीआई सेवा, दोतरफ़ा यात्रा के लिए अनुरोध का इंतज़ार का समय, बार-बार की जाने वाली कोशिशों की संख्या, रॉ अनुरोध और रिस्पॉन्स शामिल है.

एपीआई की गड़बड़ियों के रुझानों को मॉनिटर करना न भूलें, ताकि आप ऐप्लिकेशन की समस्याओं का पता लगा सकें और उन्हें ठीक कर सकें. खुद का समाधान बनाएं या कई उपलब्ध व्यावसायिक टूल में से किसी एक का इस्तेमाल करें, जो इंटरैक्टिव डैशबोर्ड बनाने और ऑटोमेटेड सूचनाएं भेजने के लिए आपके लॉग का इस्तेमाल कर सकें.

डेवलेपमेंट

टेस्ट खातों का इस्तेमाल करना

टेस्ट खाते ऐसे Google Ads खाते होते हैं जो विज्ञापन नहीं दिखाते. Google Ads API के साथ प्रयोग करने के लिए, टेस्ट खाते का इस्तेमाल किया जा सकता है. साथ ही, यह जांच की जा सकती है कि आपके ऐप्लिकेशन की कनेक्टिविटी, कैंपेन मैनेजमेंट लॉजिक या अन्य प्रोसेसिंग उम्मीद के मुताबिक काम कर रही है या नहीं. आपके डेवलपर टोकन को टेस्ट खाते में इस्तेमाल करने की मंज़ूरी मिलना ज़रूरी नहीं है. इसलिए, डेवलपर टोकन का अनुरोध करने के तुरंत बाद ऐप्लिकेशन की समीक्षा होने से पहले ही, Google Ads API के साथ डेवलप करना शुरू किया जा सकता है.