پانچ منٹ میں Apple Search Ads کو Claude یا ChatGPT سے جوڑیں

Hermoso کا Apple Search Ads کنیکٹر آپ کے Apple Ads اکاؤنٹ کو Claude، ChatGPT، Cursor، CLI یا سادہ HTTP سے جوڑتا ہے، تاکہ ایجنٹ آپ کے App Store سرچ اشتہارات آپ کے لیے چلا سکے۔ یہ campaign، ad group، targeting keywords اور negatives بناتا ہے، Apple میں جو واقعی محفوظ ہوا اسے دوبارہ پڑھ کر دیکھتا ہے، اور کارکردگی اس search term تک رپورٹ کرتا ہے جو کسی نے انسٹال کرنے سے پہلے ٹائپ کیا تھا۔ ہر وہ چیز جو بنتی ہے paused حالت میں بنتی ہے، اور spend آن کرنا ایک الگ، واضح طور پر تصدیق شدہ قدم ہے۔ رپورٹس Google Sheet، Looker Studio ڈیش بورڈ یا JSON فائل میں جا سکتی ہیں، اور Apple Ads MCP صفحہ بتاتا ہے کہ یہ کنیکٹر کیا کچھ کر سکتا ہے۔

کنیکٹ کرنے میں تقریباً پانچ منٹ لگتے ہیں۔ آپ openssl نہیں چلائیں گے، اور کوئی Apple پاس ورڈ Hermoso تک نہیں پہنچتا۔

Apple Search Ads کو Claude سے جوڑیں

Apple Search Ads کو Claude سے جوڑنے کے لیے Hermoso کو Claude میں ایک connector کے طور پر شامل کریں، پھر Hermoso کے اندر ایک بار اپنا Apple Ads اکاؤنٹ کنیکٹ کریں۔ Claude میں Customize › Connectors › Add custom connector کھولیں، نام Hermoso رکھیں، https://app.hermoso.ai/mcp پیسٹ کریں اور اپنے Hermoso اکاؤنٹ سے منظور کریں۔ Claude میں کوئی key پیسٹ نہیں کرنی۔ پھر Hermoso میں Settings › Connectors کے تحت Apple Ads کنیکٹ کریں، اس صفحے پر نیچے دیے گئے مراحل کے مطابق۔ اس کے بعد Claude وہ ہر Apple Ads tool چلا سکتا ہے جو Hermoso کے پاس ہے: سادہ الفاظ میں رپورٹ، keyword کی تبدیلی یا نئی campaign مانگیں۔ Claude Code میں اس کے بجائے دو کمانڈز ہیں: /plugin marketplace add hermoso-ai/hermoso، پھر /plugin install hermoso@hermoso۔ Claude میں Hermoso میں مکمل مراحل ہیں۔

Apple Search Ads کو ChatGPT سے جوڑیں

ChatGPT کا طریقہ بھی یہی ہے۔ ChatGPT میں Plugins کھولیں، پھر Add › Create MCP App، نام Hermoso رکھیں، https://app.hermoso.ai/mcp کو Server URL کے طور پر پیسٹ کریں، Authentication کو OAuth پر رہنے دیں اور اپنے Hermoso اکاؤنٹ سے منظور کریں۔ اگر Create MCP App نظر نہ آئے تو Settings › Plugins › Developer mode کے تحت Developer mode ایک بار آن کریں۔ Hermoso میں Apple Ads کنیکٹ ہونے کے بعد ChatGPT آپ کی keyword رپورٹ لا سکتا ہے، اسے Google Sheet میں لکھ سکتا ہے، یا آپ کی جانچ کے لیے campaign کا مسودہ بنا سکتا ہے۔ ChatGPT میں Hermoso یہ سب مرحلہ وار دکھاتا ہے۔

Cursor، Codex اور کوئی بھی دوسرا MCP کلائنٹ

