hermoso
साइन इन साइन अप
MCP & CLI
APIमूल्य निर्धारण
साइन इन साइन अप

Apple Search Ads से डेटा एक्सपोर्ट करें

Apple के पास reporting API है, पर ऐसा एक्सपोर्ट बटन नहीं जो नंबर सीधे उस जगह पहुँचा दे जहाँ आप काम करते हैं। Hermoso कनेक्टर रिपोर्ट खींचकर उसे Google Sheet, Looker Studio डैशबोर्ड या JSON फ़ाइल में डाल देता है।

Hermoso Apple Search Ads से जुड़ता है और उसे ऐसे टूल्स के रूप में दिखाता है जिन्हें आपका एजेंट कॉल कर सके: Claude, ChatGPT, Cursor, Codex, Cline, CLI या सादा HTTP। apple_ads_report campaign, ad group, ad, keyword और search-term परफ़ॉर्मेंस खींचता है, और पंक्तियाँ डेटा के रूप में लौटती हैं, CSV डाउनलोड के रूप में नहीं जिसे फिर आपको कहीं और ले जाना पड़े।

Apple Search Ads कनेक्टर

Apple अपने ads API के लिए कोई OAuth फ़्लो नहीं देता, इसलिए कनेक्ट करना बटन से नहीं, कुंजी के आदान-प्रदान से होता है: Hermoso साइनिंग कुंजी बनाता है, आप उसका public हिस्सा Apple Ads में डालते हैं और तीन ids वापस पेस्ट करते हैं। Apple Search Ads सेटअप गाइड इसे चरण-दर-चरण समझाती है, जिसमें वह Public Key फ़ील्ड भी है जो ज़्यादातर लोगों को मिलता ही नहीं। एक कनेक्शन वेब ऐप, MCP सर्वर, CLI और REST API, चारों को चलाता है, इसलिए वही एक्सपोर्ट Claude, ChatGPT या Cursor से चलता है: Apple Search Ads को Claude से या ChatGPT से एक बार कनेक्ट करें, फिर पूछें।

रिपोर्टिंग इसका एक हिस्सा है। वही कनेक्शन पूरा अकाउंट भी बनाता और चलाता है: campaigns, ad groups, keywords और negatives, budget orders, targeting, keyword सुझाव और change history। Apple Ads चैनल पेज हर टूल की सूची देता है।

रिपोर्ट में क्या है

एक कॉल, पाँच लेवल। apple_ads_report campaign, ad group, ad, keyword या search term लेवल पर रिपोर्ट करता है, और हर पंक्ति में वही मेट्रिक्स होते हैं जो Apple का अपना डैशबोर्ड दिखाता है: impressions, taps, installs, spend, tap-through rate, cost per tap और cost per acquisition। कुल माँगें, या hourly, daily, weekly या monthly ग्रैन्युलैरिटी की सीरीज़। पंक्तियाँ spend के हिसाब से क्रम में आती हैं, सबसे ज़्यादा ऊपर, एक पेज में 5,000 तक, और माँगने पर grand-totals पंक्ति भी। App Store रिपोर्ट में वे इकाइयाँ भी आ सकती हैं जिनमें कोई डिलीवरी नहीं हुई, ताकि रुका हुआ कीवर्ड गायब लाइन के बजाय शून्य के रूप में दिखे।

Apple के दो नियम हैं, जिन्हें टूल चुपचाप फ़ेल होने के बजाय समझाता है: campaign स्तर से नीचे की रिपोर्ट को campaign id चाहिए (सिर्फ़ campaign स्तर की रिपोर्ट पूरे अकाउंट को कवर कर सकती है), और search-term रिपोर्ट आपकी संस्था के अपने टाइम ज़ोन में चलती हैं, कभी UTC में नहीं। Apple Maps पर चलने वाले विज्ञापन भी कवर हैं: business-brands रिपोर्ट उसी टूल से आती है, बस एक पैरामीटर बदलकर।

Apple Search Ads को Google Sheets से कनेक्ट करें

यही एक गंतव्य है जिसमें Hermoso खुद लिखता है। Apple Ads के साथ Google Drive कनेक्ट करें (एक Google अनुमति Drive, Sheets और Docs तीनों को कवर करती है), फिर पूछें: "पिछले 30 दिनों का Apple Search Ads परफ़ॉर्मेंस कीवर्ड के हिसाब से निकालो और उसे Apple Ads नाम की नई शीट में डाल दो।" एजेंट apple_ads_report कॉल करता है, फिर create_sheet, और लिंक लौटा देता है। अगले हफ़्ते वही अनुरोध "जोड़ो" शब्द के साथ append_to_sheet से नई पंक्तियाँ जोड़ता है, शुरुआत से नहीं।

Hermoso Google से drive.file scope माँगता है, जो सिर्फ़ उन फ़ाइलों तक पहुँचता है जो उसने बनाईं या आपने चुनीं, आपकी पूरी Drive तक कभी नहीं। पूरा तरीका, जिसमें टैब को उसी जगह बदलना और उसे फ़ॉर्मेट करना भी शामिल है, Apple Search Ads को Google Sheets से कनेक्ट करें पर है।

