Apple Ads اور Google Drive کو Hermoso سے جوڑیں تو دونوں ایک ہی ایجنٹ سے قابل کال ہو جاتے ہیں۔ apple_ads_report کارکردگی کی قطاریں نکالتا ہے؛ create_sheet اور append_to_sheet انہیں ایک ایسی spreadsheet میں ڈالتے ہیں جو آپ کی اپنی ہے۔ نہ کوئی export فائل، نہ کوئی warehouse، نہ کوئی تیسرا ٹول جو آپ کے credentials رکھے۔
یہ کیسا لگتا ہے
"پچھلے ہفتے کا Apple Search Ads spend keyword کے حساب سے نکالو اور میری Apple Ads sheet میں append کرو۔" ایجنٹ رپورٹ کال کرتا ہے، قطاریں ترتیب دیتا ہے اور شامل کر دیتا ہے۔ اگلے پیر پھر پوچھیں تو sheet ایک ہفتہ اور بڑھ جاتی ہے۔
Hermoso جو Drive scope مانگتا ہے وہ drive.file ہے، جو ان فائلوں تک پہنچتا ہے جو اس نے بنائیں یا جو آپ نے چنیں، آپ کا پورا Drive نہیں۔
Apple Search Ads کو Google Sheets سے کیسے جوڑیں
- دونوں اکاؤنٹ کنیکٹ کریں۔ ایپ میں Connectors کھولیں، پہلے Apple Ads کنیکٹ کریں، پھر Google Drive۔ Sheets اور Docs اسی Google اجازت پر چلتے ہیں، تو یہ ایک consent screen ہے، تین نہیں۔ Apple Ads ایک key کا تبادلہ ہے، بٹن نہیں؛ Apple Search Ads سیٹ اپ گائیڈ اسے کور کرتی ہے، بشمول یہ کہ Apple Search Ads کو Claude سے یا ChatGPT سے کیسے جوڑیں، جہاں آپ درخواست لکھیں گے۔
- پہلی رپورٹ مانگیں۔ "پچھلے 30 دن کی Apple Search Ads کارکردگی campaign کے حساب سے نکالو اور ایک نئی sheet میں ڈالو جس کا نام Apple Ads ہو۔" ایجنٹ
apple_ads_reportکال کرتا ہے، پھرcreate_sheet، اور لنک واپس دیتا ہے۔ - اسے باقاعدہ بنائیں۔ وہی جملہ "new sheet" کی جگہ "append" کے ساتھ، اور اسے اس کلائنٹ کے شیڈول سے چلائیں جو آپ استعمال کرتے ہیں (Claude یا ChatGPT میں scheduled task، یا Hermoso CLI کو کال کرنے والا cron job)، تو ہر بار قطاریں شامل ہوں گی۔ جب تک آپ نہ کہیں، کچھ overwrite نہیں ہوتا۔
- اپنا ڈیش بورڈ sheet کی طرف موڑیں۔ Looker Studio، Power BI اور Tableau، تینوں اپنے اپنے connectors سے Google Sheets پڑھتے ہیں۔
sheet کیسی دکھتی ہے
ہر entity کی ایک مدت کے لیے ایک قطار۔ کالم اس سطح کی پیروی کرتے ہیں جو آپ نے مانگی (campaign، ad group، ad، keyword یا search term) اور وہ میٹرکس جو Apple رپورٹ کرتا ہے: impressions، taps، installs، spend، tap-through rate، cost per tap اور cost per acquisition۔ روزانہ کی سطح مانگیں تو ہر entity کی ایک قطار روزانہ ملتی ہے؛ کل جوڑ مانگیں تو ایک۔ ایجنٹ grand-totals قطار بھی شامل کر سکتا ہے، اور App Store رپورٹس پر وہ بغیر delivery والی entities بھی رکھ سکتا ہے، تاکہ ایک paused keyword غائب ہونے کے بجائے صفر دکھے۔
چونکہ ایجنٹ لکھنے سے پہلے قطاریں ترتیب دیتا ہے، آپ بالکل وہی sheet مانگ سکتے ہیں جو چاہیں: صرف وہ keywords جو ایک spend حد سے اوپر ہوں، campaign کا نام اس کے id کے ساتھ، یا لکھنے سے پہلے ہی ہفتہ وار تبدیلیوں کا حساب۔ یہ وہ کام ہے جو CSV export آپ پر چھوڑ دیتا ہے۔
شامل کریں، بدلیں، یا فارمیٹ کریں
Sheets کے tools پوری ترمیم کو کور کرتے ہیں: append_to_sheet قطاریں شامل کرتا ہے، update_sheet ایک range کو اسی جگہ لکھتا ہے، clear_sheet_range پہلے اسے خالی کرتا ہے جب آپ ڈھیر کے بجائے replace چاہتے ہیں، format_sheet headers، چوڑائی اور number formats سنبھالتا ہے، اور manage_sheet_tabs ہر campaign یا ہر مہینے کو اس کا اپنا tab دیتا ہے۔ "ڈیش بورڈ sheet کو تازہ کرو" کی درخواست ایک clear اور پھر ایک write ہے، اس tab پر جس کا آپ نام لیں۔
sheet سے Apple Search Ads کو Looker Studio میں ایکسپورٹ کریں
Hermoso کا Looker Studio کا اپنا connector نہیں ہے؛ sheet ہی پل ہے۔ Looker Studio میں data source بنائیں، Google Sheets چنیں، اور وہ spreadsheet اور tab منتخب کریں جس میں ایجنٹ append کرتا ہے۔ رپورٹ ایک بار بنائیں اور چھوڑ دیں۔ ہر append ڈیش بورڈ کے اگلے data refresh پر نظر آ جائے گا، بشرطیکہ ہر run کے درمیان کالم کے headers ایک جیسے رہیں۔ یہی طریقہ Power BI اور Tableau کے لیے بھی کام کرتا ہے۔
sheet کے بجائے JSON چاہتے ہیں؟
وہی رپورٹ Hermoso API (POST /v1/tools/apple_ads_report) یا CLI سے خام JSON کے طور پر دستیاب ہے۔ دیکھیں Apple Search Ads کو JSON میں ایکسپورٹ کریں، اور باقی ہر منزل کے لیے Apple Search Ads سے ڈیٹا ایکسپورٹ کریں۔
اکثر پوچھے گئے سوالات
Apple Search Ads کو Google Sheets سے کیسے جوڑوں؟
Hermoso میں Apple Ads اور Google Drive کنیکٹ کریں، پھر ایجنٹ سے رپورٹ کو sheet میں ڈالنے کو کہیں۔ یہ apple_ads_report سے قطاریں نکالتا ہے، create_sheet یا append_to_sheet سے لکھتا ہے، اور لنک واپس دیتا ہے۔
کیا Hermoso کو میرے پورے Google Drive تک رسائی چاہیے؟
نہیں۔ یہ drive.file مانگتا ہے، جو Hermoso کی بنائی ہوئی فائلوں اور آپ کی واضح طور پر چنی ہوئی فائلوں کو کور کرتا ہے۔
کون سی سطحیں اور میٹرکس sheet میں جا سکتے ہیں؟
Campaign، ad group، ad، keyword یا search-term کی سطح، impressions، taps، installs، spend، tap-through rate، cost per tap اور cost per acquisition کے ساتھ، کل جوڑ کی صورت میں یا ہر گھنٹے، روزانہ، ہفتہ وار یا ماہانہ سیریز کی صورت میں۔
کیا شیڈول شدہ رپورٹ میری sheet کو overwrite کرے گی؟
جب تک آپ نہ کہیں، نہیں۔ Appends قطاریں شامل کرتے ہیں؛ replace ایک clear اور پھر آپ کے نام لیے ہوئے tab پر write ہے، اور ایجنٹ یہ صرف تب کرتا ہے جب درخواست میں یہ لکھا ہو۔
کیا Looker Studio یا Power BI نتیجہ پڑھ سکتے ہیں؟
ہاں۔ Hermoso کا دونوں کے لیے کوئی native connector نہیں، لیکن دونوں اپنے Google Sheets connectors سے پڑھتے ہیں، تو اس sheet پر بنا ڈیش بورڈ ایجنٹ کے append کے ساتھ تازہ ہوتا رہتا ہے۔
کیا رپورٹ کسی شیڈول پر چل سکتی ہے؟
ہاں، اس کلائنٹ سے جس میں آپ کا ایجنٹ چلتا ہے: Claude یا ChatGPT میں scheduled task، یا Hermoso CLI یا API کو کال کرنے والا cron job۔ ہر run نیا دورانیہ لیتا ہے اور شامل کرتا ہے۔