hermoso
سائن ان سائن اپ
MCP & CLI
APIقیمت
سائن ان سائن اپ

Apple Search Ads سے ڈیٹا ایکسپورٹ کریں

Apple کے پاس رپورٹنگ API ہے، لیکن کوئی export بٹن نہیں جو اعداد وہاں پہنچائے جہاں آپ کام کرتے ہیں۔ Hermoso کا کنیکٹر رپورٹ خود نکالتا ہے اور اسے Google Sheet، Looker Studio ڈیش بورڈ یا JSON فائل میں رکھتا ہے۔

Hermoso Apple Search Ads سے جڑتا ہے اور اسے ایسے tools کے طور پر پیش کرتا ہے جنہیں آپ کا ایجنٹ کال کر سکتا ہے: 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 flow شائع نہیں کرتا، تو کنیکٹ کرنا کوئی بٹن دبانے کے بجائے key کا تبادلہ ہے: Hermoso signing key بناتا ہے، آپ اس کا public half 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 چینل صفحہ ہر tool کی فہرست دیتا ہے۔

رپورٹ میں کیا ہوتا ہے

ایک کال، پانچ سطحیں۔ apple_ads_report campaign، ad group، ad، keyword یا search term کی سطح پر رپورٹ دیتا ہے، اور ہر قطار میں وہ میٹرکس ہوتے ہیں جو Apple کا اپنا ڈیش بورڈ دکھاتا ہے: impressions، taps، installs، spend، tap-through rate، cost per tap اور cost per acquisition۔ کل جوڑ مانگیں، یا ہر گھنٹے، روزانہ، ہفتہ وار یا ماہانہ سیریز۔ قطاریں spend کے حساب سے، سب سے زیادہ پہلے آتی ہیں، ہر صفحے پر 5,000 تک، اور درخواست پر ایک grand-totals قطار بھی۔ App Store رپورٹس میں ایسے entities بھی شامل ہو سکتے ہیں جن کی کوئی delivery نہیں ہوئی، تو ایک paused keyword صفر کے طور پر دکھتا ہے، غائب نہیں ہوتا۔

Apple کے دو قواعد جو Hermoso غیر واضح طور پر ناکام ہونے کے بجائے ٹول میں خود سمجھاتا ہے: campaign سطح سے نیچے کی رپورٹ کو campaign id درکار ہے (صرف campaign سطح کی رپورٹ پورے اکاؤنٹ کا احاطہ کر سکتی ہے)، اور search-term رپورٹس آپ کی تنظیم کے اپنے time zone میں چلتی ہیں، UTC میں کبھی نہیں۔ Apple Maps کے ads بھی شامل ہیں: business-brands رپورٹ اسی tool سے آتی ہے، بس ایک parameter بدل جاتا ہے۔

Apple Search Ads کو Google Sheets سے جوڑیں

یہ وہ واحد منزل ہے جس میں Hermoso خود لکھتا ہے۔ Google Drive کو Apple Ads کے ساتھ کنیکٹ کریں (ایک Google اجازت Drive، Sheets اور Docs کو کور کرتی ہے)، پھر پوچھیں: "پچھلے 30 دن کی Apple Search Ads کارکردگی keyword کے حساب سے نکالیں اور ایک نئی sheet میں ڈالیں جس کا نام Apple Ads ہو۔" ایجنٹ apple_ads_report کال کرتا ہے، پھر create_sheet، اور لنک واپس دیتا ہے۔ اگلے ہفتے اسی درخواست میں "append" لکھیں تو append_to_sheet نئی قطاریں شامل کرتا ہے، شروع سے دوبارہ نہیں لکھتا۔

Hermoso Google سے drive.file scope مانگتا ہے، جو صرف وہ فائلیں کھولتا ہے جو اس نے بنائیں یا جو آپ نے چنیں، آپ کا پورا Drive نہیں۔ ٹیب کو جگہ پر بدلنے اور اسے فارمیٹ کرنے سمیت مکمل طریقہ Apple Search Ads کو Google Sheets سے جوڑیں پر ہے۔

Apple Search Ads کو Looker Studio میں ایکسپورٹ کریں

