Google Ads API Developer Assistant को इंस्टॉल और इस्तेमाल करना

ज़रूरी शर्तें

शुरू करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

  1. Google Ads API का ऐक्सेस:

  2. सॉफ़्टवेयर:

    • Python 3.10 या इसके बाद का वर्शन. Python डिफ़ॉल्ट भाषा है. इसलिए, आपके पास यह इंस्टॉल होनी चाहिए और आपके पाथ पर होनी चाहिए.
    • gemini-cli इंस्टॉल हो.
    • jq (कमांड-लाइन JSON प्रोसेसर). अगर यह मौजूद नहीं है, तो इंस्टॉलेशन स्क्रिप्ट इसे इंस्टॉल करने की कोशिश करेगी.

  3. डेटा स्टोर करने की जगह:

अपनी प्रोफ़ाइल बनाना शुरू करें

  1. प्रोजेक्ट डायरेक्ट्री पर जाएं:

    cd <full path>/google-ads-api-developer-assistant

  2. सेटअप स्क्रिप्ट चलाएं: यह स्क्रिप्ट, gemini-cli को कॉन्फ़िगर करती है, ताकि वह Assistant के GEMINI.md कॉन्टेक्स्ट फ़ाइलों और ज़रूरी टूल का इस्तेमाल कर सके.

    ./install.sh

    अगर Windows का इस्तेमाल किया जा रहा है, तो setup.ps1 PowerShell स्क्रिप्ट चलाएं.

  3. gemini-cli शुरू करें:

    gemini

  4. Assistant से इंटरैक्ट करना: अब आम बोलचाल की भाषा में सवाल पूछे जा सकते हैं या निर्देश दिए जा सकते हैं.

मुख्य सुविधाएं

  • सामान्य भाषा में सवाल-जवाब: Google Ads API की सुविधाओं, सबसे सही तरीकों या खास संसाधनों के बारे में सवाल पूछें.

    • "कौनसे कैंपेन टाइप उपलब्ध हैं?"
    • "GAQL में तारीख के हिसाब से फ़िल्टर कैसे करें?"
    • "click_view और impression_view के बीच का अंतर बताओ."

  • कोड जनरेट करना: GAQL क्वेरी और एक्ज़ीक्यूट किए जा सकने वाले Python कोड स्निपेट जनरेट करना.

    • "मुझे ऐसे कैंपेन दिखाओ जिनमें पिछले 30 दिनों में सबसे ज़्यादा कन्वर्ज़न हुए हैं."
    • "कैंपेन आईडी 12345 के लिए, चालू किए गए सभी विज्ञापन ग्रुप के नाम दिखाओ."
    • "सभी कैंपेन में अस्वीकार किए गए विज्ञापनों का पता लगाएं." जनरेट किया गया कोड, saved_code/ डायरेक्ट्री में सेव किया जाता है.

  • एपीआई को सीधे तौर पर एक्ज़ीक्यूट करना: जनरेट की गई सिर्फ़ पढ़ने के लिए उपलब्ध Python स्क्रिप्ट को सीधे तौर पर gemini-cli से रन करें और अपने टर्मिनल में फ़ॉर्मैट किए गए नतीजे देखें. Assistant के कोड जनरेट करने के बाद, आपको स्क्रीन पर यह प्रॉम्प्ट दिखेगा:

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

run डालें. अगर आपकी डिफ़ॉल्ट भाषा Python, Ruby या PHP है, तो स्क्रिप्ट Assistant के कॉन्टेक्स्ट में एक्ज़ीक्यूट होगी. सुरक्षा नीतियों की वजह से, कंपाइल की गई भाषाएं काम नहीं करेंगी.

  • CSV फ़ाइल में एक्सपोर्ट करना: एपीआई कॉल से मिले टेबल वाले नतीजों को CSV फ़ाइल में सेव करें.

    • "नतीजों को CSV फ़ाइल में सेव करो." फ़ाइलें, saved_csv/ डायरेक्ट्री में सेव की जाती हैं.

  • समस्या हल करने में सहायता: गड़बड़ी के मैसेज या एपीआई के अनचाहे व्यवहार से जुड़ी मदद पाएं.

    • "मुझे 'AuthenticationError.OAUTH_TOKEN_INVALID' गड़बड़ी का मैसेज मिला है. मुझे क्या करना चाहिए?"
    • "मुझे अपनी क्वेरी के लिए कोई नतीजा क्यों नहीं दिख रहा है?"

इस्तेमाल के उदाहरण

  • रिपोर्टिंग:
    • "मुझे ग्राहक 12345678 के लिए, पिछले महीने के हिसाब से लागत के आधार पर टॉप 5 कीवर्ड दिखाओ."
  • खाते का स्ट्रक्चर:
    • "सभी कैंपेन के नाम और उनके आईडी की सूची बनाओ."
  • समस्या हल करना:
    • "मैंने 100 कन्वर्ज़न अपलोड किए हैं, लेकिन यूज़र इंटरफ़ेस (यूआई) में सिर्फ़ 78 दिख रहे हैं. मैं एपीआई का इस्तेमाल करके, इस समस्या को कैसे ठीक करूं?"
  • लर्निंग:
    • "/explain what a shared set is"
  • कोड जनरेट करने की सुविधा:
    • "company name के लिए, परफ़ॉर्मेंस मैक्स कैंपेन बनाने का कोड लिखो."

समुदाय और सहायता

  • GitHub की समस्याएं: गड़बड़ियों की शिकायत करें, सुविधाओं के बारे में सुझाव दें या रिपॉज़िटरी में मौजूद समस्याएं टैब में जाकर सहायता पाएं.
  • Discord: Google Advertising and Measurement Community के Discord सर्वर पर मौजूद #ads-api-ai-tools चैनल में शामिल होकर चर्चा करें.
  • सुझाव/राय दें या शिकायत करें: इस सर्वे फ़ॉर्म के ज़रिए अपने सुझाव/राय दें या शिकायत करें.

योगदान देने के बारे में दिशा-निर्देश

हम आपके योगदान का स्वागत करते हैं! दिशा-निर्देशों के लिए, GitHub रिपॉज़िटरी में मौजूद CONTRIBUTING.md फ़ाइल देखें.