דילוג לתוכן
Remote Sunrise

המדריכים של Remote Sunrise

חיבור SearchAds Manager ל-Codex

הפעילו את שרת ה־MCP המקומי ב־SearchAds Manager, חברו אותו ל־Codex וודאו שהוא פועל באמצעות בדיקת תקינות בסיסית ב־Apple Search Ads עם נתונים זמניים.

חזרה סקירת MCP

השתמשו בעמוד זה כשתרצו ש־Codex יעבוד מול Apple Search Ads באמצעות היישום המקומי SearchAds Manager, במקום באמצעות סקריפט API מותאם אישית.

1. הגדרת היישום ל־macOS

  1. Codex

    שולח בקשה לשרת ה-MCP המקומי.

  2. SearchAds Manager

    מפעיל את השרת ב-Mac שלכם ומטפל בבקשה.

  3. Apple Ads

    מחזיר נתוני חשבון או מבצע פעולה מורשית בקמפיין.

השאירו את SearchAds Manager פועל ב-Mac שלכם. הוא מתחבר ל-Apple Ads באמצעות הגישה ל-API שהגדרתם ביישום.
  1. הפעילו את SearchAds Manager ב־macOS.
  2. פתחו את הגדרות.
  3. הגדירו את פרטי הגישה הרגילים של Apple Search Ads אם הם עדיין לא הוגדרו.
  4. פתחו את אוטומציה, ואז מצאו את הסעיף שרת ה-MCP של Codex.
  5. הפעילו את השרת.
  6. בדקו או שנו את היציאה ואת האסימון לפי הצורך.
  7. לחצו על החלת הגדרות השרת.
הגדרות SearchAds Manager כשהסעיף אוטומציה נבחר והאפשרות הפעלת שרת MCP מקומי מסומנת
ב-Mac, עברו אל הגדרות → אוטומציה והפעילו את שרת ה-MCP המקומי. החילו את הגדרות השרת, ואז העתיקו את פקודת Codex מהיישום.

אם פרטי הגישה עדיין לא הוגדרו, פעלו לפי מדריך ה־OAuth של Apple: יישום OAuth עבור ה־API של Apple Search Ads.

2. הוספת השרת ל־Codex

הפקודה המדויקת להרצה מוצגת בכרטיס ההגדרות. מבנה הפקודה הוא:

codex mcp add searchads --url "http://127.0.0.1:7717/mcp?token=YOUR_TOKEN"

לאחר הוספת השרת:

  1. השאירו את היישום ב־macOS פועל.
  2. התחילו הפעלה חדשה של Codex במאגר שבו תרצו לעבוד, או התחברו מחדש לשרתי MCP אם יישום הלקוח שלכם תומך בכך.
  3. השתמשו בשרת searchads להפקת דוחות ולפעולות כתיבה, במקום כתיבה ידנית של סקריפטים ל־API.
  1. קראו תחילה ל־list_apps כשאתם זקוקים ל־adam_id.
  2. קראו ל־list_supported_countries לפני יצירת קמפיין כשאתם זקוקים לקודי מדינה תקפים.
  3. השתמשו ב־get_campaign_report, ב־get_adgroup_report וב־get_keyword_report כדי לבדוק ביצועים לפני ביצוע שינויים.
  4. השתמשו ב־list_campaigns, ב־list_adgroups וב־list_keywords כדי לבדוק את המצב הנוכחי לפני ביצוע שינויים.
  5. השתמשו ב־create_campaigns, ב־add_adgroups וב־add_keywords לתהליכי יצירה.
  6. השתמשו ב־update_campaigns, ב־update_adgroups וב־update_keywords לעריכות מבוקרות.
  7. השתמשו ב־delete_campaigns, ב־delete_adgroups וב־delete_keywords רק לצורך ניקוי מפורש הכרוך במחיקה.
  8. העדיפו קבוצות קטנות ומוגדרות במפורש של פעולות כתיבה, כדי שיהיה קל יותר לבחון כשלים.

4. פתרון בעיות

  1. אם Codex אינו מצליח להתחבר, ודאו שהיישום ב־macOS פתוח ושסטטוס השרת מציג פועל.
  2. אם קריאות לכלים נכשלות עם שגיאות תצורה, בדקו שוב את פרטי הגישה של Apple Search Ads בהגדרות היישום.
  3. אם תיצרו מחדש את האסימון או תשנו את היציאה, הריצו שוב את codex mcp add ... עם כתובת ה־URL החדשה.

5. הנחיות לבדיקת תקינות בסיסית עם נתונים זמניים

הצגת ההנחיות האופציונליות לבדיקת תקינות בסיסית

הריצו את ההנחיות הבאות באותה הפעלה של Codex, כדי שיוכל לזכור את מזהי הבדיקה שהוא יוצר.

השתמשו בקידומת שמות זמנית כגון mcp-smoke-... ומחקו הכול בסיום. לישויות בדיקה חדשות יש בדרך כלל מדדים שערכם אפס בדוחות; גם כך ניתן לוודא שמסלול הפקת הדוחות דרך MCP פועל.

הנחיה לגילוי

באמצעות שרת ה-MCP `searchads` בלבד, הכן סביבת בדיקת תקינות בסיסית ל-MCP.