Model Context Protocol بولنے والا کوئی بھی کلائنٹ اسی پتے پر وہی tools تک پہنچتا ہے۔ Cursor https://app.hermoso.ai/mcp کو اپنی mcp.json سے پڑھتا ہے؛ Codex، codex plugin marketplace add hermoso-ai/hermoso کے ذریعے Hermoso plugin لیتا ہے، جو ٹرمینل سے وہی tools چلاتا ہے۔ آپ جو بھی کلائنٹ استعمال کریں، آپ کے Apple credentials چیٹ سے نہیں گزرتے۔ ایجنٹ Hermoso کے tools کو کال کرتا ہے، اور Hermoso ہر درخواست پر Apple کو اپنی رکھی ہوئی key سے دستخط کرتا ہے۔ Apple Ads MCP صفحہ ہر tool کی فہرست دیتا ہے۔

کنیکٹ ہونے کے بعد کیا پوچھیں

• “پچھلے ہفتے کی Apple Search Ads کارکردگی keyword کے لحاظ سے نکالیں اور مجھے وہ دس دکھائیں جن کی cost per acquisition سب سے زیادہ ہے۔”
• “آخری 30 دن کا spend، installs اور CPA campaign کے حساب سے ایک نئی Google Sheet میں ڈالیں جس کا نام Apple Ads ہو۔” (پہلے Google Drive کنیکٹ کریں۔)
• “اس مہینے میری US campaign میں کون سے search terms نے installs لائے جن پر میں ابھی exact keywords کے طور پر بڈ نہیں کر رہا؟”
• “Brand ad group میں ‘budget planner’ اور ‘expense tracker’ کو exact match keywords کے طور پر شامل کریں، اور ‘jobs’ کو negative کے طور پر۔”
• “Apple میری ایپ کے لیے کون سے keywords تجویز کرتا ہے، اور جن پر میں پہلے ہی بڈ کر رہا ہوں ان پر میرا impression share کتنا ہے؟”
• “میری ایپ کے لیے UK میں ایک paused campaign بنائیں جس کا روزانہ بجٹ 50 ڈالر ہو، پھر دکھائیں کہ Apple نے کیا محفوظ کیا۔”

رپورٹ پڑھنے سے کبھی spend کو ہاتھ نہیں لگتا۔ ایجنٹ جو بھی بناتا ہے وہ paused بنتا ہے، اور spend آن کرنے کا سوئچ آپ کی واضح تصدیق کا انتظار کرتا ہے۔

پہلے وہ بات جو زیادہ تر لوگوں کو رکا دیتی ہے

Apple کی اپنی ہدایت یہ ہے: “Ads UI سے Account Settings › API منتخب کریں۔ key کو Public Key فیلڈ میں پیسٹ کریں۔”

یہ فیلڈ Account Admin کے لیے موجود ہی نہیں ہے۔ اپنے اکاؤنٹ پر بطور admin سائن ان کریں، Account Settings › API کھولیں، تو ایک ٹیبل نظر آتا ہے جس کا عنوان Manage API Access ہے (تیسرے فریق سروس فراہم کنندگان کی فہرست جس میں ایک ہی Remove Access action ہے) اور صفحے پر کہیں key فیلڈ نہیں ہوتی۔ یہ بالکل کسی غائب فیچر جیسا لگتا ہے، اسی لیے لوگ یہیں رک کر سمجھ لیتے ہیں کہ API ان کے لیے دستیاب نہیں۔

یہ دستیاب ہے۔ Public Key فیلڈ اس صارف کو نظر آتی ہے جس کے پاس API role ہو، اور اکاؤنٹ کا admin ہونا اس role کے برابر نہیں۔ Apple کا invite ڈائیلاگ چھ roles پیش کرتا ہے، جن میں سے بالکل دو API roles ہیں:

• API Account Manager: “all campaign groups کے لیے API management کی read اور write رسائی”۔ اگر آپ چاہتے ہیں کہ Hermoso صرف رپورٹ نہیں بلکہ campaigns بھی بنائے تو یہی منتخب کریں۔
• API Account Read Only: “all campaign groups کے لیے API management کی صرف read رسائی”۔ رپورٹنگ کے لیے کافی ہے، اور اس کے علاوہ کچھ نہیں۔

