แชร์ผ่าน

Dataverse API สำหรับ Customer Insights - Data

  • บทความ

หากคุณใช้ Customer Insights - Data API อยู่แล้ว เช่น ค้นหาโปรไฟล์ลูกค้าหรือรับการเป็นสมาชิกเซ็กเมนต์ เราขอแนะนำให้คุณย้าย API ของคุณไปที่ Dataverse API แทน การสนับสนุนสำหรับการสอบถามเมตาดาต้า เช่น รับการกำหนดเซ็กเมนต์และการจัดการเวิร์กโฟลว์กำลังจะมาถึงเร็วๆ นี้ใน Dataverse API

หากคุณเริ่มต้นการสอบถามข้อมูลโดยใช้ API เราขอแนะนำให้ใช้ Dataverse API แทน

สำคัญ

ขอแนะนำให้ใช้ Dataverse API เพื่ออ่านข้อมูล (GET) เท่านั้น และไม่เขียนข้อมูล (POST/PATCH/PUT) เนื่องจากอาจทำให้เกิดปัญหากับการประมวลผล Customer Insights - Data

Dataverse API มีข้อดีดังต่อไปนี้:

  • ความสามารถเพิ่มเติมสำหรับการกรองและการเรียงลำดับ

  • ปรับปรุงขนาดและประสิทธิภาพ

  • ประสบการณ์ API ที่สอดคล้องกันทั่วทั้งแอป Dynamics 365 และ Power Platform

การสอบถามตัวอย่าง

หากต้องการเริ่มต้นใช้งาน Dataverse API สร้างการลงทะเบียนแอปพลิเคชันใน 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}: ตัวระบุสําหรับผู้เยี่ยมชมเว็บไซต์แต่ละรายซึ่งสร้างขึ้นโดยอัตโนมัติเมื่อใช้สคริปต์การติดตามเว็บ ตัวอย่างเช่น: 3f43317e-d1ef-4cd3-9917-2d3342111d1a

ลูกค้า

ตัวอย่างการสอบถามสำหรับตาราง โปรไฟล์ลูกค้า และการเป็นสมาชิกเซ็กเมนต์

ชนิดการสอบถาม ตัวอย่าง หมายเหตุ
รับลูกค้าทั้งหมด {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}'
รับลูกค้าตามรหัส (เข้า) {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 การตอบกลับจะส่งคืนทั้ง ลูกค้าที่รู้จักและไม่รู้จัก ตารางที่สร้างสำหรับการติดตามเว็บและการตั้งค่าส่วนบุคคลมีอยู่ใน 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

กิจกรรมแบบรวม

ตัวอย่างคิวรีสำหรับตาราง 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'

ขั้นตอนถัดไป