تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.
تاريخ تحديث المصدر باللغة الإنجليزية: ‏٢١‏/١٠‏/٢٠٢٢

نظرة عامة

نوصي بقراءة هذا الدليل بتمعن والدمج مع أكبر عدد ممكن من واجهات API التجارة؛ بشكل مثالي مع كل العناصر ذات الصلة بحالة الاستخدام لديك.

نطاق دور المطوّر

بصفتك مطورًا، فأنت على الأرجح تندرج ضمن إحدى هذه الفئات:

  • البائع: أنت جزء من شركة تجارة إلكترونية توفر مجموعة تقنية مخصصة وتريد الدمج مع واجهات API التجارة من Meta لتمكين متجر واحد (أو مجموعة من المتاجر) للعمل باستخدام تقنيات Meta.

  • الشريك/موفر الخدمات الفنية: أنت جزء من شركة منصة تجارة إلكترونية أو شركة تقدم خدمات برمجية لأنشطة تجارية موجودة في مجال التجارة الإلكترونية ولكن ليس لديها متجر خاص بها (يشار إليها إجمالاً كموفر خدمات فنية تجارية أو شريك) وتريد الدمج مع واجهات API التجارة نيابةً عن المتاجر المتعددة المدعومة بواسطة المنصة.

في كلتا الفئتين، سيكون لجودة الدمج تأثيرًا هادفًا عندما يتفاعل عملاؤك مع المنتجات والمتاجر التي تدار من خلال واجهات API التجارة التي نوفرها. يركز هذا الدليل بالتحديد على مساعدة المطوّرين الشركاء الذين يريدون:

  • الدمج مع واجهات API التجارة.

  • الحصول على نظرة عامة و"فهم أكبر" لكل العناصر التي تلعب دورًا في إنشاء عملية دمج عالية الجودة مع واجهات API التجارة من Meta.

  • معرفة كيف يمكن أن يؤدي الدمج إلى نتائج إيجابية للنشاط التجاري: العثور على عملاء جدد وإتمام المزيد من المبيعات والاستفادة من إعلانات Meta بشكل ناجح لتحقيق النتائج ذاتها.

الاعتبارات المرتبطة بدور المشتري

يتمتع المشترون بمعايير عالية للغاية عندما يتعلق الأمر باتخاذ قرارات الشراء. حيث يبحثون عن أكبر كم من المعلومات حول المنتجات التي يفكرون في شرائها. ويريدون التوصل إلى اتفاق جيد، كما يتوقعون العثور على الخصومات والعروض الترويجية ذاتها في المتجر تمامًا مثلما يعثرون عليها في موقع الويب لدى البائع. يحتاج المشترون إلى الحصول على تحديثات فورية حول الطلب الذي قدموه، مع معلومات دقيقة حول الشحن والتتبع والمرتجعات.

يُعد توفير كل من هذه العناصر إلى Meta أمرًا أساسيًا لتحسين معدلات تحويل المشتري من خلال المتاجر.

دفق المطوّر عالي المستوى

في Meta، نسمح للمطوّرين التابعين لجهة خارجية بإنشاء الأنظمة يمكن دمجها مع منصات Instagram وفيسبوك عبر مجموعة من نقاط نهاية API التجارة، والتي تشكل معًا جزءًا من واجهة Graph API. نوضح هنا دفق المطوّر عالي المستوى والمكونات المستخدمة في إنشاء دمج API التجارة عالي الجودة.

المتطلبات الأساسية

  • يجب أن يتوفر نشاط تجاري تم إعداده والتحقق منه على Meta

  • يجب التوقيع على العقود التجارية المطلوبة، بما في ذلك تعديل موفر الخدمات الفنية والشروط التكميلية

  • يجب أن تكون على دراية بمفاهيم واجهة Graph API، وهي الطريقة الأساسية لقراءة البيانات من منصة التجارة لدى Meta والكتابة فيها

الخطوة الأولى: إنشاء تطبيق المطوّر