باقی چار (Account Admin، Account Finance، Account Read Only اور Limited Access) کسی بھی طرح API credentials نہیں بنا سکتے۔ تو حل ایک ایسی دعوت ہے جو آپ خود اپنے آپ کو بھیجتے ہیں:

1. Account Settings › User Management کھولیں اور Invite Users منتخب کریں۔
2. ایک ایسا پتہ دعوت دیں جو آپ کے کنٹرول میں ہو (اپنا، یا کوئی مشترکہ پتہ جیسے ads-api@yourcompany.com تاکہ credential کسی ایک فرد سے آگے بھی چلے) اور role API Account Manager رکھیں۔
3. اس inbox سے دعوت قبول کریں، پھر Apple Ads میں سائن ان کریں اس user کے طور پر۔

اب Account Settings › API پر ایک Public Key فیلڈ موجود ہے۔

کنکشن، مرحلہ وار

1. Hermoso میں شروع کریں۔ Settings › Connectors › Apple Ads › Connect۔ Hermoso ایک EC P-256 signing key بناتا ہے (وہی prime256v1 key جو Apple کی دو openssl کمانڈز بناتیں) اور آپ کو صرف public half دکھاتا ہے۔ اسے کاپی کریں۔
2. public half Apple کو دیں۔ اپنے API-role صارف کے طور پر، Account Settings › API کھولیں، اسے Public Key میں پیسٹ کریں، اور Save کریں۔
3. تینوں ids واپس کاپی کریں۔ Apple اب اس فیلڈ کے اوپر clientId، teamId اور keyId دکھاتا ہے۔ تینوں۔
4. Hermoso میں مکمل کریں۔ تینوں ids پیسٹ کریں اور save کریں۔ Hermoso Apple سے token کا تبادلہ کرتا ہے اور کچھ بھی محفوظ کرنے سے پہلے آپ کی organization کی فہرست پڑھتا ہے، تو غلط لکھا گیا id وہیں ناکام ہو جاتا ہے، جب آپ کو وہ پیسٹ کیا ہوا دکھائی دیتا ہے، نہ کہ ایک گھنٹے بعد پہلی رپورٹ کے وقت۔
5. organization چنیں، اگر آپ کی credentials ایک سے زیادہ پر محیط ہوں۔ کنکشن آپ کے چنے ہوئے ایک سے جڑ جاتا ہے۔

کچھ غلط ہو جائے تو

API صفحے پر Public Key فیلڈ نہیں ہے

آپ Account Admin کے طور پر سائن ان ہیں، یا چار غیر API roles میں سے کسی کے طور پر۔ خود کو API Account Manager کے طور پر دعوت دیں اور اس user کے طور پر سائن ان کریں (اوپر دیکھیں)۔ Apple Ads کنکشن کے کبھی نہ بننے کی یہ سب سے عام وجہ ہے۔

Apple credentials کو رد کر دیتا ہے

تینوں ids اس key سے مطابقت رکھنے چاہئیں جو Apple کے پاس ہے۔ clientId، teamId اور keyId کو Public Key فیلڈ کے ٹھیک اوپر سے دوبارہ کاپی کریں، کسی پرانی key سے نہیں جسے آپ نے بدل دیا ہو۔ اگر پھر بھی ناکام ہو تو Hermoso میں کنکشن دوبارہ شروع کریں: یہ نیا key pair بناتا ہے، اور آپ نیا public half Apple میں پیسٹ کرتے ہیں۔

سیٹ اپ سیشن ختم ہو گیا

Hermoso بنایا گیا private key 24 گھنٹے تک رکھتا ہے، جب آپ جا کر اس کا public half Apple میں پیسٹ کرتے ہیں۔ اس کے بعد وہ جان بوجھ کر حذف ہو جاتا ہے۔ کنکشن دوبارہ شروع کریں اور نئی public key پیسٹ کریں۔

