إعلانات الوجهة - الكتالوج وقائمة المنتجات

لترويج الوجهات على فيسبوك، عليك مشاركة المعلومات حولها مع فيسبوك. ويمكنك تنفيذ ذلك من خلال إنشاء كتالوج وجهات ثم تعبئته بالوجهات.

تحميل ملفات بتنسيق CSV أو XML لـ "قوائم منتجات الوجهات" مع الوجهات التي تريد ترويجها

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

لاستخدام واجهة API لإدارة الكتالوج:

1. يمكنك إنشاء كتالوج وجهة
2. تحميل قائمة المنتجات إلى فيسبوك
3. يمكنك إنشاء مجموعات المنتج من كتالوج الوجهة
4. ربط الكتالوج بمصادر الأحداث

قائمة منتجات الوجهة - تحميل الوجهات إلى فيسبوك

قائمة منتجات الوجهة هي ملف يتضمن الوجهات التي تريد ترويجها. ويمثل كل سطر أو عنصر في الملف وجهة واحدة. كما يمكنك استخدام قائمة أو أكثر من قوائم منتجات الوجهات، طالما كانت كل قوائم المنتجات تتضمن كل الوجهات التي تريد ترويجها.

تنسيقات قائمة منتجات الوجهة المدعومة

تنسيق CSV - العينة والوصف

عينة CSV | عينة TSV (بلا تنسيق) | عينة TSV (بنمط JSON)

• يجب أن يحتوي الصف الأول على أسماء الحقول المُختارة بالترتيب الذي تتوفر به القيم. وتعمل الصفوف التالية بعد ذلك على تقديم القيم ذات الصلة لكل وجهة.
• يجب تضمين الحقول التي تحتوي على مسافة أو فواصل داخل "علامتي تنصيص".
• يمكن تقديم الحقول المتداخلة أو ذات القيم المتعددة، مثل أو address أو neighborhood أو image، باستخدام قيم بتشفير JSON أو من خلال مجموعة من أعمدة النص العادي "بلا تنسيق" تتم تسميتها باستخدام بنية مسار JSON، مثل address.city وneighborhood[0] وimage[0].url وimage[0].tag[0] وimage[0].tag[1]. ويمكن استخدام المصطلحين بالتبادل في الملف ذاته.

XML - العينة والوصف

عينة XML

• تتضمن عقدة <listings> XML الجذرية مجموعة من عُقد <listing> بحيث تمثل كل منها وجهة.
• يحب أن يبدأ الملف بإشارة تعريف <?xml صالحة.

الحقول المدعومة - الوجهات

صُممت الحقول المدعومة التالية للعناصر التي تضيفها إلى كتالوج المنتجات.

بالنسبة للكتالوجات المترجمة، راجع الحقول المدعومة للوجهات.

روابط لمواضع معينة للمنتجات

قم بتوفير روابط لمواضع معينة في قائمة المنتجات من خلال اتباع مواصفات روابط التطبيق. وتحتل معلومات الروابط لمواضع معينة في قائمة المنتجات الأولوية بالنسبة لأي معلومات يجمعها فيسبوك من خلال بيانات تعريف روابط التطبيق عن طريق متتبع الويب.

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

معلمات كائن الصورة

معلمات كائن العنوان

تتناسب الأقسام التالية مع إدارة الكتالوج لديك فقط باستخدام API هذه.

إنشاء كتالوج الوجهات باستخدام واجهة API

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

لإنشاء كتالوج وجهات لإعلانات الوجهات، يمكنك تعيين vertical إلى destinations:

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

تحميل قوائم منتجات الوجهات عبر واجهة API

بمجرد الانتهاء من إنشاء الكتالوج، يجب تحميل قائمة (قوائم) منتجات الوجهات إلى فيسبوك. يمكنك استخدام واجهة API لإنشاء كائن قائمة لكل قائمة تريد تحميلها. وندعم عمليات التحميل المباشرة والمجدولة.

فلترة كتالوج الوجهات لمجموعات الوجهات

مجموعة الوجهات هي مجموعة فرعية من كتالوجك. ولإعداد إعلانات الوجهات، تحتاج إلى مجموعة وجهات. ولذلك، يجب على الأقل إنشاء واحدة.

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

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$destination_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();

from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()

curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

تتكون المعلمة filter من البيانات وعناصر التشغيل التالية: