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