میں نے openssl سے پہلے ہی key بنا لی تھی

تو اسے استعمال کریں۔ کنیکٹ کرتے وقت Hermoso کی key کے بجائے اپنی موجودہ EC P-256 private key پیسٹ کریں، اور آپ کے Apple اکاؤنٹ میں پہلے سے موجود public key کام کرتی رہے گی۔ یہ EC P-256 (prime256v1) key ہونی چاہیے۔ Apple کوئی اور curve قبول نہیں کرتا۔

میں کئی Apple Ads organizations سنبھالتا ہوں

ہر ایک کو اس کے اپنے Hermoso profile میں کنیکٹ کریں۔ ایک کنکشن ایک ہی organization سے جڑا ہوتا ہے، اور یہی بات ایجنسی کی campaign کو کسی غلط کلائنٹ کے اکاؤنٹ میں جانے سے روکتی ہے۔

Apple Search Ads کنیکٹر کیا کچھ کر سکتا ہے

بنانا: create_apple_ads_campaign، create_apple_ads_ad_group، add_apple_ads_keywords، add_apple_ads_negative_keywords، update_apple_ads_object، set_apple_ads_status، delete_apple_ads_object۔

پڑھنا: list_apple_ads_campaigns (status، serving status، روزانہ اور کل بجٹ، وہ ملک جہاں campaign چلتی ہے، اور جب campaign نہ چل سکے تو Apple کی اپنی بتائی ہوئی وجہ)، list_apple_ads_ad_groups (default bid، اور یہ کہ Apple کا Search Match چالو ہے یا نہیں)، list_apple_ads_keywords (targeting اور negative، match type اور bid کے ساتھ)، apple_ads_report (impressions، taps، installs، spend، TTR، CPT اور CPA، campaign، ad group، keyword، search-term یا ad سطح پر) اور list_apple_ads_orgs۔

یہ سب Claude، Claude Code، Codex، Cursor، Cline، OpenClaw، Hermes یا کسی بھی دوسرے MCP کلائنٹ سے، اور web studio سے کال ہو سکتا ہے۔ دونوں طرح یہ ایک ہی engine ہے۔ دیکھیں MCP جائزہ یا ads tool reference۔

اور بھی: یہ creatives اور ads بناتا ہے (create_apple_ads_creative، create_apple_ads_ad)، ایک ہی کال میں 1,000 تک keywords لوڈ کرتا ہے (bulk_apple_ads_keywords)، اور Apple کا اپنا ڈیٹا پڑھتا ہے: apple_ads_keyword_suggestions، apple_ads_impression_share، apple_ads_search_term_popularity اور apple_ads_change_history۔ ان میں سے ہر ایک اسی چیٹ سے کال ہو سکتا ہے۔

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

وہی کنکشن رپورٹنگ بھی کرتا ہے۔ apple_ads_report campaign، ad group، ad، keyword اور search-term کی کارکردگی نکالتا ہے (impressions، taps، installs، spend، tap-through rate، cost per tap اور cost per acquisition)، کل جوڑ کی صورت میں، یا ہر گھنٹے، دن، ہفتے یا مہینے کی سیریز کی صورت میں، ہر صفحے پر 5,000 قطاروں تک۔ رپورٹ پڑھنے سے کبھی spend کو ہاتھ نہیں لگتا۔ قطاریں آگے کہاں جائیں، یہ آپ پر ہے، اور تین سب سے عام جگہیں نیچے ہیں۔ مکمل گائیڈ Apple Search Ads سے ڈیٹا ایکسپورٹ کریں پر ہے۔

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

Google Drive کو Apple Ads کے ساتھ کنیکٹ کریں (ایک Google اجازت Drive، Sheets اور Docs تینوں کو کور کرتی ہے) اور اپنے ایجنٹ سے رپورٹ کو sheet میں ڈالنے کو کہیں۔ یہ apple_ads_report کال کرتا ہے، پھر نئی spreadsheet کے لیے create_sheet یا اس ہفتے کی قطاریں کسی موجودہ sheet میں شامل کرنے کے لیے append_to_sheet۔ Hermoso Google سے drive.file scope مانگتا ہے، تو یہ صرف ان فائلوں تک پہنچتا ہے جو اس نے بنائیں یا جو آپ نے منتخب کیں۔ مرحلہ وار طریقہ: Apple Search Ads کو Google Sheets سے جوڑیں۔

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

