الإعلانات التعاونية

الإعلانات التعاونية هي حل تم إنشاؤه استنادًا إلى إعلانات كتالوج Advantage+. تمكّن معلني العلامات التجارية من التعاون بشكل آمن مع بائع تجزئة أو شريك تسويق وتحقيق الأهداف الإعلانية، مثل استهداف منتج معين لتحقيق للمبيعات باستخدام المحتوى الذي يوفره بائع التجزئة.

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

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

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

الخطوات المتقدمة

بالنسبة لبائعي التجزئة وشركاء التسويق:

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

بالنسبة للعلامات التجارية:

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

خطوات لتجار التجزئة وشركاء التسويق

الخطوة الأولى: التأهيل لاستخدام الإعلانات التعاونية

لإكمال هذه الخطوة، يحتاج تطبيقك إلى الإذنين business_management وcatalog_management.

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

الخطوة الثانية: إنشاء شريحة كتالوج

لإكمال هذه الخطوة، يحتاج تطبيقك إلى الإذنين business_management وcatalog_management.

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

لإنشاء شريحة كتالوج عبر API، أرسل طلب POST إلى عنصر الربط owned_product_catalogs. الحقول التالية مطلوبة لإنشاء شريحة الكتالوج:

parent_catalog_id: الكتالوج الأصلي الذي تم إنشاء الشريحة منه. يجب أن يكون هذا الكتالوج متوافقًا مع الإعلانات التعاونية. يمكنك العثور على حالة الكتالوج في "مدير المعاملات التجارية".
catalog_segment_filter: قاعدة بتشفير JSON تستخدم لإنشاء شريحة الكتالوج.

الخطوة الثالثة: مشاركة شريحة الكتالوج

لإكمال هذه الخطوة، يحتاج تطبيقك إلى الإذنين business_management وcatalog_management.

شارك شريحة الكتالوج مع شريك العلامة التجارية. للقيام بذلك عبر API، أرسل طلب POST إلى /{catalog_segment_id}/agencies. في الاستدعاء الذي تجريه، يمكنك إضافة الحقول التالية:

الحقل الوصف

الحقل	الوصف
`business` النوع: numeric string (سلسلة رقمية) أو integer (عدد صحيح)	مطلوب. معرف النشاط التجاري الذي ستتم مشاركة الكتالوج معه.
`permitted_tasks` النوع: array (مصفوفة) < enum {MANAGE, ADVERTISE} >	مطلوب. المهام التي سيتم السماح للنشاط التجاري بتنفيذها. الخيارات المتوفرة هي: `['ADVERTISE', 'MANAGE']`.
`utm_settings` النوع: JSON object (كائن JSON) {enum{campaign_source,campaign_medium,campaign_name}: string}	اختياري. يمكنك تحديد `campaign_source` و`campaign_medium` و`campaign_name`. على سبيل المثال: `{campaign_source: “fb_campaign_source”}`.

business

النوع: numeric string (سلسلة رقمية) أو integer (عدد صحيح)

مطلوب.

معرف النشاط التجاري الذي ستتم مشاركة الكتالوج معه.

permitted_tasks

النوع: array (مصفوفة) < enum {MANAGE, ADVERTISE} >

مطلوب.

المهام التي سيتم السماح للنشاط التجاري بتنفيذها. الخيارات المتوفرة هي: ['ADVERTISE', 'MANAGE'].

utm_settings

النوع: JSON object (كائن JSON) {enum{campaign_source,campaign_medium,campaign_name}: string}

اختياري.

يمكنك تحديد campaign_source وcampaign_medium وcampaign_name.

على سبيل المثال: {campaign_source: “fb_campaign_source”}.

(لشركاء التسويق فقط) الخطوة الرابعة: توفير أدوات الاكتشاف للعلامات التجارية

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

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

GET {business-id}?fields=collaborative_ads_suggested_partners — ابحث عن شركاء لنشاط تجاري محدد.
GET collaborative_ads_directory?fields=collaborative_ads_merchants — احصل على القائمة الكاملة بتجار التجزئة للإعلانات التعاونية.
GET {cpas-advertiser-partnership-recommendation-id}?fields=advertiser_business_id,brand_business_id,brands,countries,merchant_business_id,status,status_reason — احصل على توصية واحدة لبائع التجزئة.

إذا وجدت علامة تجارية شريكًا، فيمكنك التواصل مع بائع التجزئة لطلب التعاون. افعل ذلك عن طريق إرسال الطلب التالي POST إلى /{cpas-collaboration-request-id}:

{business-id}/collaborative_ads_collaboration_requests?
brands=”[“[BRAND NAME]”, “[BRAND NAME 2]”]”&
contact_email=[CONTACT_EMAIL]&
contact_first_name=[CONTACT_FIRST_NAME]&
contact_last_name=[CONTACT_LAST_NAME]&
phone_number=[PHONE NUMBER]&
receiver_business=[RECEIVING BUSINESS ID]
requester_agency_or_brand=[REQUESTING ENTITY - AGENCY, BRAND or MERCHANT]

