كتالوج مُترجم لإعلانات كتالوج Advantage+

نظرة عامة

استخدم هذا الدليل لإعداد كتالوج مُترجم لإعلانات كتالوج Advantage+.

يُعد الكتالوج بمثابة كائن (أو حاوية) تضم معلومات حول منتجاتك حيث يتم تحميل مخزونك.

طريقة العمل

توفر Meta وظيفة الكتالوج المُترجم، ما يتيح لك إعداد كتالوج المنتجات لعرض العناصر في الإعلانات أو المتاجر للعناصر في البلدان المختلفة. تُعد ترجمة العملة والسعر والعنوان أو الوصف المترجمين من الحالات الشائعة. يمكنك أيضًا توفير عنوان URL للمنتج المترجم للانتقال بالعميل إلى موقع الويب الخاص بالمنتج الخاص ببلدك أو بلغة معينة. تعرف على المزيد حول كيفية إعداد الكتالوج المُترجم.

إنشاء قالب إعلانات كتالوج Advantage+

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

بالإضافة إلى الحقول الأخرى الواردة في بيانات قالب التصميم (ضمن مواصفات قصة الكائن)، يمكنك تحديد مصفوفة من عمليات التخصيص، في الحقل customization_rules_spec، حيث يكون لكل عملية تخصيص النموذج التالي:

اسم الحقلالوصفقبول معلمات القالب

customization_spec

النوع: object (كائن)

مطلوب.

يصف اللغة المطلوبة لعملية التخصيص. تعرف على كيفية إنشاء إعلانات كتالوج Advantage+ لعدة لغات وبلدان، مركز مساعدة الإعلانات.

مثال: {'language' => 'en_XX'}

لا

message

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

اختياري.

يمثل رسالة لإعلانك تظهر على Instagram.

المثال: Test {{product.name | titleize}}

نعم

link

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

اختياري.

يمثل رابط إلى موقعك على الويب يُستخدم لإنشاء شرح توضيحي للإعلان. يتم استبدال هذا الحقل دومًا بالحقل link من قائمة منتجاتك، باستثناء بطاقة إنهاء الإعلانات الدوّارة التي ترتبط بهذا. لا يمكن أن يكون هذا عنوان URL على موقع Facebook.com.

المثال: //link.com


بالنسبة لإعلانات التشكيلة، يمكنك استخدام link لتوفير مستند تجارب فورية، كما هو موضَّح بالتفصيل في إعلانات التشكيلة.

مثال: https://fb.com/canvas_doc/CANVAS_ID

لا

name

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

اختياري.

يمثل اسم أو عنوان إعلانك يظهر على Instagram.

المثال: Headline {{product.price}}

نعم

description

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

اختياري.

يمثل وصف لإعلانك. لا يظهر على Instagram.

المثال: Description {{product. description}}

نعم

template_url_spec

النوع: object (كائن)

اختياري.

يمكن استخدامه لتوفير رابط ويب لموضع معين، كما هو موضح بالتفصيل في القوالب وتتبع النقر. ملاحظة: نحن ندعم فقط رابط الويب الداخلي.

المثال: {'web' => {'url' => DEEP_LINK}}
المثال: {'web' => {'url' => 'example://link/?id={{product. retailer_id}}'}}

نعم

video_id

النوع: integer (عدد صحيح)

اختياري.

بالنسبة لإعلانات التشكيلة فقط، يمكنك استخدام video_id لتوفير فيديو للوسائط الرئيسية للتشكيلة، كما هو موضَّح بالتفصيل في إعلانات التشكيلة.

المثال: 1234

لا

picture

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

اختياري.

بالنسبة لإعلانات التشكيلة فقط، يمكنك استخدام picture لتوفير صورة للوسائط الرئيسية للتشكيلة، كما هو موضَّح بالتفصيل في إعلانات التشكيلة.

المثال: https://url/image.jpg

لا

عند تحديد مصفوفة عمليات التخصيص، لا يجب سوى استخدام عملية تخصيص واحدة لتحديد customization_spec فقط. حيث يحدد ذلك لغة النص غير المخصص الذي تم استخدامه في template_data.

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

راجع أيضًا إنشاء قالب تصميم والحقول المدعومة لإعلانات كتالوج Advantage+ وتنسيقات قائمة البيانات المدعومة للإعلانات الديناميكية.

قالب إعلانات التشكيلة

عند إنشاء إعلانات التشكيلة، يمكنك تحديد التخصيصات للتصميم، مثل إعلانات كتالوج Advantage+ متعددة اللغات عبر customization_rules_spec.

التقييدات:

  • يجب إنشاء link لإعلانات التشكيلة باستخدام القوالب — واجهة المتجر الفورية، المعروفة "ببيع المنتجات، الشبكة (1932289657009030)" سابقًا
  • يتم عرض قالب إعلانات التشكيلة فقط عبر موضع موجز الهواتف المحمولة على فيسبوك فقط.

أمثلة

معاينة إعلانات كتالوج Advantage+ متعددة اللغات أو البلدان للتحقق من اللغة أو بلد مختلف

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'dynamic_customization={
       "language": "fr_XX",
       "country": "FR"
     }' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>/previews

إنشاء قالب إعلانات كتالوج Advantage+ دوّارة بلغات متعددة

curl -X POST \
  -F 'name="Dynamic Ad Template Creative Sample"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "message": "English Test {{product.name | titleize}}",
         "link": "http://www.example.com/englishurl",
         "name": "English Headline {{product.price}}",
         "description": "English Description {{product.description}}",
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "message": "French Test {{product.name | titleize}}",
             "link": "http://www.example.com/frenchurl",
             "name": "French Headline {{product.price}}",
             "description": "French Description {{product.description}}",
             "template_url_spec": {
               "web": {
                 "url": "http://www.example.com/frenchdeeplink"
               }
             }
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'template_url_spec={
       "web": {
         "url": "http://www.example.com/englishdeeplink"
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

إنشاء إعلان تشكيلة يتضمن الوسائط الرئيسية للصورة بلغات متعددة

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "picture": "<IMAGE_URL>",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

إنشاء إعلان تشكيلة يتضمن الوسائط الرئيسية للفيديو بلغات متعددة

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "video_id": "<VIDEO_ID>",
         "image_url": "<IMAGE_URL>",
         "title": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE",
           "value": {
             "link": "<CANVAS_LINK>"
           }
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "video_id": "<VIDEO_ID_FR>",
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

إنشاء إعلان تشكيلة يتضمن الوسائط الرئيسية للفيديو الديناميكي بلغات متعددة

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "format_option": "collection_video",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives