Sdílet prostřednictvím

Rozhraní API Dataverse pro Customer Insights - Data

  • Článek

Pokud již používáte rozhraní API Customer Insights - Data k dotazování na data, jako je dotaz na profil zákazníka nebo získávání členství v segmentech, doporučujeme namísto toho migrovat rozhraní API na rozhraní API Dataverse. Podpora pro dotazování na metadata, jako je získání definice segmentu a správa pracovních postupů, bude brzy k dispozici pro rozhraní API Dataverse.

Pokud začínáte s dotazováním na data pomocí rozhraní API, doporučujeme místo toho použít rozhraní API Dataverse.

Důležité

Doporučuje se používat rozhraní API Dataverse pouze ke čtení dat (GET) a nikoli k zápisu dat (POST/PATCH/PUT), protože to může způsobit problémy se zpracováním v Customer Insights - Data.

Rozhraní API Dataverse mají následující výhody:

  • Rozšířené možnosti filtrování a řazení

  • Lepší škálování a výkon

  • Konzistentní rozhraní API napříč aplikacemi Dynamics 365 a Power Platform

Vzorové dotazy

Chcete-li začít používat rozhraní API Dataverse, vytvořte registraci aplikace v Azure a požádejte o oprávnění Dataverse a udělejte aplikaci oprávnění prohlížet v Customer Insights - Data.

Ukázky dotazů upravte, aby fungovaly v cílových prostředích:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/, kde {URI organizace} je URI Dataverse tenanta přidruženého k vašemu prostředí. Příklad: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID sjednoceného záznamu zákazníka. Například: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Identifikátor primárního klíče záznamu zákazníka ve zdroji dat. Například: CNTID_1002.

  • {DSname}: Řetězec s názvem tabulky zdroje dat, který se zpracovává v Customer Insights - Data. Například: Website_contacts.

  • {SegmentName}: Řetězec s názvem výstupní tabulky segmentu. Například: Male_under_40.

  • {CookieId}: Identifikátor každého návštěvníka webu, který je automaticky vygenerován při použití skriptu pro sledování webu. Například: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

zákazníku

Vzorové dotazy pro členství v tabulce CustomerProfile a segmentech.

Typ dotazu Příklad Poznámka:
Získat všechny zákazníky {serviceRoot}/msdynci_customerprofiles
Načtení zákazníka podle ID {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Načtení zákazníka podle alternativního klíče {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternativní klíče zůstávají v jednotné tabulce zákazníků ve formátu msdynci_DSname_TableName_PrimaryKeyColumnName
Načíst vybrané atributy pro zákazníka {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Načíst zákazníky podle ID (v) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Načíst zákazníky podle alternativního klíče (v) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Hledat zákazníky {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Načíst všechny zákazníky, kteří jsou členy segmentu {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Načíst zákazníka, pokud je členem segmentu {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Načíst členství zákazníka ve všech skupinách {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Přizpůsobení webu

Ukázkové dotazy k přizpůsobení vašeho webu na základě CookieId. Odpověď vrátí známé i neznámé zákazníky. Tabulky vytvořené pro sledování a personalizaci webu jsou k dispozici v Dataverse.

Typ dotazu Příklad Poznámka:
Načtení zákazníka podle CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Získejte zákazníka pomocí CookieId a zahrňte segmenty, míry, aktivity {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Získejte poslední (posledních 10) zobrazení stránky zákazníka pomocí CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Tento dotaz lze změnit tak, aby vracel až 200 posledních zobrazení stránky
Získejte poslední (posledních 10) kliknutí na stránku zákazníka pomocí CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Tento dotaz lze změnit tak, aby vracel až 200 posledních kliknutí na stránku

Sjednocená aktivita

Vzorové dotazy pro tabulku UnifiedActivity:

Typ dotazu Příklad Poznámka:
Načíst všechny aktivity zákazníka {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Načíst všechny aktivity zákazníka v časovém období {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
Načíst všechny aktivity typu activityType zákazníka {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Načíst všechny aktivity activityDisplayName zákazníka {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Načíst všechny aktivity zákazníka a seřadit je {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Další příklady

Vzorové dotazy pro jiné tabulky:

Typ dotazu Příklad Poznámka:
Načíst všechny míry zákazníka {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Načíst obohacené značky zákazníka {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Načíst obohacené zájmy zákazníka {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Načíst výsledky modelu AI zákazníka {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Další kroky