لترويج مخزون رحلات الطيران لديك على فيسبوك، يجب مشاركة معلومات حول رحلات الطيران مع فيسبوك. ويمكنك القيام بذلك من خلال إنشاء كتالوج رحلات جوية ثم ملؤه بمسارات الرحلات الجوية. تتوفر ثلاث طرق لملء الكتالوج وتحديثه باستمرار.
يمكنك إنشاء كتالوجات للرحلات الجوية الخاصة بك وإدارتها من مدير المعاملات التجارية:
قائمة رحلة الطيران هي ملف يحتوي على مخزون رحلات الطيران لديك. يمثل كل سطر أو عنصر في الملف مسارًا واحدًا فقط. يمكنك استخدام قائمة أو أكثر من قوائم الرحلات الجوية، طالما كانت كل القوائم مجتمعة تتضمن مخزون الرحلات الجوية بالكامل.
عينة من CSV | عينة من TSV (بلا تنسيق)
"
علامتي تنصيص"
. image
باستخدام قيم بتشفير بلغة JSON أو من خلال مجموعة من أعمدة النص العادي "بلا تنسيق" تتم تسميتها باستخدام بنية مسار بلغة JSON، مثل image[0].url
وimage[0].tag[0]
وimage[0].tag[1]
. يمكن استخدام المصطلحين بالتبادل في الملف نفسه.<listings>
XML الجذرية مجموعة من عُقد <listing>
بحيث تمثل كل منها رحلة جوية.<?xml
صالحة.يقوم محلل القوائم تلقائيًا باكتشاف تشفيرات النصوص UTF8
وUTF16
وUTF32
، ويقوم بتعيين القيمة الافتراضية على LATIN1
إذا واجه سلسلة بايت غير متوقعة. يمكنك تقديم النص في قيم الحقول بأي لغة، بينما يجب أن تكون أسماء الحقول مطابقة للأسماء التالية وباللغة الإنجليزية فقط.
صُممت الحقول المدعومة التالية للعناصر التي تضيفها إلى كتالوج المنتجات.
بالنسبة للكتالوجات التي تم تطويعها محليًا، يمكنك الرجوع إلى الحقول المدعومة لإعلانات الرحلات الجوية.
الحقل والنوع | الوصف |
---|---|
النوع: string (سلسلة) | مطلوب. رمز اتحاد النقل الجوي الدولي (IATA) لمطار المنشأ. ويدعم رمز اتحاد النقل الجوي الدولي (IATA) للمطار والمدينة. يمكنك استخدام ميزة البحث برمز IATA للتحقق من رموز اتحاد النقل الجوي الدولي (IATA). نصيحة: لتحسين الأداء، تجنب استخدام مسافة في حقل المعرف الفريد هذا. المثال: |
النوع: string (سلسلة) | مطلوب. رمز اتحاد النقل الجوي الدولي (IATA) لمطار الوجهة. ويدعم رمز اتحاد النقل الجوي الدولي (IATA) للمطار والمدينة. يمكنك استخدام ميزة البحث برمز IATA للتحقق من رموز اتحاد النقل الجوي الدولي (IATA). نصيحة: لتحسين الأداء، تجنب استخدام مسافة في حقل المعرف الفريد هذا. المثال: |
النوع: object (كائن) | مطلوب. أقصى عدد للعناصر: 20 بيانات صورة الرحلة الجوية. يمكنك تقديم 20 صورة كحد أقصى لرحلة الطيران. وتحتوي كل صورة على حقلين وهما: راجع معلمات كائن الصورة |
النوع: string (سلسلة) | مطلوب. أقصى حجم: 5000 فقرة قصيرة تصف المسار. |
النوع: string (سلسلة) | يكون مطلوبًا فقط إذا لم يتم تحديد رابط لموضع معين على مستوى الإعلان. ويمكنك استخدام الحقل رابط ينقلك إلى الموقع الخارجي حيث يمكنك عرض رحلة الطيران. إذا تم تعيين رابط لموضع معين في مستوى الإعلان، فستكون له الأولوية. |
النوع: string (سلسلة) | اسم مدينة المنشأ. المثال: |
النوع: string (سلسلة) | اسم مدينة الوجهة. المثال: |
النوع: string (سلسلة) | يمثل سعر الرحلة الجوية. ويجب تحديد القيمة من خلال العملة. المثال: |
النوع: element (عنصر) | يمثل أي رابط لموضع معين يتوجه مباشرة إلى صفحة تفاصيل رحلة جوية في تطبيق الهواتف المحمولة لديك باستخدام روابط التطبيق. يمكنك تحديد روابط لموضع معين (بترتيب الأولوية، من الأعلى إلى الأدنى):
|
النوع: string (سلسلة) | سعر الرحلة الجوية ذهابًا فقط. ويجب تحديد القيمة من خلال العملة. المثال: |
النوع: integer (عدد صحيح) | يمثل أولوية الرحلة الجوية. وتتراوح القيمة من 0 (أقل أولوية) إلى 5 (أعلى قيمة). وستكون الرحلة الجوية بدون هذه القيمة بالأولوية=0. المثال: |
النوع: string (سلسلة) | يتحكم فيما إذا كان العنصر نشطًا أو مؤرشفًا في الكتالوج لديك. لا يمكن رؤية العناصر النشطة إلا بواسطة الأشخاص في إعلاناتك أو المتاجر أو أي قناة أخرى. القيم المدعومة: المثال: ملاحظة: قد تقوم بعض المنصات الشريكة، مثل Shopify بمزامنة العناصر مع الكتالوج لديك من خلال حالة تُسمى staging، والتي يتشابه سلوكها مع سلوك الحالة كان يُسمى هذا الحقل |
اسم الحقل والنوع | الوصف |
---|---|
النوع: string (سلسلة) | مطلوب. عنوان URL لصورة رحلة الطيران. اتبع مواصفات الصورة التالية:
|
النوع: string (سلسلة) | سلسلة تمثل محتوى الصورة. يمكن أن يكون هناك العديد من الإشارات المرتبطة بصورة. الأمثلة:
اختياري. |
إذا كان لديك تطبيقان مختلفان لكل من iPhone وiPad، يجب تحديد معلومات محددة لكل من iPhone وiPad. أو يمكنك تحديد معلومات iOS فقط.
اسم الحقل والنوع | الوصف |
---|---|
النوع: string | نظام مخصص لتطبيق iOS. مثال: |
النوع: string | معرف التطبيق لمتجر تطبيقات App Store. مثال: 1234 |
النوع: string | اسم التطبيق (اسم مناسب للعرض). مثال: |
النوع: string | نظام مخصص لتطبيق iPhone. مثال: |
النوع: string | معرف التطبيق لمتجر تطبيقات App Store. مثال: |
النوع: string | اسم التطبيق (اسم مناسب للعرض). مثال: |
النوع: string | نظام مخصص لتطبيق iPhone. مثال: |
النوع: string | معرف التطبيق لمتجر تطبيقات App Store. مثال: |
النوع: string | اسم التطبيق (اسم مناسب للعرض). مثال: |
النوع: string | نظام مخصص لتطبيق Android. مثال: |
النوع: string | اسم حزمة مؤهل بالكامل لإنشاء النية. مثال: |
النوع: string | اسم فئة نشاط مؤهل بالكامل لإنشاء النية. مثال: |
النوع: string | اسم التطبيق (اسم مناسب للعرض). مثال: |
قم بتوفير روابط لمواضع معينة في قائمة المنتجات من خلال اتباع مواصفات روابط التطبيق. وتحتل معلومات الروابط لمواضع معينة في قائمة المنتجات الأولوية بالنسبة لأي معلومات يجمعها فيسبوك من خلال بيانات تعريف روابط التطبيق عن طريق متتبع الويب.
إذا كان لديك معلومات حول الروابط لمواضع معينة من روابط التطبيق بالفعل، فلن تحتاج إلى تحديد هذه البيانات. يستخدم فيسبوك هذه المعلومات من روابط التطبيق لعرض رابط صحيح لموضع معين. ولعرض الروابط لمواضع معينة في الإعلانات، يمكنك الرجوع إلى إعلانات كتالوج 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 التسويق المناسب وأنك قد وافقت على شروط الخدمة من خلال إنشاء كتالوجك الأول باستخدام مدير الأعمال.
لإنشاء كتالوج رحلات جوية لإعلانات رحلات جوية، قم بتعيين 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 لإنشاء كائن قائمة بيانات لكل قائمة تريد تحميلها. ندعم عمليات التحميل المباشرة والمجدولة.
مجموعة الرحلات الجوية هي مجموعة فرعية من كتالوجك. لإعداد إعلانات رحلات الطيران، يجب عليك إنشاء مجموعة رحلات جوية واحدة على الأقل.
ويتم تحديد مجموعات رحلات الطيران باستخدام الفلاتر التي يتم تطبيقها على كتالوج رحلات الطيران. على سبيل المثال، يمكنك إنشاء مجموعة رحلات جوية تحتوي على كل المسارات التي تغادر من لندن. ويرجى العلم أنه يمكنك أيضًا إنشاء مجموعة رحلات جوية دون استخدام أية فلاتر. وفي هذه الحالة، ستتضمن مجموعة الرحلات الجوية كل رحلات الطيران الموجودة في كتالوجك.
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
من البيانات وعناصر التشغيل التالية:
عناصر التشغيل | نوع الفلتر |
---|---|
| يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف. |
| لا يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف. |
| يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف. |
| لا يحتوي على سلسلة فرعية. عنصر التشغيل حساس لحالة الأحرف. |
| يساوي. عنصر التشغيل حساس لحالة الأحرف. |
| لا يساوي. عنصر التشغيل حساس لحالة الأحرف. |
| أقل من. للحقول الرقمية فقط. |
| أقل من أو يساوي. للحقول الرقمية فقط. |
| أكبر من. للحقول الرقمية فقط. |
| أكبر من أو يساوي. للحقول الرقمية فقط. |
البيانات | البيانات التي تتم فلترتها |
---|---|
| رمز اتحاد النقل الجوي الدولي (IATA) لمطار المنشأ. |
| رمز اتحاد النقل الجوي الدولي (IATA) لمطار الوجهة. |
| سعر الرحلة الجوية. السعر بالسنت. |
| فقرة قصيرة تصف المسار. |