ตรวจหารถเข็นที่ถูกละทิ้งและส่งการแจ้งเตือนให้ลูกค้า

2023-03-08

บทความนี้จะอธิบายวิธีการปรับแต่งแอปตัวอย่างของตัวเชื่อมต่อรถเข็นที่ละทิ้งของ Microsoft Dynamics 365 Commerce เพื่อตรวจหารถเข็นที่ถูกละทิ้งและส่งการแจ้งเตือนทางอีเมลสำหรับเตือนความจำให้กับลูกค้า

ความสามารถในการกู้คืนรายได้และรักษาลูกค้าผ่านการแจ้งเตือนรถเข็นที่ถูกละทิ้งเป็นความสามารถที่สำคัญที่ Dynamics 365 Commerce รองรับ ด้วยการปรับแต่งแอปตัวอย่างของตัวเชื่อมต่อรถเข็นที่ละทิ้งของ Commerce ผู้ค้าปลีกสามารถเข้าถึงรถเข็นซื้อของบน Retail Server ที่ยังไม่ได้แก้ไขในระหว่างกรอบเวลาที่ผู้ค้าปลีกกําหนด รถเข็นเหล่านั้นสามารถเรียกดู เสริมด้วยข้อมูลผลิตภัณฑ์และลูกค้า และส่งต่อไปยังผู้ให้บริการการตลาดทางอีเมลบุคคลที่สาม ซึ่งสามารถสร้างการแจ้งเตือนทางอีเมลและส่งให้กับลูกค้าได้

การแจ้งเตือนทางอีเมลของรถเข็นที่ละทิ้งซึ่งลูกค้าได้รับสามารถมีข้อมูลต่อไปนี้:

ชื่อของลูกค้า
นามสกุลของลูกค้า
ที่อยู่อีเมลของลูกค้า
URL ที่ส่งลูกค้ากลับไปยังรถเข็น
สกุลเงินของธุรกรรม
รายการผลิตภัณฑ์ในรถเข็นของลูกค้า สำหรับผลิตภัณฑ์แต่ละอย่าง จะมีข้อมูลต่อไปนี้:
- ชื่อที่แสดงของผลิตภัณฑ์
- รหัสผลิตภัณฑ์ (ใช้เพื่อรวบรวม URL ไปยังหน้ารายละเอียดผลิตภัณฑ์)
- รูปภาพของผลิตภัณฑ์ที่สามารถปรับขนาดโดยอัตโนมัติเพื่อรองรับขนาดมุมมองที่ต่างกัน
- ข้อความแสดงแทนสำหรับรูปภาพผลิตภัณฑ์
- ราคาต่อหน่วยของผลิตภัณฑ์

ตัวอย่างตัวเชื่อมต่อรถเข็นที่ละทิ้ง

แบบจำลองตัวเชื่อมต่อที่ Microsoft จัดหาผ่านชุดการพัฒนาซอฟต์แวร์ Retail (SDK) ช่วยให้สามารถเรียกข้อมูลรถเข็นที่ถูกละทิ้งและส่งไปยังผู้ให้บริการด้านการตลาดทางอีเมลของบุคคลที่สาม ตัวเชื่อมต่อนี้จัดการกับการสื่อสารกับ Retail Server ใช้ Azure Key Vault เพื่อความปลอดภัย จัดการการจัดกำหนดการของการเรียกข้อมูลรถเข็นเพื่อเปิดกรอบเวลาที่ระบุ และเรียกข้อมูลใบสั่งและผลิตภัณฑ์ นอกจากนี้ ยังมีการใช้งานตัวอย่างสำหรับการรวมกับผู้ให้บริการการตลาดทางอีเมลของบุคคลที่สามด้วย ตัวเชื่อมต่อถูกสร้างขึ้นเพื่อสื่อสารกับ Emarsys ในแบบสำเร็จรูป อย่างไรก็ตาม คุณสามารถปรับแต่งเพื่อรวมกับโซลูชันอื่นๆ เช่น Constant Contact, Mailchimp และ SendGrid ได้อย่างง่ายดาย

