Apple Ads و Google Drive را به Hermoso وصل کنید تا هر دو از همان عامل قابل فراخوانی شوند. apple_ads_report ردیف‌های عملکرد را میکشد؛ create_sheet و append_to_sheet آن‌ها را در یک صفحه‌گسترده‌ای می‌گذارند که مال شماست. بدون فایل صادرشده، بدون انبار داده، و بدون ابزار سومی که اعتبارنامه‌های شما را نگه دارد.
این چه شکلی دارد
«عملکرد هزینهٔ Apple Search Ads هفتهٔ گذشته را بر اساس کلمه کلیدی بکش و به صفحهٔ Apple Ads من اضافه کن.» عامل گزارش را صدا میزند، ردیف‌ها را شکل میدهد و آن‌ها را اضافه میکند. دوشنبهٔ بعد دوباره بپرسید و صفحه یک هفته بزرگ‌تر میشود.
دامنهٔ دسترسی Drive که Hermoso درخواست میکند 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، جایی که درخواست خود را تایپ می‌کنید.
- اولین گزارش را بخواهید. «عملکرد Apple Search Ads را بر اساس کمپین برای ۳۰ روز گذشته بکش و در یک صفحهٔ جدید به نام Apple Ads بگذار.» عامل
apple_ads_reportرا صدا میزند، سپسcreate_sheet، و لینک را به شما میدهد. - آن را تکراری کنید. همان جمله با «افزودن» به‌جای «صفحهٔ جدید»، که از کلاینتی که استفاده می‌کنید روی زمانبندی اجرا شود (یک وظیفهٔ زمانبندیشده در Claude یا ChatGPT، یا یک cron job که Hermoso CLI را صدا میزند)، هر بار یک بلوک ردیف اضافه میکند. چیزی بازنویسی نمی‌شود مگر اینکه شما بخواهید.
- داشبوردتان را به صفحه وصل کنید. Looker Studio، Power BI و Tableau همگی Google Sheets را با connectorهای خودشان میخوانند.
صفحه چه شکلی است
یک ردیف برای هر موجودیت در هر دوره. ستون‌ها از سطحی که درخواست کردهاید پیروی میکنند (کمپین، گروه آگهی، آگهی، کلمه کلیدی یا عبارت جستجو) به‌علاوهٔ معیارهایی که Apple گزارش میدهد: نمایش، تپ، نصب، هزینه، نرخ تپ، هزینهٔ هر تپ و هزینهٔ هر نصب. اگر دانه‌بندی روزانه بخواهید، هر موجودیت هر روز یک ردیف می‌گیرد؛ اگر جمع کل بخواهید، یک ردیف. عامل میتواند یک ردیف جمع کل هم اضافه کند، و در گزارش‌های App Store میتواند موجودیت‌هایی را که هیچ نمایشی نداشته‌اند نگه دارد تا یک کلمه کلیدی متوقف به‌جای ناپدید شدن، صفر نشان داده شود.
چون عامل ردیف‌ها را قبل از نوشتن شکل میدهد، می‌توانید دقیقاً همان صفحه‌ای را که می‌خواهید بخواهید: فقط کلمات کلیدی بالاتر از یک آستانهٔ هزینه، نام کمپین کنار شناسه‌اش، یا تغییرات هفته‌به‌هفته که قبل از نوشتن محاسبه شده‌اند. این کاری است که یک خروجی CSV آن را به خود شما واگذار میکند.
افزودن، جایگزینی یا قالب‌بندی
ابزارهای Sheets کل ویرایش را پوشش می‌دهند: append_to_sheet ردیف اضافه میکند، update_sheet یک محدوده را در جای خودش می‌نویسد، clear_sheet_range قبل از آن یک محدوده را خالی میکند وقتی بخواهید به‌جای انباشته‌شدن، جایگزین شود، format_sheet سرتیترها، عرض ستون‌ها و قالب اعداد را مدیریت میکند، و manage_sheet_tabs به هر کمپین یا هر ماه تب خودش را میدهد. درخواست «صفحهٔ داشبورد را تازه کن» یک پاککردن و سپس یک نوشتن است، روی تبی که نام میبرید.
صادرکردن Apple Search Ads به Looker Studio از روی صفحه
Hermoso connector بومی Looker Studio ندارد؛ صفحه پل ارتباطی است. در Looker Studio یک منبع داده بسازید، Google Sheets را انتخاب کنید و صفحه‌گسترده و تبی را که عامل به آن اضافه میکند انتخاب کنید. داشبورد را یک‌بار بسازید و رها کنید. هر افزوده در بازخوانی بعدی داده‌های داشبورد نمایش داده میشود، به شرطی که سرتیترهای ستون‌ها بین اجراها یکسان بماند. همین الگو برای Power BI و Tableau هم کار میکند.
JSON می‌خواهید به‌جای صفحه؟
همین گزارش به‌صورت JSON خام از Hermoso API (POST /v1/tools/apple_ads_report) یا CLI هم در دسترس است. صادرکردن Apple Search Ads به JSON را ببینید، و صادرکردن داده از Apple Search Ads را برای هر مقصد دیگری.
پرسش‌های متداول
چگونه Apple Search Ads را به Google Sheets وصل کنم؟
Apple Ads و Google Drive را در Hermoso وصل کنید، سپس از عامل بخواهید گزارش را در یک صفحه بگذارد. عامل ردیف‌ها را با apple_ads_report میکشد و با create_sheet یا append_to_sheet می‌نویسد، و لینک را به شما میدهد.
آیا Hermoso به کل Google Drive من دسترسی دارد؟
خیر. Hermoso درخواست drive.file میکند، که فایلهایی را که Hermoso ساخته و فایلهایی را که صریحاً انتخاب کردهاید پوشش میدهد.
کدام سطوح و معیارها میتوانند به صفحه بروند؟
سطح کمپین، گروه آگهی، آگهی، کلمه کلیدی یا عبارت جستجو، با نمایش، تپ، نصب، هزینه، نرخ تپ، هزینهٔ هر تپ و هزینهٔ هر نصب، به‌صورت جمع کل یا سری ساعتی، روزانه، هفتگی یا ماهانه.
آیا گزارش زمانبندیشده صفحهٔ من را بازنویسی میکند؟
مگر اینکه بخواهید، خیر. افزودنها ردیف اضافه میکنند؛ جایگزینی یعنی یک پاککردن و سپس یک نوشتن روی تبی که نام میبرید، و عامل این کار را فقط وقتی انجام میدهد که درخواست بگوید.
آیا Looker Studio یا Power BI میتوانند نتیجه را بخوانند؟
بله. Hermoso connector بومی برای هیچکدام ندارد، اما هر دو Google Sheets را با connectorهای خودشان میخوانند، پس داشبوردی که روی صفحه ساخته شده با افزودهشدن عامل به صفحه تازه میشود.
آیا گزارش میتواند روی زمانبندی اجرا شود؟
بله، از کلاینتی که عامل شما در آن اجرا میشود: یک وظیفهٔ زمانبندیشده در Claude یا ChatGPT، یا یک cron job که Hermoso CLI یا API را صدا میزند. هر اجرا دوره جدید را میکشد و اضافه میکند.
کاملاً رایگان شروع کنید، بدون نیاز به کارت، با همهٔ امکانات در همهٔ پلن‌ها.
شروع رایگان → مشاهدهٔ قیمت‌ها