Hermoso کا Looker Studio کا اپنا کوئی connector نہیں ہے۔ Looker Studio خود Google Sheets کو اپنے built-in connector سے پڑھتا ہے، تو اوپر کی sheet ہی پل ہے: ایک بار Google Sheets data source کے طور پر شامل کریں، ڈیش بورڈ بنائیں، اور ہر ہفتے کی شامل ہونے والی قطاریں اگلے refresh پر نظر آ جائیں گی۔ Power BI اور Tableau بھی اسی طرح یہی sheet پڑھتے ہیں۔ Looker Studio کے مراحل۔

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

خام قطاروں کے لیے، API key کے ساتھ Hermoso REST API پر tool کال کریں: POST https://app.hermoso.ai/v1/tools/apple_ads_report جس کی JSON body میں رپورٹ کے arguments ہوں، اور جواب کے data.rows سے قطاریں پڑھیں۔ ٹرمینل سے، npx -y hermoso call apple_ads_report --json '{...}' --structured وہی نتیجہ JSON کے طور پر چھاپتا ہے۔ ایک مکمل مثال کی درخواست۔

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

Apple Search Ads کو Claude سے کیسے جوڑوں؟

Hermoso کو https://app.hermoso.ai/mcp URL کے ساتھ Claude میں ایک custom connector کے طور پر شامل کریں، اپنے Hermoso اکاؤنٹ سے منظور کریں، پھر Settings › Connectors کے تحت Hermoso میں Apple Ads کنیکٹ کریں۔ اس کے بعد Claude Hermoso کے Apple Ads tools کے ذریعے آپ کی Apple Search Ads campaigns کی رپورٹ لے سکتا ہے، ان میں تبدیلی کر سکتا ہے اور نئی بنا سکتا ہے۔

کیا ChatGPT میری Apple Search Ads کا ڈیٹا پڑھ سکتا ہے؟

ہاں۔ ChatGPT میں Plugins › Add › Create MCP App کے تحت https://app.hermoso.ai/mcp شامل کریں، اور Hermoso میں Apple Ads کنیکٹ کریں۔ اس کے بعد ChatGPT campaign، ad group، ad، keyword یا search term کے حساب سے impressions، taps، installs، spend، TTR، CPT اور CPA نکال سکتا ہے، اور قطاریں ایک Google Sheet میں لکھ سکتا ہے۔

کیا Apple Search Ads کا MCP سرور ہے؟

ہاں۔ Hermoso کا hosted MCP سرور https://app.hermoso.ai/mcp پر Apple Ads کا پورا toolset Claude، ChatGPT، Cursor، Codex یا کسی بھی MCP کلائنٹ کے لیے کھولتا ہے: رپورٹنگ، campaigns، ad groups، keywords اور negatives، creatives اور ads، اور Apple کی keyword تجاویز۔ جو کچھ بھی یہ بناتا ہے وہ paused بنتا ہے۔

Apple Ads API صفحے پر Public Key فیلڈ کیوں نہیں ہے؟

کیونکہ آپ Account Admin کے طور پر سائن ان ہیں۔ Apple وہ فیلڈ صرف اس user کو دکھاتا ہے جس کے پاس API role ہو۔ admin کو اس کے بجائے third-party service providers کی ایک “Manage API Access” ٹیبل نظر آتی ہے، جس میں کہیں key فیلڈ نہیں ہوتی۔ Account Settings › User Management کے تحت خود کو API Account Manager کے طور پر دعوت دیں، اس user کے طور پر سائن ان کریں، اور فیلڈ نظر آ جائے گی۔

مجھے کون سا Apple Ads role چاہیے؟

