מדריך ל-API של Taboola: נקודות קצה של Backstage, אימות ושימושים מעשיים

ה-API של Taboola — רשמית Backstage API — הוא הממשק REST של Taboola למפרסמים. אתה מאמת את עצמך עם OAuth 2.0 client credentials, ואז קורא וכותב כל דבר שאתה יכול לגעת בו ב-Ads Console: קמפיינים, פריטים קרייטיביים, טרגוטינג, תקציבים ודוחות ביצועים, הכל תחת https://backstage.taboola.com/backstage/api/1.0/{account_id}/…. זה השכבה שבה קוני מדיה משתמשים כדי למכן שינויים בהצעות מחיר ובתקציב, להעלות קרייטיבים בהמונים, לסנכרן הוצאות למחסן נתונים, ולבנות את מנועי הכללים שה-UI של Taboola לא מציע. מה שהוא בכוונה לא חושף זה נתונים של אף אחד אחר — עבור התצוגה התחרותית של הרשת אתה צריך API שונה לחלוטין, שנכסה בסוף.

מה מכיל ה-API של Backstage#

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

• ניהול קמפיינים. צור, קרא, עדכן והשהה קמפיינים; הגדר CPCs, תקציבים יומיים וכלליים, טרגוטינג גיאוגרפי/פלטפורמה, וחסימת אתרים. כל דבר שהיית משנה ידנית ב-7 בבוקר אחרי בדיקת המספרים של הלילה יכול להיות סקריפט במקום.
• פריטים (קרייטיבים). כל קמפיין מכיל פריטים — היחידות של תמונה-פלוס-כותרת שבאמת מוצגות. ה-API מאפשר לך להוסיף פריטים בהמונים, לעדכן את הסטטוס שלהם, ולקרוא את מצב הבדיקה לכל פריט, וכך חשבונות גדולים מעבירים עשרות וריאציות קרייטיביות בלי לגעת ב-UI. (אם אתה עדיין מקים את הקמפיינים הראשונים שלך ידנית, התחל עם המדריך שלנו להקמת קמפיין ב-Taboola — ה-API מניח שאתה כבר מכיר את המושגים של הקונסולה.)
• דיווח. נקודות קצה של ביצועים מצטברים לפי מימד — יום, קמפיין, אתר, מדינה, פלטפורמה, פריט — החומר הגולמי לכל אופטימיזציה אוטומטית.
• מילונים. נקודות קצה לחיפוש עבור הערכים המוגדרים שכל השאר תלויים בהם: קודי מדינה, פלטפורמות, קטעי קהל.

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

אימות: client credentials לטוקן bearer#

Backstage משתמש בזרימת OAuth 2.0 client-credentials הסטנדרטית. החלף את המזהה והסוד שלך עבור טוקן:

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

התגובה מכילה access_token שאתה שולח ככותרת bearer בכל קריאה:

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

קריאת allowed-accounts היא הבקשה הראשונה הנכונה: היא מחזירה את ערכי account_id (מזהים מספריים ושמות קריאים) שכל נקודת קצה אחרת צריכה בנתיב שלה. טוקנים פגי תוקף — שמור אחד במטמון ורענן על 401 במקום ליצור טוקן חדש לכל בקשה, גם עבור זמן תגובה וגם כי בקשות לטוקנים מוגבלות בקצב בצורה אגרסיבית יותר מבקשות לנתונים.

נקודות הקצה שבאמת תשתמש בהן#

נקודות הקצה לדיווח לוקחות פרמטרי שאילתה של start_date ו-end_date פלוס מסננים אופציונליים, וקטע ה-dimension (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) קובע את החלוקה. site_breakdown הוא זה שהכי חשוב לאופטימיזציה: זה הזרם של ביצועים לכל מפרסם שמניע אוטומציה של רשימות חסימה.

מה קוני מדיה באמת ממנפים#

ה-API מחזיר את עלות ההקמה שלו בארבע משימות חוזרות:

1. מנועי כללים. הקלאסי: כל שעה, משוך site_breakdown עבור קמפיינים פעילים; כל אתר שהוציא יותר מ-N× מה-CPA המטרה עם אפס המרות עובר לרשימת האתרים החסומים של הקמפיין דרך עדכון קמפיין. זו אותה לולאת 'חתוך את המפסידים' שכל מפרסם Taboola רציני מריץ ידנית — מקודדת, לא רגשית, ופועלת ב-3 לפנות בוקר.
2. ניהול הצעות מחיר. כוונון עדין של CPCs קמפיין (ושינויים בהצעות מחיר לכל אתר, במקום שזמינים) כלפי מעלה בימים ואזורים גיאוגרפיים שעוברים את המטרה, כלפי מטה כש-CPA נסחף — התאמות קטנות, תכופות ומשעממות שמצטברות.
3. פעולות קרייטיביות בהמונים. העלאת 30 וריאציות של כותרת/תמונה לכל קמפיין, השעיית כל מה שנמצא מתחת לחציון CTR שבועי, ושמירה על רוטציה קרייטיבית לפני עייפות בלי אחר צהריים של לחיצות.
4. צינורות הוצאות. משימה לילית שמושכת campaign-summary לפי יום למחסן הנתונים, כך שהוצאות Taboola נוחתות ליד הכנסות המרה וכל ערוץ אחר בלוח מחוונים אחד.

