مشاركة عبر

واجهات API لتطبيق Dataverse في Customer Insights - Data

  • مقالة

إذا كنت تستخدم واجهات API لـ Customer Insights - Data، للاستعلام عن ملف تعريف العميل أو الحصول على عضويات الشرائح، فإننا نوصى بأن تقوم بترحيل واجهات APIs الخاصة بك إلى واجهات API لـ Dataverse بدلاً من ذلك. سيتم قريبا الوصول إلى دعم بيانات التعريف للاستعلام، مثل الحصول على تعريف المقطع وإدارة سير Dataverse العمل.

إذا كنت تقوم ببدء الاستعلام عن البيانات باستخدام واجهات برمجة التطبيقات ، فإننا نوصي باستخدام واجهات برمجة التطبيقات ( Dataverse APIs) بدلا من ذلك.

مهم

من المستحسن استخدام واجهات API لـ Dataverse لقراءة البيانات (GET) فقط وليس لكتابة البيانات (POST/PATCH/PUT) حيث يمكن أن تتسبب 1لك في حدوث مشاكل تتعلق بمعالجة Customer Insights - Data.

تتسم واجهات API لـ Dataverse بالميزات التالية:

  • إمكانات موسرة للتصفية والفرز

  • مقياس وأداء محسنين

  • تجربة API متسقة عبر Dynamics 365 وتطبيق Power Platform .

نماذج الاستعلامات

لبدء استخدام واجهات API لـ Dataverse، أنشئ تسجيل تطبيق في Azure واطلب أذونات لـ Dataverse وعارض التطبيق أذونات على Customer Insights - Data.

قم بتعديل نماذج الاستعلام لجعلها تعمل في البيئات المستهدفة:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ حيث {Organization 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}: معرف لكل زائر موقع ويب. يتم إنشاؤه تلقائيًا عند استخدام البرنامج النصي لتعقب الويب. على سبيل المثال: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

العميل

عينة استعلامات لمائدة CustomerProfile وعضويات الشرائح.

نوع الاستعلام مثال ‏‫ملاحظة‬
الحصول على كل العملاء. {serviceRoot}/msdynci_customerprofiles
الحصول على عميل عن طريق الم ID {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}'
الحصول على العملاء حسب الم IDs (في) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
احصل على العملاء عن طريق المفاتيح البديلة (في) {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

تخصيص الويب

عينة استعلامات لتخصيص موقعك على الويب بالاستناد إلى CookieId. يعيد الرد العملاء المعروفين وغير المعروفين.

نوع الاستعلام مثال ‏‫ملاحظة
الحصول على عميل بواسطة CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
الحصول على عميل بواسطة CookieId وتضمين الشرائح والقياسات والأنشطة {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
الحصول على أحدث طرق عرض لصفحة (آخر عشر) عميل من خلال CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) يمكن تغيير ذلك لإرجاع إلى ما يصل إلى 200 من طرق عرض الصفحات الأخيرة
الحصول على أحدث النقرات على صفحة (آخر عشر) عميل من خلال CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) يمكن تغيير ذلك لإرجاع إلى ما يصل إلى 200 من النقرات على الصفحات الأخيرة

النشاط الموحد

نموذج استعلامات جدول UnifiedActivity.

نوع الاستعلام مثال ‏‫ملاحظة‬
احصل على جميع أنشطة العميل {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
الحصول على كافة أنشطة العميل خلال فترة زمنية {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
الحصول على كافة أنشطة نوع نشاط عميل {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

أمثلة أخرى

نموذج استعلامات لجداول أخرى.

نوع الاستعلام مثال ‏‫ملاحظة‬
احصل على جميع مقاييس العميل {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'
الحصول الذكاء الاصطناعي نموذج نتائج نموذج العميل {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

الخطوات التالية