لإرسال طلبات إلى نقاط نهاية واجهة Graph API هذه، يجب أولاً إنشاء تطبيق في بوابة Meta للمطوّرين. في هذا السياق، يمثل التطبيق مجموعة من الإمكانات التي يمكن لبرنامج الجهة الخارجية لديك الوصول إليها على أنظمة Meta. يرتبط كل استدعاء API ترسله على أنظمة Meta بهذا التطبيق وتحدد الإمكانات أي API ستعمل على استدعاء البرنامج الذي يمكنك الوصول إليه. يرتبط هذا التطبيق بكيان نشاطك التجاري على Meta. تم تصميم نموذج بيانات Meta بحيث تصبح كل الأصول التي تنشئها لتشغيل النشاط التجاري على Meta مملوكة من خلال كائن كيان النشاط التجاري هذا. يمكن لكائن النشاط التجاري نفسه الذي يمتلك تطبيقك أيضًا امتلاك صفحة فيسبوك وحساب Instagram وحساب إعلاني وكتالوج منتجات.

الخطوة الثانية: إنشاء رمز الوصول (باستخدام الحساب الاختباري)

كجزء من عملية الموافقة المسبقة على التطبيق، تحتاج إلى توفير رمز وصول مع كل استدعاء عند إجراء استدعاءات API. يتيح رمز الوصول هذا لتطبيقك الوصول إلى منصات Meta نيابة عن المستخدم. تُعد رموز الوصول مكافئة للمفاتيح الرقمية التي تحافظ على تسجيل دخول المستخدم إلى فيسبوك حتى لا يحتاج إلى إعادة إدخال كلمة السر في كل مرة يحتاج البرنامج التابع لجهة خارجية إلى الوصول إلى منصات Meta نيابةً عن هذا المستخدم.

بصفتك مطوّرًا شريكًا يريد إنشاء دمج تجاري حيث ستدير متاجر متعددة، سيتعين عليك تخزين رموز وصول متعددة، رمز لكل متجر تدعمه ويبيع على قنوات فيسبوك وInstagram.

للبدء، أنشئ حسابًا تجاريًا اختباريًا، مع ربط الأصول وإنشاء رمز وصول مقابل ليتم استخدامه لإنشاء دمج API التجارة.

نوصي باستخدام رموز الوصول المدعومة من مستخدم النظام للوصول إلى API التجارة كرموز وصول تم الحصول عليها من مستخدم اعتيادي ويمكن إبطالها بعد فترة زمنية أو إذا قام هذا المستخدم بتغيير كلمة سر فيسبوك. يمثل مستخدمو النظام الخوادم أو البرامج التي تقوم بإرسال استدعاءات API إلى الأصول التي يمتلكها أو يديرها حساب مدير الأعمال. للحصول على إرشادات تفصيلية، يمكنك الرجوع إلى إعداد دمج API.

الخطوة الثالثة: إنشاء عمليات دمج التجارة (باستخدام حساب اختباري)

ابدأ عملية الدمج مع واجهات API الكتالوج وإدارة الطلبات والعروض الترويجية (العروض) في الوقت نفسه باستخدام الحساب الاختباري التجاري الذي تم إنشاؤه في الخطوة الثانية: الدمج مع واجهات API الكتالوج لإعداد وتشغيل كتالوج محدث وعالي الجودة يعمل على تعزيز تجربة الشراء والتأثير على قرارات الشراء. يمكنك الدمج مع واجهات API إدارة الطلبات لإدارة مسار الطلبات التي يجريها المشترون على قنوات فيسبوك وInstagram. يمكنك الدمج مع واجهات API العرض الترويجي لمزامنة أنواع مختلفة من العروض الترويجية ومعالجة عمليات الشراء واسترداد الأموال في وجود العروض الترويجية.

تعرف على كيفية الدمج مع واجهات API هذه لتلبية معايير جودة المتاجر.

الخطوة الرابعة: إرسال التطبيق للمراجعة

