إعلانات رحلات الطيران - الكتالوج والقائمة

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

  1. تحميل ملفات بتنسيق CSV أو XML إلى 'قوائم الرحلات الجوية' تتضمن مخزون الرحلات الجوية
  2. استخدام نشاط الأحداث لملء الكتالوج تلقائيًا
  3. الجمع بين قائمة الرحلة الجوية والرحلات الجوية التي يتم إنشاؤها تلقائيًا

يمكنك إنشاء كتالوجات للرحلات الجوية الخاصة بك وإدارتها من مدير المعاملات التجارية:

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

قائمة رحلة الطيران - تحميل رحلات الطيران على فيسبوك

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

تنسيقات قوائم رحلات الطيران المدعومة

ملف CSV > العينة - الوصف

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

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

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

عينة من XML

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

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

الحقول المدعومة - إعلانات الرحلات الجوية

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

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

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

origin_airport

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

مطلوب.

رمز اتحاد النقل الجوي الدولي (IATA) لمطار المنشأ. ويدعم رمز اتحاد النقل الجوي الدولي (IATA) للمطار والمدينة. يمكنك استخدام ميزة البحث برمز IATA للتحقق من رموز اتحاد النقل الجوي الدولي (IATA). نصيحة: لتحسين الأداء، تجنب استخدام مسافة في حقل المعرف الفريد هذا.

المثال: SFO

destination_airport

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

مطلوب.

رمز اتحاد النقل الجوي الدولي (IATA) لمطار الوجهة. ويدعم رمز اتحاد النقل الجوي الدولي (IATA) للمطار والمدينة. يمكنك استخدام ميزة البحث برمز IATA للتحقق من رموز اتحاد النقل الجوي الدولي (IATA). نصيحة: لتحسين الأداء، تجنب استخدام مسافة في حقل المعرف الفريد هذا.

المثال: JFK

image

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

مطلوب.

أقصى عدد للعناصر: 20

بيانات صورة الرحلة الجوية. يمكنك تقديم 20 صورة كحد أقصى لرحلة الطيران. وتحتوي كل صورة على حقلين وهما: url وtag. يمكن أن يكون لديك عدة علامات مرتبطة بصورة واحدة. ويجب توفير صورة image واحدة على الأقل. يمكن أن يصل حجم كل صورة إلى 4 ميجابايت كحد أقصى.

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

description

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

مطلوب.

أقصى حجم: 5000

فقرة قصيرة تصف المسار.

url

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

يكون مطلوبًا فقط إذا لم يتم تحديد رابط لموضع معين على مستوى الإعلان. ويمكنك استخدام الحقل Deep Link في مدير الإعلانات أو template_url_spec في واجهة API).

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

origin_city

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

اسم مدينة المنشأ.

المثال: San Francisco

destination_city

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

اسم مدينة الوجهة.

المثال: New York

price

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

يمثل سعر الرحلة الجوية. ويجب تحديد القيمة من خلال العملة.

المثال: 99.99 USD

applink

النوع: element (عنصر)

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

  1. على مستوى الإعلان باستخدام template_url_spec
  2. هنا في قائمة المنتجات باستخدام كائن Applink
  3. من خلال إضافة علامات تعريف رابط التطبيق إلى موقعك على الويب.

one_way_price

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

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

المثال: 99.99 USD

priority

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

يمثل أولوية الرحلة الجوية. وتتراوح القيمة من 0 (أقل أولوية) إلى 5 (أعلى قيمة). وستكون الرحلة الجوية بدون هذه القيمة بالأولوية=0.

المثال: 5

status

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

يتحكم فيما إذا كان العنصر نشطًا أو مؤرشفًا في الكتالوج لديك. لا يمكن رؤية العناصر النشطة إلا بواسطة الأشخاص في إعلاناتك أو المتاجر أو أي قناة أخرى. القيم المدعومة: active وarchived. وتكون العناصر نشطة بشكل افتراضي. تعرف على المزيد حول أرشفة العناصر.


المثال: active


ملاحظة: قد تقوم بعض المنصات الشريكة، مثل Shopify بمزامنة العناصر مع الكتالوج لديك من خلال حالة تُسمى staging، والتي يتشابه سلوكها مع سلوك الحالة archived.

كان يُسمى هذا الحقل visibility سابقًا. ورغم أننا ما زلنا ندعم اسم الحقل القديم، نوصيك باستخدام الاسم الجديد.

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

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

url

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

مطلوب.

عنوان URL لصورة رحلة الطيران. اتبع مواصفات الصورة التالية:

  • يجب أن تكون كل الصور بتنسيق JPG أو GIF أو PNG.

  • بالنسبة للإعلانات الدوّارة وإعلانات المجموعة: تظهر الصور بتنسيق مربع بنسبة العرض إلى الارتفاع (1:1). الحد الأدنى لحجم الصورة هو 500 × 500 بيكسل. نوصي باستخدام صور بحجم 1024 × 1024 بيكسل للحصول على أفضل جودة.

  • بالنسبة للإعلانات التي تتضمن صورة واحدة: تظهر الصور بنسبة عرض إلى ارتفاع 1.91:1. والحد الأدنى لحجم الصورة هو 500 × 500 بيكسل. ونوصي باستخدام صور بحجم 1200 × 628 بيكسل للحصول على أفضل جودة.

