Příklady dotazů OData

Poznámka:

K tabulkám Customer Insights - Data lze také přistupovat pomocí rozhraní API Dataverse. K dotazování na data Customer Insights doporučujeme používat Dataverse API, protože nabízejí rozsáhlejší filtrování, větší propustnost a nižší latenci. Další informace viz Rozhraní API Dataverse pro Customer Insights.

Open Data Protocol (OData) je protokol pro přístup k datům postavený na základních protokolech, jako je HTTP. Využívá běžně přijímané metodiky, jako je REST pro web. Existují různé druhy knihoven a nástrojů, které lze použít ke konzumaci služeb OData.

Na pomoc s vytvářením vlastních implementací založených na Rozhraní API Dynamics 365 Customer Insights - Data se podívejte na některé často požadované vzorové dotazy,.

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

• {serviceRoot}: https://api.ci.ai.dynamics.com/v1/instances/{instanceId}, kde {instanceId} je GUID prostředí Customer Insights - Data, na které se chcete dotazovat. Operace ListAllInstances vám umožní najít {InstanceId}, k níž máte přístup.
• {CID}: GUID sjednoceného záznamu zákazníka. Příklad: ce759201f786d590bf2134bff576c369.
• {AlternateKey}: Identifikátor primárního klíče záznamu zákazníka ve zdroji dat. Příklad: CNTID_1002
• {DSname}: Řetězec s názvem tabulky zdroje dat, který se zpracovává v Customer Insights - Data. Příklad: Website_contacts.
• {SegmentName}: Řetězec s názvem výstupní tabulky segmentu v Customer Insights - Data. Příklad: Male_under_40.

zákazníku

Vzorové dotazy pro tabulku Customer.

Typ dotazu	Příklad	Poznámka:
ID jednoho zákazníka	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'
Alternativní klíč	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}'	Alternativní klíče přetrvávají ve sjednocené tabulce zákazníka
Výběrem	{serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1'
v	{serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’)
Alternativní klíč + v	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}')
Vyhledávat	{serviceRoot}/data/Customer?$top=10&$skip=0&$search="string"	Vrátí 10 nejlepších výsledků pro hledaný řetězec
Členství v segmentu	{serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10	Vrátí přednastavený počet řádků z tabulky segmentace.
Členství zákazníka v segmentu	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}')	Vrátí profil zákazníka, pokud je členem daného segmentu

Sjednocená aktivita

Vzorové dotazy pro tabulku UnifiedActivity:

Typ dotazu	Příklad	Poznámka:
Aktivita CID	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}'	Vypisuje aktivity konkrétního profilu zákazníka
Časový rámec aktivity	{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	Aktivity zákaznického profilu v časovém rámci
Typ aktivity	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}'
Aktivita podle zobrazovaného jména	{serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’
Třídění aktivity	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc	Řazení aktivit ve vzestupném nebo sestupném pořadí
Veškeré aktivity a míry pro zákazníka	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}'	Aktivity a míry jsou další páry klíč/hodnota ve vráceném profilu zákazníka

Správa pracovních postupů

Ukázkové dotazy týkající se procesů v Customer Insights - Data, jako je obnovení zdroje dat, sjednocení dat nebo získání stavu sjednocovací úlohy.

Typ dotazu	Příklad	Poznámka:
Získat ID zdroje dat	{serviceRoot}/manage/datasources/v2	Vrátí všechny zdroje dat ve vašem prostředí. Z odpovědi můžete zkontrolovat 'friendlyName' pro konkrétní zdroj dat a poté použít jeho 'dataSourceId'.
Aktualizace zdroje dat	{serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true	Pomocí 'dataSourceId' z výše uvedené odpovědi obnovte zdroj dat. Toto je žádost POST
Spustit úplnou aktualizaci	{serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true	Aktualizuje procesy ve vašem prostředí. Toto je žádost POST
Získat stav procesů	{serviceRoot}/manage/workflows/main/jobs

Další příklady

Vzorové dotazy pro jiné tabulky:

Typ dotazu	Příklad	Poznámka:
Míry CID	{serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}'
Obohacené značky CID	{serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
Rozšířené zájmy CID	{serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
In-klauzule + Rozbalit	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}')

Omezení

• Customer Insights API ve výchozím nastavení vrací maximálně 100 objektů. Pomocí standardních technik stránkování můžete analyzovat více než 100 vrácených objektů. Případně můžete exportovat svá data.

• Následující dotazy nejsou podporovány:

  • $filter na přijatých zdrojových tabulkách. Dotazy $filter můžete spouštět pouze na systémové tabulky, které vytvoří Customer Insights - Data.
  • $expand z dotazu $search. Například: Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey".
  • $expand z $select, pokud je vybrána pouze podmnožina atributů. Například: Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.
  • $expand obohacené značky nebo afinity zájmu pro daného zákazníka. Například: Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'.
  • Dotaz na výstupní tabulky predikčního modelu prostřednictvím alternativního klíče. Například: OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.