הוראות התממשקות – לקליטת לידים

כדי להעביר פניות למערכת במבי יש לשלוח בתצורת – POST את נתוני הטופס לכתובת:

https://www.bmby.com/shared/AddClient/index.php

** יש לבחור בצורה של “x-www-form-urlencoded” ולא JSON.

השדות שאפשר לשלוח הם: (יש חשיבות לאותיות גדולות וקטנות – שדות שלא מופיעים אצלכם בטופס לא חובה לשלוח)

●  Fname – שם פרטי

●  Lname – שם משפחה

●  Phone – טלפון (חובה לכלול שדה טלפון או מייל – לפחות אחד מהם)

●  Mobile – טלפון סלולרי

●  Email  – דוא”ל (חובה לכלול שדה טלפון או מייל – לפחות אחד מהם )

●  City – עיר   

●  Address – כתובת

●  Comments – הודעה / הערות 

●  Website – כתובת האתר

●  Company Name –  שם החברה

●  AllowedSMS – על מנת לאשר דיוור של – SMSלשלוח 0 במקרה ולא מאשר או 2 במקרה ומאשר.

●  AllowedMail – השדה הזה שולח אלינו את הספרה 0 כאשר לקוח מאשר קבלת חומר פרסומי

                             ואת הספרה 2 כאשר הוא לא מאשר. (תיבת הצ’קבוקס שמתייחסת לאישור קבלת דיוור) 

●  IP  – שולח את ה IP של הגולש. (שדה חובה במקרה של שליחת שדה  AllowedMail)

●  ProductTitle – מתעניין במוצר – ניתן לשלוח את המוצר בו מתעניין הלקוח (בתלות בסוג המערכת) לפי מה שמוגדר ברשימת המוצרים בניהול חברה.

●  MediaTitle – שדה מקור הגעה, שדה ששולח אלינו את המקור הגעה של הלקוח על מנת לראות במערכת במבי מאין הגיע הליד.

 

    מקורות הגעה

– יש ליידע אותנו איזה מקור הגעה/מקורות יש להגדיר.

– אם מדובר במקור אחד – יש לשלוח לנו את המקור, אנחנו נגדיר.

– אם מדובר ביותר ממקור אחד – יש לשלוח לנו את רשימת המקורות כתובים בדיוק כפי שהם הולכים להישלח אלינו (יש דגש לתווים, אותיות גדולות וכו’ ).

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

יש צורך לבנות שני שדות נוספים: 

●  XXXX=ProjectID מספר פרוייקט בבמבי.

● XXXXXX=Password סיסמא לממשק.

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

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

● שדות טקסט

● שדות קומבו עם ערכים מובנים מראש 

● שדות מולטי סלקט

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

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

שליחת שדות UTM לבמבי

ניתן לשלוח UTM לבמבי לפי השדות הבאים:

● utm_source 

● utm_campaign 

● utm_medium 

● utm_term 

● utm_content 

את השדות ניתן לראות תחת מסך מתעניינים-> לידים על ידי הוספת השדות לתצוגה.

ישנה אופציה נוספת ליצירת מקור הגעה מובנה על ידי שליחת 3 UTM יחד.

אם שולחים utm_source +utm_medium +utm_campaign  יווצר בבמבי מקור הגעה חדש המורכב מ3 השדות הללו ללא הצורך להקים אותו מראש בבמבי וניתן יהיה לחתוך את הלידים לפי מקור ההגעה הזה בדוח יחסי המרה.

לדוגמא:

utm_source =facebook

utm_medium =banner02

utm_campaign=tv

יווצר מקור בשם facebook_banner02_tv

תשובות חוזרות משרתי במבי

בתגובה ל- POST תקין יחזירו שרתי במבי את הערך – Response=1 זה אומר שהליד התקבל בשרת עם ערכים נכונים ונרשם תקין.

 במידה והתקבלה התשובה Response=0 זה אומר שהליד התקבל בשרת אבל הערכים שנשלחו שגויים ולכן הליד לא הוכנס למערכת הלקוח –

 ניתן לפנות לתמיכה לקבלת פרטים נוספים על מהות התקלה.

במידה וקיבלתם תשובה אחרת (200 ok) משמעות הדבר היא שהליד לא התקבל בשרתי במבי כלל, התשובה הינה לא מהשרתים שלנו אלא מהשרת

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

**מומלץ לשמור את הלידים בצד שלכם במקביל לשליחה לבמבי וזאת על מנת למנוע איבוד מידע במקרה של תקלה. (הדבר אינו חובה).

דגשים נוספים: 

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

הודעות שגיאה שהשרת מחזיר

– error no email or phone –  יד נשלח ללא אימייל או טלפון שאחד מהם חייב להיות כשדה חובה – תנאי הכרחי לכניסת ליד.

– Permission denied הנתונים לא נשלחים בפועל מהדומיין/URLכתובת IP של השרת שמסרתם לנו, אלא ממקום אחר. 

יש לפנות לתמיכה לבדיקה והגדרה מחדש