1. מצא אפליקציה בבעלותי שאוכל להשתמש בה בבטחה לקמפיין בדיקה זמני. העדף אפליקציה שתואמת ל-"Monitor and Manage Search Ads"; אחרת, הצג את 5 האפליקציות הראשונות שבבעלותי ובחר אחת מהן.
2. קרא ל-`list_supported_countries` ובחר ב-`US` אם המדינה נתמכת. אחרת, בחר מדינה נתמכת וציין את קוד המדינה שבחרת.
3. קרא ל-`list_campaigns` עבור קמפיינים ששמותיהם מתחילים ב-`mcp-smoke-`.
4. ציין את ה-`adam_id` שנבחר, את קוד המדינה ואת קידומת הבדיקה הייחודית בפורמט `mcp-smoke-YYYYMMDD-HHMMSS`.
5. אל תיצור דבר עדיין.

הנחיה ליצירת קמפיין

באמצעות שרת ה-MCP `searchads` בלבד, צור קמפיין בדיקה זמני מושהה בשם `<PREFIX>-campaign` עבור האפליקציה והמדינה שנבחרו קודם.

השתמש בנתונים הבאים:
- ה-`adam_id` שנבחר
- קוד מדינה אחד
- `daily_budget_amount` בערך 5
- `currency` בערך `USD`

לאחר היצירה, קרא ל-`list_campaigns` עם קידומת הבדיקה והחזר את ה-`campaign_id` החדש.

הנחיה לדוח ולעדכון של קמפיין

באמצעות שרת ה-MCP `searchads` בלבד:

1. קרא ל-`get_campaign_report` עבור `<CAMPAIGN_ID>` עם `days: 0`.
2. עדכן את הקמפיין באמצעות `update_campaigns` כך שהתקציב היומי יהיה 6 USD והסטטוס יהיה `ENABLED`.
3. קרא שוב ל-`list_campaigns` עם קידומת הבדיקה.
4. סכם את מצב הקמפיין לפני העדכון ואחריו.

הנחיה להוספת קבוצות מודעות

באמצעות שרת ה-MCP `searchads` בלבד, הוסף שתי קבוצות מודעות מושהות ל-`<CAMPAIGN_ID>`:

1. `<PREFIX>-ag-1`
2. `<PREFIX>-ag-2`

השתמש בנתונים הבאים:
- `default_bid_amount` בערך 1
- `currency` בערך `USD`
- `automated_keywords_opt_in` בערך false

לאחר היצירה, קרא ל-`list_adgroups` עבור הקמפיין והחזר את שני ערכי ה-`ad_group_id`.

הנחיה לדוח ולעדכון של קבוצת מודעות

באמצעות שרת ה-MCP `searchads` בלבד:

1. קרא ל-`get_adgroup_report` עבור `<CAMPAIGN_ID>` עם `days: 0`.
2. עדכן את `<PREFIX>-ag-1` באמצעות `update_adgroups` כך שהסטטוס יהיה `ENABLED`, הערך של `default_bid_amount` יהיה 1.2 USD והערך של `cpa_goal_amount` יהיה 4 USD.
3. קרא שוב ל-`list_adgroups` עבור `<CAMPAIGN_ID>`.
4. סכם את קבוצת המודעות המעודכנת והחזר את ה-`ad_group_id` שלה.

הנחיה להוספת מילות מפתח

באמצעות שרת ה-MCP `searchads` בלבד, הוסף מילות מפתח ל-`<AD_GROUP_ID>` בתוך `<CAMPAIGN_ID>` באמצעות `keyword_set` אחד.

השתמש בנתונים הבאים:
- `default_bid_amount` בערך 0.8
- `default_currency` בערך `USD`

הוסף את מילות המפתח הבאות:
1. `<PREFIX> exact` עם `match_type` בערך `EXACT` ו-`status` בערך `ACTIVE`
2. `<PREFIX> broad` עם `match_type` בערך `BROAD` ו-`status` בערך `ACTIVE`

לאחר היצירה, קרא ל-`list_keywords` עבור `<CAMPAIGN_ID>` ו-`<AD_GROUP_ID>` והחזר את ערכי ה-`keyword_id` שנוצרו.

הנחיה לדוח ולעדכון של מילות מפתח

באמצעות שרת ה-MCP `searchads` בלבד:

1. קרא ל-`get_keyword_report` עבור `<CAMPAIGN_ID>` ו-`ad_group_ids: [<AD_GROUP_ID>]` עם `days: 0`.
2. עדכן את מילת המפתח מסוג EXACT באמצעות `update_keywords` כך שהצעת המחיר שלה תהיה 0.9 USD והסטטוס שלה יהיה `PAUSED`.
3. קרא שוב ל-`list_keywords` עבור `<CAMPAIGN_ID>` ו-`<AD_GROUP_ID>`.
4. סכם את מילת המפתח המעודכנת והחזר את שתי השורות העדכניות של מילות המפתח.

הנחיה לניקוי

באמצעות שרת ה-MCP `searchads` בלבד, מחק את נתוני בדיקת התקינות הבסיסית של MCP.

1. מחק את כל מילות המפתח של הבדיקה ב-`<AD_GROUP_ID>` באמצעות `delete_keywords`.
2. קרא ל-`list_keywords` עבור `<CAMPAIGN_ID>` ו-`<AD_GROUP_ID>` כדי לוודא שמילות המפתח נמחקו.
3. מחק את שתי קבוצות המודעות של הבדיקה באמצעות `delete_adgroups`.
4. קרא ל-`list_adgroups` עבור `<CAMPAIGN_ID>` כדי לוודא שקבוצות המודעות נמחקו.
5. מחק את קמפיין הבדיקה באמצעות `delete_campaigns`.
6. קרא ל-`list_campaigns` עם קידומת הבדיקה כדי לוודא שהקמפיין נמחק.
7. סכם את תוצאות הניקוי.