שימוש ב - תבניות שונות
קיימות 2 גירסאות שונות של טופס המייסייט: donate (משנת 2015) ו- pay (משנת 2020).
על מנת להשתמש בתבנית החדשה pay, פשוט החליפו את ה - donate/ בכתובת של טופס התרומה שלכם ב - pay/.
כך שאם כתובת טופס התרומה הנוכחית שלכם היא:
תוכלו לשנות אותה ל:
שינוי ה - URL
כברירת מחדל, טופס התרומה יושב בדומיין secured.israelgives.org עבור טופס באנגלית, וב - secured.israeltoremet.org עבור טופס בעברית.
עם זאת, תוכלו להשתמש בדומיין secureddonation.com במקום כל אחד מהדומיינים הללו.
כך שאם ה - URL שלכם כרגע הוא https://secured.israelgives.org/he/pay/leket2
תוכלו לשנותו ל - https://secureddonation.com/he/pay/leket2
העברת משתנים לכתובת ה-URL של טופס התרומה
תוכלו לכלול מספר משתנים בכתובת האינטרנט (ה-URL) של טופס התרומה שלכם (או באמצעות שיטת POST), על מנת לבחור מראש אפשרויות מסוימות שיופיעו בטופס התרומה.
ניתן להוסיף משתנים על גבי טופס תרומה MYSITE או על גבי טופס שאינו מותאם אישית.
הקישור (URL) של MYSITE נראה כך: https://secureddonation.com/he/pay/leket2
הקישור של טופס שאינו מותאם אישית נראה כך: https://secureddonation.com/he/pay/makedonation?MakeDonation=1&AmutaGovId=580484681
שימו לב כי תוכלו להחליף את משתנה השפה (en/) כפי שתרצו, ואם אתם משתמשים בטופס שאינו מותאם אישית, הקפידו להחליף את 580484681 עם מספר העמותה שעבורה תרצו לסלוק תשלום. לאחר כתובת ה- URL הבסיסית שלכם, תצטרכו להוסיף סימן שאלה (?). לאחר מכן תוכלו לכלול מספר משתנים שיכללו בטופס התרומה:
currency ( מטבע)
sum (סכום)
freq (תדירות)
step=2 (לטעון את הטופס ישירות בשלב 2 של תהליך התרומה)
noemailreq=1 (כתובת דוא"ל לא חובה)
cf1=XXXX (שדה מותאם אישית)
fb=1 (להציג רק את החלק האמצעי של הטופס)
cc911=1 (לבצע תרומה עם כרטיס דמו)
אם תרצו להשתמש ביותר ממשתנה אחד, הוסיפו את הסימן & בין המשתנים השונים, כך:
?currency=1&sum=100&freq=2
Currency (מטבע)
משתנה זה מסמן את המטבע ומספר הזיהוי שלו שתרצו לבחור. לצפייה ברשימת המטבעות המלאה ומספרי הזיהוי שלהם, לחצו כאן .
לדוגמא, מספר הזיהוי של דולר אמריקאי הוא 2. כך שאם תרצו לבחור בדולר אמריקאי שיופיע בטופס התרומה, תכללו את המשתנה הבא, כך:
https://secureddonation.com/en/pay/leket2?currency=2
Sum (סכומי התרומה)
די מסביר את עצמו. הזינו את המשתנה sum= ואז את הסכום שתרצו שיכלל מראש. שימו לב שאם הסכום שתציינו הוא אחד מסכומי התרומה המוצעים בטופס, אז זהו סכום שיופיע כבר מראש. אם הסכום שתבחרו הוא לא אחד מסכומי התרומה מוצעים, אז הוא יופיע בסכום התרומה ה"אחר" שהמשתמש יכול להזין.
אז אם תרצו לבחור מראש דולר אמריקאי ו - 100, השתמשו בפורמט הזה:
https://secureddonation.com/en/pay/leket2?currency=2&sum=100
Frequency ( תדירות התרומה)
תוכלו לבחור מבין 3 תדירויות: תרומה חד-פעמית (1), תרומה חודשית (2) ותרומה שנתית, בפורמט הבא (השתמשו ב - freq):
https://secureddonation.com/en/pay/leket2?currency=2&sum=100&freq=2
תוכלו להשתמש גם במשתנים הבאים
projectId: זהו המספר המזהה של הפרויקט שנוצר דרך חשבון העמותה.
noemailreq=1:הוספה של משתנה זה תגרום לכתובת האימייל להיות שדה אפשרי בטופס התרומה שלכם (בלעדיו, כתובת אימייל בלעדיו כתובת אימייל כתובת אימייל תמיד תהיה שדה נדרש).
spaff: זהו משתנה שטוב לשימוש למטרת מעקב ותיעוד מקור המפנה לטופס התרומה שלך, כמו מקור פרסומי לדוגמא. הוא צריך להיות בנוי ממילה אחד, ללא רווחים או סמלים מיוחדים חות מאשר "-" או "_".
כך שאם תרצו להוסיף משתנה spaff שנקרא walla_news, זה צריך להופיע כך:
https://secureddonation.com/en/pay/leket2?currency=2&sum=100&freq=2&spaff=walla_news
שימו לב שאם תרצו לעקוב אחר הפניה או מקור לקמפיין (להבדיל מדף תרומה), עליכם להשתמש בקוד מעקב האפיליאט שלנו.
שלב 2
אם אתם מעבירים סכום, תדיגות ומטבע אל טופס התרומה, באפשרותכם לדלג ישירות אל שלב התשלום (שאנו קוראים לו " שלב 2") של טופס התרומה. פשוט הוסיפו step=2 על גבי ה-URL, כך:
https://secureddonation.com/en/pay/leket2?currency=2&sum=100&freq=2&spaff=walla_news&step=2
Note that when you skip ahead to Step 2, we'll automatically place the
שימו לב שכאשר אתם מדלגים ישירות אל שלב 2, נמקם באופן אוטומטי את כתובת האימייל שמולאה בשדה המיועד בשלב זה של תהליך התרומה, בניגוד למיקומה המקורי בשלב 1.
שימו לב שכשתשתמשו ב XX , התורם ידרש לשלם באמצעות כרטיס אשראי (פייפאל יכול להבחר כאמצעי תשלום רק משלב 1).
מעקב לפי שדות בהתאמה אישית (Custom field)
בכתובת עמוד של כל טופס התרומה, בסוף ה-URL, תוכלו להוסיף קטע ייחוס (attribution), שנראה כך: ?cf1=XXXX , כאשר במקום XXXX תזינו מילה אחת בתווים לטיניים.
כך שאם טופס התרומה שלכם ממוקם בכתובת https://securedddonation.com/donate/charity , הכתובת החדשה כולל המעקב תהיה https://securedddonation.com/donate/charity?cf1=XXXX
האותיות CF מייצגות "שדה בהתאמה אישית" (custom field), והן ייתנו ייחוס לכל תרומה שנעשתה דרך קישור ה -URL שמכיל את הסיומת הזו. תוכלו לראות זאת כאשר תייצאו את דו"ח התרומות שלכם לאקסל דרך חשבונכם..
אנו תומכים ב- 20 שדות מותאמים אישית, כך שתוכלו להוסיף עד 20 שדות מעקב, על ידי הוספת החלק הבא ל-URL:
cf1=XXX&cf2=XXXX&cf3=XXXX (etc..)
חלק מרכזי בלבד
אם ברצונכם להציג את החלק המרכזי בלבד (בלי הצדדים הימני והשמאלי של העמד), הוסיפו fb=1 על גבי ה - URL.
בדיקות וטסטים עם כרטיס הדמו שלנו
אם אתם רוצים לבדוק את טופס התרומה מבלי לבצע תרומה אמיתית, הוסיפו cc911=1 על גבי ה- URL ואז השתמשו בכרטיס האשראי שמספרו: 9111111111111111.
הסתרת שדות בטופס התרומה (נוסף ב 28/07/2020)
אתם יכולים להסתיר מספר שדות בטופס התרומה על ידי הוספת אחד או יותר מהמשתנים הבאים לכתובת ה- URL של הטופס שלכם:
• hidefrequency = 1 יסתיר את לשונית תדירות התרומה בראש העמוד. הקפד להעביר את התדירות (freq) לכתובת ה- URL, עם זאת, אחרת הטופס לא יתפקד כראוי.
• hidetaxstatus = 1 יסתיר את סעיף הסטטוס לניכוי מס.
• hidecurrency = 1 יסתיר את בורר התפריט (מטבע). עם זאת, הקפד להעביר את המטבע לכתובת URL, אחרת הטופס לא יתפקד כראוי.
• hidehonoreecard = 1 יסתיר את היכולת ליצור כרטיס אלקטרוני של honoree.
• hidepaypal = 1 יסתיר את אפשרות התשלום באמצעות PayPal
• hideaddress = 1 יסתיר את שדה הכתובות האפשרית. שים לב שהכתובת נדרשת בתרומה בדולרים קנדיים, כך שהכתובת תופיע גם אם אתה משתמש במשתנה זה.
• hidephone = 1 יסתיר את מספר הטלפון.
• hidelanguage = 1 יסתיר את בורר השפות בראש העמוד.
• hidecovermyfee=1 יסתיר את הפיצ'ר כסו את העמלה שלי מטופס בתרומה.
כך, למשל, אם רציתם להשתמש בכל המשתנים הללו, כתובת האתר שלכם יכולה להיות:
https://secureddonation.com/en/pay/MoreshetFund?hidecurrency=1¤cy=2&hideaddress=1&hidephone=1&hidefrequency=1&freq=2&hidepaypal=1&hidetaxstatus=1&hidehonoreecard=1
הערה: למרות שאין לנו כרגע אפשרות להסתיר אוטומטית את שדה הכותרת, נוכל לעזור לכם להסתיר אותו באמצעות JS (פשוט צרו איתנו קשר ואנו נעשה זאת עבורכם).
שדות חובה - כתובת וטלפון
כברירת מחדל, טלפון וכתובת הם שדות אפשריים. עם זאת, אשף ה MYSITE יאפשר לכם להגדיר אחד או את שניהם כשדות חובה.
שדות ושאלות מותאמות אישית
אתם יכולים להוסיף מגוון שדות ושאלות מותאמים אישית לטופס התרומה שלכם:
שדה קלט (של טקסט או מספרים)
שדה קלט (של מספרים בלבד)
שדה קלט (מספר שורות)
רשימה נפתחת
תיבת סימון
למידע נוסף על הוספת שדות מותאמים אישית, לחץ כאן.
הפנייה לכתובת אחרת לאחר תשלום
כברירת מחדל, לאחר תשלום מוצלח, אנו מפנים את המשתמש לדף "תודה" שלנו.
אם אתם רוצים להפנות את הקישור לדף התודה שלכם (הנמצא בכתובת https://www.my.org/thankyou ), השתמש בפרמטר successurl כך:
https://secureddonation.com/en/pay/MoreshetFund?successurl=https://www.my.org/thankyou
כיצד לטעון את דף התודה בדף אינטרנט אחר ולא במודל
אם אתם טוענים את טופס התרומה כמודל ורוצים להפנות את התורם לאחר תשלום מוצלח לכתובת האתר שלכם, אך בתוך דף האב (ולא בתוך המודל), השתמש ב- pptop = 1
להחזיר לעצמך את פרטי התשלום
כאשר אתם מעבירים את כתובת האתר לטופס התרומה, העבירו את המשתנים הנוספים כחלק מעמוד התודה, ונחזיר לכם את המשתנים האלה לאחר אישור התשלום:
&tlname={lname}&tfrequency={frequency}&ttrid={trid}&tdonid={donid}
&inst={installments}
סכום = סכום תשלום
מטבע: אנו נחזיר את המטבע כראשי תיבות של 3 אותיות (למשל דולר ארה"ב יהיה USD )
Fname = שם פרטי
Lname = שם משפחה
תדירות = נחזיר לך 1 (תרומה חד פעמית), 2 (תרומה חודשית חוזרת) או 3 (תרומה שנתית חוזרת)
Donid = מספר התרומה כפי שנרשמה במערכת שלנו
תשלומים - מספר התשלומים שהתורם בחר, או 0 אם אין
שימו לב שלאחר הפרמטר successurl בא הסימן ? , וכי כל הפרמטרים מופרדים עם &
אנו ממליצים שכל מה שבא לאחר successurl יעשה ב urlencode.
הקפידו למקם את successurl כפרמטר האחרון שאתם מציבים בכתובת האתר