Παραδείγματα ερωτήματος OData
Σημείωμα
Οι πίνακες Customer Insights - Data είναι επίσης προσπελάσιμοι χρησιμοποιώντας Dataverse API. Συνιστούμε να χρησιμοποιείτε Dataverse API για την υποβολή ερωτημάτων στα δεδομένα του Customer Insights, καθώς αυτά προσφέρουν πιο εκτενές φιλτράρισμα, μεγαλύτερη ταχύτητα μετάδοσης και μικρότερη καθυστέρηση. Για περισσότερες πληροφορίες, ανατρέξτε στα API Dataverse για το Customer Insights.
Το Πρωτόκολλο ανοιχτών δεδομένων (OData) είναι ένα πρωτόκολλο πρόσβασης σε δεδομένα, το οποίο είναι ενσωματωμένο σε κύρια πρωτόκολλα, όπως το HTTP. Χρησιμοποιεί συχνά αποδεκτές μεθοδολογίες όπως το REST για το web. Υπάρχουν διάφορων ειδών βιβλιοθήκες και εργαλεία που μπορούν να χρησιμοποιηθούν για την κατανάλωση των υπηρεσιών OData.
Για να δημιουργήσετε τις δικές σας υλοποιήσεις με βάση τα API του Dynamics 365 Customer Insights - Data, δείτε ορισμένα παραδείγματα ερωτημάτων που ζητούνται συχνά.
Τροποποιήστε τα δείγματα ερωτημάτων για να λειτουργούν στα περιβάλλοντα προορισμού:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}όπου {instanceId} είναι το GUID του Customer Insights - Data περιβάλλοντος που θέλετε να υποβάλετε ερώτημα. Η λειτουργία ListAllInstances σάς επιτρέπει να βρείτε το {InstanceId} στο οποίο έχετε πρόσβαση. - {CID}: GUID μιας ενοποιημένης καρτέλας πελάτη. Παράδειγμα:
ce759201f786d590bf2134bff576c369. - {AlternateKey}: Αναγνωριστικό του πρωτεύοντος κλειδιού μιας καρτέλας πελάτη σε μια προέλευση δεδομένων. Παράδειγμα:
CNTID_1002 - {DSname}: Συμβολοσειρά με το όνομα πίνακα μιας προέλευσης δεδομένων που αποκτά πρόσβαση στο Customer Insights - Data. Παράδειγμα:
Website_contacts. - {SegmentName}: Συμβολοσειρά με το όνομα πίνακα αποτελέσματος ενός τμήματος στο Customer Insights - Data. Παράδειγμα:
Male_under_40.
Πελάτη
Ερωτήματα-δείγματα για τον πίνακα Πελάτης.
| Τύπος ερωτήματος | Παράδειγμα | Σημείωμα |
|---|---|---|
| Μεμονωμένο αναγνωριστικό πελάτη | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' |
|
| Εναλλακτικό κλειδί | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' |
Τα εναλλακτικά κλειδιά διατηρούνται στον ενοποιημένο πίνακα πελάτη |
| Επιλέξτε | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
| σε | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
| Εναλλακτικό κλειδί + σε | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}') |
|
| Αναζήτηση | {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" |
Επιστρέφει τα 10 πρώτα αποτελέσματα για μια συμβολοσειρά αναζήτησης |
| Ιδιότητα μέλους τμήματος | {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 |
Επιστρέφει έναν προκαθορισμένο αριθμό γραμμών από τον πίνακα τμηματοποίησης |
| Τμήμα ιδιότητας μέλους για έναν πελάτη | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') |
Επιστρέφει το προφίλ πελάτη εάν είναι μέλος του συγκεκριμένου τμήματος |
Ενοποιημένη δραστηριότητα
Ερωτήματα-δείγματα για τον πίνακα UnifiedActivity:
| Τύπος ερωτήματος | Παράδειγμα | Σημείωμα |
|---|---|---|
| Δραστηριότητα του CID | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' |
Παραθέτει δραστηριότητες ενός συγκεκριμένου προφίλ πελατών |
| Χρονικό πλαίσιο δραστηριότητας | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityTime gt 2017-01-01T00:00:00.000Z and ActivityTime lt 2020-01-01T00:00:00.000Z |
Δραστηριότητες ενός προφίλ πελάτη σε ένα χρονικό πλαίσιο |
| Τύπος δραστηριότητας | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}' |
|
| Δραστηριότητα κατά εμφανιζόμενο όνομα | {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’ |
|
| Ταξινόμηση δραστηριοτήτων | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc |
Αύξουσα ή φθίνουσα ταξινόμηση δραστηριοτήτων |
| Όλες οι δραστηριότητες και οι ενέργειες για έναν πελάτη | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' |
Οι δραστηριότητες και οι ενέργειες είναι πρόσθετα ζεύγη κλειδιών/τιμών στο προφίλ πελάτη που επιστρέφεται |
Διαχείριση ροών εργασίας
Δείγματα ερωτημάτων που σχετίζονται με διεργασίες στο Customer Insights - Data, όπως προέλευση δεδομένων, ενοποίηση δεδομένων ή λήψη της κατάστασης μιας εργασίας έγκρισης.
| Τύπος ερωτήματος | Παράδειγμα | Σημείωμα |
|---|---|---|
| Λήψη αναγνωριστικών προέλευσης δεδομένων | {serviceRoot}/manage/datasources/v2 |
Επιστρέφει όλες τις προελεύσεις δεδομένων στο περιβάλλον σας. Από την απόκριση, μπορείτε να ελέγξετε το 'friendlyName' για μια συγκεκριμένη προέλευση δεδομένων στη συνέχεια, να χρησιμοποιήσετε το 'dataSourceId'. |
| Ανανέωση μιας προέλευσης δεδομένων | {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true |
Χρησιμοποιήστε το 'dataSourceId' από την παραπάνω απόκριση για να ανανεώσετε μια προέλευση δεδομένων. Αυτό είναι ένα αίτημα POST. |
| Εκτέλεση πλήρους ανανέωσης | {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true |
Ανανεώνει όλες τις διεργασίες στο περιβάλλον σας. Αυτό είναι ένα αίτημα POST. |
| Λήψη κατάστασης διεργασιών | {serviceRoot}/manage/workflows/main/jobs |
Άλλα παραδείγματα
Δείγματα ερωτημάτων για άλλους πίνακες:
| Τύπος ερωτήματος | Παράδειγμα | Σημείωμα |
|---|---|---|
| Μετρήσεις του CID | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
| Εμπλουτισμένες επωνυμίες του CID | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| Εμπλουτισμένα ενδιαφερόντα του CID | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| Όρος In + Ανάπτυξη | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
Περιορισμοί
Το API του Customer Insights επιστρέφει το πολύ έως 100 αντικείμενα από προεπιλογή. Μπορείτε να αναλύσετε πάνω από τα 100 αντικείμενα που έχουν επιστραφεί χρησιμοποιώντας τυπικές τεχνικές σελιδοποίησης. Εναλλακτικά, μπορείτε να εξαγάγετε τα δεδομένα σας.
Τα ακόλουθα ερωτήματα δεν υποστηρίζονται:
-
$filterστους πίνακες προέλευσης που έχουν ληφθεί. Μπορείτε να εκτελέσετε ερωτήματα $filter σε πίνακες συστήματος που δημιουργεί το Customer Insights - Data. -
$expandαπό ένα ερώτημα$search. Για παράδειγμα:Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey". -
$expandαπό$selectεάν έχει επιλεγεί μόνο ένα υποσύνολο χαρακτηριστικών. Για παράδειγμα:Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'. -
$expandεμπλουτισμένες εκδηλώσεις ενδιαφέροντος ή εμπορικής επωνυμίας για ένα δεδομένο πελάτη. Για παράδειγμα:Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'. - Πίνακες εξόδου μοντέλου πρόβλεψης ερωτήματος μέσω εναλλακτικού κλειδιού. Για παράδειγμα:
OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.
-