الإعلانات متعددة اللغات

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

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

للحصول على معلومات عامة حول هذه الميزة، يمكنك الرجوع إلى مركز مساعدة الإعلانات، الإعلان لجمهور متعدد اللغات. ويمكنك الرجوع إلى أهداف الحملة الإعلانية المدعومة.

تمثل الإعلانات متعددة اللغات إحدى واجهات API الثلاثة لدينا والتي تستخدم قواعد تخصيص الأصول.

بدء الاستخدام

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

إذا لم تتوفر لديك الموارد اللازمة لترجمة إعلانك يدويًا، يمكنك الرجوع إلى خدمة الترجمة التلقائية.

الخطوة الثانية: توفير تصميم عبر asset_feed_spec

يتم تحديد تصميمات الإعلانات متعددة اللغات باستخدام مواصفات asset_feed_spec. وتكون قائمة منتجات الأصول عبارة عن مجموعة من عناصر التصميمات المختلفة، مثل الصورة والعناوين والنصوص الأساسية وما إلى ذلك. ويمكنك إنشاء asset_feed_spec في /adcreative.

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

المعلمات المتوفرة

تتضمن المعلمات التي يجب توفيرها في asset_feed_spec ما يلي:

اسم الخاصية الوصف

images

النوع: array (مصفوفة)

مطلوب للتنسيق الإعلاني SINGLE_IMAGE. ويجب توفير url أو hash

يمثل صورًا في شكل url أو hash. ويجب توفير الصور الموجودة في مكتبة الصور الخاصة بالحساب الإعلاني.


يجب توفير هذا الحقل كمصفوفة من {"url": "<IMAGE_URL>", "hash": "<IMAGE_HASH>", "url_tags": "<TAG>", "adlabels": [{name: "<LABEL>"}]}.

videos

النوع: array (مصفوفة)

مطلوب للتنسيق الإعلاني SINGLE_VIDEO

يمثل مصفوفة من video_ids. ويجب أن تتوفر مقاطع الفيديو في مكتبة الفيديو الخاصة بالحساب الإعلاني.


يجب توفير هذا الحقل كمصفوفة من {"video_id": "<VIDEO_ID>","thumbnail_url": "{<THUMBNAIL_URL>}", "url_tags": "{<TAG>}", "adlabels": [{"name": "<LABEL>"}]}.

bodies

النوع: array (مصفوفة)

مطلوب، ولكن تظل url_tags اختيارية

يمثل مصفوفة من النصوص الأساسية التي تتضمن الرسالة الأساسية للإعلان.


يمكنك توفير هذا الحقل كمصفوفة من {"text": "<BODY_TEXT>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}.

titles

النوع: array (مصفوفة)

مطلوب، ولكن تظل url_tags اختيارية

يمثل مصفوفة من العناوين. ويتوفر عنوان قصير في الإعلان يظهر غالبًا بجوار رابط أو صورة أو فيديو.


يجب توفير هذا الحقل كمصفوفة من {"text": "<TITLE>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}.

descriptions

النوع: array (مصفوفة)

مطلوب، ولكن تظل url_tags اختيارية

يمثل مصفوفة من النص الوصفي الثانوي الأقل ظهورًا من العناوين أو النصوص الأساسية.


ويجب توفير هذا الحقل كمصفوفة من {"text": "<DESCRIPTION>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}. ويمكنك استخدام سلسلة فارغة بمسافة واحدة في حقل الوصف الفارغ.

link_urls

النوع: array (مصفوفة)

مطلوب، ولكن تظل القيمتان display_url وdeeplink_url اختياريتان.

يمثل مصفوفة من عناوين URL للروابط.


يجب توفير هذا الحقل كمصفوفة من {"website_url": "<URL>", "adlabels": [{"name": "<LABEL>"}], "deeplink_url": "<DEEPLINK>", "display_url": "<URL>"}.

call_to_action_types

النوع: array (مصفوفة)

مطلوب.

يمثل مصفوفة من قيم أنواع الدعوة لاتخاذ إجراء.


يجب توفير هذا الحقل كمصفوفة من الدعوات لاتخاذ الإجراء المدعومة: ["<CALL_TO_ACTION>"].

ad_formats

مطلوب.

يمثل مصفوفة من تنسيقات إعلانات Facebook التي تريد إنشاء الإعلانات بها. وتكون التنسيقات المدعومة هي: SINGLE_IMAGE وSINGLE_VIDEO.


يجب توفير هذا الحقل كمصفوفة من التنسيقات الإعلانية المدعومة: ["{<AD_FORMAT>}"].

asset_customization_rules

النوع: يمكنك الرجوع إلى الجدول أدناه ضمن قواعد تخصيص الأصول

مطلوب.

يمثل مصفوفة من قواعد تخصيص الأصول.

قواعد تخصيص الأصول

يمكن تحديد الأصول التي تظهر مع بعضها للمشاهدين الذين يتحدثون بلغة معينة. وتتضمن كل قاعدة مواصفات customization_spec التي تحدد اللغات المحلية للأشخاص الذين يشاهدون هذه الأصول أثناء عرض الإعلان.

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

اسم الخاصية الوصف

customization_spec

النوع: {"locales": [<LOCALE1>, <LOCALE2>]}

مطلوب.

يمكن تحديد اللغات المحلية حيث يتعين عرض الأصول في هذه القاعدة. ولمعرفة اللغات المحلية المدعومة، يمكنك الرجوع إلى اللغات المتوفرة.

image_label

النوع: {"name": "<LABEL>"}

مطلوب للتنسيق الإعلاني SINGLE_IMAGE.

يمثل التسمية المرفقة بأحد أصول الصور في قائمة منتجات الأصول.

video_label

النوع: {"name": "<LABEL>"}

مطلوب للتنسيق الإعلاني SINGLE_VIDEO

يمثل التسمية المرفقة بأحد أصول الفيديو في قائمة منتجات الأصول.

body_label

النوع: {"name": "<LABEL>"}

مطلوب.

يمثل التسمية المرفقة بأحد أصول النص الأساسي في قائمة منتجات الأصول.

title_label

النوع: {"name": "<LABEL>"}

مطلوب.

يمثل التسمية المرفقة بأحد أصول العنوان في قائمة منتجات الأصول.

description_label

النوع: {"name": "<LABEL>"}

مطلوب.

يمثل التسمية المرفقة بأحد أصول الوصف في قائمة منتجات الأصول.

link_url_label

النوع: {"name": "<LABEL>"}

مطلوب.

يمثل التسمية المرفقة بأحد أصول link_url في قائمة منتجات الأصول.

is_default

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

مطلوب.

يمثل علامة قيمة Boolean (قيمة منطقية) لتحديد القاعدة الافتراضية. ويجب تعيين قاعدة واحدة تحديدًا بالعلامة is_default إلى القيمة true.

اللغات المتاحة

يجب أن تكون اللغات المحلية التي توفرها في customization_spec هي معرفات لغات محلية مدعومة في استهداف الإعلانات. ويمكنك الرجوع إلى الاستهداف والموضع واللغات المحلية. كما يمكنك البحث عن لغة محددة باستخدام نقطة النهاية /search. واستخدم المعلمة q للبحث عن اسم لغة محددة. واترك هذه المعلمة فارغة للحصول على قائمة بكل اللغات المدعومة:

curl -G 
  -d "type=adlocale"
  -d "q=en"
  -d "limit=2"
  -d "access_token=<ACCESS_TOKEN>" 
  https://graph.facebook.com/<API_VERSION>/search

عند نجاح العملية، ستحصل على قائمة اللغات:

{
  "data": [
    {
      "key": 6,
      "name": "English (US)"
    },
    {
      "key": 24,
      "name": "English (UK)"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD",
    }
  }
}

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

الخطوة الثالثة: إنشاء الإعلانات باستخدام مواصفات قائمة منتجات الأصول

يمكنك إنشاء قائمة منتجات الأصول باستخدام الحقل asset_feed_spec في POST ad_account_ID/adcreatives:

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }'
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Essayez notre délicieuse recette de guacamole!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "french"}],
         },
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Les meilleurs avocats!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com/en",
           "adlabels": [{"name": "english"}],
         },
         {
           "website_url": "www.jaspersmarket.com/fr",
           "adlabels": [{"name": "french"}],
         },
       ],
       "images": [
         {
           "hash": "J45p3r5m4RK374VOc4DO2",
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "customization_spec": {
             "locales": [9,44],
           },
           "title_label": {"name": "french"},
           "body_label": {"name": "french"},
           "description_label": {"name": "french"},
           "link_url_label": {"name": "french"},
         },
         {
             "is_default": true,
           "customization_spec": {
             "locales": [24]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"},
         },
       ]
     }'
  -F 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adcreatives