tag

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

سلسلة تمثل محتوى الصورة. يمكن أن يكون هناك العديد من الإشارات المرتبطة بصورة.

الأمثلة:

  • Fitness Center
  • Swimming Pool

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

إذا كان لديك تطبيقان مختلفان لكل من iPhone وiPad، يجب تحديد معلومات محددة لكل من iPhone وiPad. أو يمكنك تحديد معلومات iOS فقط.

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

ios_url

النوع: string

نظام مخصص لتطبيق iOS.

مثال: example-ios://electronic

ios_app_store_id

النوع: string

معرف التطبيق لمتجر تطبيقات App Store.

مثال: 1234

ios_app_name

النوع: string

اسم التطبيق (اسم مناسب للعرض).

مثال: Electronic Example iOS

iphone_url

النوع: string

نظام مخصص لتطبيق iPhone.

مثال: example-iphone://electronic

iphone_app_store_id

النوع: string

معرف التطبيق لمتجر تطبيقات App Store.

مثال: 5678

iphone_app_name

النوع: string

اسم التطبيق (اسم مناسب للعرض).

مثال: Electronic Example iPhone

ipad_url

النوع: string

نظام مخصص لتطبيق iPhone.

مثال: example-ipad://electronic

ipad_app_store_id

النوع: string

معرف التطبيق لمتجر تطبيقات App Store.

مثال: 9010

ipad_app_name

النوع: string

اسم التطبيق (اسم مناسب للعرض).

مثال: Electronic Example iPad

android_url

النوع: string

نظام مخصص لتطبيق Android.

مثال: example-android://electronic

android_package

النوع: string

اسم حزمة مؤهل بالكامل لإنشاء النية.

مثال: com.electronic

android_class

النوع: string

اسم فئة نشاط مؤهل بالكامل لإنشاء النية.

مثال: com.electronic.Example

android_app_name

النوع: string

اسم التطبيق (اسم مناسب للعرض).

مثال: Electronic Example Android

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

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

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

إنشاء رحلات الطيران تلقائيًا - إضافة مسارات إلى الكتالوج تلقائيًا باستخدام نشاط الأحداث

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

لتمكين ذلك، قم بإرسال طلب POST إلى كتالوج الرحلات الجوية وتعيين generate_items_from_events على true.

curl \
  -F 'flight_catalog_settings={generate_items_from_events:1}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

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

curl \
  -F 'fallback_image_url=http://example.com/some.image_1.jpg' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

بمجرد ربط كتالوجك ببيكسل و/أو تطبيق ويبدأ في تلقي أحداث إعلانات رحلات الطيران، يتم نشر كتالوجك. يمكنك التحقق من ذلك من خلال الاستعلام عن كتالوج المنتجات.

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights

الأحداث المجمعة - استخدام قوائم رحلات الطيران ورحلات الطيران التي يتم إنشاؤها تلقائيًا

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

للقيام بذلك، كل ما عليك فعله هو الجمع بين الخطوتين تحميل قائمة رحلات جوية وملء كتالوجك تلقائيًا.

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

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

المستندات المرجعية

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

لإنشاء كتالوج رحلات جوية لإعلانات رحلات جوية، قم بتعيين vertical إلى flights:

curl -X POST \
  -F 'name="Test Flight Catalog"' \
  -F 'vertical="flights"' \
  -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;

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

$flight_set->setData(array(
  ProductSetFields::NAME => 'Test Flight Set',
  ProductSetFields::FILTER => array(
    'origin_airport' => array(
      'eq' => 'LHR',
    ),
  ),
));

$flight_set->create();
from facebookads.adobjects.productset import ProductSet

flight_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

flight_set[ProductSet.Field.name] = 'Test Flights Set'
flight_set[ProductSet.Field.filter] = {
    'origin_airport': {
        'eq': 'SFO',
    },
}

flight_set.remote_create()
curl \
  -F 'name=Test Flight Set' \
  -F 'filter={"origin_airport":{"eq":"LHR"}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<PRODUCT_CATALOG_ID>/product_sets

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

عناصر التشغيلنوع الفلتر

i_contains

يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف.

i_not_contains

لا يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف.

contains

يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف.

not_contains

لا يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف.

eq

يساوي. عنصر التشغيل حساس لحالة الأحرف.

neq

لا يساوي. عنصر التشغيل حساس لحالة الأحرف.

lt

أقل من. للحقول الرقمية فقط.

lte

أقل من أو يساوي. للحقول الرقمية فقط.

gt

أكبر من. للحقول الرقمية فقط.

gte

أكبر من أو يساوي. للحقول الرقمية فقط.

البياناتالبيانات التي تتم فلترتها

origin_airport

رمز اتحاد النقل الجوي الدولي (IATA) لمطار المنشأ.

destination_airport

رمز اتحاد النقل الجوي الدولي (IATA) لمطار الوجهة.

price

سعر الرحلة الجوية. السعر بالسنت.

description

فقرة قصيرة تصف المسار.