Hermoso کا Looker Studio کا اپنا کوئی connector نہیں، اور ہم اسے ظاہر کرنے کے بجائے صاف کہنا بہتر سمجھتے ہیں۔ اسے اس کی ضرورت بھی نہیں: Looker Studio خود Google Sheets کو اپنے built-in connector سے پڑھتا ہے، تو اوپر کی sheet ہی پل ہے۔

  1. ایجنٹ سے رپورٹ ایک tab میں لکھوائیں۔ روزانہ کی سطح، ہر دن کے ہر keyword کے لیے ایک قطار، ایک header قطار اور ایک تاریخ کا کالم۔ تاریخ والے کالم کو تاریخ کے طور پر فارمیٹ کرنے کو کہیں (format_sheet یہ کرتا ہے) تاکہ Looker Studio اسے تاریخ کے طور پر پڑھے۔
  2. sheet کو data source کے طور پر شامل کریں۔ Looker Studio میں data source بنائیں، Google Sheets چنیں، spreadsheet اور وہ tab منتخب کریں، اور "Use first row as headers" آن رکھیں۔
  3. رپورٹ ایک بار بنائیں۔ دن کے حساب سے spend، keyword کے حساب سے cost per acquisition، campaign کے حساب سے installs: جو کچھ آپ ہر پیر کو کسی اسپریڈ شیٹ میں دوبارہ بناتے ہیں۔
  4. شامل کرتے رہیں۔ ہر ہفتے ایجنٹ اسی tab میں نئی قطاریں شامل کرتا ہے، اور ڈیش بورڈ انہیں اپنے اگلے data refresh پر اٹھا لیتا ہے۔ ہر run کے درمیان کالم کے نام ایک جیسے رکھیں، کیونکہ Looker Studio فیلڈز کو header سے ملاتا ہے۔

یہی sheet Power BI اور Tableau کے لیے بھی کام کرتی ہے، کیونکہ ان دونوں کے اپنے Google Sheets connectors ہیں۔

Apple Search Ads کو JSON میں ایکسپورٹ کریں

اگر آپ spreadsheet کے بجائے خام قطاریں چاہتے ہیں تو تین طریقے ہیں، سب ایک ہی کنکشن استعمال کرتے ہیں۔

REST API۔ ہر Hermoso tool POST /v1/tools/{name} پر کال ہو سکتا ہے، اس API key کے ساتھ جو آپ ایپ میں MCP & CLI ٹیب پر بناتے ہیں۔ request body tool کے 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 کے طور پر چھاپتا ہے، جسے فائل میں redirect کیا جا سکتا ہے یا کسی اور script میں pipe کیا جا سکتا ہے۔

آپ کا ایجنٹ۔ کسی بھی چیٹ میں قطاریں JSON میں مانگیں، اور جواب میں وہ اسی شکل میں ملیں گی جو آپ نے مانگی تھی۔

لمبی رپورٹس کے لیے limit ہر صفحے پر 5,000 قطاروں تک لیتا ہے اور offset اگلے صفحے پر جاتا ہے؛ نتیجے کا hasMore بتاتا ہے کہ اور صفحہ ہے یا نہیں۔ رپورٹ پڑھنے سے کوئی credit خرچ نہیں ہوتا۔ مکمل API حوالہ developer docs میں ہے۔

دوسری منزلیں

"Direct" کا مطلب ہے کہ Hermoso خود لکھتا ہے۔ باقی سب ایک قدم ہے جو وہ ٹول خود کرتا ہے جو آپ پہلے سے استعمال کرتے ہیں۔

  • Google Sheets، Google Docs، Google Drive، OneDrive: direct۔
  • Looker Studio، Power BI، Tableau: sheet کے ذریعے، ہر ایک اپنے Google Sheets connector کے ساتھ۔
  • BigQuery: sheet کے ذریعے، یا آپ کے اپنے ایجنٹ کے ذریعے۔ BigQuery کسی Google Sheet کو external table کے طور پر query کر سکتا ہے۔ اگر آپ کا ایجنٹ کسی ایسی جگہ چلتا ہے جہاں BigQuery client اور آپ کے project credentials ہیں، تو وہ Hermoso کی لوٹائی ہوئی قطاریں سیدھا ایک table میں ڈال سکتا ہے۔
  • Excel: sheet کے ذریعے یا فائل کے ذریعے۔ sheet کو .xlsx کے طور پر ڈاؤن لوڈ کریں، یا ایجنٹ سے کہیں کہ Google Drive یا OneDrive میں ایک فائل چھوڑ دے۔
  • PostgreSQL، Redshift، Snowflake یا کوئی بھی warehouse: اپنے ایجنٹ یا API کے ذریعے۔ Hermoso JSON واپس دیتا ہے؛ جس چیز کے پاس آپ کے database credentials ہیں وہی اسے لکھتی ہے۔ Hermoso warehouse credentials اپنے پاس نہیں رکھتا۔

ہفتہ وار ایکسپورٹ کو خودکار کرنا

prompt ہی automation ہے۔ کچھ ایسا کہ "ہر پیر کو پچھلے ہفتے کی ہر campaign کی Apple Search Ads کارکردگی keyword کے حساب سے نکالو، Apple Ads sheet میں append کرو، اور بتاؤ کہ cost per acquisition کے لحاظ سے کون سے keywords سب سے زیادہ بدلے" ایک مکمل کام ہے۔ اسے اپنے کلائنٹ کے پاس موجود scheduling سے چلائیں (Claude یا ChatGPT میں scheduled tasks، یا Hermoso CLI یا API کو کال کرنے والا cron job) تو sheet، اور اسے پڑھنے والے ہر ڈیش بورڈ، تازہ رہتے ہیں۔

چونکہ وہی کنکشن اکاؤنٹ میں تبدیلیاں بھی کرتا ہے، رپورٹ اور اس کا حل ایک ہی جگہ رہتے ہیں: وہ ایجنٹ جو دیکھتا ہے کہ کسی keyword کی cost per acquisition دگنی ہو گئی ہے، اسی گفتگو میں اسے paused کر سکتا ہے یا negative شامل کر سکتا ہے۔

اکثر پوچھے گئے سوالات

Apple Search Ads کا ڈیٹا کیسے ایکسپورٹ کروں؟

Apple Ads کو Hermoso سے ایک بار کنیکٹ کریں، پھر اپنے ایجنٹ سے وہ رپورٹ مانگیں جو آپ چاہتے ہیں، مثلاً پچھلے ہفتے کی keyword کارکردگی۔ apple_ads_report tool اسے Apple کے reporting API سے نکالتا ہے، اور ایجنٹ اسے Google Sheet میں لکھتا ہے، JSON دیتا ہے، یا دونوں۔

کیا میں Apple Search Ads کو Google Sheets سے جوڑ سکتا ہوں؟

ہاں۔ Hermoso میں Apple Ads اور Google Drive کنیکٹ کریں، پھر ایجنٹ سے رپورٹ کو sheet میں ڈالنے کو کہیں۔ یہ create_sheet سے sheet بناتا ہے، یا append_to_sheet سے موجودہ sheet میں قطاریں شامل کرتا ہے، اور ہر ہفتے یہ دہرا سکتا ہے۔

کیا میں Apple Search Ads کو Looker Studio میں ایکسپورٹ کر سکتا ہوں؟

ہاں، Google Sheets کے ذریعے۔ Hermoso کا Looker Studio کا اپنا connector نہیں ہے۔ ایجنٹ رپورٹ کو ایک sheet میں لکھتا ہے، آپ Looker Studio میں اس sheet کو ایک بار Google Sheets data source کے طور پر شامل کرتے ہیں، اور ہر append ڈیش بورڈ کے اگلے refresh پر نظر آ جاتا ہے۔

میں Apple Search Ads کا ڈیٹا JSON میں کیسے حاصل کروں؟

API key کے ساتھ 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 tools اکاؤنٹ بناتے اور چلاتے ہیں۔

کیا میں Apple Search Ads کی search-term رپورٹس لے سکتا ہوں؟

ہاں۔ search-term سطح مانگیں اور campaign کا نام لیں۔ Apple search terms صرف campaign کے حساب سے دیتا ہے، تنظیم کے اپنے time zone میں۔

ایک رپورٹ میں کتنی قطاریں آ سکتی ہیں؟

ہر صفحے پر 5,000 تک، spend کے حساب سے سب سے زیادہ سے کم کی ترتیب میں، اور ایک flag جو ایجنٹ کو بتاتا ہے کہ اور صفحات ہیں یا نہیں۔ زیادہ تر اکاؤنٹس کی ہفتہ وار keyword رپورٹ ایک صفحے میں آ جاتی ہے۔

کیا یہ Apple Maps کے ads کو بھی کور کرتا ہے؟

ہاں۔ business-brands campaigns کی رپورٹیں اسی tool سے آتی ہیں، جس میں promoted object type کو App Store کے بجائے Apple Maps پر سیٹ کیا جاتا ہے۔

کیا اسے سیٹ اپ کرنے کے لیے ڈویلپر کی ضرورت ہے؟

نہیں۔ Apple Ads کو ایپ میں ایک بار کنیکٹ کریں، پھر اپنے ایجنٹ سے سادہ زبان میں پوچھیں: پچھلا ہفتہ keyword کے حساب سے نکالو اور sheet میں ڈالو۔ اگر آپ اسے script کرنا چاہتے ہیں تو API اور CLI موجود ہیں۔

مفت شروع کریں، کارڈ کی ضرورت نہیں، ہر پلان پر ہر فیچر کے ساتھ۔

مفت شروع کریں →   قیمتیں دیکھیں