יצירת מסע

רלוונטי ל: תובנות לקוח של Dynamics 365

הערה

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

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

מה הוא עושה

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

יצירת הרשומה לא מפרסמת או מתחילה את המסע. בדוק את המסע שנוצר ב-Customer Insights לפני ההפעלה.

נסה הנחיות כמו

• צור מסע תובנות לקוח מתוך המסע המלא הזה, JSON.
• אימות, העשיר וצור את ההגדרה הזו של מסע חד-פעמי.
• צור את המסע הזה לאחר שווידא שהחוזה שלו תקף.

מה שתראו בצ'אט

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

טיפים שימושיים

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

מה קורה הלאה?

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

האם זה משנה את הנתונים?

כן. יכולת זו יוצרת רשומת מסע של תובנות לקוחות.

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

דרישות מוקדמות

כלי זה זמין בשרת Dynamics 365 Customer Insights MCP. מסעות תובנות הלקוחות חייבים להיות מותאמים לסביבה הנבחרת. אתה צריך אישור להריץ את ממשקי ה-API של אימות והעשרת המסע וליצור רשומות מסע. המסע חייב להתייחס לקהל תקף, תוכן, ציות ומזהים קשורים ספציפיים לסביבה.

סיכום הכלים

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

התנהגות כלי

קורא ל-API לאימות מסע Customer Insights API, מעשיר את ההגדרה המקובלת, מאמת את ההגדרה המועשירת ויוצר את הרשומה המתקבלת msdynmkt_journey . כישלונות אימות חוזרים מבלי ליצור רשומה.

ביאורים

ביאור	ערך:	משמעות
readOnlyHint	false	יוצר תיעוד מסע.
destructiveHint	false	יוצר רשומה אך לא מוחק או מחק מסע קיים.
idempotentHint	false	חזרה על בקשה מוצלחת יכולה ליצור מסע נוסף.
openWorldHint	לא הוגדר	משתמש בברירת המחדל כי הוא קורא ל-Customer Insights APIs דרך Dataverse.

מושגי קלט

קלט	תיאור	חובה
journeyJson	הגדרה מלאה של מסע תובנות לקוחות שפורסמה כסדרה כ-JSON.	‏‏כן‬
shouldValidateContract	האם שתי שיחות האימות אמורות לאמת את חוזה הנסיעה. ברירת המחדל היא true.	לא

תגובה והתנהגות ממשק משתמש

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

סוג תגובה

תוצאת יצירת המסע.

התשובה מכילה את מזהה המסע שנוצר ואת תוצאת האימות. הוא לא חושף את ה-JSON המועשר של המסע או המטען של תכונות מותאמות למודל.

הערות ניתוב

שימוש create_journey :

• אימות, העשרה ויצירת מסע מתוך מסע שלם - הגדרת JSON.

אל תשתמש create_journey ב:

• המשתמש רוצה לבדוק את הסכמת הנמען—נתב ל- check_consent.
• המשתמש צריך כתובת URL לביטול הרשמה—נתב ל- get_unsubscribe_link.
• המשתמש רוצה לפרסם, להפעיל, להשהות או למחוק מסע קיים; יכולת זו אינה מבצעת את הפעולות הללו.

כלים קשורים

כלי	מערכת יחסים
check_consent	בודק את הסכמת המקבל לפני תקשורת המסע
get_unsubscribe_link	יוצר קישור ביטול הרשמה תואם להודעת מסע
get_customer_segments	מפרטת קטעים שיכולים לעזור לזהות קהל מסע

סיווג מוטציות נתונים

מוטציה ליצירה בלבד.

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