ภาพประกอบต่อไปนี้แสดงส่วนประกอบของแอปตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้ง

ส่วนประกอบของแอปตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้ง

สำคัญ

บางภูมิภาคต้องการให้ลูกค้าสามารถเลือกไม่แสดงข้อมูลรถเข็นของตนผ่านไปยังผู้ให้บริการการตลาดทางอีเมล หรือร้องขอให้ลบข้อมูลออก แต่ Microsoft ไม่มีตัวเลือกเหล่านี้ให้กับลูกค้า ดังนั้น หากคุณวางแผนที่จะทำธุรกิจในภูมิภาคที่กำหนดตัวเลือกนี้ คุณต้องจัดเตรียมโครงสร้างพื้นฐานที่จำเป็นและการปรับแต่งเพื่อติดตามการกำหนดลักษณะของลูกค้า และป้องกันไม่ให้ข้อมูลลูกค้าถูกส่งไปยังแพลตฟอร์มอีเมลของคุณ คุณต้องกําหนดกระบวนการลบข้อมูลลูกค้าจากผู้ให้บริการการตลาดทางอีเมลของคุณตามการร้องขอของลูกค้าด้วย

ขอรับโค้ดตัวอย่าง

แอปตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งรวมอยู่ใน Retail SDK เป็นรุ่น 10.0.16 โค้ดมีอยู่ใน \RetailSDK\Code\SampleExtensions\RetailServer\Extensions.AbandonedCartSample สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Retail SDK และวิธีการขอรับ ดูที่ ชุดการพัฒนาซอฟต์แวร์ (SDK) ของ Retail

หมายเหตุ

แม้ว่าโค้ดตัวอย่างจะเปิดใช้งานครั้งแรกในรุ่น 10.0.16 แต่โค้ดก็จะเข้ากันได้กับรุ่น 10.0.13 และที่ใหม่กว่าของ Retail Server

ข้อกำหนดเบื้องต้นและการขึ้นต่อกัน

ก่อนที่คุณจะสามารถปรับใช้และตั้งค่าคอนฟิกโค้ดตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้ง ต้องเป็นไปตามข้อกําหนดเบื้องต้นต่อไปนี้

เข้าถึงทรัพยากร Commerce

เมื่อต้องการตั้งค่าคอนฟิกและปรับใช้แอปตัวเชื่อมต่อรถเข็นที่ละทิ้ง คุณต้องมีสิทธิ์เข้าถึงทรัพยากร Commerce ต่อไปนี้

ผู้ดูแลระบบเข้าถึงศูนย์ควบคุม Commerce สำหรับสภาพแวดล้อมของคุณ
เข้าถึงโครงการ Microsoft Dynamics Lifecycle Services (LCS) สำหรับสภาพแวดล้อมของคุณ

Azure Cosmos DB

แอปตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งใช้ Azure Cosmos DB เพื่อติดตามรหัสและเวลาประทับของรถเข็นที่มีการเรียกข้อมูลก่อนหน้านี้ คุณสามารถใช้ Azure Cosmos DB เพื่อเก็บข้อมูลนี้ต่อไป หรือคุณสามารถเลือกปรับแต่งตัวอย่างของโค้ดเพื่อรวมกับตัวเลือกที่จัดเก็บข้อมูลอื่นได้ หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับ Azure Cosmos DB ดูที่ ยินดีต้อนรับสู่ Azure Cosmos DB

หากคุณใช้ Azure Cosmos DB คุณสมบัติต้องตรงข้อกำหนดเบื้องต้นต่อไปนี้คุณจึงจะสามารถเรียกใช้ตัวอย่างได้:

คุณต้องมีบัญชี Azure Cosmos DB ที่ใช้งานอยู่ หากคุณไม่มีบัญชี ดูที่ สร้างบัญชีฐานข้อมูล
คุณต้องเรียกดูค่า URI และ PRIMARY KEY (หรือ SECONDARY KEY) จากเบลด คีย์ ของบัญชี Azure Cosmos DB ในพอร์ทัล Azure หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเรียกข้อมูลปลายทางและคีย์ของบัญชี Azure Cosmos DB ของคุณ ดูที่ ดู คัดลอก และสร้างคีย์การเข้าถึงและรหัสผ่านใหม่