تُعد مراجعة التطبيقات جزءًا محوريًا من عملية تطوير التطبيق. يمكنك بدء عملية مراجعة التطبيقات من خلال طلب أذونات فردية ووصف كيفية استخدام الأذونات المطلوبة بواسطة تطبيقك لتنمية الأنشطة التجارية التي تدعمها. تمكننا هذه العملية من التحقق من أن تطبيقك يستخدم منتجاتنا وواجهات API التي نوفرها بطريقة معتمدة. تعرف على المزيد حول عملية مراجعة التطبيقات.

الخطوة الخامسة: تنفيذ دفق لإعداد البائعين لاستخدام ميزات التجارة في Meta

يمكنك تنفيذ أفضل مسار لإعداد البائعين لاستخدام ميزات التجارة في Meta. في نهاية هذا الدفق، يتم إنشاء رمز الوصول لكل بائع تدعمه، والذي تحتاج إلى تخزينه واستخدامه عند إجراء استدعاءات API نيابةً عن ذلك البائع.

تعرف على الإرشادات المفصلة حول كيفية إنشاء دمج مثالي لعملية الإعداد يلبي معايير جودة المتاجر.

الخطوة السادسة: تحسين دمج API التجارة (باستخدام حساب الإنتاج)

يمكنك تحسين الدمج لمعالجة سيناريوهات حالة عناصر الربط المختلفة ومعالجة حالات الفشل بسلاسة. يمكنك التعرف على أفضل ممارسات الدمج الموصى بها والموضحة في دليل أفضل الممارسات واعتمادها. وأخيرًا، اختبر عملية الدمج عن طريق إرسال طلبات حقيقية.

معايير جودة الدمج

يعرض الجدول أدناه المهام المطلوبة من البائع (JTBD) ويجمعها حسب الفئات المختلفة، أي الأولوية (يكون الرقم 0 أعلى أولوية)، سواء كانت مخصصة لـ Meta أو قابلة للتطبيق على القنوات الأخرى، وحسب متطلبات معايير جودة دمج التجارة في Meta والتحسينات المحتملة.

الفئة المهام المطلوبة من البائع (JTBD) الأولوية متعدد القنوات / مخصص لـ Meta معايير الجودة: الحد الأدنى من المتطلبات معايير الجودة: التحسينات

إعداد المتاجر وإدارتها

الإعداد لاستخدام المتاجر

0

مخصص لـ Meta

يجب على الجهة الخارجية استخدام ملحق FBE

عرض المشكلات الموجودة في المتجر وحلها (بما في ذلك مشكلات دمج النشاط التجاري)

0

عرض الرؤى والتوصيات الخاصة بالمتجر

1

مخصص لـ Meta

لا ينطبق

تخصيص منظر المتجر وطابعه

2

مخصص لـ Meta

لا ينطبق

الاستجابة/التواصل مع المشترين في Meta

0

كلا الخيارين (يفضل الكثير من البائعين استخدام Messenger/الرسائل الخاصة على IG/واتساب للرد على العملاء، بينما سيعتمد الآخرون على أدوات تابعة لجهات خارجية للتواصل مع العملاء)

لا ينطبق

إدارة الكتالوج

إضافة/إزالة/تعديل المنتجات للحفاظ على كتالوج وافر ومحدث

0

متعدد القنوات

يجب على الجهة الخارجية مزامنة كتالوج المنتجات مع Meta ومعالجة الأخطاء باستخدام آلية مزامنة قابلة للتوسيع بالنسبة للحقول غير المتغيرة (مزامنة الكتالوج الكامل كل 24 ساعة ومزامنة delta كل ساعة) ومزامنة تحديثات الحقل عالي التغير (المخزون والتسعير) بشكل شبه فوري (كل 15 دقيقة على الأقل)

يجب على الجهة الخارجية مزامنة تشكيلة مجموعة المنتجات مع Meta

عرض مشكلات المنتجات المحددة في Meta وحلها (مثل إشارات دمج النشاط التجاري)

0

متعدد القنوات (على الرغم من أن حل المشكلة الفعلي يمكن أن يتوفر على أي مساحة عمل توفرها Meta، مثل الطعن على دمج النشاط التجاري)

