שתף באמצעות

ממשקי API של Dataverse עבור Customer Insights - Data

  • מאמר

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

אם אתה מתחיל עם שאילתות נתונים באמצעות ממשקי API, אנו ממליצים להשתמש בממשקי API של Dataverse במקום זאת.

חשוב

מומלץ להשתמש בממשקי API של Dataverse רק לקריאת נתונים (GET) ולא לכתיבת נתונים (POST/PATCH/PUT) מכיוון שהם עלולים לגרום לבעיות בעיבוד Customer Insights - Data.

לממשקי API של Dataverse יש את היתרונות הבאים:

  • יכולות מורחבות לסינון ומיון

  • מדרגיות וביצועים משופרים

  • חוויית API עקבית באפליקציות Dynamics 365 ו- Power Platform

שאילתות לדוגמה

כדי להתחיל להשתמש בממשקי API של Dataverse, צור רישום אפליקציה ב- Azure ובקש הרשאות עבור Dataverse והענק הרשאות צפייה באפליקציית Customer Insights - Data שלך.

שנה את דוגמאות השאילתה כדי לגרום להם לעבוד על סביבות היעד:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ היכן ש- { URI של ארגון} הוא URI של דייר Dataverse הקשור לסביבה שלך. לדוגמה: https://{mydvorg}.crm.dynamics.com

  • {CID}: ‏GUID של רשומת לקוח מאוחדת. לדוגמה: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: מזהה של המפתח הראשי של רשומת לקוח במקור נתונים. לדוגמה: CNTID_1002.

  • {DSname}: מחרוזת עם שם הטבלה של מקור נתונים שנכנסת ל- Customer Insights - Data. לדוגמה: Website_contacts.

  • {SegmentName}: מחרוזת עם שם טבלת הפלט של פלח. לדוגמה: Male_under_40.

  • {CookieId}: מזהה עבור כל מבקר באתר. מזהה נוצר באופן אוטומטי בעת שימוש בסקריפט המעקב באינטרנט. לדוגמה: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

לקוח

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

סוג שאילתה דוגמה הערה
קבל את כל הלקוחות {serviceRoot}/msdynci_customerprofiles
קבל לקוח לפי תעודת זהות {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
קבל לקוח על ידי מפתח חלופי {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' מפתחות חלופיים נשארים בטבלת הלקוחות המאוחדת בתבנית msdynci_DSname_TableName_PrimaryKeyColumnName
קבל תכונות נבחרות עבור לקוח {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
קבל לקוחות לפי מזהים (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
קבל לקוחות לפי מפתחות חלופיים (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
חפש לקוחות {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
קבל את כל הלקוחות שחברים בפלח {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
קבל לקוח אם הוא חבר בפלח {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
קבל את כל החברויות בפלחים של לקוח {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

התאמה אישית באינטרנט

שאילתות לדוגמה להתאמה אישית של האתר שלך על סמך ה- CookieId. התגובה מחזירה גם לקוחות ידועים וגם לא ידועים.

סוג שאילתה דוגמה הערה
קבלת לקוח באמצעות CookieId {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}')
קבלת לקוח באמצעות CookieId והכללה של פלחים, מדדים, פעילויות {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
קבלת צפיות אחרונות בדפים (10 האחרונות) של לקוח באמצעות CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) ניתן לשנות הגדרה זו להחזרת עד 200 צפיות בדפים אחרונים
קבלת קליקים אחרונים בדפים (10 האחרונים) של לקוח באמצעות CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) ניתן לשנות הגדרה זו להחזרת עד 200 קליקים בדפים אחרונים

פעילות מאוחדת

שאילתות לדוגמה עבור הטבלה UnifiedActivity.

סוג שאילתה דוגמה הערה
קבל את כל הפעילויות של לקוח {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'
קבל את כל הפעילויות של לקוח בתוך פרק זמן {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-01T00:00:00Z
קבל את כל הפעילויות מסוג activityType של לקוח {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
קבל את כל הפעילויות מסוג activityDisplayName של לקוח {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
קבל את כל הפעילויות של לקוח ומיין אותן {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

דוגמאות אחרות

שאילתות לדוגמה עבור טבלאות אחרות.

סוג שאילתה דוגמה הערה
קבל את כל המדדים של לקוח {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
קבל מותגים מועשרים של לקוח {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
קבל תחומי עניין מועשרים של לקוח {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
קבל תוצאות של מודל AI של לקוח {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

‏‫השלבים הבאים‬