Apple Search Ads को Looker Studio में एक्सपोर्ट करें

Hermoso में Looker Studio का कोई नेटिव कनेक्टर नहीं है, और हम इसे छिपाने के बजाय साफ़ कहना बेहतर समझते हैं। इसकी ज़रूरत भी नहीं: Looker Studio Google Sheets को अपने बिल्ट-इन कनेक्टर से पढ़ता है, इसलिए ऊपर की शीट ही पुल है।

  1. एजेंट से रिपोर्ट एक टैब में लिखवाएँ। रोज़ाना ग्रैन्युलैरिटी, हर दिन हर कीवर्ड की एक पंक्ति, एक हेडर पंक्ति और एक तारीख़ कॉलम। तारीख़ कॉलम को तारीख़ के फ़ॉर्मेट में माँगें (format_sheet यह कर देता है) ताकि Looker Studio उसे तारीख़ के रूप में पढ़े।
  2. शीट को डेटा सोर्स बनाएँ। Looker Studio में डेटा सोर्स बनाएँ, Google Sheets चुनें, स्प्रेडशीट और वह टैब चुनें, और "Use first row as headers" चालू रखें।
  3. रिपोर्ट एक बार बनाएँ। दिन के हिसाब से खर्च, कीवर्ड के हिसाब से cost per acquisition, कैंपेन के हिसाब से installs: वह सब जो आप हर सोमवार शीट में दोबारा बनाते।
  4. जोड़ते रहें। हर हफ़्ते एजेंट उसी टैब में नई पंक्तियाँ जोड़ता है और डैशबोर्ड अगली डेटा रिफ़्रेश पर उन्हें उठा लेता है। हर रन में कॉलम के नाम एक जैसे रखें, क्योंकि Looker Studio फ़ील्ड को हेडर से मैप करता है।

यही शीट Power BI और Tableau पर भी चलती है, जिनके अपने Google Sheets कनेक्टर हैं।

Apple Search Ads को JSON में एक्सपोर्ट करें

अगर आपको शीट के बजाय raw पंक्तियाँ चाहिए, तो तीन तरीके हैं, और सभी एक ही कनेक्शन से।

REST API। हर Hermoso टूल POST /v1/tools/{name} पर कॉल होता है, उस API कुंजी के साथ जो आप ऐप में MCP & CLI टैब पर बनाते हैं। रिक्वेस्ट बॉडी टूल के arguments होती है, और जवाब का data फ़ील्ड structured नतीजा है, जिसमें पंक्तियाँ data.rows में होती हैं:

curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
  -H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
  -d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
  | jq '.data.rows' > apple-search-ads.json

CLI। npx -y hermoso call apple_ads_report --json '{...}' --structured वही structured नतीजा JSON में प्रिंट करता है, जिसे फ़ाइल में रीडायरेक्ट किया जा सके या किसी दूसरी स्क्रिप्ट में पाइप किया जा सके।

आपका एजेंट। किसी भी चैट में JSON में पंक्तियाँ माँगें, और वे जवाब में आ जाती हैं, जैसे आपने माँगा था वैसे आकार में।

लंबी रिपोर्ट के लिए limit एक पेज में 5,000 पंक्तियों तक लेता है और offset अगले पेज पर ले जाता है; नतीजे का hasMore बताता है कि और पेज है या नहीं। रिपोर्ट पढ़ने में क्रेडिट खर्च नहीं होते। पूरा API संदर्भ डेवलपर डॉक्स में है।

अन्य गंतव्य

"Direct" का मतलब है Hermoso खुद लिखता है। बाकी हर चीज़ एक ऐसा कदम है जो आपका पहले से इस्तेमाल होने वाला टूल खुद कर देता है।

  • Google Sheets, Google Docs, Google Drive, OneDrive: direct।
  • Looker Studio, Power BI, Tableau: शीट के ज़रिए, हर एक अपने Google Sheets कनेक्टर से।
  • BigQuery: शीट के ज़रिए, या आपके अपने एजेंट के ज़रिए। BigQuery Google Sheet को external table के रूप में क्वेरी कर सकता है। अगर आपका एजेंट ऐसी जगह चलता है जहाँ BigQuery client और आपके प्रोजेक्ट के क्रेडेंशियल हैं, तो वह Hermoso से मिली पंक्तियाँ सीधे किसी table में डाल सकता है।
  • Excel: शीट के ज़रिए या फ़ाइल से। शीट को .xlsx में डाउनलोड करें, या एजेंट से Google Drive या OneDrive में फ़ाइल छोड़ने को कहें।
  • PostgreSQL, Redshift, Snowflake या कोई भी वेयरहाउस: आपके अपने एजेंट या API के ज़रिए। Hermoso JSON लौटाता है; जो भी आपके डेटाबेस क्रेडेंशियल रखता है, वही लिखता है। Hermoso वेयरहाउस क्रेडेंशियल नहीं रखता।

