Deli putem

Dataverse API-ji za Customer Insights - Data

  • Članak

Ako već koristite Customer Insights - Data API-je, kao što je upit korisničkog profila ili dobijanje članstva u segment-u, preporučujemo da umesto toga migrirate svoje API-je na Dataverse API-je. Podrška za upite metapodataka, kao što su definicija segment i upravljanje radnim procesom, uskoro dolazi API-jima Dataverse .

Ako započinjete sa upitima podataka pomoću API-ja, preporučujemo da umesto toga koristite Dataverse API-je.

Važno

Preporučuje se da koristite Dataverse API-je samo za čitanje podataka (GET), a ne za pisanje podataka (POST / PATCH / PUT) jer to može izazvati probleme sa Customer Insights - Data obradom.

Dataverse API-ji imaju sledeće prednosti:

  • Proširene mogućnosti za filtriranje i sortiranje

  • Poboljšana skala i performanse

  • Konzistentno API iskustvo u Dynamics 365 i Power Platform aplikacijama

Primeri upita

Da biste započeli sa korišćenjem Dataverse API-ja, kreirajte registraciju aplikacije u Azure-u i zatražite dozvole za Dataverse i dodelite dozvole Customer Insights - Data za pregledač aplikacije.

Izmenite uzorke upita da bi oni radili na ciljnim okruženjima:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ gde je URI {organizacije URI stanara povezanog} sa Dataverse vašim okruženjem. Na primer: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID jedinstvenog zapisa o klijentima. Na primer: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Identifikator primarnog ključa zapisa klijenta u izvoru podataka. Na primer: CNTID_1002.

  • {DSname}: String sa imenom tabele izvor podataka koji se unosi Customer Insights - Data. Na primer: Website_contacts.

  • {SegmentName}: String sa imenom izlazne tabele segment. Na primer: Male_under_40.

  • {CookieId}: Identifikator za svakog posetioca veb sajta. Ovo se automatski generiše kada se koristi skripta zapraćenje veba. Na primer: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

klijentu

Primeri upita za tabelu CustomerProfile i članstvo u segmentu.

Tip upita Primer Belešku
Nabavite sve kupce {serviceRoot}/msdynci_customerprofiles
Nabavite kupca po ID-u {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Nabavite kupca Alternativni ključ {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternativni tasteri ostaju u jedinstvenoj tabeli kupaca u formatu msdynci_DSname_TableName_PrimaryKeyColumnName
Nabavite izabrane atribute za kupca {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Dobijajte kupce po ID-ovima (U) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Dobijte kupce po alternativnim ključevima (u) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Pretraga klijenata {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Nabavite sve kupce koji su članovi segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Nabavite kupca ako je član segment {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Nabavite sva članstva u segment kupca {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Veb personalizacija

Primeri upita za personalizaciju vašeg veb sajta na osnovu CookieId-a. Odgovor vraća i poznate i nepoznate kupce.

Tip upita Primer Belešku
Nabavite klijenta putem CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Nabavite kupca pomoću CookieId-a i uključite segmente, mere, aktivnosti {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Nabavite nedavne (poslednje KSNUMKS) prikaze stranica klijenta od strane CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Ovo se može promeniti da se vrati do 200 nedavnih prikaza stranica
Nabavite nedavne (poslednje KSNUMKS) klikove na stranicu klijenta od strane CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Ovo se može promeniti da se vrati do 200 nedavnih klikova na stranicu

Objedinjena aktivnost

Primeri upita za tabelu UnifiedActiviti .

Tip upita Primer Belešku
Nabavite sve aktivnosti kupca {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Nabavite sve aktivnosti kupca u određenom vremenskom periodu {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-01T00:00:00Z
Nabavite sve aktivnosti aktivnostiTip klijenta {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Nabavite sve aktivnosti activitiDisplaiName kupca {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Nabavite sve aktivnosti kupca i sortirajte ih {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Drugi primeri

Primeri upita za druge tabele.

Tip upita Primer Belešku
Nabavite sve mere kupca {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Nabavite obogaćene brendove kupca {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Obogaćite interese kupca {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Nabavite rezultate AI modela kupca {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Sledeći koraci