Salesforce Marketing Cloud

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

לפני שמתחילים

לפני שמשתמשים במחבר Salesforce Marketing Cloud, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

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

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Salesforce Marketing Cloud מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אפשר גם להזין תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud logging ובוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

      צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר טרנזקציות לחיבור מסוים, צריך יותר צמתים, ולהפך – כדי לעבד פחות טרנזקציות, צריך פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.

    8. ‫API Integration Type: סוג ההרשאה לתהליך OAuth. הערכים הקבילים הם Server-to-Server ו-Web-App.
    9. מזהה החשבון: מזהה החשבון או מזהה ה-MID של היחידה העסקית שאליה מכוונים.
    10. הצגת תוספים של נתוני חשבונות צאצא: הצגת תוספים של נתוני חשבונות צאצא אם הם מוגדרים.
    11. מופע: המופע של Salesforce Marketing Cloud API שבו נעשה שימוש.
    12. ‫List Data Extensions: ערך בוליאני שקובע אם תוספי נתונים יוצגו כטבלאות או לא.
    13. שאילתה בכל החשבונות: שאילתה בכל החשבונות, כולל החשבון הראשי וכל החשבונות המשניים, לגבי אירוע מסוים.
    14. סכימה: מציינים את גרסת השרת של Salesforce Marketing Cloud שאליו רוצים להתחבר.
    15. תת-דומיין: תת-הדומיין של Salesforce Marketing Cloud API.
    16. שימוש באימות מדור קודם: ערך בוליאני שקובע אם החיבור צריך להתבצע ל-Salesforce Marketing Cloud API בארכיטקטורת REST באמצעות אימות מדור קודם או לא.
    17. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
      • סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. יש תמיכה בסוגי האימות הבאים:
        • בסיסי: אימות HTTP בסיסי.
        • ‫Digest: אימות HTTP מסוג Digest.
      • משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
      • סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
      • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. יש תמיכה בסוגי האימות הבאים:
        • ‫Auto (אוטומטי): הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
        • תמיד: החיבור תמיד מופעל באמצעות SSL.
        • לעולם לא: החיבור לא מופעל באמצעות SSL.
        • מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
      • בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
        1. לוחצים על + הוספת יעד.
        2. בוחרים סוג יעד.
          • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

            כדי ליצור חיבור פרטי למערכת העורפית, פועלים לפי השלבים הבאים:

    18. אם רוצים, אפשר ללחוץ על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    19. לוחצים על הבא.
  5. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Salesforce Marketing Cloud תומך בסוגי האימות הבאים:

      • שם משתמש וסיסמה
      • ‫OAuth 2.0 – פרטי כניסה של לקוח
      • ‫OAuth 2.0 – קוד הרשאה

        • כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    2. לוחצים על הבא.
  6. בדיקה: בודקים את פרטי החיבור והאימות.
  7. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

  • שם משתמש וסיסמה
    • שם משתמש: שם המשתמש של המחבר
    • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.
  • ‫OAuth 2.0 – פרטי לקוח
    • Client ID: מזהה הלקוח של האפליקציה שיצרתם.
    • סוד הלקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
    • גרסת הסוד: הגרסה של סוד הלקוח.
  • OAuth 2.0 – קוד הרשאה
    • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
    • ‫Scopes: רשימה מופרדת בפסיקים של ההיקפים הרצויים.
    • סוד הלקוח: סוד הלקוח שמשמש לבקשת אסימוני גישה.
    • גרסת הסוד: הגרסה של סוד הלקוח.
    • כתובת URL לאישור: כתובת ה-URL לאישור שנוצרת כשיוצרים לקוח.

הגדרת Salesforce Marketing Cloud

