Apple Ads और Google Drive को Hermoso से कनेक्ट करें, और दोनों एक ही एजेंट से कॉल होने लगते हैं। apple_ads_report परफ़ॉर्मेंस की पंक्तियाँ लाती है; create_sheet और append_to_sheet उन्हें आपकी अपनी स्प्रेडशीट में डालते हैं। कोई एक्सपोर्ट फ़ाइल नहीं, कोई वेयरहाउस नहीं, और कोई तीसरा टूल नहीं जो आपके क्रेडेंशियल रखे।
यह कैसा दिखता है
"पिछले हफ़्ते का Apple Search Ads खर्च कीवर्ड के हिसाब से निकालो और उसे मेरी Apple Ads शीट में जोड़ दो।" एजेंट रिपोर्ट कॉल करता है, पंक्तियों को आकार देता है और उन्हें जोड़ देता है। अगले सोमवार फिर पूछें तो शीट में एक हफ़्ते की और पंक्तियाँ जुड़ जाती हैं।
Hermoso जो Drive scope माँगता है वह drive.file है, जो सिर्फ़ उन फ़ाइलों तक पहुँचता है जो उसने बनाईं या आपने चुनीं, आपकी पूरी Drive तक नहीं।
Apple Search Ads को Google Sheets से कनेक्ट कैसे करें
- दोनों अकाउंट कनेक्ट करें। ऐप में Connectors खोलें और Apple Ads कनेक्ट करें, फिर Google Drive। Sheets और Docs उसी Google अनुमति पर चलते हैं, तो यह एक ही सहमति स्क्रीन है, तीन नहीं। Apple Ads में कोई बटन नहीं, कुंजी का आदान-प्रदान होता है; Apple Search Ads सेटअप गाइड इसे समझाती है, जिसमें यह भी है कि Apple Search Ads को Claude से या ChatGPT से कैसे जोड़ें, जहाँ आप अनुरोध टाइप करेंगे।
- पहली रिपोर्ट माँगें। "पिछले 30 दिनों का Apple Search Ads परफ़ॉर्मेंस कैंपेन के हिसाब से निकालो और उसे Apple Ads नाम की नई शीट में डाल दो।" एजेंट
apple_ads_reportकॉल करता है, फिरcreate_sheet, और लिंक लौटा देता है। - इसे नियमित बनाएँ। वही वाक्य, बस "नई शीट" की जगह "जोड़ो" लिखकर, उस क्लाइंट से शेड्यूल पर चलाएँ जिसे आप इस्तेमाल करते हैं (Claude या ChatGPT में scheduled task, या Hermoso CLI को कॉल करने वाला cron job)। हर बार पंक्तियों का नया ब्लॉक जुड़ता है। आप न कहें तो कुछ भी overwrite नहीं होता।
- अपना डैशबोर्ड शीट की ओर इंगित करें। Looker Studio, Power BI और Tableau, तीनों अपने-अपने कनेक्टर से Google Sheets पढ़ते हैं।
शीट कैसी दिखती है
हर इकाई की हर अवधि के लिए एक पंक्ति। कॉलम उस स्तर के अनुसार होते हैं जो आपने माँगा (कैंपेन, ad group, ad, keyword या search term) और साथ में वे मेट्रिक्स जो Apple रिपोर्ट करता है: impressions, taps, installs, spend, tap-through rate, cost per tap और cost per acquisition। रोज़ाना ग्रैन्युलैरिटी माँगें तो हर इकाई की एक पंक्ति रोज़; कुल माँगें तो एक पंक्ति। एजेंट एक grand-totals पंक्ति जोड़ सकता है, और App Store रिपोर्ट पर वह उन इकाइयों को भी रख सकता है जिनमें कोई डिलीवरी नहीं हुई, ताकि रुका हुआ कीवर्ड गायब होने के बजाय शून्य दिखे।
क्योंकि एजेंट लिखने से पहले पंक्तियों को आकार देता है, आप ठीक वही शीट माँग सकते हैं: सिर्फ़ वे कीवर्ड जिनका खर्च एक सीमा से ऊपर है, कैंपेन का नाम उसके id के साथ, और लिखने से पहले हफ़्ते-दर-हफ़्ते बदलाव निकाले हुए। यह वह काम है जो CSV एक्सपोर्ट आपके ऊपर छोड़ देता है।
जोड़ें, बदलें, या फ़ॉर्मेट करें
Sheets के टूल पूरा संपादन कवर करते हैं: append_to_sheet पंक्तियाँ जोड़ता है, update_sheet किसी रेंज को उसी जगह लिखता है, clear_sheet_range पहले उसे खाली करता है जब आप जमा होने के बजाय बदलाव चाहते हैं, format_sheet हेडर, चौड़ाई और नंबर फ़ॉर्मेट सँभालता है, और manage_sheet_tabs हर कैंपेन या हर महीने को अपना टैब देता है। "डैशबोर्ड शीट ताज़ा करो" अनुरोध का मतलब है साफ़ करना और फिर लिखना, उसी टैब पर जिसका आप नाम लें।
शीट से Apple Search Ads को Looker Studio में एक्सपोर्ट करें
Hermoso में Looker Studio का कोई नेटिव कनेक्टर नहीं है; शीट ही पुल है। Looker Studio में डेटा सोर्स बनाएँ, Google Sheets चुनें, और वह स्प्रेडशीट व टैब चुनें जिसमें एजेंट जोड़ता है। रिपोर्ट एक बार बनाएँ और छोड़ दें। हर जोड़ अगली डेटा रिफ़्रेश पर डैशबोर्ड पर दिखेगा, बशर्ते कॉलम हेडर हर बार एक जैसे रहें। यही पैटर्न Power BI और Tableau पर भी चलता है।
शीट के बजाय JSON चाहिए?
यही रिपोर्ट Hermoso API (POST /v1/tools/apple_ads_report) या CLI से raw JSON के रूप में मिलती है। देखें Apple Search Ads को JSON में एक्सपोर्ट करें, और बाकी हर गंतव्य के लिए Apple Search Ads से डेटा एक्सपोर्ट करें।
अक्सर पूछे जाने वाले प्रश्न
Apple Search Ads को Google Sheets से कैसे कनेक्ट करें?
Hermoso में Apple Ads और Google Drive कनेक्ट करें, फिर अपने एजेंट से रिपोर्ट को शीट में डालने को कहें। वह apple_ads_report से पंक्तियाँ लेता है, create_sheet या append_to_sheet से उन्हें लिखता है, और लिंक लौटा देता है।
क्या Hermoso को मेरी पूरी Google Drive तक पहुँच चाहिए?
नहीं। वह drive.file माँगता है, जो Hermoso द्वारा बनाई गई फ़ाइलों और आपकी स्पष्ट रूप से चुनी फ़ाइलों को कवर करता है।
शीट में कौन-से लेवल और मेट्रिक्स जा सकते हैं?
कैंपेन, ad group, ad, keyword या search-term लेवल, impressions, taps, installs, spend, tap-through rate, cost per tap और cost per acquisition के साथ, या तो कुल के रूप में या hourly, daily, weekly या monthly सीरीज़ के रूप में।
क्या शेड्यूल की गई रिपोर्ट मेरी शीट को overwrite करेगी?
जब तक आप ऐसा न कहें, नहीं। जोड़ने से पंक्तियाँ जुड़ती हैं; बदलाव का मतलब है साफ़ करना और फिर आपके नामित टैब पर लिखना, और एजेंट ऐसा तभी करता है जब अनुरोध में ऐसा लिखा हो।
क्या Looker Studio या Power BI नतीजा पढ़ सकते हैं?
हाँ। दोनों के लिए Hermoso का कोई नेटिव कनेक्टर नहीं है, पर दोनों Google Sheets को अपने कनेक्टर से पढ़ते हैं, इसलिए शीट पर बना डैशबोर्ड एजेंट के जोड़ते ही ताज़ा होता रहता है।
क्या रिपोर्ट शेड्यूल पर चल सकती है?
हाँ, उस क्लाइंट से जिसमें आपका एजेंट चलता है: Claude या ChatGPT में scheduled task, या Hermoso CLI या API को कॉल करने वाला cron job। हर रन नई अवधि खींचता है और उसे जोड़ देता है।