إعداد قائمة بيانات MBE

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

المثال — دفق الإعداد من جهة الشريك (تسجيل دخول النشاط التجاري)

قبل البدء

  1. يجب أن يكون تطبيقك مملوكًا بواسطة مدير أعمال يمثل نشاطًا تجاريًا تم التحقق منه. تعرف على المزيد حول كيفية التحقق من نشاطك التجاري.
  2. يلزم توفير تطبيق Meta يتضمن الأذونات التالية المعتمدة عبر عملية مراجعة التطبيقات خاصةً تلك التطبيقات التي تتفاعل في إدارة قائمة البيانات:
    • catalog_management — وبدلاً من ذلك، يمكنك طلب الإذن ads_management إذا كنت تريد أيضًا إدارة إعلانات البائعين نيابة عن العميل.

التكوينات المطلوبة

الإضافات

الحقلالنوعالوصف

setup

الإعداد

مطلوب

إعداد Facebook الخاص بالبائع، مثل المعرف الفريد الخاص به (external_business_id) أو عملة الكتالوج الخاصة به (currency). راجع تفاصيل كائن الإعداد.

business_config

business_config

مطلوب

كائن التكوين الذي يستخدمه ملحق Facebook للأعمال لتكوين سير عمل ملحق Facebook للأعمال. راجع business_configتفاصيل الكائن.

repeat

boolean (قيمة منطقية)

مطلوب

يمكنك تعيين هذه القيمة إلى false.

الإعداد

الحقلالوصف

نوع external_business_id
: string (سلسلة)

مطلوب.
معرف نشاط تجاري فريد لتمثيل نشاط عميلك التجاري. نستخدم ذلك كمعرف فريد. على سبيل المثال، إذا كانت شركة البائع هي "Fubar"، فقد يكون "fubar-123" هو معرف external_business_id.

نوع timezone
: string (سلسلة)

مطلوب.
المنطقة الزمنية التي يتواجد فيها النشاط التجاري. راجع قيم المنطقة الزمنية المحتملة.

نوع currency
: string (سلسلة)

مطلوب.
يمثل رمز العملة لمعيار ISO المكوّن من ثلاثة أحرف للعملة الافتراضية التي تستخدمها عناصر كتالوج النشاط التجاري. راجع رموز العملة المدعومة.

نوع business_vertical
: enum (تعداد)

مطلوب.
المجال المرتبط بالنشاط التجاري.
القيمة:ECOMMERCE

نوع merchant_settings_id
: string (سلسلة)

اختياري.
يتم استخدامه عند الترقية من ملحق Meta للأعمال، بالإصدار 1. تواصل مع شريك Meta إذا كنت تحاول الترحيل من الإصدار 1 إلى الإصدار 2.

نوع domain
: string (سلسلة)

مطلوب لقنوات COMMERCE وCOMMERCE_OFFSITE
النطاق المُستخدم للاعتماد اليدوي في Instagram. على سبيل المثال، https://exampleshop.partnersite.com.

نوع channel
: enum (تعداد)

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

نوع business_manager_id
: string (سلسلة)

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

نوع ad_account_id
: string (سلسلة)

اختياري.
معرف الحساب الإعلاني لحساب المستخدم الإعلاني الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

نوع page_id
: string (سلسلة)

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

نوع ig_profile_id
: string (سلسلة)

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

نوع pixel_id
: string (سلسلة)

اختياري.
معرف البيكسل لبيكسل المستخدم الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

نوع catalog_id
: string (سلسلة)

اختياري.
معرف الكتالوج لكتالوج المستخدم الموجود الذي يمكن لشريك إدخاله ليحدده مسبقًا للمستخدم في دفق الإعداد.

تكوين النشاط التجاري

الحقلالوصف

business
FBEBusinessPropertiesConfigData

مطلوب.
يمثل معلومات حول النشاط التجاري لدى المستخدم النهائي

catalog_feed_scheduled
FBECatalogFeedConfigData

اختياري.
يحدد ما إذا كان يجب على ملحق فيسبوك للأعمال استخدام نهج قائمة المنتجات والذي يجلب عناصر الكتالوج من عنوان feed_url

FBECatalogFeedConfigData

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

الحقلالوصف

نوع enabled
: boolean (قيمة منطقية)

مطلوب.
يمكنك التمييز لتمكين الميزة أو تعطيلها

نوع feed_url
: string (سلسلة)

مطلوب.
عنوان URL الخاص بملف مُستضاف للعامة ويحتوي على مخزون النشاط التجاري (يجب أن يكون بالتنسيق CSV أو TSV أو XML)