ממשקי API להמרות

1. למה בכלל צד שרת?

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

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

2. מה נשלח — ומה לעולם אינו נשלח

הדבר היחיד שמזהה את המבקר בקריאות אלה הוא העוגייה או מזהה הלחיצה שהרשת הגדירה בעצמה. שום מידע אחר על האדם אינו יוצא מהשרת שלנו.

רשת	המזהה שבשימוש	מקורו
Meta	_fbp, _fbc	עוגיות צד ראשון שמגדיר פיקסל Meta
LinkedIn	li_fat_id	עוגיית צד ראשון שמגדיר LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp היא עוגייה, ttclid מגיע מ-URL הלחיצה על המודעה
Google Ads	gclid, wbraid, gbraid	מ-URL הלחיצה על המודעה, או מעוגיית _gcl_aw לאחר מכן
Microsoft Advertising	msclkid	מ-URL הלחיצה על המודעה, או מעוגיית _uetmsclkid שכותב תג UET

רק עם הסכמה

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

3. ל-Google Ads יש שלושה מזהים, לא אחד

זה מפתיע אנשים, ולכן חשוב לומר זאת במפורש. Google משתמשת במזהה gclid ללחיצה יחידה על מודעה. כשמניעת המעקב של Apple מונעת שיוך של לחיצה יחידה, Google שולחת wbraid או gbraid במקומו, והם מייצגים קבוצת לחיצות.

שלושתם מוציאים זה את זה — Google דוחה המרה שמכילה שניים. אנו שולחים אחד בדיוק, והמזהה gclid מקבל עדיפות כשיש יותר מאחד, כי הוא המדויק ביותר.

הם מופיעים ב-URL רק פעם אחת

המזהה מופיע בכתובת רק בדף הראשון לאחר הלחיצה על המודעה. לאחר מכן תג Google שומר אותו בעוגיית _gcl_aw — אנו קוראים את העוגייה כחלופה; בלעדיה, המרה בדף השלישי של הביקור לא הייתה מוצאת מזהה כלל.

4. הגדרה

Meta, LinkedIn ו-TikTok

שני שדות לכל אחת: מזהה הפיקסל או כלל ההמרה, ואסימון גישה שנוצר בממשק הרשת עצמה. שניהם נשמרים בהצפנת AES-256-GCM ולעולם אינם מוצגים שוב לאחר השמירה.

Google Ads דורשת שישה

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

שדה	היכן למצוא
מזהה לקוח	בפינה הימנית העליונה ב-Google Ads. ספרות בלבד, ללא המקפים.
מזהה פעולת המרה	Goals and conversions, ואז הפעולה שאליה יש לשייך את ההמרה.
אסימון מפתח	חשבון מנהל Google Ads שלך, API Center.
מזהה וסוד לקוח OAuth	Google Cloud Console, Credentials, לקוח OAuth מסוג “desktop app”.
אסימון רענון	יש ליצור אותו פעם אחת להרשאה adwords.

ל-LinkedIn יש שני נתיבים, ועדיף הקצר

ב-Campaign Manager: Data, Signals Manager, Direct API, Generate access token. זהו הנתיב למפרסמים ששולחים את נתוניהם — ללא אפליקציית מפתח וללא בדיקה. תוקף האסימון אינו פג, ו-Campaign Manager לא יציג אותו פעם נוספת, ולכן יש להעתיקו מיד.

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

Microsoft Advertising היא הפשוטה

אחרי Google Ads מצפים לאותה מורכבות — OAuth, אסימון מפתח ושלב אישור. ההפך הוא הנכון: שני שדות. מזהה תג UET שכבר משמש בדפדפן, ואסימון שמועתק מ-Microsoft Advertising תחת תג UET, “Use Conversions API”, “Copy Token”. אין צורך להגיש בקשה.

יש להשתמש באותו מזהה תג כמו בתג הדפדפן. כך Microsoft מזהה את האירוע בצד השרת ואת אירוע הדפדפן כהמרה אחת במקום שתיים.

5. מתי מדווחת המרה

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

מה מופיע בחשבון הפרסום

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

אם שום דבר לא מגיע

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