Marketo
מחבר Marketo מאפשר לכם לבצע פעולות של הוספה, מחיקה, עדכון וקריאה של נתוני Marketo.
לפני שמתחילים
לפני שמשתמשים במחבר Marketo, צריך לבצע את המשימות הבאות:
- בפרויקט שלכם ב-Google Cloud:
- מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
- נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM roles/connectors.admin.
- מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
roles/secretmanager.viewerroles/secretmanager.secretAccessor
חשבון שירות הוא סוג מיוחד של חשבון Google שמייצג משתמש לא אנושי, שצריך לאמת ולאשר כדי לתת לו גישה לנתונים ב-Google APIs. אם אין לכם חשבון שירות, אתם צריכים ליצור חשבון שירות. המחבר וחשבון השירות צריכים להיות שייכים לאותו פרויקט. מידע נוסף זמין במאמר בנושא יצירת חשבון שירות.
- מפעילים את השירותים הבאים:
-
secretmanager.googleapis.com(Secret Manager API) -
connectors.googleapis.com(Connectors API)
במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.
-
אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תתבקשו להפעיל אותם כשאתם מגדירים את המחבר.
הגדרת המחבר
החיבור הוא ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:
- במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
- לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
- בקטע מיקום, בוחרים את המיקום של החיבור.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
אזורים נתמכים למחברים:
רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
- לוחצים על הבא.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
- בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
- מחבר: בוחרים באפשרות Marketo מהרשימה הנפתחת של המחברים הזמינים.
- גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
- בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.
השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:
- שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
- האותיות צריכות להיות קטנות.
- שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
- שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
- אופציונלי: מזינים תיאור למופע החיבור.
- חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
- אופציונלי: מגדירים את ההגדרות של צומת החיבור:
- מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
- מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
- אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
- לוחצים על הבא.
- בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
- סוג היעד: אפשר לציין את פרטי היעד ככתובת מארח או כקובץ מצורף של שירות. בוחרים באחד מסוגי היעדים הבאים:
- כתובת המארח: אם רוצים לציין את שם המארח או את כתובת ה-IP של היעד.
- צירוף שירות: אם רוצים לציין את נקודת הקצה הפרטית לכתובות ה-IP הפנימיות. קובץ ה-Service Attachment מאפשר לכם להסתיר את כתובות ה-IP הפנימיות מהרשת החיצונית. אפשר ליצור קובץ מצורף עם השירות ב-Google Cloud באמצעות התכונה Private Service Connect. מידע על הגדרת Private Service Connect זמין במאמר פרסום שירותים מנוהלים.
בהתאם לסוג היעד שבחרתם, מזינים את כתובת המארח או את שם קובץ השירות.
כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.
- לוחצים על הבא.
- סוג היעד: אפשר לציין את פרטי היעד ככתובת מארח או כקובץ מצורף של שירות. בוחרים באחד מסוגי היעדים הבאים:
-
בקטע אימות, מזינים את פרטי האימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
החיבור ל-Marketo תומך בסוגי האימות הבאים:
- פרטי כניסה של לקוח ב-OAuth 2.0
- שם משתמש וסיסמה
- לוחצים על הבא.
כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
- בדיקה: בודקים את פרטי החיבור והאימות.
- לוחצים על יצירה.
הגדרת אימות
מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.
-
פרטי לקוח OAuth 2.0
- מזהה לקוח: מזהה הלקוח שסופק על ידי כלי החיבור לאפליקציה שיצרתם.
- סוד לקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
-
שם משתמש וסיסמה
- UserId: מזהה המשתמש ב-Marketo SOAP API.
- EncryptionKey: סוד ב-Secret Manager שמכיל את מפתח ההצפנה של Marketo SOAP API.
מגבלות המערכת
מחבר Marketo יכול לעבד עסקה אחת בשנייה, לכל צומת, ומגביל את מספר העסקאות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.
מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.
שימוש בחיבור Marketo בשילוב
אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.
- כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
- מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.
פעולות
בקטע הזה מפורטות הפעולות שהמחבר תומך בהן. כדי להבין איך להגדיר את הפעולות, אפשר לעיין בדוגמאות לפעולות.
פעולה AddLandingPageContentSection
מוסיף קטע תוכן לדף הנחיתה המטורגט.
פרמטרים של קלט לפעולה AddLandingPageContentSection
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| LandingPageId | String | נכון | מזהה דף הנחיתה |
| ContentId | String | נכון | המזהה של קטע התוכן. וגם המזהה של הקטע ב-HTML. |
| סוג | String | נכון | סוג הקטע בתוכן. הערכים המותרים הם Image, Form, Rectangle, Snippet, RichText, HTML. |
דוגמאות להגדרת הפעולה AddLandingPageContentSection מופיעות במאמר דוגמאות לפעולות.
פעולת מחיקה של תוכן בקטע בדף נחיתה
מחיקת הקטע של תוכן דף הנחיתה ב-Marketo.
פרמטרי הקלט של הפעולה DeleteLandingPageContentSection
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| LandingPageId | String | נכון | המזהה של דף הנחיתה. |
| ContentId | String | נכון | המזהה של קטע התוכן. וגם המזהה של הקטע ב-HTML. |
דוגמאות להגדרת הפעולה DeleteLandingPageContentSection מופיעות במאמר דוגמאות לפעולות.
פעולת UpdateEmailContent
מעדכן את התוכן של הודעת אימייל.
פרמטרים של קלט בפעולה UpdateEmailContent
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| EmailId | String | נכון | המזהה של האימייל. |
| FromEmail | String | נכון | כתובת השולח של האימייל |
| FromName | String | נכון | השם של השולח באימייל |
| ReplyTo | String | נכון | כתובת לתשובה של האימייל |
| נושא | String | נכון | שורת הנושא של האימייל |
דוגמאות להגדרת הפעולה UpdateEmailContent מופיעות במאמר דוגמאות לפעולות.
פעולת UpdateLandingPageContentSection
מוסיפים או מעדכנים את הקטע של תוכן דף הנחיתה ב-Marketo.
פרמטרים של קלט לפעולה UpdateLandingPageContentSection
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| סוג | String | נכון | סוג קטע התוכן.הערכים המותרים הם Image, Form, Rectangle, Snippet, RichText, HTML. |
| ערך | String | נכון | סוג הקטע בתוכן. |
| LandingPageId | String | נכון | המזהה של דף הנחיתה. |
| ContentId | String | נכון | המזהה של קטע התוכן. וגם המזהה של הקטע ב-HTML. |
דוגמאות להגדרת הפעולה UpdateLandingPageContentSection מופיעות במאמר דוגמאות לפעולות.
הפעולה GetImportProgramMembersStatus
מקבל את הסטטוס של חברי תוכנית ייבוא מפעולת קובץ ב-Marketo.
פרמטרים של קלט בפעולה GetImportProgramMembersStatus
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| BatchId | String | נכון | המזהה של אצווה לייבוא לידים. |
דוגמאות להגדרת הפעולה GetImportProgramMembersStatus מופיעות במאמר דוגמאות לפעולות.
תזמון פעולה בקמפיין
מגדיר מרחוק לוח זמנים להפעלת קמפיין אצווה בזמן נתון.
פרמטרים של קלט לפעולה ScheduleCampaign
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| CampaignId | String | נכון | המזהה של קמפיין האצווה שרוצים לתזמן. |
| RunAt | String | נכון | התאריך והשעה שבהם הקמפיין יופעל. אם לא מגדירים את השדה הזה, הקמפיין יופעל חמש דקות אחרי ביצוע השיחה. |
דוגמאות להגדרת הפעולה ScheduleCampaign מופיעות במאמר דוגמאות לפעולות.
הפעולה ListMembersOfList
הפונקציה קובעת אם הלידים נכללים ברשימה ב-Marketo.
פרמטרים של קלט לפעולה ListMembersOfList
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| ListId | String | נכון | המזהה של הרשימה שרוצים לבדוק אם יש בה לידים. |
| LeadId | String | נכון | רשימה מופרדת בפסיקים של מזהי לידים שצריך לבדוק אם הם נמצאים ברשימה שצוינה על ידי ListId. |
דוגמאות להגדרת הפעולה ListMembersOfList מופיעות במאמר דוגמאות לפעולות.
פעולה AssociateLead
משייך רשומת ליד מוכרת ב-Marketo לקובץ Cookie מסוג munchkin ולהיסטוריית הפעילות באינטרנט שמשויכת אליו
פרמטרים של קלט לפעולה AssociateLead
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| LeadId | String | נכון | מזהה הליד לשיוך. |
| קובץ cookie | String | נכון | ערך קובץ ה-Cookie שרוצים לשייך |
דוגמאות להגדרת הפעולה AssociateLead מופיעות במאמר דוגמאות לפעולות.
הפעולה MergeLeads
מיזוג של שתי רשומות או יותר של לידים מוכרים לרשומה אחת של ליד.
פרמטרים של קלט לפעולה MergeLeads
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| WinningLeadId | String | נכון | המזהה של רשומת הליד המנצחת |
| LoosingLeadId | String | נכון | רשימה של מזהי לידים שמופרדים בפסיקים |
דוגמאות להגדרת הפעולה MergeLeads מופיעות במאמר דוגמאות לפעולות.
הפעולה GetImportLeadsStatus
מקבל את הסטטוס של פעולת ייבוא לידים מקובץ ב-Marketo.
פרמטרים של קלט בפעולה GetImportLeadsStatus
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| BatchId | String | נכון | המזהה של אצווה לייבוא לידים. |
דוגמאות להגדרת הפעולה GetImportLeadsStatus מופיעות במאמר דוגמאות לפעולות.
הפעולה CancelExportJob
ביטול של עבודת ייצוא.
פרמטרים של קלט לפעולה CancelExportJob
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| JobId | String | נכון | המזהה של משימת הייצוא. |
| סוג | String | נכון | סוג האובייקט של BulkExtract. הערכים הזמינים הם : Activities, Leads, ProgramMembers הערכים המותרים הם Activities, Leads, ProgramMembers. |
דוגמאות להגדרת הפעולה CancelExportJob מופיעות במאמר דוגמאות לפעולות.
הפעולה EnqueueExportJob
מכניס משימת ייצוא לתור ומתחיל את המשימה כשמשאבי מחשוב הופכים לזמינים.
פרמטרים של קלט של הפעולה EnqueueExportJob
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| JobId | String | נכון | המזהה של משימת הייצוא. |
| סוג | String | נכון | סוג האובייקט של BulkExtract. הערכים הזמינים הם : Activities, Leads, ProgramMembers. הערכים המותרים הם Activities, Leads, ProgramMembers. |
דוגמאות להגדרת הפעולה EnqueueExportJob מופיעות במאמר דוגמאות לפעולות.
פעולה GetExportJobStatus
הפונקציה מחזירה את הסטטוס של משימת ייצוא. סטטוס המשימה זמין למשך 30 ימים אחרי שהסטטוס שלה היה 'הושלמה' או 'נכשלה'.
פרמטרים של קלט של הפעולה GetExportJobStatus
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| JobId | String | נכון | המזהה של משימת הייצוא. |
| סוג | String | נכון | סוג האובייקט של BulkExtract. הערכים הזמינים הם : Activities, Leads, ProgramMembers. הערכים המותרים הם Activities, Leads, ProgramMembers. |
דוגמאות להגדרת הפעולה GetExportJobStatus מופיעות במאמר דוגמאות לפעולות.
הפעולה CreateEmailTemplate
יצירת תבנית אימייל חדשה.
פרמטרים של קלט לפעולה CreateEmailTemplate
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| FolderId | String | נכון | מזהה התיקייה |
| FolderType | String | נכון | סוג התיקייה. |
| שם | String | נכון | השם של תבנית האימייל. חייב להיות ייחודי בתיקיית האב. |
| קובץ | String | נכון | קובץ Multipart. תוכן HTML לתבנית. |
דוגמאות להגדרת הפעולה CreateEmailTemplate מופיעות במאמר דוגמאות לפעולות.
פעולה UpdateLeadProgramStatus
שינוי סטטוס התוכנית של רשימת לידים בתוכנית יעד. אפשר להשתמש ב-API הזה רק כדי לשנות את הסטטוס של חברים קיימים בתוכנית.
פרמטרים של קלט לפעולה UpdateLeadProgramStatus
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| ProgramId | String | נכון | המזהה של קמפיין האצווה שרוצים לתזמן. |
| LeadIds | String | נכון | רשימה של מזהי לידים מופרדים בפסיקים. |
| סטטוס | String | נכון | סטטוס התוכנית של הרשומה. |
דוגמה להגדרת הפעולה UpdateLeadProgramStatus מופיעה במאמר דוגמאות לפעולות.
הפעולה RemoveLeadsFromList
הסרת לידים מרשימה ב-Marketo.
פרמטרים של קלט לפעולה RemoveLeadsFromList
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| ListId | String | נכון | המזהה של הרשימה שממנה רוצים להסיר לידים. |
| LeadId | String | נכון | רשימה מופרדת בפסיקים של מזהי לידים שיוסרו מהרשימה שצוינה על ידי ListId. |
דוגמאות להגדרת הפעולה RemoveLeadsFromList מופיעות במאמר דוגמאות לפעולות.
פעולת ייבוא של אובייקטים מותאמים אישית מקובץ
מייבא אובייקטים בהתאמה אישית מקובץ אל Marketo.
פרמטרים של קלט של הפעולה ImportCustomObjectsFromFile
| שם הפרמטר | סוג הנתונים | חובה | תיאור |
|---|---|---|---|
| קובץ | String | נכון | הנתיב לקובץ שמכיל את האובייקטים המותאמים אישית שרוצים לייבא ל-Marketo, למשל C:\temp\custom_object_import.csv. |
| TableName | String | נכון | השם של טבלת האובייקטים המותאמים אישית. לדוגמה: CustomObject_test |
| פורמט | String | נכון | הפורמט של הקובץ שישמש לייבוא אובייקטים מותאמים אישית אל Marketo. הערכים המותרים הם csv, tsv, ssv. |
| תוכן | String | נכון | התוכן כ-InputStream שיועלה אם לא צוין קובץ. |
דוגמה להגדרת הפעולה ImportCustomObjectsFromFile מופיעה במאמר דוגמאות לפעולות.
דוגמאות לפעולות
בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.
דוגמה – הוספה של תוכן בדף נחיתה
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
AddLandingPageContentSectionולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "LandingPageId": "1005", "ContentId": "1120", "Type": "HTML" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה CampaignTest של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Id": "1130", "json:repeatelementorder": "id", "requestsuccess": "true", "@affectedrows": "1" }]
דוגמה – DeleteLandingPageContentSection
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
DeleteLandingPageContentSectionולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "LandingPageId": "1005", "ContentId": "1009" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה DeleteLandingPageContentSection של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Id": "1005", "json:repeatelementorder": "id", "requestsuccess": "true", "@affectedrows": "1" }]
דוגמה – UpdateEmailContent
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
UpdateEmailContentולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "EmailId": "1001", "FromName": "test", "FromEmail": "222larabrown@gmail.com", "Subject": "TestSubject Line", "ReplyTo": "222larabrown@gmail.com" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה UpdateEmailContent של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Id": "1001", "json:repeatelementorder": "id", "requestsuccess": "true" }]
דוגמה – UpdateLandingPageContentSection
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
UpdateLandingPageContentSectionולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "Type": "HTML", "Value": " Test Update ", "LandingPageId": "1005", "ContentId": "1120" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה UpdateLandingPageContentSection של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Id": "1005", "json:repeatelementorder": "id", "requestsuccess": "true", "@affectedrows": "1" }]
דוגמה – GetImportProgramMembersStatus
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
GetImportProgramMembersStatusולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "BatchId": "1029" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה GetImportProgramMembersStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "BatchId": "1029", "Status": "Complete", "NumOfLeadsProcessed": "3", "NumOfRowsFailed": "0", "NumOfRowsWithWarning": "3", "Message": "Import succeeded, 3 records imported (3 members), 3 warning.", "importid": "1029", "requestsuccess": "true" }]
דוגמה – ScheduleCampaign
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
ScheduleCampaignולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "CampaignId": "1065", "RunAt": "2024-05-23T18:05:00+0000" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה ScheduleCampaign של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Success": "true", "id": "1065", "json:repeatelementorder": "id", "requestsuccess": "true" }]
דוגמה – ListMembersOfList
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
ListMembersOfListולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "ListId": "1003", "LeadId": "13,25,21" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה ListMembersOfList של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "LeadId": "13", "Status": "notmemberof", "ReasonCode": null, "ReasonMessage": null, "id": "13", "requestsuccess": "true" }, { "LeadId": "25", "Status": "notmemberof", "ReasonCode": null, "ReasonMessage": null, "id": "25", "requestsuccess": "true" }, { "LeadId": "21", "Status": "notmemberof", "ReasonCode": null, "ReasonMessage": null, "id": "21", "requestsuccess": "true" }]
דוגמה – AssociateLead
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
AssociateLeadולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "LeadId": 582.0, "Cookie": "id:703-VQQ-088%26token:_mch-marketo.com-_mch-mktoweb.com-1717156982039-98850" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה AssociateLead של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Status": "Success" }]
דוגמה – MergeLeads
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
MergeLeadsולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "LoosingLeadId": "10", "WinningLeadId": "45" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה MergeLeads של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Status": "Success" }]
דוגמה – GetImportLeadsStatus
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
GetImportLeadsStatusולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "BatchId": "1022" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה GetImportLeadsStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "BatchId": "1022", "Status": "Complete", "NumOfLeadsProcessed": "3", "NumOfRowsFailed": "0", "NumOfRowsWithWarning": "0", "Message": "Import succeeded, 3 records imported (3 members)", "importid": "1022", "requestsuccess": "true" }]
דוגמה – ביטול של משימת ייצוא
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
CancelExportJobולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b", "Type": "Leads" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה CancelExportJob של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "JobId": "ddf64e6f-0e9c-4254-91a9-32277349a22b", "JobStatus": "Cancelled", "Format": "CSV", "CreatedAt": "2024-05-28T05:45:13Z", "StartedAt": null, "QueuedAt": null, "exportid": null, "json:repeatelementorder": null, "status": null, "requestsuccess": null }]
דוגמה – EnqueueExportJob
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
EnqueueExportJobולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303", "Type": "Leads" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה EnqueueExportJob של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "JobId": "d04f60fb-5e68-40b5-9928-76fdb9034303", "JobStatus": "Queued", "Format": "CSV", "CreatedAt": "2024-05-27T12:12:53Z", "QueuedAt": "2024-05-27T12:13:20Z", "exportid": null, "json:repeatelementorder": null, "status": null, "requestsuccess": null }]
דוגמה – GetExportJobStatus
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
GetExportJobStatusולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4", "Type": "Leads" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה GetExportJobStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4", "Format": "CSV", "CreatedAt": "2024-05-23T10:12:09Z", "JobStatus": "Created", "QueuedAt": null, "StartedAt": null, "FinishedAt": null, "NumberOfRecords": null, "FileSize": null, "exportid": null, "status": null, "requestsuccess": null }]
דוגמה – CreateEmailTemplate
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
CreateEmailTemplateולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "FolderId": 27.0, "FolderType": "Folder", "Content": "\n\n\n \n My First Heading \n My first paragraph. \n \n\n", "Name": "Test1718166502676", "Filename": "FileName1718166502678" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה CreateEmailTemplate של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Id": "1048", "createdat": "2024-06-12T04:28:23Z+0000", "folder_type": "Folder", "workspace": "Default", "folder_foldername": "Templates", "name": "Test1718166502676", "version": "2", "requestsuccess": "true", "url": "https://app-abc.marketo.com/#ET1048B2ZN27", "folder_value": "27", "updatedat": "2024-06-12T04:28:23Z+0000", "status": "draft" }]
דוגמה – UpdateLeadProgramStatus
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
UpdateLeadProgramStatusולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "ProgramId": "1002", "Status": "Member", "LeadIds": "3" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה UpdateLeadProgramStatus של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "Success": "true", "id": "3", "status": "updated", "requestsuccess": "true" }]
דוגמה – RemoveLeadsFromList
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
RemoveLeadsFromListולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "ListId": "1026", "LeadId": "57" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה RemoveLeadsFromList של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "LeadId": "57", "Status": "skipped", "ReasonCode": "1015", "ReasonMessage": "Lead not in list", "id": "57", "requestsuccess": "true" }]
דוגמה – ImportCustomObjectsFromFile
- בתיבת הדו-שיח
Configure connector task, לוחצים עלActions. - בוחרים את הפעולה
ImportCustomObjectsFromFileולוחצים על סיום. - בקטע מיפוי נתונים
Open Data Mapping Editorואז מזינים ערך דומה לערך הבא בשדהInput:{ "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4", "Type": "Leads" }
בדוגמה הזו מוצגים רשומות ספציפיות של אובייקטים. אם הפעולה מצליחה, לפרמטר התגובה ImportCustomObjectsFromFile של המשימה connectorOutputPayload יהיה ערך שדומה לזה:
[{ "JobId": "358a974e-7bbb-475e-a71e-72ce4c01ffa4", "Format": "CSV", "CreatedAt": "2024-05-23T10:12:09Z", "JobStatus": "Created", "QueuedAt": null, "StartedAt": null, "FinishedAt": null, "NumberOfRecords": null, "FileSize": null, "exportid": null, "status": null, "requestsuccess": null }]
דוגמאות לפעולות על ישויות
בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.
כשמשתמשים בפעולת רשימה ומצפים שנפח הנתונים יהיה גדול, מומלץ לציין פסוקית סינון עבור הישויות הבאות: LeadsLists, LeadPrograms, Activities, LandingPageContentSec, LeadChanges, LeadChangesFields, Emails, LandingPages, Forms, Programs, Leads, LandingPageTemplateCon, OpportunityRoles, SalesPersons, Tokens, ListStaticMemberShip, Opportunities, LeadChangesAttributes ו-Segments. בנוסף, כדי למיין את קבוצת התוצאות, צריך קודם להחיל את סעיף המסנן.
דוגמה – הצגת כל האימיילים
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות 'אימיילים' מהרשימה
Entity. - בוחרים את הפעולה
Listולוחצים על סיום.
דוגמה – קבלת קמפיינים חכמים יחידים
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות 'קמפיינים חכמים' מהרשימה
Entity. - בוחרים את הפעולה
Getולוחצים על סיום. - מגדירים את מזהה הישות ל-Get single SmartCampaigns. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים
1002בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).
דוגמה – מחיקת אימיילים
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות 'אימיילים' מהרשימה
Entity. - בוחרים את הפעולה
Deleteולוחצים על סיום. - מגדירים את מזהה הישות לערך Delete Emails (מחיקת אימיילים). כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים
1048.0בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).
דוגמה – יצירת אימיילים
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות 'אימיילים' מהרשימה
Entity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "Template": 1.0, "FolderId": 1002.0, "Name": "Test Email", "FolderType": "Program" }
Running this example, returns a response similar to the following in the Connector task's
connectorOutputPayloadoutput variable:{ "Id": "1048.0" }
דוגמה – עדכון של EmailTemplates
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות EmailTemplates מהרשימה
Entity. - בוחרים את הפעולה
Updateולוחצים על סיום. - מגדירים את EntityID כדי לעדכן את EmailTemplates. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים
1034.0בשדה שמופיע. - בקטע Data mapper (מיפוי נתונים) של Task (משימה), לוחצים על
OpenDataMappingeditor (עורך) ומזינים ערך דומה לערך הבא ב-field:{ "Name": "temp email updated", "Description": "updation" }
הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
{ "Id": 1034.0 }