Azure Key Vault

แอปตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งใช้ Key Vault เพื่อจัดเก็บชื่อและข้อมูลลับของส่วนประกอบต่างๆ ที่ต้องมีการเข้าถึงที่ปลอดภัย

หากต้องการตั้งค่า Key Vault ให้ทำตามขั้นตอนเหล่านี้

ปฏิบัติตามคำแนะนำใน จัดการ Key Vault ใน Azure Stack Hub โดยใช้พอร์ทัล
สร้างข้อมูลลับสำหรับข้อมูลต่อไปนี้
- ชื่อผู้ใช้และข้อมูลลับของ API ใน Emarsys Application Programming Interface (API)
- รหัสและข้อมูลลับของแอปพลิเคชันรถเข็นที่ถูกละทิ้ง

โค้ดตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งจะใช้ข้อมูลประจำตัวเริ่มต้นของ Azure เพื่อเข้าถึง Key Vault คุณต้องให้สิทธิ์ของ รายการ และ อ่าน กับข้อมูลประจำตัวที่คุณวางแผนจะใช้เข้าถึง Key Vault

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลประจำตัวเริ่มต้นของ Azure ดูที่ คลาส DefaultAzureCredential

สร้างรหัสแอปพลิเคชันของแอปตัวอย่างตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งสำหรับผู้เช่า Azure AD

คุณต้องสร้างรหัสแอปพลิเคชันของแอปตัวอย่างตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งสำหรับผู้เช่า Azure Active Directory (AD) สำหรับข้อมูลเกี่ยวกับวิธีการสร้างรหัสแอปพลิเคชัน ดูที่ ใช้พอร์ทัลเพื่อสร้างแอปพลิเคชัน Azure AD และผู้ใช้งานบริการที่สามารถเข้าถึงทรัพยากร

เพิ่มรหัสแอปพลิเคชันตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งไปยังรายการอนุญาตสำหรับ Retail Server API

จากนั้น คุณต้องเพิ่มรหัสแอปพลิเคชันตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้งไปยังรายการอนุญาตสำหรับ Retail Server API สำหรับข้อมูลเกี่ยวกับวิธีการเพิ่มรหัสแอปพลิเคชันไปยังรายการอนุญาตใน Azure ดูที่ การสนับสนุนการรับรองความถูกต้องของบริการกับบริการใน Retail Server

ตั้งค่าคอนฟิกแอปตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้ง

เมื่อต้องการตั้งค่าคอนฟิกแอปตัวอย่างของตัวเชื่อมต่อรถเข็นที่ถูกละทิ้ง ให้แก้ไขไฟล์การตั้งค่าคอนฟิก appSettings.json ที่อยู่ที่ระดับรากของไดเรกทอรี AbandonedCartDetectionSample ตารางต่อไปนี้อธิบายคุณสมบัติของไฟล์การตั้งค่าคอนฟิก

KeyVaultOptions

คุณสมบัติ	คำอธิบาย
KeyVaultURI	ชื่อ Domain Name System (DNS) ของ Key Vault ที่คุณใช้งานในพอร์ทัล Azure

RetailServerClientOptions

