ייצוא נתונים מ-Apple Search Ads

Hermoso מתחבר ל-Apple Search Ads ומציג אותו ככלים שהסוכן שלכם יכול לקרוא להם: Claude, ChatGPT, Cursor, Codex, Cline, ה-CLI או HTTP רגיל. apple_ads_report מושך ביצועים של קמפיין, קבוצת מודעות, מודעה, מילת מפתח ומונח חיפוש, והשורות חוזרות כנתונים ולא כקובץ CSV להורדה שאתם צריכים להעביר לאן שהוא.

מחבר Apple Search Ads

Apple לא מפרסמת זרימת OAuth ל-API של המודעות שלה, ולכן החיבור הוא החלפת מפתחות ולא כפתור: Hermoso מייצר את מפתח החתימה, אתם מדביקים את החצי הציבורי שלו ב-Apple Ads ומעתיקים חזרה שלושה מזהים. מדריך ההגדרה של Apple Search Ads עובר על כל השלבים, כולל שדה Public Key שרוב האנשים לא מוצאים. חיבור אחד משרת אחר כך את אפליקציית הווב, שרת ה-MCP, ה-CLI וה-REST API, כך שאותו ייצוא עובד מ-Claude, מ-ChatGPT או מ-Cursor: חברו את Apple Search Ads ל-Claude או ל-ChatGPT פעם אחת, ואז שאלו.

דיווח הוא רק חלק אחד. אותו חיבור גם בונה ומנהל את החשבון: קמפיינים, קבוצות מודעות, מילות מפתח ושליליות, הזמנות תקציב, מיקוד, הצעות מילות מפתח והיסטוריית שינויים. עמוד הערוץ של Apple Ads מפרט כל כלי.

מה הדוח כולל

קריאה אחת, חמש רמות. apple_ads_report מדווח ברמת קמפיין, קבוצת מודעות, מודעה, מילת מפתח או מונח חיפוש, וכל שורה נושאת את המדדים שלוח הבקרה של Apple עצמו מציג: הופעות, הקשות, התקנות, הוצאה, שיעור הקשה, עלות הקשה ועלות רכישה. בקשו סיכומים, או סדרה ברמת גרנולריות שעתית, יומית, שבועית או חודשית. השורות חוזרות ממוינות לפי הוצאה, מהגבוהה לנמוכה, עד 5,000 בעמוד, עם שורת סיכום כוללת לפי בקשה. בדוחות App Store יכולים להופיע גם ישויות ללא הצגה, כך שמילת מפתח מושהית מופיעה כאפס ולא כשורה חסרה.

שני כללים ש-Apple אוכפת, והכלי מסביר אותם במקום להיכשל בשקט: דוח מתחת לרמת הקמפיין דורש מזהה קמפיין (רק דוח ברמת קמפיין יכול לכסות את החשבון כולו), ודוחות מונחי חיפוש רצים לפי אזור הזמן של הארגון שלכם, ולא לפי UTC. גם מודעות במפות Apple מכוסות: דוח של מותגים עסקיים מגיע מאותו כלי עם פרמטר אחד שונה.

חיבור Apple Search Ads ל-Google Sheets

זה היעד היחיד שאליו Hermoso כותב בעצמו. חברו את Google Drive לצד Apple Ads (אישור Google אחד מכסה את Drive, Sheets ו-Docs), ואז שאלו: "הציגו את הביצועים של Apple Search Ads לפי מילת מפתח ב-30 הימים האחרונים, ושימו אותם בגיליון חדש בשם Apple Ads." הסוכן קורא ל-apple_ads_report, אחר כך ל-create_sheet, ומחזיר לכם את הקישור. בשבוע הבא, אותה בקשה עם "הוספה" תוסיף שורות עם append_to_sheet במקום להתחיל מחדש.

Hermoso מבקש מ-Google את היקף drive.file, שמגיע רק לקבצים שהוא יצר ולקבצים שאתם בוחרים, ולא לכל ה-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. בנו את הדוח פעם אחת. הוצאה לפי יום, עלות רכישה לפי מילת מפתח, התקנות לפי קמפיין: כל מה שהייתם בונים מחדש בגיליון כל יום שני.
4. המשיכו להוסיף. בכל שבוע הסוכן מוסיף שורות חדשות לאותה לשונית, והדשבורד מקבל אותן ברענון הנתונים הבא. שמרו על שמות העמודות זהים בין הרצות, כי Looker Studio ממפה שדות לפי כותרת.

אותו גיליון עובד גם עבור Power BI ו-Tableau, ולשניהם יש מחברי Google Sheets משלהם.

ייצוא Apple Search Ads ל-JSON

אם אתם רוצים את השורות הגולמיות במקום גיליון, יש שלוש דרכים לקבל אותן, כולן באמצעות אותו חיבור.

ה-REST API. כל כלי של Hermoso נקרא ב-POST /v1/tools/{name} עם מפתח API שאתם יוצרים באפליקציה בלשונית MCP & CLI. גוף הבקשה הוא הארגומנטים של הכלי, והשדה data בתשובה הוא התוצאה המובנית, עם השורות ב-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 מדפיס את אותה תוצאה מובנית כ-JSON, מוכנה להפניה לקובץ או לצינור לסקריפט אחר.

הסוכן שלכם. בכל צ'אט, בקשו את השורות כ-JSON ותקבלו אותן בתשובה, כבר מעוצבות כפי שביקשתם.