عند نجاح العملية، ستحصل على معرف تصميم الإعلان:

{"id":"238474593777777"}

إذا كانت مواصفات asset_feed_spec تلبي التقييدات المفروضة أدناه، فسيظهر لك خطأ.

لإنشاء إعلان باستخدام معرف تصميم الإعلان الحالي، يمكنك استدعاء POST act_AD_ACCOUNT_ID/ads. وبدلًا من ذلك ومن أجل عرض لغات مختلفة في إعلانك، يمكنك توفير asset_feed_spec وobject_story_spec في المعلمة creative التابعة للإعلان.

للتحقق من مواصفات asset_feed_spec الجديدة، يمكنك استدعاء طلب GET بمعرف الإعلان أو معرف تصميم الإعلان:

curl -G
-d 'fields=object_story_spec,asset_feed_spec'
-d 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/API_VERSION/<CREATIVE_ID>

الخطوة الرابعة الاختيارية: معاينة الإعلان

يمكنك معاينة إصدارات اللغات المختلفة في إعلانك باستخدام نقطة النهاية generatepreview. وأضف الحقل dynamic_asset_label مع adlabel في قاعدة لعرض إصدار لغة محدد.

فعلى سبيل المثال، لمعاينة إصدار اللغة الفرنسية من التصميم أعلاه:

curl -G \
  --data-urlencode 'creative={ 
    "object_story_spec": { 
      "page_id": "<PAGE_ID>" 
    },
    "asset_feed_spec": {
      ...
    }
  }' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'dynamic_asset_label=french'
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

الترجمات التلقائية

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

يمكن العثور على مصدر الترجمة التلقائية في أصول النص المحددة بواسطة قاعدة تخصيص الأصول الافتراضية. وتتم تسمية نُسخ الإعلانات المُترجمة تلقائيًا بالاسم "مُترجمة تلقائيًا".

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

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }'
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "autotranslate": ["fr_XX"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         }
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}]
         }
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}]
         }
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com",
           "adlabels": [{"name": "english"}]
         }
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "is_default": true,
           "customization_spec": {
             "locales": [6]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"}
         }
       ]
     }'
  -F 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives/?fields=asset_feed_spec

يمكن مراجعة النُسخ المُترجمة تلقائيًا من خلال إجراء استدعاء إلى الحقل asset_feed_spec في التصميم.

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

link_urls

يمكنك إضافة عنوان URL لرابط مخصص إلى إصدار الإعلان المُترجم تلقائيًا.

لإجراء ذلك، أضف عنوان URL language-specific إلى الحقل link_urls مع تضمين adlabel، ثم أضف قاعدة جديدة إلى asset_customization_rules تحتوي على رموز اللغة المحلية المرتبطة وlink_url_label التابع لهذه اللغة.

التقييدات

فيما يلي القيود والتقييدات التي تخضع لها قائمة منتجات الأصول.

التنسيقات الإعلانية

  • تنسيق إعلان واحد فقط لكل asset_feed_spec
  • بالنسبة لتنسيق SINGLE_IMAGE، يجب توفير صورة واحدة على الأقل.
  • بالنسبة لتنسيق SINGLE_VIDEO، يجب توفير فيديو واحد على الأقل

