Κοινή χρήση μέσω

Dataverse API για το Customer Insights - Data

  • Άρθρο

Αν χρησιμοποιείτε ήδη API του Customer Insights - Data για να υποβάλετε ερωτήματα για δεδομένα, όπως να υποβάλετε ερωτήματα σε ένα προφίλ πελάτη ή να λάβετε συμμετοχές σε τμήμα αγοράς, συνιστούμε να μετεγκαταστήσετε τα API σας στα Dataverse API. Η υποστήριξη για την υποβολή ερωτημάτων για μετα-δεδομένα, όπως λήψη ορισμού τμήματος αγοράς και διαχείρισης ροής εργασιών, θα είναι σύντομα δυνατή στα API Dataverse.

Εάν έχετε γρήγορα αποτελέσματα με την υποβολή ερωτημάτων για δεδομένα χρησιμοποιώντας API, συνιστούμε να χρησιμοποιήσετε αντί για αυτό τα API Dataverse.

Σημαντικό

Συνιστάται η χρήση API Dataverse μόνο για την ανάγνωση δεδομένων (GET) και όχι για τη σύνταξη δεδομένων (POST/PATCH/PUT), καθώς ενδέχεται να προκαλέσει προβλήματα κατά την επεξεργασία του Customer Insights - Data.

Τα Dataverse API έχουν τα ακόλουθα πλεονεκτήματα:

  • Εκτεταμένες δυνατότητες για φιλτράρισμα και ταξινόμηση

  • Βελτιωμένη κλίμακα και επιδόσεις

  • Συνεπής εμπειρία 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}: Αναγνωριστικό για κάθε επισκέπτη της τοποθεσίας web, το οποίο δημιουργείται αυτόματα κατά τη χρήση της δέσμης ενεργειών παρακολούθησης web. Για παράδειγμα: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Πελάτη

Δείγματα ερωτημάτων για τον πίνακα CustomerProfile και τις συμμετοχές σε τμήμα αγοράς.

Τύπος ερωτήματος Παράδειγμα Σημείωμα
Λήψη όλων των πελατών {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

Εξατομίκευση Web

Δείγματα ερωτημάτων για την εξατομίκευση της τοποθεσίας Web με βάση το CookieId. Η απόκριση επιστρέφει τόσο γνωστούς όσο και άγνωστους πελάτες. Οι πίνακες που δημιουργήθηκαν για παρακολούθηση ιστού και εξατομίκευση είναι διαθέσιμοι στο Dataverse.

Τύπος ερωτήματος Παράδειγμα Σημείωμα
Λήψη πελάτη κατά CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Αποκτήστε έναν πελάτη μέσω CookieId και συμπεριλάβετε τμήματα, μετρήσεις, δραστηριότητες {serviceRoot}/msdynci_p13nprofile(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 πρόσφατα κλικ σελίδας
Λήψη όλων των δραστηριοτήτων ενός πελάτη {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Λήψη όλων των δραστηριοτήτων ενός πελάτη εντός χρονικής περιόδου {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-01T00:00:00Z
Λήψη όλων των δραστηριοτήτων μιας τιμής activityType ενός πελάτη {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Λήψη όλων των δραστηριοτήτων μιας τιμής activityDisplayName ενός πελάτη {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Λήψη όλων των δραστηριοτήτων ενός πελάτη και ταξινόμησή τους {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Ενοποιημένη δραστηριότητα

Εάν η εξατομίκευση Web δεν χρησιμοποιείται, δείγματα ερωτημάτων για τον πίνακα UnifiedActivity.

Τύπος ερωτήματος Παράδειγμα Σημείωμα
Λήψη όλων των δραστηριοτήτων ενός πελάτη {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'
Λήψη όλων των δραστηριοτήτων ενός πελάτη εντός χρονικής περιόδου {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-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'

Επόμενα βήματα