לדוחות ארוכים, limit מקבל עד 5,000 שורות בעמוד, ו-offset עובר לעמוד הבא; השדה hasMore בתוצאה אומר אם יש עמוד נוסף. קריאת דוח לא מוציאה קרדיטים. התיעוד המלא של ה-API נמצא במסמכי המפתחים.

יעדים אחרים

"ישיר" פירושו ש-Hermoso כותב בעצמו. כל השאר הוא צעד אחד שכלי שאתם כבר משתמשים בו עושה לבד.

• Google Sheets, Google Docs, Google Drive, OneDrive: ישיר.
• Looker Studio, Power BI, Tableau: דרך הגיליון, כל אחד עם מחבר Google Sheets משלו.
• BigQuery: דרך הגיליון, או דרך הסוכן שלכם. BigQuery יכול לשאול Google Sheet כטבלה חיצונית. אם הסוכן שלכם רץ במקום עם לקוח BigQuery ועם פרטי הפרויקט שלכם, הוא יכול להכניס את השורות ש-Hermoso מחזיר ישר לטבלה.
• Excel: דרך הגיליון או קובץ. הורידו את הגיליון כ-.xlsx, או בקשו מהסוכן להשאיר קובץ ב-Google Drive או ב-OneDrive.
• PostgreSQL, Redshift, Snowflake או כל מחסן נתונים: דרך הסוכן שלכם או דרך ה-API. Hermoso מחזיר JSON; מה שמחזיק את פרטי מסד הנתונים שלכם כותב אותו. Hermoso לא מחזיק פרטי מחסן נתונים.

אוטומציה של הייצוא השבועי

הפרומפט הוא האוטומציה. משהו כמו "בכל יום שני, משכו את הביצועים של Apple Search Ads של השבוע שעבר לפי מילת מפתח לכל קמפיין, הוסיפו אותם לגיליון Apple Ads, וספרו לי אילו מילות מפתח זזו הכי הרבה בעלות הרכישה (CPA)" הוא משימה שלמה. הריצו אותה לפי לוח זמנים עם הכלי שהלקוח שלכם כבר מציע (משימות מתוזמנות ב-Claude או ב-ChatGPT, או משימת cron שקוראת ל-CLI או ל-API של Hermoso), והגיליון, וכל דשבורד שקורא ממנו, נשארים עדכניים.

מאחר שאותו חיבור גם עורך את החשבון, הדוח והתיקון נמצאים במקום אחד: הסוכן שמזהה שעלות הרכישה של מילת מפתח הכפילה את עצמה יכול להשהות אותה או להוסיף שלילית באותה שיחה.

שאלות נפוצות

איך מייצאים נתונים מ-Apple Search Ads?

חברו את Apple Ads ל-Hermoso פעם אחת, ואז בקשו מהסוכן את הדוח שאתם רוצים, למשל ביצועי מילות מפתח של השבוע שעבר. הכלי apple_ads_report מושך אותו מה-API לדיווח של Apple, והסוכן כותב אותו ל-Google Sheet, מחזיר לכם JSON, או את שניהם.

אפשר לחבר את Apple Search Ads ל-Google Sheets?

כן. חברו את Apple Ads ואת Google Drive ב-Hermoso, ואז בקשו מהסוכן לשים את הדוח בגיליון. הוא יוצר את הגיליון עם create_sheet, או מוסיף שורות לגיליון קיים עם append_to_sheet, ויכול לחזור על זה כל שבוע.

אפשר לייצא את Apple Search Ads ל-Looker Studio?

כן, דרך Google Sheets. ל-Hermoso אין מחבר מקורי ל-Looker Studio. הסוכן כותב את הדוח לגיליון, אתם מוסיפים את הגיליון כמקור נתונים מסוג Google Sheets ב-Looker Studio פעם אחת, וכל הוספה מופיעה ברענון הבא של הדשבורד.

איך מייצאים נתוני Apple Search Ads ל-JSON?

קראו ל-POST /v1/tools/apple_ads_report ב-API של Hermoso עם מפתח API וקראו את data.rows מהתשובה, או הריצו hermoso call apple_ads_report --json '{...}' --structured מה-CLI. שתי הדרכים מחזירות את אותן שורות כ-JSON.

האם יש API לדיווח של Apple Search Ads?

כן, ו-Hermoso בנוי עליו. apple_ads_report מכסה ביצועים ברמת קמפיין, קבוצת מודעות, מודעה, מילת מפתח ומונח חיפוש, והכלים האחרים של Apple Ads בונים ומנהלים את החשבון.

אפשר לקבל דוחות של מונחי חיפוש ב-Apple Search Ads?

כן. בקשו את רמת מונח החיפוש וציינו את הקמפיין. Apple מגישה מונחי חיפוש רק לפי קמפיין, לפי אזור הזמן של הארגון.

כמה שורות דוח אחד יכול להחזיר?

עד 5,000 בעמוד, ממוינות לפי הוצאה מהגבוהה לנמוכה, עם סימון שאומר לסוכן אם יש עמודים נוספים. דוח מילות מפתח שבועי לרוב החשבונות נכנס בעמוד אחד.

האם זה מכסה מודעות במפות Apple?

כן. דוחות של קמפייני מותגים עסקיים מגיעים מאותו כלי, כשסוג האובייקט המקודם מוגדר למפות Apple במקום ל-App Store.

צריך מפתח כדי להגדיר את זה?

לא. חברו את Apple Ads פעם אחת באפליקציה, ואז בקשו מהסוכן בשפה רגילה: הביאו את השבוע שעבר לפי מילת מפתח ושימו בגיליון. ה-API וה-CLI זמינים אם תרצו לכתוב סקריפט.