الأصول، عام

  • يمكنك توفير 49 أصلًا على الأكثر لكل نوع أصل باستثناء call_to_action_types.
  • يجب توفير أصل call_to_action_type واحد بالتحديد لكل الأهداف.

الأصول النصية

  • يجب توفير أصل نصي واحد على الأقل، مثل العناوين title والنصوص الأساسية والأوصاف description والعناوين link_urls لكل إصدار لغة متوفر ضمن قائمة منتجات الأصول.
  • يجب أن تتضمن جميع الأصول النصية الحقل adlabels.
  • الحد الأقصى للطول: 255 حرفًا للعنوان، و4096 حرفًا للنص الأساسي، و10000 حرف للوصف.

أصول الصور ومقاطع الفيديو

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

أصول عناوين URL للروابط

  • في حالة توفير url_tags، سيتم إلحاقها بعنوان link_url كمعلمات لكل أصل في الإعلان.
  • في حالة استخدام الهدف APP_INSTALLS، فيجب أن يتطابق العنوان link_url لديك مع العنوان promoted_object.object_store_url التابع للمجموعة الإعلانية.

قواعد تخصيص الأصول

  • يجب توفير قاعدة تخصيص الأصول لكل متغيرات اللغات في asset_feed_spec.
  • يجب توفير قاعدة افتراضية واحدة. وتكون هذه قاعدة تخصيص الأصول مع تعيين is_default إلى القيمة true. وتعمل بمثابة قاعدة نسخ احتياطي وتتيح عرض الإعلانات حتى عندما لا تتطابق اللغة المحلية لأحد المستخدمين مع إحدى اللغات في asset_feed_spec.

المواضع

  • تدعم الإعلانات متعددة اللغات جميع المواضع.

أنواع الأهداف والوجهات المتوفرة

  • LINK_CLICKS -يمثل موقع الويب والتطبيقات فقط، وليس Messenger.
  • APP_INSTALLS - يمثل تطبيقات أجهزة الكمبيوتر أو الهواتف المحمولة.
  • CONVERSIONS - يمثل موقع الويب والتطبيقات فقط، وليس Messenger.
  • REACH - يمثل جميع أنواع الوجهات.
  • BRAND_AWARENESS - يمثل جميع أنواع الوجهات.
  • VIDEO_VIEWS - يمثل جميع أنواع الوجهات.

أنواع الشراء المدعومة

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

يتم دعم اتجاهات الترجمات التالية. واستخدم رمز اللهجة المقابل في الحقل autotranslate:

اللغة المصدرلغة الترجمة المستهدفةرمز اللهجة

الإنجليزية

الإسبانية

es_XX

الإنجليزية

الفرنسية

fr_XX

الإنجليزية

الألمانية

de_DE

الإنجليزية

البرتغالية

pt_XX

الإنجليزية

الإيطالية

it_IT

الإنجليزية

العربية

ar_AR

الإنجليزية

الهولندية

nl_XX

الإنجليزية

الملايوية

ms_MY

الإنجليزية

السويدية

sv_SE

الإنجليزية

الإندونيسية

id_ID

الإنجليزية

البولندية

pl_PL

الإنجليزية

الهندية

hi_IN

الإنجليزية

الدنماركية

da_DK

الإنجليزية

التركية

tr_TR

الإنجليزية

التاغالوغية

tl_XX

الإنجليزية

الرومانية

ro_RO

الألمانية

الإنجليزية

en_XX

العربية

الإنجليزية

en_XX

العبرية

الإنجليزية

en_XX

الإسبانية

الإنجليزية

en_XX

اليابانية

الإنجليزية

en_XX

النرويجية

الإنجليزية

en_XX

الفرنسية

الإنجليزية

en_XX

الهولندية

الإنجليزية

en_XX

السويدية

الإنجليزية

en_XX