ממשק ה-API להמרות של פייסבוק: מדריך הטמעה לשנת 2026

מאת Marcus Chen

מומחי שיווק ביצועים נבדק על ידי קוני מדיה בכירים

תשובה מהירה של AI

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

פורסם 10 יולי 2026

12 דקות קריאה · התקנה

ה-API להמרות של פייסבוק (CAPI) הוא המקביל בצד השרת לפיקסל הדפדפן. לאחר ש-iOS 14.5 הרס את המעקב מבוסס הדפדפן, CAPI הפך לדרך היחידה לשחזר את ההמרות שפייסבוק החמיצה. בשנת 2026, מפרסמים שמפעילים הגדרות מבוססות פיקסל בלבד משאירים 30-60% מההמרות המיוחסות על השולחן. מדריך זה מכסה התקנת CAPI נקייה מקצה לקצה.

מה CAPI באמת עושה

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

• משחזר המרות iOS. משתמשים מוגבלי ATT עדיין מפעילים אירועי שרת.
• עוקף חוסמי פרסומות. אירועים משרת לשרת אינם חסומים.
• איכות נתונים גבוהה יותר. אירועי שרת יכולים לכלול מזהים מהצד הראשון (דוא"ל מהודר, טלפון, מזהה לקוח) להתאמה חזקה יותר.
• הסרת כפילויות טובה יותר. בשילוב עם פיקסל באמצעות event_id, Meta מסיר כפילויות וסופר כל המרה פעם אחת.

שלוש דרכי התקנה

1. אינטגרציות פלטפורמה מקוריות (הכי קל)

ל-Shopify, WooCommerce, BigCommerce, Magento, Wix ו-Squarespace יש כולן מחברי CAPI מקוריים של Meta. הפעילו בניהול הפלטפורמה, הדביקו את טוקן הגישה, סיימתם. הכי טוב לצוותים שאינם מפתחים.

2. מנהל תגים בצד השרת (מומלץ)

השתמשו ב-Stape או ב-Google Tag Manager Server-Side כדי לשלוח אירועי CAPI ממיכל sGTM. אתם מקבלים שליטה מלאה באירועים, הסרת כפילויות והתאמה מתקדמת ללא כתיבת קוד שרת. תקן תעשייתי למפעילים רציניים.

3. אינטגרציית API ישירה (הכי הרבה שליטה)

שלחו בקשת POST ישירות ל-https://graph.facebook.com/v18.0/{pixel_id}/events מהצד האחורי שלכם. הכי טוב ל-SaaS, אפליקציות מותאמות אישית וכל דבר שאינו בנוי על פלטפורמת מסחר מרכזית.

שלב אחר שלב: הטמעת API ישירה

1. צרו טוקן גישה ל-CAPI. Events Manager → הפיקסל שלכם → Settings → Conversions API → Generate Access Token.
2. בחרו את האירועים לשליחה בצד השרת. שלחו תמיד Purchase, Lead ו-CompleteRegistration. אופציונלי: ViewContent, AddToCart, InitiateCheckout להתאמה עשירה יותר.
3. בנו את מטען האירוע. נדרש: event_name, event_time, action_source ("website"), event_id (להסרת כפילויות), ו-user_data (דוא"ל/טלפון/external_id מהודר).
4. הדרו את כל שדות user_data עם SHA-256. דוא"ל, טלפון, שם, עיר, מדינה, מיקוד, כולם מהודרים, באותיות קטנות, ללא רווחים.
5. שלחו POST לנקודת הקצה של Graph API. כללו את טוקן הגישה כפרמטר שאילתה או כותרת.
6. הגדירו לוגיקת ניסיון חוזר. בקשת POST שנכשלה (שגיאות 5xx) צריכה לנסות שוב עם השהיה אקספוננציאלית עד 3 פעמים.
7. תעדו כל אירוע לביקורת. אחסנו את מטען האירוע ואת התגובה של Meta כדי שתוכלו לנפות באגים בייחוס מאוחר יותר.

הסרת כפילויות אירועים: הפרט הקריטי

• צרו event_id ייחודי לכל המרה (למשל, מזהה ההזמנה שלכם).
• שלחו את אותו event_id גם בקריאת פיקסל הדפדפן וגם באירוע CAPI.
• ודאו ש-event_name תואם בדיוק, "Purchase" לא "purchase".
• ודאו ש-event_time נמצא בטווח של דקה אחת בין שני האירועים להסרת כפילויות נקייה.
• השתמשו בדוח הסרת הכפילויות של Events Manager כדי לוודא שהיחסים בריאים (אירועים מותאמים דפדפן+שרת צריכים להיות הדלי הדומיננטי).

התאמה מתקדמת: למה מזהים מהודרים חשובים

CAPI מאפשר לכם להעביר מזהי משתמש (דוא"ל מהודר, טלפון, שם, עיר וכו') בכל אירוע. Meta משתמש בהם כדי להתאים את ההמרה בחזרה למשתמש שלחץ על המודעה, גם אם עוגיית הדפדפן נעלמה.

• דוא"ל (em): המזהה בעל ההשפעה הגבוהה ביותר. העבירו אותו בכל אירוע שאפשר.
• טלפון (ph): מספר, ללא עיצוב, עם קוד מדינה (למשל, 14155551234).
• שם פרטי (fn) ושם משפחה (ln): באותיות קטנות.
• עיר (ct), מדינה (st), מיקוד (zp), ארץ (country): כולם באותיות קטנות, ללא רווחים.
• מזהה חיצוני (external_id): מזהה הלקוח הפנימי שלכם, מהודר. מצוין להתאמת רוכשים חוזרים.
• מזהה קליק (fbc) ומזהה דפדפן (fbp): תפסו מעוגיות הדפדפן והעבירו בכל אירוע שרת להתאמה חזקה יותר.

אימות ש-CAPI עובד

1. Events Manager → לשונית Diagnostics. אמור להראות ללא אזהרות קריטיות.
2. Events Manager → Event Quality / Event Match Quality. שאפו ל-7+ בסולם של 10.
3. Events Manager → תרשים עמודות Events Received. אשרו ששתי העמודות Browser ו-Server מאוכלסות.
4. Test Events. צרו test_event_code, ירו המרה אמיתית, וצפו בה נוחתת בזמן אמת.
5. לאחר 7 ימים: השוו המרות מיוחסות ב-Ads Manager לפני ואחרי CAPI. עלייה של 20%+ בהמרות מיוחסות מאשרת ש-CAPI משחזר נתונים.

CAPI אינו אופציונלי יותר. המפרסמים שמפעילים הגדרות מבוססות פיקסל בלבד בשנת 2026 מתחרים עם יד אחת קשורה מאחורי הגב. בחרו את נתיב ההתקנה התואם לערימה שלכם, הסירו כפילויות כראוי, ואמתו עם Event Match Quality. יומיים של עבודה משתלמים לצמיתות.