כדי להגדיר את Salesforce Marketing Cloud, מתחברים לחשבון קיים או יוצרים חשבון חדש באמצעות הכניסה ל-Salesforce Marketing Cloud. מידע על תמיכה בקהילה ומידע נוסף זמין ב-Trailblazer Community. מידע על Salesforce Marketing Cloud REST APIs זמין במאמר Salesforce Marketing Cloud REST API. מידע על Salesforce Marketing Cloud SOAP API זמין במאמר בנושא SOAP APIs.

יצירת לקוח API

  1. בדף הפרופיל שלכם ב-Salesforce Marketing Cloud, לוחצים על הגדרה.
  2. בחלונית הימנית, בוחרים באפשרות Installed Packages (חבילות מותקנות) ואז לוחצים על New (חדש).
  3. מזינים שם ותיאור לשילוב.
  4. בוחרים באפשרות Server-to-Server (שרת-אל-שרת) בתור סוג השילוב.
  5. לוחצים על Save.

    6. תוכלו לראות את מזהה הלקוח, סוד הלקוח, כתובת ה-URL הבסיסית של SOAP, כתובת ה-URL הבסיסית של REST ופרטים נוספים.

אימות בסיסי – סוג החיבור

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

שם השדה פרטים
מיקום us-east1
מחבר ‫Salesforce Marketing Cloud
גרסת המחבר 1
שם החיבור sfmcconn1
תיאור ‫SOAP - סיסמת משתמש
הפעלת Cloud Logging כן
חשבון השירות service-account@my-project.iam.gserviceaccount.com
סוג שילוב ה-API שרת לשרת
סכימה SOAP
מספר חשבון ACCOUNT_ID
הצגת נתוני תוספים משוכפלים כן
Instance s11
הצגת רשימה של תוספי נתונים כן
רמת הפירוט 5
תת-דומיין SUBDOMAIN
שם משתמש שם משתמש
סיסמה PASSWORD
גרסה של סוד 1

OAuth 2.0 – סוג החיבור

בטבלה הבאה מפורטים ערכי ההגדרה לדוגמה של סוג החיבור OAuth 2.0 client credentials.

שם השדה פרטים
מיקום us-east1
מחבר ‫Salesforce Marketing Cloud
גרסת המחבר 1
שם החיבור sfmc-rest-conn
הפעלת Cloud Logging לא
חשבון השירות service-account@my-project.iam.gserviceaccount.com
סוג שילוב ה-API שרת לשרת
סכימה REST
מספר חשבון ACCOUNT_ID
הצגת נתוני תוספים משוכפלים כן
Instance s11
הצגת רשימה של תוספי נתונים כן
שליחת שאילתות לכל החשבונות כן
רמת הפירוט 4
תת-דומיין SUBDOMAIN
מזהה לקוח CLIENT_ID
סוד לקוח CLIENT_SECRET
גרסה של סוד 1

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

  • פעולה: פעולה היא הפעילות שאפשר לבצע על ישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

    בחירה של ישות מתוך הרשימה הזמינה יוצרת רשימה של פעולות שזמינות לישות. תיאור מפורט של הפעולות זמין במאמר פעולות על ישויות של משימת המחברים. עם זאת, אם מחבר לא תומך באף אחת מהפעולות על ישויות, הפעולות הלא נתמכות האלה לא יופיעו ברשימה Operations.

  • פעולה: פעולה היא פונקציה מסוג first class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. בדרך כלל, לפעולה יהיו כמה פרמטרים של קלט ופרמטר של פלט. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

מגבלות המערכת

מחבר Salesforce Marketing Cloud יכול לעבד עד 7 עסקאות בשנייה, לכל צומת, ומגביל את כל העסקאות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

פעולות

בקטע הזה מפורטות כל הפעולות שנתמכות בחיבור ל-Salesforce Marketing Cloud.

פעולת GetJourneyPublicationStatus

הפעולה הזו מקבלת את הסטטוס של פרסום מסלול המשתמש.

פרמטרים של קלט לפעולה GetJourneyPublicationStatus

שם הפרמטר סוג הנתונים חובה תיאור
StatusId מחרוזת True המזהה של הסטטוס של פרסום מסלול המרה.

