استخدم التطبيق الأصلي لإثراء بيانات العملاء
يستطيع تطبيق GenderAPI لمتجر Shopify معالجة العملاء الحاليين والجدد، وإضافة تقدير للجنس، واستنتاج الاسم الأول المفقود من عنوان البريد الإلكتروني. ابدأ من متجر Shopify الصحيح واختر الإعدادات المناسبة لحقول العملاء التي تريد تحديثها.
هذا تطبيق Shopify أصلي له إعدادات معالجة وخطة خاصة به. لا يستدعي التنفيذ الذي رُوجع في 27 سبتمبر 2026 نقطة النهاية العامة للتقدير في V2. لا تفترض أن رصيد مفتاح API لديك أو خيارات الذكاء الاصطناعي في V2 أو حقول استجابة V2 تنطبق على هذا التطبيق.
جهّز المتجر وقرّر ما الذي سيتغير
- افتح Gender API - Determine gender في Shopify App Store. تحقّق من الناشر Ozan Soft والمتجر المستهدف والأذونات الحالية والخطة قبل التثبيت.
- راجع رصيد التطبيق وإعدادات معالجة العملاء فيه. قرّر ما إذا كنت ستعالج العملاء الحاليين، أو تفعّل المعالجة التلقائية للعملاء الجدد، أو الأمرين معًا.
- راجع مجموعة صغيرة من سجلات العملاء تتضمن أسماء أولى مُدخلة وأسماء مفقودة ومُدخلات ملتبسة. أبقِ الأسماء والوسوم الحالية ظاهرة أثناء مراجعة النتائج.
- فعّل إكمال الأسماء الأولى المفقودة فقط إذا أردت أن يُكتب اسم مرشّح مُستنتج من عنوان البريد الإلكتروني في حقل الاسم الأول للعميل. تقدير الجنس وتعديل الاسم قراران منفصلان.
- تحقّق من الوسوم التي أُنشئت ومن حقل metafield الخاص بالعميل قبل استخدامها في شريحة. تأكد من أن معلومات العميل الأخرى بقيت دون تغيير.
افهم حقول العملاء التي يستخدمها التطبيق
تصف عمليات الربط التالية الشيفرة المصدرية للتطبيق التي رُوجعت. تحقّق منها في التطبيق المثبّت وعلى عيّنة مضبوطة قبل ربط أي سير عمل لاحق.
| حقل العميل أو الإعداد | الاتجاه | السلوك |
|---|---|---|
| الاسم الأول | مُدخل | المُدخل المفضّل عند وجود اسم أول. |
| البريد الإلكتروني | مُدخل | يُستخدم لاستنتاج اسم مرشّح عندما يكون الاسم الأول مفقودًا؛ وقد يبقى العنوان الذي لا يتضمن اسمًا صالحًا غير محسوم. |
| بلد العنوان | سياق اختياري | قد تستخدم المعالجة بلد عنوان العميل المتاح سياقًا للبحث عن الاسم. |
| وسوم العميل | مُخرج | يستخدم التنفيذ الذي رُوجع male أو female أو gender_null، ويحتفظ بالوسوم غير ذات الصلة. |
| custom.gender | مُخرج | حقل metafield للعميل يحتوي على التصنيف المُستنتج كقيمة نصية من سطر واحد. |
| تحديث الاسم الأول | مُخرج اختياري | عند تفعيل هذه الميزة، قد يملأ اسم مرشّح مُستنتج من عنوان البريد الإلكتروني الاسم الأول المفقود؛ ويضيف التنفيذ first_name_found_from_email. |
| الإثراء التلقائي | إعداد التطبيق | يتحكم في معالجة أحداث العملاء الجدد؛ ويعتمد توفره على الخطة وإعدادات التطبيق. |
راجع الوسوم والنتائج غير المعروفة والتصنيفات الموجودة
افتح عميلًا تمت معالجته في Shopify وقارن وسومه وcustom.gender والاسم الأول بالسجل الأصلي. استخدم في الشريحة الحقل والتصنيف المحفوظين فعليًا، بدلًا من افتراض توفر مسار JSON من API.
يتخطى سير العمل الذي رُوجع العملاء الذين يحملون مسبقًا الوسم male أو female أو gender_null. لذلك قد يشير السجل الذي لم يتغير إلى تصنيف موجود وليس إلى بحث جديد. قرّر كيف ستراجع التصنيفات السابقة قبل بدء تشغيل جديد.
تعامل مع gender_null على أنه نتيجة غير محسومة. لا توفر عمليات الربط الأصلية قيمة درجة الثقة من V2، ولا حقل المصدر، ولا سجل usage لكل طلب. لا تختلق هذه القيم في تصدير جدول البيانات، ولا تحوّل النتيجة غير المعروفة إلى تصنيف ثنائي.
| النتيجة | الخطوة التالية المقترحة |
|---|---|
| الوسوم وحقل metafield المتوقعة | تحقّق من معرّف العميل المصدر واسمح فقط بالشريحة أو التحديث اللاحق المخطط له. |
| gender_null | اترك الحالة غير محسومة واستبعدها من القواعد التي تتطلب نتيجة identified. |
| وسم جنس موجود مسبقًا | تحقّق مما إذا كان التطبيق قد تخطى العميل قبل أن تقرر إعادة المعالجة. |
| تحديث مفقود أو غير متسق | تحقّق من حالة المعالجة في التطبيق قبل إعادة تشغيل المجموعة كاملة. |
تحقّق من خطة التطبيق والوصول إلى البيانات
راجع حدود معالجة العملاء في شاشة الخطة والرصيد الحالية لتطبيق Shopify. للتطبيق الذي رُوجع رصيد أرصدة لكل متجر، وتتم عمليات الشراء فيه عبر Shopify؛ ولا يُضبط بمفتاح API عام من GenderAPI. تحقّق من الأسعار الحالية في صفحة التطبيق بدلًا من تطبيق أسعار أرصدة V2.
يحتاج التطبيق إلى الوصول إلى بيانات العملاء وقد يعدّل سجلاتهم. وتتضمن المعالجة قائمة انتظار من جهة التطبيق. لذلك لا ينبغي قراءة الإرشادات المتعلقة بالاحتفاظ بطلبات البريد الإلكتروني على أنها وعد بعدم تخزين أي بيانات للعملاء إطلاقًا في سير العمل هذا. راجع أذونات التطبيق والسياسة المنشورة لمتجرك.
التصنيف المُستنتج إشارة تقديرية في البيانات. أبقِه منفصلًا عن المعلومات التي يقدمها الشخص بنفسه، ولا تستخدمه أساسًا وحيدًا لقرارات الأهلية أو الوصول أو التسعير أو غيرها من القرارات ذات العواقب المهمة.
استخدم V2 عندما تحتاج إلى استجابة منظّمة
للتكامل المخصّص، تقبل GenderAPI V2 الأسماء وعناوين البريد الإلكتروني وأسماء المستخدمين، وتعيد حقولًا صريحة للنتيجة ودرجة الثقة والمصدر والاستهلاك. اضبط ذلك الاتصال بشكل منفصل؛ فقراءة دليل V2 لا تغيّر التطبيق المثبّت ولا أعمدة مُخرجاته.
تغطي أمثلة Python وNode.js الطلبات الفردية والطلبات المجمّعة ونتائج unknown والأخطاء التشغيلية. ابدأ بدليل المصادقة واختر وضع الذكاء الاصطناعي قبل إرسال طلب تُخصم عليه الأرصدة.
الأسئلة الشائعة
هل أضبط تطبيق Shopify باستخدام مفتاح API الخاص بي في V2؟
يعتمد التطبيق الأصلي الذي رُوجع على التثبيت في Shopify وعلى إعدادات خطة خاصة به ورصيد لكل متجر. سير العمل المخصّص عبر HTTP مع V2 تكامل منفصل، ولا يحل محل إعدادات التطبيق الأصلي.
أين أجد التصنيف المُستنتج للعميل؟
يكتب التطبيق الذي رُوجع وسوم العميل وحقل metafield الخاص بالعميل custom.gender. راجع التطبيق المثبّت وعميلًا نموذجيًا قبل إنشاء شرائح مبنية على هذه القيم.
ماذا تعني القيمة gender_null؟
تشير هذه القيمة إلى تصنيف غير محسوم في التطبيق الأصلي الذي رُوجع. أبقِ ذلك العميل ضمن مجموعة النتائج غير المعروفة بدلًا من تحويل القيمة إلى male أو female.
هل يمكنني ترك الأسماء الأولى للعملاء دون تغيير؟
راجع إعداد إكمال الأسماء الأولى المفقودة بمعزل عن معالجة الجنس. فعّله فقط إذا أردت أن يملأ التطبيق الاسم الأول المفقود باسم مرشّح مُستنتج من عنوان البريد الإلكتروني.
المصادر والوثائق
رُوجع هذا الدليل آخر مرة في . تحقّق من طريقة التثبيت في وثائق المنصة، واستخدم وثائق API أدناه لبناء تكامل V2 منفصل.