साप्ताहिक एक्सपोर्ट को स्वचालित करना

प्रॉम्प्ट ही स्वचालन है। "हर सोमवार पिछले हफ़्ते का Apple Search Ads परफ़ॉर्मेंस हर कैंपेन के हर कीवर्ड के हिसाब से निकालो, उसे Apple Ads शीट में जोड़ो, और बताओ कि cost per acquisition में कौन-से कीवर्ड सबसे ज़्यादा हिले" अपने आप में पूरा काम है। इसे उस शेड्यूलिंग के साथ चलाएँ जो आपके क्लाइंट में पहले से है (Claude या ChatGPT में scheduled tasks, या Hermoso CLI या API को कॉल करने वाला cron job), और शीट, तथा उसे पढ़ने वाले हर डैशबोर्ड, ताज़ा रहते हैं।

क्योंकि वही कनेक्शन अकाउंट में बदलाव भी करता है, इसलिए रिपोर्ट और सुधार एक ही जगह रहते हैं: जो एजेंट देखता है कि किसी कीवर्ड का cost per acquisition दोगुना हो गया, वह उसी बातचीत में उसे pause कर सकता है या negative जोड़ सकता है।

अक्सर पूछे जाने वाले प्रश्न

Apple Search Ads से डेटा कैसे एक्सपोर्ट करें?

एक बार Apple Ads को Hermoso से कनेक्ट करें, फिर अपने एजेंट से वह रिपोर्ट माँगें जो आपको चाहिए, जैसे पिछले हफ़्ते का कीवर्ड परफ़ॉर्मेंस। apple_ads_report टूल उसे Apple की reporting API से निकालता है, और एजेंट उसे Google Sheet में लिखता है, आपको JSON देता है, या दोनों।

क्या मैं Apple Search Ads को Google Sheets से कनेक्ट कर सकता हूँ?

हाँ। Hermoso में Apple Ads और Google Drive कनेक्ट करें, फिर एजेंट से रिपोर्ट को शीट में डालने को कहें। वह create_sheet से नई शीट बनाता है, या append_to_sheet से मौजूदा शीट में पंक्तियाँ जोड़ता है, और यह हर हफ़्ते दोहरा सकता है।

क्या मैं Apple Search Ads को Looker Studio में एक्सपोर्ट कर सकता हूँ?

हाँ, Google Sheets के ज़रिए। Hermoso में Looker Studio का नेटिव कनेक्टर नहीं है। एजेंट रिपोर्ट को शीट में लिखता है, आप उस शीट को Looker Studio में एक बार Google Sheets डेटा सोर्स के रूप में जोड़ते हैं, और हर जोड़ अगले रिफ़्रेश पर डैशबोर्ड पर दिखता है।

Apple Search Ads डेटा को JSON में कैसे एक्सपोर्ट करें?

API कुंजी के साथ Hermoso API पर POST /v1/tools/apple_ads_report कॉल करें और जवाब में से data.rows पढ़ें, या CLI से hermoso call apple_ads_report --json '{...}' --structured चलाएँ। दोनों एक ही पंक्तियाँ JSON में लौटाते हैं।

क्या Apple Search Ads की reporting API है?

हाँ, और Hermoso उसी पर बना है। apple_ads_report campaign, ad group, ad, keyword और search-term परफ़ॉर्मेंस कवर करता है, और बाकी Apple Ads टूल अकाउंट बनाते और चलाते हैं।

क्या मैं Apple Search Ads की search-term रिपोर्ट ले सकता हूँ?

हाँ। search-term लेवल माँगें और कैंपेन का नाम लें। Apple search terms सिर्फ़ कैंपेन के हिसाब से देता है, और संस्था के अपने टाइम ज़ोन में।

एक रिपोर्ट में कितनी पंक्तियाँ आ सकती हैं?

एक पेज में 5,000 तक, spend के हिसाब से सबसे ज़्यादा से सबसे कम के क्रम में, और एक फ़्लैग के साथ जो बताता है कि और पेज हैं या नहीं। ज़्यादातर अकाउंट की साप्ताहिक कीवर्ड रिपोर्ट एक पेज में आ जाती है।

क्या यह Apple Maps पर चलने वाले विज्ञापनों को कवर करता है?

हाँ। business-brands कैंपेन की रिपोर्ट उसी टूल से आती है, बस promoted object type को App Store के बजाय Apple Maps पर सेट करके।

क्या इसे सेट करने के लिए डेवलपर चाहिए?

नहीं। ऐप में Apple Ads एक बार कनेक्ट करें, फिर अपने एजेंट से सादी भाषा में पूछें: पिछले हफ़्ते का कीवर्ड के हिसाब से निकालो और शीट में डाल दो। API और CLI तब हैं जब आप स्क्रिप्ट लिखना चाहें।

बिना कार्ड के मुफ़्त शुरू करें, हर प्लान पर हर फ़ीचर के साथ।

मुफ़्त में शुरू करें →   प्राइसिंग देखें