פרמטרים של הפלט של הפעולה GetJourneyPublicationStatus

הפעולה הזו מחזירה את הסטטוס 200 (OK) עם גוף תגובה שמציין את כל התוצאות.

דוגמה להגדרת הפעולה GetJourneyPublicationStatus מופיעה במאמר דוגמאות.

פעולה של FireEntryEvent

מפעילים את אירוע הכניסה שמתחיל את המסע.

פרמטרים של קלט לפעולה FireEntryEvent

שם הפרמטר סוג הנתונים חובה תיאור
ContactKey String True המזהה שמזהה באופן ייחודי מנוי או איש קשר
EventDefinitionKey String True אחרי שיוצרים ושומרים את האירוע, אפשר למצוא את EventDefinitionKey ב-Event Administration. הדבר נכון גם לאירועים רגילים וגם לאירועים בהתאמה אישית. אל תכללו נקודה במפתח של הגדרת האירוע.
נתונים String לא נכון מאפייני האירוע. חובה רק אם הפרמטר מוגדר באירוע מותאם אישית או באירוע.

פרמטרים של הפלט של הפעולה FireEntryEvent

הפעולה הזו מחזירה את הסטטוס 200 (OK) עם גוף תגובה שמציין את כל התוצאות

דוגמה להגדרת הפעולה FireEntryEvent מופיעה במאמר דוגמאות.

פעולה מסוג StopJourney

הפסקת מסלול פעיל

פרמטרים של קלט לפעולה StopJourney

שם הפרמטר סוג הנתונים חובה תיאור
JourneyId String True המזהה של המסלול להפסיק, בפורמט GUID (UUID)
JourneyVersion מספר שלם True מספר הגרסה של הנסיעה להפסקה

פרמטרים של פלט של הפעולה StopJourney

הפעולה הזו מחזירה את הסטטוס 200 (OK) עם גוף תגובה שמציין את כל התוצאות

דוגמה להגדרת הפעולה StopJourney מופיעה במאמר דוגמאות.

פעולה של PublishJourney

הפעולה PublishJourney מפרסמת גרסה של מסלול לקוח באופן אסינכרוני

פרמטרים של קלט לפעולה PublishJourney

שם הפרמטר סוג הנתונים חובה תיאור
JourneyId String True המזהה של המסלול להפסיק, בפורמט GUID (UUID).
JourneyVersion מספר שלם True מספר הגרסה של הנסיעה שרוצים להפסיק.

פרמטרים של פלט של הפעולה PublishJourney

הפעולה הזו מחזירה את הסטטוס 200 (OK) עם גוף תגובה שמציין את כל התוצאות

דוגמה להגדרת הפעולה PublishJourney מופיעה במאמר דוגמאות.

יצירת פעולה מסוג CreateTriggeredSend

הפעולה CreateTriggeredSend יוצרת אובייקט של שליחה מופעלת שמייצג מופע ספציפי של שליחת אימייל מופעלת

פרמטרים של קלט לפעולה CreateTriggeredSend

שם הפרמטר סוג הנתונים חובה תיאור
מפתח String לא נכון הגדרת שליחה אוטומטית משויכת לשליחה אוטומטית. המאפיין הזה תואם למפתח החיצוני שמוקצה לאובייקט ב-Marketing Cloud.
SendId String לא נכון המזהה של הגדרת שליחת אירוע הכניסה שמגיע מהתגובה כשיוצרים TriggeredSendDefinition. צריך לציין את המפתח הזה או את המפתח החיצוני.
FromAddress String לא נכון כתובת האימייל שתופיע כשולח.
FromName String לא נכון שם השולח
ToAddress String True כתובת האימייל של הנמען של ההודעה.
SubscriberKey String True מזהה ייחודי שמוגדר עבור נמען ההודעה.
SubscriberAttributes String לא נכון זוגות של שם וערך של מאפייני מנוי שהוגדרו להודעה.
RequestType String לא נכון הערכים החוקיים הם ASYNC ו-SYNC. ערך ברירת המחדל אם לא מוגדר הוא ASYNC. קובעת אם הבקשה תעובד באופן אסינכרוני.