اگر آپ چاہتے ہیں کہ Hermoso campaigns، ad groups اور keywords بنائے تو API Account Manager۔ Apple اسے “all campaign groups کے لیے API management کی read اور write رسائی” کہتا ہے۔ اگر صرف رپورٹنگ چاہیے تو API Account Read Only کافی ہے۔ Apple کے باقی چار roles (Account Admin، Account Finance، Account Read Only اور Limited Access) کسی بھی طرح API credentials نہیں بنا سکتے۔

کیا مجھے openssl چلانا ہوگا؟

نہیں۔ Apple کی اپنی ہدایات دو openssl کمانڈز دیتی ہیں؛ Hermoso آپ کے لیے EC P-256 key pair بناتا ہے اور آپ کو صرف public half دکھاتا ہے۔ private half وہ ہے جو آپ کی درخواستوں پر دستخط کرتا ہے، اور آپ اسے کبھی دیکھتے، پیسٹ کرتے یا محفوظ کرتے نہیں۔ اگر آپ کے پاس کسی اور ٹول سے بنی key پہلے سے ہے تو آپ وہ لا سکتے ہیں۔

کیا Apple Ads کنیکٹ کرنے پر کوئی لاگت آتی ہے یا spend کا خطرہ ہے؟

نہیں۔ پڑھنے والی کالیں مفت ہیں، اور Hermoso کا بنایا ہوا ہر object بغیر کسی override کے PAUSED بنتا ہے۔ object کو فعال کرنا ہی وہ واحد سوئچ ہے جو حقیقی spend شروع کرتا ہے، اور اس کے لیے واضح تصدیق درکار ہے۔

clientId، teamId اور keyId کیا ہیں؟

یہ وہ تین شناخت کنندگان ہیں جو آپ کے key محفوظ کرنے کے بعد Apple، Public Key فیلڈ کے اوپر دکھاتا ہے۔ یہ Apple کے سامنے آپ کے API user کی شناخت کرتے ہیں؛ private key ثابت کرتی ہے کہ یہ آپ ہی ہیں۔ تینوں Hermoso میں واپس پیسٹ کریں اور کنکشن مکمل ہو جاتا ہے۔

کیا ایک کنکشن کئی Apple Ads organizations کو کور کر سکتا ہے؟

ایک کنکشن اس ایک organization سے جڑا ہوتا ہے جو آپ اسے بناتے وقت چنتے ہیں۔ Apple orgId کو ایک campaign group کی طرح دیکھتا ہے، تو ایک login کئی کو کور کر سکتا ہے۔ ہر کلائنٹ کے لیے الگ organization رکھنے والی ایجنسی ہر ایک کو اپنے Hermoso profile میں کنیکٹ کرتی ہے۔

کیا مجھے ہر 180 دن بعد key rotate کرنی ہوگی؟

نہیں۔ Apple client secret کو 180 دن تک محدود کرتا ہے، اسی لیے اس کی اپنی ہدایات آپ کو rotation کا شیڈول رکھنے کو کہتی ہیں۔ Hermoso private key خود رکھتا ہے اور ہر token تبادلے کے لیے ایک نیا مختصر مدت کا secret بناتا ہے، تو کوئی ایسی چیز نہیں جو config فائل میں پڑی ہو اور ایکسپائر ہو جائے۔

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

ہاں۔ Apple Ads کے ساتھ Google Drive کنیکٹ کریں، اور آپ کا ایجنٹ create_sheet یا append_to_sheet سے رپورٹ ایک Google Sheet میں لکھ دیتا ہے۔ Hermoso کا Looker Studio کا اپنا connector نہیں ہے؛ Looker Studio وہ sheet اپنے Google Sheets connector سے پڑھتا ہے۔

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

ہاں۔ API key کے ساتھ Hermoso API پر POST /v1/tools/apple_ads_report کال کریں اور جواب سے data.rows پڑھیں، یا CLI سے --structured کے ساتھ hermoso call apple_ads_report چلائیں۔