תוכנית אינטגרציה מינימלית#

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

1. מעגל טוקן. החלף פרטי גישה לטוקן וקרא ל-allowed-accounts. אם זה עובד, אימות והרשאות נפתרו.
2. דיווח לקריאה בלבד. משוך campaign-summary לפי יום עבור השבוע האחרון והשווה את המספרים מול ה-Ads Console. אל תכתוב שום דבר עד שהקריאות שלך תואמות למה שה-UI מראה.
3. מוטציה בטוחה אחת. השהה ובטל השעיה של קמפיין בדיקה אחד דרך PUT. אשר שהשינוי מופיע בקונסולה ושמצב ההצגה עוקב.
4. סינכרון ההוצאות הלילי. תזמן את משיכת הדיווח למסד הנתונים שלך. זה לבד מצדיק את האינטגרציה עבור רוב הצוותים.
5. מנוע הכללים, במצב יבש. חשב את החלטות חסימת האתרים ורשום מה היה קורה במשך שבוע לפני שתאפשר לו לכתוב. השוואת הבחירות שלו לאלה שאתה עושה ידנית היא ה-QA הזול ביותר שאי פעם תריץ.

דילוג ישיר לשלב חמש היא הטעות הסטנדרטית — באגים בנתיב הכתיבה מול חשבון מודעות חי הם שיעורים יקרים.

מגבלות קצב ומכשלות מעשיות#

• כבד את התקרה. Backstage אוכף מגבלות קצב לכל חשבון; אסוף קריאות בצורה מרוכזת (קריאת דוח אחת לקמפיין לשעה, לא אחת לדקה) והפחת קצב על 429s. בדוק את ההפניה עבור מגבלות נוכחיות במקום להניח.
• דיווח מאחר אחרי הצגה. נתוני השעות האחרונות מתקבעים עם הזמן; בנה כללים מול נתונים בני לפחות כמה שעות או שתשהה קמפיינים על מספרים לא שלמים.
• עריכות אינן מיידיות. שינויים בקמפיין מתפשטים להצגה עם עיכוב, ועריכות פריטים יכולות להפעיל מחדש בדיקה. אוטומציה צריכה לסבול את הפער במקום להנפיק מחדש כתיבות 'שנכשלו'.
• אחסן מזהים, לא שמות. שמות קמפיין ופריטים נערכים על ידי בני אדם; מזהים מספריים הם מפתחות צירוף יציבים.
• שמור על נתיב הכתיבה. מנוע כללים עם באג יכול להשעות את כל ההוצאה של חשבון או להכפיל הצעת מחיר פי 10. רשום כל מוטציה, הוסף גבולות שפיות (לעולם אל תשנה הצעת מחיר ביותר מ-X% למעבר), והתחל כל כלל חדש במצב יבש.

ה-API האחר של Taboola: נתונים תחרותיים#

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

זה הפער שכיסוי ה-API למפתחים של OpenAdLibrary. האינדקס מחזיק מעל 206,000 קרייטיבים חיים של Taboola (יולי 2026) בתוך קורפוס של מעל 725,000 מודעות מקוריות ב-49 רשתות, ואותם נתונים מאחורי ספריית המודעות של Taboola ניתנים לשאילתה דרך REST: חפש קרייטיבים לפי מפרסם, נישה, אזור גיאוגרפי ואורך חיים; משוך כותרות ודפי נחיתה; עקוב אחרי מתי מתחרים משיקים ומסיימים קמפיינים. מדריך ה-API לנתוני מודעות מקוריות מתעד את נקודות הקצה, ואם זרימת העבודה שלך חיה בסוכן LLM יש שרת MCP שחושף את אותו קורפוס ככלים עבור Claude ו-ChatGPT. מפתח חינמי מכסה שימוש קל ומחיר נשאר קבוע להמשך; הנוף הרחב יותר של גישה תכנותית למודיעין מודעות נסקר בכלי ריגול מודעות עם API.

שני ה-APIs משתלבים באופן טבעי: Backstage ממכן ביצוע בחשבון שלך, ה-API למודיעין ממכן מחקר על כל השאר. הקונים שמפיקים את המירב מאוטומציה מריצים את שניהם — מנוע כללים שמשמר את הקמפיינים שלהם, וזרם תחרותי שמסמן מתי מפרסם חדש מתחיל להתרחב בנישה שלהם כך שהבדיקה הבאה לעולם לא נבחרת בעיוורון. התחל עם כלי הריגול של Taboola כדי לראות את הקורפוס התחרותי בדפדפן, ואז קח את אותן שאילתות לתכנות כשזרימת העבודה מוכחת.