تتبع رسائل التواصل من خلال نقاط النهاية التالية:

خطوات العلامات التجارية

الخطوة الأولى: قبول شريحة الكتالوج

إذا لم تقبل علامتك التجارية شروط الخدمة الخاصة بالنشاط التجاري المشترك الجديد، فيجب القيام بذلك.

بعد استلام الأصل الذي تمت مشاركته، يحتاج مستخدم مسؤول النشاط التجاري إلى:

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

بعد قبول الشروط، يمكن لعلامتك التجارية إضافة أشخاص إلى شريحة الكتالوج باستخدام نقطة النهاية /{product-catalog-id}/assigned_users. ملاحظة: يتطلب هذا الإذن business_management.

الخطوة الثانية: إنشاء الحملة الإعلانية

لإكمال هذه الخطوة، يحتاج تطبيقك إلى الإذنين business_management وads_management.

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

لإنشاء الإعلانات وتشغيلها، فإنك تفعل ما تفعله عادةً مع كتالوج المنتجات لديك، ومع ذلك، يجب توفير catalog_segment_ID بدلاً من معرف الكتالوج:

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<CATALOG_SEGMENT_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

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

{
"id": "<CAMPAIGN_ID>"
}

هناك أربعة حقول يمكنك تعيينها عادةً من خلال إعلانات كتالوج Advantage+ والتي لا يمكنك استخدامها مع شريحة كتالوج:

يتم تعيين multi_share_end_card على false افتراضيًا ولا يمكنك تغييره
لا يمكنك التغيير description في template_data
template_url_spec التي يمكنك استخدامها لعناوين URL للروابط إلى مواضع معينة يجب أن تشير إلى موقع البائع على الويب
مواصفات التتبع المخصصة معطلة

الخطوة الثالثة: عرض التقارير

بمجرد تشغيل الإعلانات، يمكن لمعلني العلامة التجارية الحصول على أدوات قياس حول أداء الإعلانات. لدينا العديد من أدوات قياس الرؤى الجديدة على مستويات كائنات الإعلانات المختلفة. اطلع على catalog_segment_value وأدوات القياس ذات الصلة بـ:

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

الخطوة الرابعة: تصحيح الأخطاء وتشخيص المشكلات

يجب على العلامات التجارية الآن استكشاف الأخطاء وإصلاحها وتصحيح أي مشكلات في تشغيل إعلانات كتالوج Advantage+ لشريحة الكتالوج.

راجع أدوات تصحيح أخطاء إعلانات كتالوج Advantage+.

الرؤى

تتعلق أدوات القياس التقديرية التالية بالإعلانات التعاونية - راجع حول أدوات القياس التقديرية وأدوات القياس قيد التطوير والأدوات التابعة لجهات خارجية.

للاستعلام عن أي من أدوات قياس التقارير لدينا:

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

يمكن إجراء الاستعلامات على الكائنات التالية: الحساب الإعلاني، والحملة الإعلانية، والمجموعة الإعلانية، والإعلان.

تقسيم action_converted_product_id غير مدعوم على مستوى الحساب الإعلاني.

Metric	Description
`catalog_segment_value`	Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level.
`catalog_segment_value_omni_purchase_roas`	Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailer' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_value_website_purchase_roas`	Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_value_mobile_purchase_roas`	The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_actions`	Similar to `catalog_segment_value`, when using this metric a breakdown of actions is given for the catalog segment at each ad object level.
`converted_product_value`	Value of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see `/{product-item-id}` for information. If you want to get brand names as well, please use Ads Manager.
`converted_product_quantity`	Quantity of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see `/{product-item-id}` for information. If you want to get brand names as well, please use Ads Manager.

التقسيمات

يتم استخدام التقسيمات لتجميع نتائج الرؤى في مجموعات مختلفة - راجع التقسيمات. يمكنك استخدام التقسيمات التالية مع أدوات قياس الإعلانات التعاونية:

التاريخ: احصل على رؤى لنطاق تاريخ محدد. لاستخدام هذا التقسيم، أضف time_range إلى استعلامك. على سبيل المثال: &time_range[since]=2020-03-01&time_range[until]=2020-04-01.
مستوى المنتج: احصل على رؤى لمنتج محدد. استخدم هذا التقسيم من أجل converted_product_value وconverted_product_quantity metrics عن طريق إضافة إلى &action_breakdowns=action_converted_product_id الاستعلام.

دمج التقسيمات

استخدم التقسيمات المجمعة التالية للإعلانات التعاونية:

تقسيم action_converted_product_id غير مدعوم على مستوى الحساب الإعلاني.

action_converted_product_id
action_type، action_converted_product_id