פרמטרים של הפלט של הפעולה CreateTriggeredSend

הפעולה הזו מחזירה את הסטטוס 200 (OK) עם גוף תגובה שמציין את כל התוצאות

דוגמה להגדרת הפעולה CreateTriggeredSend מופיעה במאמר דוגמאות.

פעולת שליחת הודעה טרנזקציונלית לנמען

פעולת SendTransactionalMessageToRecipient שולחת הודעה לנמען יחיד באמצעות הגדרת שליחה

פרמטרים של קלט לפעולה SendTransactionalMessageToRecipient

שם הפרמטר סוג הנתונים חובה תיאור
MessageKey String True מזהה הודעה שהוגדר על ידי המשתמש.
DefinitionKey String True מזהה ייחודי של ההגדרה.
RecipientContactKey String True מזהה ייחודי של מנוי ב-Marketing Cloud. כל בקשה חייבת לכלול contactKey. אתם יכולים להשתמש במפתח מנוי קיים או ליצור מפתח כזה בזמן השליחה באמצעות כתובת האימייל של הנמען
RecipientTo String לא נכון כתובת הערוץ של הנמען. באימייל, זו כתובת האימייל של הנמען
מאפיינים String לא נכון מידע שמשמש להתאמה אישית של ההודעה לנמען. הם נכתבים כצמדי מפתח/ערך. המאפיינים תואמים למאפייני הפרופיל, למאפייני התוכן או למאפיינים של תוסף נתונים של שליחה מופעלת

פרמטרים של פלט של הפעולה SendTransactionalMessageToRecipient

הפעולה הזו מחזירה את הסטטוס 200 (OK) עם גוף תגובה שמציין את כל התוצאות

דוגמה להגדרת הפעולה SendTransactionalMessageToRecipient מופיעה במאמר דוגמאות.

דוגמאות לפעולות

בקטע הזה מוסבר איך לבצע חלק מהפעולות במחבר הזה.

דוגמה – קבלת הסטטוס של פרסום מסע

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה GetJourneyPublicationStatus ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "StatusId": "3acf1f54-5c9e-4719-b7f7-bfc2e5caf10a"
}

    4. אם הפעולה תצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

     [{
  "Status": "PublishCompleted",
  "Message": null
}]

דוגמה – הפעלת אירוע כניסה כדי להתחיל תהליך

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה FireEntryEvent ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "ContactKey": "Email",
  "EventDefinitionKey": "APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c",
  "Data": "{\"Email\": \"usr1@test.com\"}"
}

    4. אם הפעולה תצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

     [{
  "EventInstanceId": "0d6f6dd1-1aaa-4eec-9727-f99550ab68f9"
}]

דוגמה – הפסקת תהליך פעיל

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה StopJourney ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "JourneyId": "37D2789E-2B1D-433E-8E18-8F47E4D8E865",
  "JourneyVersion": 1.0
}

    4. אם הפעולה תצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

      [{
  "Success": true
}]

דוגמה – פרסום גרסה של תהליך

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה PublishJourney ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "JourneyId": "0868BF36-3107-460E-9EF1-09633A0592E8",
  "JourneyVersion": 1.0
}

    4. אם הפעולה תצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

     [{
  "StatusId": "acb1734d-483e-400a-97d7-0501b94f03b2"
}]

דוגמה – יצירת טריגר להפעלת מסע

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה CreateTriggeredSend ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Key": "BU27_SendDefinition1",
  "ToAddress": "usr1@test.com",
  "SubscriberKey": "107",
  "SubscriberAttributes": "{\"FirstName\": \"John\", \"LastName\": \"P\"}"
}

    4. אם הפעולה תצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

     [{
  "Success": "True",
  "RecipientSendId": "5d06edb1-d07c-48ad-a1f2-d6350eb863f8",
  "Messages": "Queued"
}]