يحب على الجهة الخارجية عرض التشخيصات من خلال توفيرح أزرار دعوة لاتخاذ إجراء (CTA) واضحة للبائعين

مراجعة محتوى المجتمع (UGC) واستخدامه

1

مخصص لـ Meta

لا ينطبق

عرض السلع / تشغيل إعلانات المتجر

تشغيل إعلانات المتجر

0

مخصص لـ Meta

يجب أن تطلب الجهة الخارجية من البائعين إعداد إشارة الإعلانات وإرسالها مرة أخرى عبر البيكسل

يجب أن تطلب الجهة الخارجية من البائعين إعداد إشارة الإعلانات وإرسالها مرة أخرى عبر واجهة API التحويلات

عرض الأداء والتحليلات (الإعلانات)

0

متعدد القنوات

لا ينطبق

عرض الأداء والتحليلات (المبيعات العادية)

1

كلا الخيارين (على الرغم من وجود أدوات يمكنها تجميع أدوات قياس عالية المستوى، وأدوات أعمق لقياس المبيعات العادية التي نوفرها عبر CM اليوم)

لا ينطبق

تشغيل العروض الترويجية (العروض)

0

متعدد القنوات

يجب على الجهة الخارجية معالجة الطلبات (عمليات إكمال الطلبات والإلغاء واسترداد الأموال) التي تتضمن خصومات ممولة من Meta والخصومات القياسية التالية الممولة من البائع: الخصومات المخصصة للعناصر الفردية الموجودة في الطلب والخصومات المخصصة على مستوى العناصر الموجودة في الطلب (مع السلع المتبقية على الأرجح) وخصومات الشحن المجاني والخصومات على العروض من فئة "اشترِ X واحصل على Y"

إذا كانت الجهة الخارجية مصدرًا لتجميع المعلومات حول الخصومات: فيجب عليها مزامنة الخصومات القياسية مع Meta باستخدام API العروض (إمكانية مقيدة في الوقت الحالي) وبخلاف ذلك: يجب على الجهة الخارجية عرض رابط إعادة توجيه إلى مدير المعاملات التجارية لدى البائعين لمزامنة كل الخصومات القياسية مع Meta

تشغيل عمليات طرح منتجات Instagram

2

مخصص لـ Meta

لا ينطبق

تشغيل أحداث التسوق عبر Instagram Live

2

مخصص لـ Meta

لا ينطبق

إنشاء منشورات عادية تمت الإشارة إلى المنتجات فيها

2

مخصص لـ Meta

لا ينطبق

المبيعات المُدارة

إدارة تفاصيل الدفع لإتمام الشراء داخل الموقع

0

مخصص لـ Meta

يجب على الجهة الخارجية استخدام ملحق FBE.

تحصيل الأرباح/معالجة مدفوعات الأموال المستردة

0

متعدد القنوات

يجب على الجهة الخارجية عرض التقارير المالية التي تم الحصول عليها من Meta

تحصيل الأرباح/معالجة مدفوعات الأموال المستردة

0

متعدد القنوات

معالجة عمليات رد المبالغ المدفوعة

0

كلا الخيارين

إنشاء التقارير الضريبية وتسوية المبيعات

0

متعدد القنوات

معالجة الطلبات وإكمالها

إدارة الطلبات بمجرد تلقيها

0

متعدد القنوات

يجب على الجهة الخارجية تلقي الطلبات الواردة من Meta إلى نظام إدارة الطلبات واعتمادها

إكمال الطلبات

0

متعدد القنوات

يجب على الجهة الخارجية مزامنة حالات الطلب (إكمال الطلبات والإلغاء واسترداد الأموال) من نظام إدارة الطلبات إلى Meta

معالجة عمليات الإرجاع واسترداد الأموال التي بدأها المشتري والبائع

0

متعدد القنوات

يجب على الجهة الخارجية مزامنة حالات الطلب (إكمال الطلبات والإلغاء واسترداد الأموال) من نظام إدارة الطلبات إلى Meta

يجب على الجهة الخارجية معالجة عمليات الإرجاع التي بدأها المشتري عبر Meta