← חומרי הסדנה

אחרי השיעור: מתחילים עם ערכת Meta אחת

המסלול הזה מתחיל אחרי השיעור הראשון. בשיעור לומדים את תהליך העבודה ואת דוגמת YS Digital; אין צורך להתקין Python, סקילים או חיבור Meta לפניו. תרגיל החובה הוא תכנון מקומי עם נתונים מדומים וללא חשבון מודעות.

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

1. תיקייה אחת ומארח אחד

חלצו את קובץ meta-product-kit.zip לתיקייה במחשב. בתוכה נמצאים הקובץ הזה, STUDENT-EXAMPLE.md ותיקיית product/. שמרו את כל התיקייה יחד. פתחו את התיקייה שחילצתם כפרויקט ב־Codex או ב־Claude Code (אחד מספיק). ב־Mac או ב־Windows מצאו את התיקייה בסייר הקבצים ובחרו אותה דרך פקודת פתיחת תיקייה/פרויקט של המארח. אפליקציית Claude לשיחה רגילה אינה מתקינה קבצים מקומיים; אם אין לכם Claude Code או Codex, קראו את הקבצים ותרגלו ידנית עם המרצה.

product/ דרושה כי היא מחזיקה את ששת הסקילים, סקריפט הבדיקה וההתקנה, ואת המסמכים שאליהם הסקילים מפנים. קישורי ששת הסקילים באתר מיועדים לקריאה או להורדה של סקיל יחיד; הם אינם מתקינים את החבילה המלאה.

2. בקשת פתיחה להעתקה למארח

אני מתחיל/ה את ערכת Meta אחרי השיעור. פתח את START-HERE.md, את product/README.md, את product/docs/install-v1.md ואת product/skills/orchestration/SKILL.md בתיקייה שבחרתי. ציין את הנתיבים שבאמת קראת. בדוק אם Python 3.11 ומעלה זמין ומהן שש תיקיות הסקילים, אך אל תשנה דבר עדיין. הסבר בעברית פשוטה צעד אחד בכל פעם: בדיקת שלמות הערכה, תצוגה מקדימה של התקנת ששת הסקילים למארח הנוכחי, ואז בקש אישור לפני הרצת --apply. אם Python חסר, הראה את ההוראות הרשמיות למערכת ההפעלה שלי ובקש אישור לפני התקנה. לאחר ההתקנה פתח משימה חדשה ובדוק שהמארח באמת מוצא את orchestration/SKILL.md. בדוק אילו כלי Meta/API/MCP מחוברים בפועל ואילו חסרים; אל תניח שחיבור קיים רק כי הסקילים הותקנו. אל תבקש ממני סיסמאות או מפתחות בצ׳אט ואל תשנה חשבונות, הרשאות, חיבורים או מידע חיצוני בלי אישור מתאים. עצור לפני כתיבה חיצונית או הוצאה כספית. אם חיבור Meta אינו מוכן, נמשיך בתרגיל מקומי: בריף לשירות ההטמעה של YS Digital, שתי זוויות מסר, קופי ובריף חזותי, ומפרט קמפיין PAUSED כמסמך בלבד.

המארח יכול ללוות את הבדיקה והפקודות רק אם הוא יכול לקרוא קבצים ולהריץ פקודות בסביבה שלכם, ובכפוף לאישורים שלכם. הוא אינו מעניק הרשאות לחשבון Meta. במידת הצורך עובדים לפי מדריך ההתקנה המלא ובוחרים רק את פקודות ה־Mac או Windows והמארח המתאים. ב־Windows משתמשים ב־PowerShell; WSL2 אינו דרוש למסלול הבסיסי.

3. מה כל רכיב עושה?

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

אם בוחרים חיבור API עצמאי: המארח מדריך, בעל החשבון יוצר ומאשר

קודם בודקים אם קיים במארח חיבור Meta מורשה שמתאים לפעולה הדרושה. חיבור כזה עשוי לנהל את אפליקציית Meta וההתחברות שלו בעצמו; אין דרישה שכל תלמיד ייצור אפליקציה. רק אם בוחרים מסלול Marketing API בניהול עצמי, מבקשים מ־Codex או Claude Code להציג את התיעוד הרשמי העדכני וללוות את בעל החשבון בשלבים: יצירת אפליקציה בחשבון Meta for Developers שבבעלותו, התאמתה לעסק ולחשבון המודעות הנכונים, בחירת יכולת Marketing API והרשאות מינימליות לפעולה המבוקשת, יצירת חיבור מאובטח, ואז בדיקת קריאה בלבד לחשבון הנבחר. כל שלב חשבון, הרשאה או אישור נעשה בידי בעל החשבון; המארח עוצר ומבקש אישור לפני שינוי.

גישה לעסק ולחשבון מודעות, מצב פיתוח/בדיקה של האפליקציה, וגישה לחשבונות של לקוחות אחרים הם תנאים שונים. ייתכן שיידרשו בדיקת אפליקציה או אימות עסק; אין להניח שהרשאה קיימת או שאישור מובטח. אין להדביק access token או app secret בצ׳אט, לשמור אותם בערכה או לשלוח אותם למרצה. המארח צריך לכוון לאחסון מאובטח ומוגבל גישה בהתאם לסביבה הזמינה. יצירת האפליקציה אינה תרגיל החובה ואינה מבוצעת אוטומטית מסקיל. Meta Business SDK והדרישות לאפליקציה ולטוקן · בחירת קהל לאפליקציה לפי Meta.

4. בדיקה לפני שממשיכים

לפני העתקת סקילים, בקשו לראות manifest_verified: true ותצוגה מקדימה עם applied: false ושישה סקילים. אחרי אישור והתקנה, בדקו applied: true ואת נתיב orchestration/SKILL.md שהמארח קרא בפועל. אל תריצו שוב --apply אם יש סקיל קיים בשם זהה; המתקין עוצר כדי לא לדרוס אותו. תרגיל YS Digital מופיע ב־STUDENT-EXAMPLE.md והוא אינו פעולה בחשבון מודעות.

5. רק אחרי שהמסלול הבסיסי עובד

אפשר לבקש מהמארח לבדוק הרחבות לפי צורך: מחקר מודעות מתחרים לשיפור השערות מסר, בדיקת התאמה בין מודעה לדף נחיתה, ובדיקת קליטת לידים כדי לזהות פניות שלא הגיעו. שלושת קובצי ה־ZIP הנוספים באתר הם תוספות בליווי המרצה, אינם חלק מששת הסקילים, וצריך לבדוק תמיכה והרשאות לכל מארח בנפרד. חיבורי Analytics, WordPress, Shopify או CRM הם אפשרויות להמשך, לא חלק מהתקנת Meta הבסיסית.

WSL2 היא סביבת Linux בתוך Windows. היא רלוונטית רק אם עוברים בהמשך לרכיבי מצב, יומן או לידים שפועלים לאורך זמן; אין צורך בה להתקנת סקילים או לתרגיל הבסיסי. לפני הפעלת סקיל נוסף קראו את SKILL.md ואת הסקריפטים שלו, בחרו מקור מהימן והרשאות מצומצמות, והשתמשו רק בדוגמאות ללא סודות או נתוני לקוחות.