คุณสมบัติ	คำอธิบาย
TenantId	รหัสผู้เช่า Azure AD ของผู้เช่า Azure ของคุณ
RetailServerAudienceId	รหัสผู้ชม Retail Server คุณสามารถปล่อยค่าเริ่มต้นไว้ได้
AppIdKeyVaultSecretName	ชื่อของข้อมูลลับที่คุณสร้างสำหรับรหัสแอปพลิเคชันของแอปตัวอย่างตัวเชื่อมต่อรถเข็นที่ถูกละทิ้ง
AppSecretKeyVaultSecretName	ชื่อของข้อมูลลับที่คุณจัดเก็บข้อมูลลับของแอปสำหรับรหัสแอปพลิเคชันของแอปตัวอย่างตัวเชื่อมต่อรถเข็นที่ถูกละทิ้ง
RetailServerUrl	URL ของอินสแตนซ์ Retail Server ของคุณ คุณสามารถค้นหาค่านี้ใน LCS
หมายเลขหน่วยปฏิบัติงาน	หมายเลขหน่วยปฏิบัติงาน (OUN) คุณสามารถค้นหาค่านี้ในศูนย์ควบคุม Commerce
IncludeAbandonedCartsModifiedSinceLastMinutes	จุดเริ่มต้นของกรอบเวลาในรถเข็นที่ถูกละทิ้งซึ่งคุณต้องการเรียกข้อมูล ค่าจะแสดงเป็นเป็นจำนวนนาทีก่อนเวลาปัจจุบัน ตัวอย่างเช่น ตั้งค่าคุณสมบัตินี้เป็น 120 เพื่อเรียกข้อมูลรถเข็นทั้งหมดที่แก้ไขครั้งล่าสุดระหว่าง 120 นาทีที่ผ่านมา และการสิ้นสุดของกรอบเวลาที่กําหนดโดยคุณสมบัติ ExcludeAbandonedCartsModifiedSinceLastMinutes
ExcludeAbandonedCartsModifiedSinceLastMinutes	จุดสิ้นสุดของกรอบเวลาในรถเข็นที่ถูกละทิ้งซึ่งคุณต้องการเรียกข้อมูล ค่าจะแสดงเป็นเป็นจำนวนนาทีก่อนเวลาปัจจุบัน ตัวอย่างเช่น หากคุณสมบัติ IncludeAbandonedCartsModifiedSinceLastMinutes ตั้งค่าเป็น 120 ตั้งค่าคุณสมบัตินี้เป็น 30 เพื่อเรียกข้อมูลรถเข็นทั้งหมดที่แก้ไขระหว่าง 120 นาทีที่ผ่านมาและ 30 นาทีที่ผ่านมา ในทางปฏิบัติ คุณสมบัตินี้จะกําหนดจํานวนเวลาที่คุณต้องการรอก่อนที่จะประกาศว่ารถเข็นถูกละทิ้ง
ReturnToCartUrl	URL ของรถเข็นบนไซต์อีคอมเมิร์ซของคุณในรูปแบบที่ใช้ในไฟล์ app.config

AzureCosmosOptions

สถานะงานการเรียกข้อมูลรถเข็นที่ถูกละทิ้ง รหัสรถเข็น และการประทับเวลาที่มีการแก้ไขถูกจัดเก็บอยู่ใน Azure Cosmos DB ตามค่าเริ่มต้น การตั้งค่าในไฟล์การตั้งค่าคอนฟิกจะชี้ไปที่อินสแตนซ์ตัวเลียนแบบเฉพาะภายในของ Azure Cosmos DB เมื่อคุณปรับใช้ตัวเชื่อมต่อกับการทำงานจริง คุณต้องอัปเดตการตั้งค่าเหล่านี้เพื่อให้ชี้ไปที่อินสแตนซ์ Azure Cosmos DB ในการสมัครใช้งาน Azure ของคุณ สำหรับการทดสอบแบบภายในหรือ sandbox คุณสามารถใช้ Azure Cosmos DB Emulator

คุณสมบัติ	คำอธิบาย
EndPointUri	URI ปลายทางที่จัดหาโดย Azure หรือตัวเลียนแบบ
PrimaryKey	คีย์หลักที่จัดหาโดย Azure หรือตัวเลียนแบบ
DatabaseId	รหัสฐานข้อมูล คุณสามารถปล่อยค่าเริ่มต้นไว้หรือระบุด้วยตนเอง
ContainerId	รหัสคอนเทนเนอร์ คุณสามารถปล่อยค่าเริ่มต้นไว้หรือระบุด้วยตนเอง

EmarsysClientOptions