דוגמה – שליחת הודעה לנמען אחד

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה SendTransactionalMessageToRecipient ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "MessageKey": "T9999009",
  "DefinitionKey": "Send-Definition-SFMC-Demo-2",
  "RecipientContactKey": "107",
  "RecipientTo": "usr1@test.com",
  "Attributes": "FirstName :John"
}

    4. אם הפעולה תצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

    [{
  "RequestId": "d8fb9e9e-3ae2-412f-b01e-d198433cfc16"
}]

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

פעולות נתמכות על ישויות

בקטע הזה מפורטות פעולות הישות שנתמכות על ידי המחבר Salesforce Marketing Cloud, ומוסבר איך לבצע חלק מפעולות הישות במחבר הזה.

ישות פעולה
DataExtensionObject_Custom List, Get, Delete, Create, Update
קמפיין List, Get, Delete
CampaignAssets List, Get, Delete
מסלולים List, Get, Delete, Create, Update
רשימה רשימה, יצירה, עדכון
אתר חדשות רשימה
מנוי רשימה, יצירה
SubscriberList רשימה
ListSubscriber רשימה
JourneyActivities Get, Delete
קמפיינים יצירה
נכסים List, Get, Delete, Create, Update

דוגמה – רשימת כל הנכסים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Assets מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. בקטע Task Input (קלט למשימה) של המשימה Connectors (מחברים), אפשר להגדיר את filterClause (סעיף מסנן) בהתאם לדרישות הלקוח.

    5. חובה להשתמש במירכאות בודדות (') כדי להקיף את הערך של פסוקית סינון, והערך צריך להיות מועבר ישירות, כמו CategoryName='Content Builder'. בדוגמה הזו, CategoryName הוא שם העמודה ו-Content Builder הוא הערך.

    אפשר להשתמש בסעיף המסנן כדי לסנן רשומות על סמך העמודות. לדוגמה, כדי לסנן רשומות, משתמשים בפסוקית הסינון הבאה: Location='US' and region='us-east1'

    במקרים מסוימים, העברת מזהה ישות עלולה להוביל לשגיאה. במקרים כאלה, אפשר להשתמש בפסוקית filter, כמו id=172.

דוגמה – קבלת רשומת נכסים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Assets מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את מזהה הישות ל-49851.0, שהוא המפתח שיועבר. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים 49851.0 בשדה Default Value.

    את הערך של Entity ID צריך להעביר ישירות, למשל Id= 49851.0. בדוגמה הזו, 49851.0 הוא הערך הייחודי של המפתח הראשי, וצריך להעביר אותו.

דוגמה – מחיקת רשומה של נכס

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Assets מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את מזהה הישות ל-49851.0, שהוא המפתח שצריך להעביר. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על EntityId ואז מזינים 49851.0 בשדה Default Value.

    הערך של מזהה הישות צריך להיות מועבר ישירות, למשל ID= 49851.0. בדוגמה הזו, 49851.0 הוא הערך הייחודי של המפתח הראשי, וצריך להעביר אותו.

דוגמה – יצירת רשומה של DataExtensionObject_Custom

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות DataExtensionObject_Custom מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"StudentName":"Cruz",
"StudentID":"1",
"Rank":"1"}

    אם השילוב יצליח, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

    {
  "StudentID": 1
}

דוגמה – יצירה של רשומת נכסים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Assets מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Name": "Googlecloud_Created_HTMLEmail_Testing_V1",
  "TypeName": "htmlemail",
  "TypeId": 208.0
}

    אם השילוב יצליח, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

    {
  "Id": 60188.0
}

דוגמה – יצירת רשומה של קמפיינים

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Campaigns מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Name": "Campaigns - Tested via Googlecloud",
  "CampaignCode": "annual2023",
  "Color": "0000ff",
  "Favorite": false
}

    אם השילוב יצליח, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

    {
  "Id": 247.0
}

