ChatGPT Ads API: המדריך למשרדי פרסום ולמפתחים

מה ה-API יודע לעשות

ה-Advertiser API הוא הדרך הרשמית לנהל ChatGPT Ads בלי ממשק. כל מה שעושים ב-Ads Manager — מקמפיין ועד דוח — אפשר לעשות גם מקוד, וזה פותח שלוש אפשרויות: לנהל הרבה חשבונות בלי לחזור על אותן פעולות, לחבר נתונים למערכות קיימות (CRM, BI, גיליונות), ולבנות כלים משלכם. אלה היכולות שמתועדות היום:

למי זה מתאים, ולמי לא

ה-API לא מחליף את Ads Manager. הוא מתאים כשיש הרבה חזרתיות או צורך לחבר נתונים:

• משרדי פרסום שמנהלים הרבה לקוחות. הקמה לפי תבנית, דוח שבועי אחיד לכל הלקוחות, והתראות על מודעות שנדחו — בלי להיכנס לכל חשבון בנפרד. הרקע העסקי: ChatGPT Ads למשרדי פרסום.
• חברות SaaS וכלי שיווק שרוצים להציע ללקוחות שלהם ניהול או דוחות של ChatGPT Ads מתוך המוצר.
• צוותי שיווק פנימיים עם אוטומציה — למשל משיכת הוצאה והמרות ל-BI כל לילה, או השהיה אוטומטית של קבוצה לפי כלל.

למי זה לא נחוץ: עסק עם קמפיין אחד או שניים. Ads Manager נוח יותר, ואת רוב העבודה החשובה — מסרים, רמזי הקשר, מדידה — ה-API לא עושה בשבילכם. מתחילים במדריך להקמת קמפיין, ועוברים לקוד רק כשהחזרתיות מתחילה להעיק.

הזדהות ומודל הגישה

כל בקשה נשלחת ל-https://api.ads.openai.com/v1 עם header בפורמט Authorization: Bearer. לפי התיעוד, כל מפתח Ads API משויך לחשבון מודעות אחד, והוא נוצר בעמוד Settings של Ads Manager. שותפים שמגדירים חשבונות של לקוחות משתמשים במפתח של החשבון שהם מגדירים. בפועל, משרד עם עשרה לקוחות מחזיק עשרה מפתחות, וכל לקוח יוצר את המפתח בחשבון שלו.

# בדיקה שהמפתח עובד ושזה החשבון הנכון
curl https://api.ads.openai.com/v1/ad_account \
  -H "Authorization: Bearer $OPENAI_ADS_API_KEY" \
  -H "Accept: application/json"

חלק מהיכולות צריכות הפעלה בחשבון לפני שהן זמינות: עדכון מותג, ניהול פיקסלים, יצירת מפתח Conversions API וקמפייני המרות. לפי מדריך השותפים, בלי הפעלה מקבלים שגיאות (למשל 403 בעדכון מותג או 404 ב-endpoints של פיקסל), ובמקרה כזה פונים לנציג השותפים ב-OpenAI.

מבנה האובייקטים: קמפיין, קבוצת מודעות, מודעה

המבנה זהה לזה שב-Ads Manager. בקמפיין בוחרים את היעד ב-bidding_type: impressions, clicks או conversions (ברירת המחדל: impressions), ואי אפשר לשנות אותו אחרי היצירה. בקמפיין המרות מצרפים בדיוק הגדרת אירוע אחת (conversion_event_setting_ids). התקציב נקבע ב-budget.lifetime_spend_limit_micros, ושם גם הטירגוט: מיקומים לפי מזהים מ-GET /v1/geo_lookup/search, פלטפורמות (ios_app, android_app, web) וקהלים מותאמים.

בקבוצת המודעות נמצאים רמזי ההקשר (context_hints) — עד 2,000 לקבוצה, ולפי OpenAI הם לא מילות מפתח בהתאמה מדויקת — והצעת המחיר ב-bidding_config: billing_event_type (impression או click) ו-max_bid_micros. במודעה מסוג chat_card יש כותרת של 3–50 תווים, גוף של עד 100 תווים, target_url ו-file_id של תמונה שהועלתה. OpenAI ממליצה על תמונה של 640×640 פיקסלים לפחות.

כל הסכומים נשלחים ב-micros, מיליוניות של יחידת המטבע של החשבון: 1,000,000 הם 1 ₪ בחשבון שקלי. זו הטעות הכי נפוצה בחיבור ראשון — אפס אחד חסר או מיותר משנה את התקציב פי עשרה.

# 1. קמפיין — נוצר במצב paused
curl https://api.ads.openai.com/v1/campaigns \
  -H "Authorization: Bearer $OPENAI_ADS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: client-a-campaign-2026-10" \
  -d '{
    "name": "Client A - Q4 leads",
    "status": "paused",
    "bidding_type": "clicks",
    "budget": { "lifetime_spend_limit_micros": 500000000 }
  }'

# 2. קבוצת מודעות — רמזי הקשר והצעת מחיר ב-micros
{
  "campaign_id": "<CAMPAIGN_ID>",
  "name": "Accounting software for small businesses",
  "status": "paused",
  "context_hints": [
    "comparing accounting software for a small business in Israel",
    "how to issue digital invoices as a freelancer"
  ],
  "bidding_config": { "billing_event_type": "click", "max_bid_micros": 3000000 }
}

# 3. מודעה — chat_card עם תמונה שהועלתה קודם דרך POST /upload
{
  "ad_group_id": "<AD_GROUP_ID>",
  "name": "Card A",
  "status": "paused",
  "creative": {
    "type": "chat_card",
    "title": "הנהלת חשבונות בלי כאב ראש",
    "body": "מערכת אחת לחשבוניות, הוצאות ודוחות. נסו חודש חינם.",
    "target_url": "https://example.co.il/lp",
    "file_id": "<FILE_ID>"
  }
}

כמה דברים שכדאי לדעת לפני שמפעילים: מודעה חדשה מקבלת review_status של in_review, ואחר כך approved או rejected. בנוסף, החשבון כולו לא מציג מודעות עד שבדיקת המותג (brand review) אושרה. תצוגה מקדימה (POST /ads/{id}/preview) תקפה ל-24 שעות. ומדריך השותפים של OpenAI ממליץ ליצור קמפיינים במצב paused, להשלים ולבדוק קבוצות ומודעות, ורק אז להפעיל.

דוחות עם Insights API

יש endpoint של insights לכל רמה: /ad_account/insights, /campaigns/{id}/insights, /ad_groups/{id}/insights ו-/ads/{id}/insights. המדדים הבסיסיים: impressions, clicks, spend, ctr, cpc ו-cpm, ולצדם conversions, click_through_conversions ו-view_through_conversions.

• רזולוציה: time_granularity ב-hourly, daily (ברירת המחדל), monthly או none.
• פילוחים: segments לפי product, country, device או platform — מימד אחד בכל בקשה.
• טווחים: עד 365 יום בכל טווח, ונתונים של עד חמש שנים אחורה. עד 2,000 שורות בבקשה, עם דפדוף before/after.
• המרות: POST /v1/conversions/insights מחזיר את המרות היעד, עם חלון ייחוס של 7, 14 או 30 יום לקליק ו-0 או יום אחד לצפייה.

# ביצועים יומיים לקמפיין
curl "https://api.ads.openai.com/v1/campaigns/<CAMPAIGN_ID>/insights?time_granularity=daily&limit=100" \
  -H "Authorization: Bearer $OPENAI_ADS_API_KEY"

Conversions API ומניעת כפילויות

Conversions API שולח אירועי המרה מהשרת, ל-POST https://bzr.openai.com/v1/events. הוא עובד עם מפתח נפרד, שנוצר דרך POST /conversions/api_keys. כל אירוע כולל id, type, timestamp_ms (עד 7 ימים אחורה) ו-data. פרטי משתמש כמו אימייל נשלחים כ-SHA-256. אפשר לשלוח עד 1,000 אירועים בבקשה — אבל אם אירוע אחד נכשל, כל הבקשה נכשלת. לבדיקה בלי לשמור יש validate_only: true.

כששולחים את אותה המרה גם מהפיקסל וגם מהשרת, משתמשים באותו ערך: id ב-API ו-event_id בפיקסל. OpenAI מתאימה לפי Pixel ID, שם האירוע וה-id, שומרת את האירוע הראשון שהגיע ומוחקת את הכפילויות. ההתקנה בצד הדפדפן: מדריך OpenAI Pixel.

מגבלות קצב וטיפים מעשיים

• 600 בקשות לדקה לכל endpoint, 1,200 בסך הכול — גם לפי חשבון וגם לפי כתובת IP. משרד שמריץ כמה לקוחות מאותו שרת צריך לזכור את מגבלת ה-IP.
• Bulk API מוגבל בנפרד: 10 בקשות ליצירת jobs בכל 10 שניות לכל חשבון.
• Idempotency-Key בבקשות יצירה: בניסיון חוזר שולחים את אותו מפתח עם אותה בקשה, ובמשאב חדש מפתח חדש. כך תקלת רשת לא יוצרת קמפיין כפול.
• דוחות בלילה, לא בלולאה. המלצה שלנו: למשוך daily פעם ביום ולשמור אצלכם, במקום לשאול את ה-API בכל טעינת דשבורד.
• לוג שינויים. Audit Logs מציג את השינויים שנרשמו במשאבי החשבון — שימושי כשגם הלקוח וגם המשרד עובדים באותו חשבון.
• בדיקות. אין sandbox מתועד, ולכן כל בדיקה רצה על חשבון אמיתי. יוצרים במצב paused, בודקים בתצוגה מקדימה, ורק אז מפעילים.

מה עדיין לא מתועד

נכון ל-30.9.2026 לא מצאנו בתיעוד הציבורי סביבת sandbox או חשבונות בדיקה, תהליך מסודר להצטרפות כשותף API, או מנגנון OAuth שבו לקוח מאשר גישה בלחיצה. מדריך השותפים מניח שהגישה כבר קיימת, ומפנה לנציג השותפים ב-OpenAI. מי שבונה מוצר מסחרי על ה-API צריך לפנות ל-OpenAI לפני שמתחייב ללקוחות. GPTAds אינה שותפה רשמית של OpenAI; אנחנו עובדים עם ה-API הציבורי ועם החשבונות של הלקוחות.

להמשך: פרסום ב-ChatGPT — המדריך המלא, ניהול קמפיינים ב-ChatGPT Ads ופרסום B2B ב-ChatGPT.