सबसे सही तरीके

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

अपने ऐप्लिकेशन को मैनेज करना

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

  • पक्का करें कि आपके 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 आपके आवेदन की समीक्षा करके, एपीआई के ऐक्सेस लेवल को बढ़ा सकता है.

आगे बढ़ें
एपीआई की सीमाएं और कोटा