דוגמה – יצירת רשומה של מסלולי המרה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Journeys מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Version": 1.0,
  "Name": "API_Journey_Googlecloud_Retest_1",
  "CreatedDate": "2023-04-26 04:20:29.87",
  "ModifiedDate": "2023-05-10 07:45:06.04",
  "LastPublishedDate": "2023-04-26 04:37:18.0",
  "Description": "API_Journey_Googlecloud_Retest_1",
  "WorkFlowApiVersion": 1.0,
  "Tags": null,
  "Goals": "",
  "Triggers": "[{\"id\": \"c79154a3-a0d2-435e-a6ad-bed46474620a\", \"key\": \"TRIGGER\", \"name\": \"API_Journey_Googlecloud\", \"description\": \"\", \"type\": \"APIEvent\", \"outcomes\": [], \"arguments\": {\"startActivityKey\": \"{Context.StartActivityKey}\", \"dequeueReason\": \"{Context.DequeueReason}\", \"lastExecutedActivityKey\": \"{Context.LastExecutedActivityKey}\", \"filterResult\": \"true\"}, \"configurationArguments\": {\"schemaVersionId\": 0, \"criteria\": \"\", \"filterDefinitionId\": \"00000000-0000-0000-0000-000000000000\"}, \"metaData\": {\"sourceInteractionId\": \"00000000-0000-0000-0000-000000000000\", \"eventDefinitionId\": \"8153cf00-ebf6-4c18-b52f-573eb724df87\", \"eventDefinitionKey\": \"APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c\", \"chainType\": \"None\", \"configurationRequired\": false, \"iconUrl\": \"/images/icon_journeyBuilder-event-api-blue.svg\", \"title\": \"\", \"entrySourceGroupConfigUrl\": \"jb:///data/entry/api-event/entrysourcegroupconfig.json\"}}",
  "Defaults": "[{\"email\": [\"{Event.APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c.\"Email"}\"], \"properties\": {\"analyticsTracking\": {\"enabled\": false, \"analyticsType\": \"google\", \"urlDomainsToTrack\": []}}}]"
}

    אם השילוב יצליח, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

    {
  "Id": "aa03afe4-6a28-481f-bec4-564712127414"
}

דוגמה – יצירת רשומת רשימה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות List מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "ID": "04052023.0",
  "ObjectID": "82349658-b482-404f-8c67-e555aadee0f4",
  "PartnerKey": "null",
  "CreatedDate": "2023-03-16 10:52:48.097",
  "ModifiedDate": "2023-03-17 10:30:34.497",
  "Client_ID": "5.14012689E8",
  "Client_PartnerClientKey": null,
  "ListName": "Googlecloud_Created_Subscriber_List",
  "Description": "null",
  "Category": "15449.0",
  "Type": "Public",
  "CustomerKey": "Googlecloud_BCONE",
  "ListClassification": "ExactTargetList",
  "AutomatedEmail_ID": "null"
}

    אם השילוב יצליח, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

    {
  "Id": 4052023.0
}

דוגמה – יצירת רשומת מינוי

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Subscriber מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "EmailAddress": "baklavainthebalkans@gmail.com",
  "SubscriberKey": "KB1"
}

    אם השילוב יצליח, פרמטר התגובה connectorOutputPayload של משימת המחבר יקבל ערך שדומה לזה:

    {
  "Success": true
}

דוגמה – עדכון של רשומה מסוג DataExtensionObject_Custom

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות DataExtensionObject_Custom מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"StudentName":"Charlie",
"Rank":"1"
}
  5. מגדירים את מזהה הישות לערך כמו 103032, שהוא המפתח הראשי שיועבר. כדי להגדיר את מזהה הישות, בקטע Task Input של המשימה Connectors, לוחצים על entityId ואז מזינים 10 בשדה Default Value.

    אם לישות יש מפתחות עסקיים או מפתחות ראשיים מורכבים, במקום לציין את entityId, אפשר גם להגדיר את filterClause ל-Rank='1' and StudentID='10'.

    6. אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    {
    "StudentID": 1
}

