מודעות Meta

רכיב מודעות Meta מחפש בספריית המודעות הציבורית של Meta ומחזיר את מודעות הפייסבוק והאינסטגרם המתאימות כרשימת JSON. כל מודעה כוללת את עמוד המפרסם, טקסט המודעה, הכותרת, הקריאה לפעולה, הקישור לדף הנחיתה, קישורים לתמונות ולסרטונים, תאריכי הפרסום והאם היא עדיין פעילה. חברו את הרשימה לרכיב יצירת טקסט - כל LLM לניתוח מתחרים, או לרכיב חילוץ שדה כדי להריץ יצירה אחת לכל מודעה.

מתי להשתמש

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

התחלה מהירה

חיפוש לפי

השדות מילת חיפוש וכתובות עמודי פייסבוק מקבלים {}. הטקסט של רכיב שמחובר לקלט מילת חיפוש / כתובות עמודים מחליף את {}, וכך רכיב טקסט או רכיב רשימה יכולים להזין את החיפוש.

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

הגדרות

קלטים

פלטים

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

כל מודעה בפלט JSON כוללת את השדות האלה:

{
  "adArchiveId": "866569929827744",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=866569929827744",
  "pageName": "Nike",
  "pageId": "15087023444",
  "startDate": "2026-09-01T07:00:00.000Z",
  "endDate": null,
  "isActive": true,
  "platforms": ["FACEBOOK", "INSTAGRAM"],
  "text": "Just do it.",
  "title": "Air Max",
  "caption": "nike.com",
  "ctaText": "Shop now",
  "linkUrl": "https://nike.com/airmax",
  "images": ["https://…/creative.jpg"],
  "videos": ["https://…/creative.mp4"],
  "videoPreviews": ["https://…/poster.jpg"],
  "collationCount": 3
}

לכל מודעה יש גם שדה format ורשימת creatives, עם הסוג, הקישור, הגודל והפורמט של כל קריאייטיב. כשניתוח ה-AI מופעל, לכל מודעה שנותחה יש אובייקט analysis עם הממצאים של המנתח.

תוצאות

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

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

קריאייטיבים בספרייה שלכם

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

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

קרדיטים

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

• החיוב הוא על הכמות שביקשתם. תקופה צרה או מילת חיפוש שיש לה מעט מודעות עשויות להחזיר פחות מודעות מהמבוקש.
• ניתוח AI מוסיף קריאת AI אחת לכל מודעה שנותחה. בקריאה הזו המודל קורא את הפריים ואת הטקסט של המודעה, ואת שורת הפוקוס שלכם. הקריאה מחויבת לפי הטוקנים שהיא השתמשה בהם בפועל, בתעריף של מודל הניתוח. העלות של כל הניתוחים בהרצה מסוכמת ונגבית פעם אחת, מעבר למחיר של הגריפה עצמה. Gemini 4 Argon רץ רק בשירות הישיר של Google, והקריאה אליו מחויבת בתעריף של אותו שירות. ראו את הסעיף איך מחויבות קריאות LLM בדף קרדיטים.
• השריון לניתוח AI. לפני ההרצה, Nodaro משריין את מחיר הגריפה ועוד ניתוח טיפוסי לכל מודעה מבוקשת. כשהיתרה נמוכה מהשריון, ההרצה נדחית לפני שמשהו רץ. אחרי ההרצה הרכיב גובה את מחיר הגריפה ועוד את מה שהניתוחים השתמשו בו.
• מודעות שלא נותחו לא עולות כלום. זה חל גם על אצווה שחזרה עם פחות מודעות מהמבוקש וגם על הרצה ארוכה שנגמר לה הזמן. על ניתוח שיצרן המודל חייב עליו משלמים גם כשהוא נכשל. על הרצה שנכשלה מקבלים החזר של מחיר הגריפה, אבל על ניתוחים שכבר חויבו עדיין משלמים.
• מפרסמים מהקלט. כשרכיב טקסט או רכיב רשימה מספקים את שמות המפרסמים, מספר המקורות ידוע רק כשהרכיב רץ. עד אז, האומדן ברכיב מניח מקור אחד.
• חיפוש המפרסמים לא עולה כלום.

בהתקנה באירוח עצמי, רכיב מודעות Meta צריך את מפתח הגריפה שמתואר בדף מפתחות ספק, או חיבור ל-Nodaro Cloud.

טיפים

• למדו מקריאייטיבים שכבר לא רצים. בחרו בהגדרה סטטוס מודעה את האפשרות לא פעילה, עם תקופה ארוכה, כדי לראות את המודעות שמפרסם כבר הפסיק לפרסם.
• פצלו לפי מודעה. חלצו את השדה images או text בעזרת רכיב חילוץ שדה, לפני רכיב רשימה, כדי להריץ יצירה אחת לכל מודעה.
• השתמשו בתמונות הפוסטר. תמונות הפוסטר שבשדה videoPreviews של מודעות הווידאו של מותג הן פריימי ייחוס טובים לקונספטים חדשים.

פתרון בעיות

דרך ה-API

הנתיב POST /v1/meta-ads-scrape מריץ את הרכיב דרך קוד. ל-API יש שני מצבים, חיפוש לפי מילה ועמודים: שלחו מפרסם שבחרתם ככתובת עמוד הפייסבוק שלו. הרצה שמעתיקה כל סרטון ומנתחת כל מודעה נמשכת לעיתים קרובות יותר מהמגבלה של כ-100 שניות לבקשת HTTP אחת, ולכן שלחו "respondAsync": true. הקריאה עונה אז מיד עם jobId, ואת המודעות מקבלים מהמשימה שהושלמה עם GET /v1/jobs/:id.

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