דוגמה – עדכון רשומה של נכס

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות 'נכסים' מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Description": "June2023-Updated"
}
  5. מגדירים את מזהה הישות לישות של הנכסים . כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים 52080 בשדה Default Value.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    {
  "Id": 52080.0
}

דוגמה – עדכון רשומה של תהליך

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Journeys מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
}
  5. מגדירים את מזהה הישות לישות של Journeys . כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים 0868BF36-3107-460E-9EF1-09633A0592E8 בשדה Default Value.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    {
  "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
}

דוגמה – עדכון רשומה של רשימה

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות List מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
  "Description": "UpdatedDescription"
}
  5. מגדירים את מזהה הישות לישות של הרשימה . כדי להגדיר את מזהה הישות, לוחצים על entityId ואז מזינים 1234 בשדה Default Value.

    אם השילוב יצליח, לפרמטר התגובה connectorOutputPayload של משימת המחבר יהיה ערך שדומה לזה:

    {
  "ID": 1234.0
}

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

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

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:

שם הפרמטר סוג נתונים חובה תיאור
apiintegration_type ENUM לא נכון סוג ההרשאה לתהליך OAuth. הערכים הקבילים הם Server-to-Server ו-Web-App. הערכים הנתמכים הם: Server-to-Server, Web-App
סכימה ENUM True מציינים את ממשקי ה-API של Salesforce Marketing Cloud שאליהם רוצים להתחבר. הערכים הנתמכים הם: REST, ‏ SOAP
account_id מחרוזת לא נכון מזהה החשבון או MID של היחידה העסקית של היעד.
display_child_data_extensions בוליאני לא נכון אם הוגדרו הרחבות נתונים בחשבונות צאצא, הן יוצגו.
מכונה מחרוזת לא נכון המופע של Salesforce Marketing Cloud API שבו נעשה שימוש. הערה: אם המופע גדול מ-s10, צריך לציין את שם תת-הדומיין.
list_data_extensions בוליאני לא נכון ערך בוליאני שקובע אם תוספי נתונים יוצגו כטבלאות או לא.
query_all_accounts בוליאני לא נכון שאילתה לגבי אירוע מסוים בכל החשבונות, כולל החשבון הראשי וכל החשבונות המשניים.
דרגת מלל מחרוזת לא נכון רמת המלל של החיבור, משתנה מ-1 עד 5. רמת פירוט גבוהה יותר תתעד את כל פרטי התקשורת (בקשה,תגובה ואישורי SSL).
תת-דומיין מחרוזת לא נכון תת-הדומיין של Salesforce Marketing Cloud API.
proxy_enabled בוליאני לא נכון מסמנים את תיבת הסימון הזו כדי להגדיר שרת Proxy לחיבור.
proxy_auth_scheme ENUM לא נכון סוג האימות שמשמש לאימות לשרת ה-proxy‏ ProxyServer. הערכים הנתמכים הם: BASIC, ‏ DIGEST, ‏ NONE
proxy_user מחרוזת לא נכון שם משתמש שישמש לאימות בשרת ה-proxy ‏ProxyServer.
proxy_password SECRET לא נכון סיסמה שתשמש לאימות בשרת ה-proxy‏ ProxyServer.
proxy_ssltype ENUM לא נכון סוג ה-SSL שבו צריך להשתמש כשמתחברים לשרת ה-proxy של ProxyServer. הערכים הנתמכים הם: AUTO, ‏ ALWAYS, ‏ NEVER, ‏ TUNNEL

שימוש בחיבור Salesforce Marketing Cloud בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור באינטגרציה באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת Connectors ב-Application Integration זמין במאמר משימת Connectors.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים