خيارات الشريك المميزة

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

التكوينات المتوفرة

استهداف الفئة

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

رؤى السلة

تقدم رؤى السلة معلومات حول فئات عمليات الشراء الأخرى التي تم شراؤها مع المنتج المعروض في إعلان العلامة التجارية أو المعلِن.

الجماهير المخصصة لبائع التجزئة

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

استرداد الخيارات المميزة

استخدم استدعاء API GET لاسترداد إعدادات الخيارات المميزة لشريحة كتالوج. يمكنك تقديم إما catalog_segment_id وpartner_business_id أو vendor_id فقط. إذا استخدمت كليهما، فتأكد أن catalog_segment_id يملكه المورد الذي تم تقديمه.

الطلب

للحصول على الإعدادات من خلال catalog_segment_id وpartner_business_id:

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .catalog_segment_id(CATALOG_SEGMENT_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  .vendor_id(VENDOR_ID) \
  &access_token=ACCESS_TOKEN"

للحصول على الإعدادات من خلال vendor_id فقط:

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .vendor_id(VENDOR_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  &access_token=ACCESS_TOKEN"

المعلمات

الاسمالوصف

business_id

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

مطلوب.
معرف النشاط التجاري الذي يتوفر فيه الكتالوج أو المورد.

catalog_segment_id

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

اختياري.
معرف شريحة الكتالوج المراد تحديثها. يتطلب إما هذا الحقل أو الحقل vendor_id.

vendor_id

string (سلسلة)

اختياري.
معرف المورد المراد تحديثه. يتطلب إما هذا الحقل أو الحقل catalog_segment_id.

partner_business_id

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

مطلوب.
معرف النشاط التجاري الخاص بالشريك المراد استرداده.

الاستجابة

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

{
  "collaborative_ads_partner_premium_options": {
    "enable_extended_audience_retargeting": bool,
    "enable_basket_insight": bool,
    "retailer_custom_audience_config": {
      "audience_id": [
        AUDIENCE_ID_1,
        AUDIENCE_ID_2,
        AUDIENCE_ID_3
      ]
    }
  }
}

تحديث الخيارات المميزة

استخدم استدعاء API POST لنقطة النهاية /{business_id}/partner_premium_options لتحديث معلومات الخيارات المميزة.

الطلب

لتحديث الإعدادات من خلال catalog_segment_id وpartner_business_id فقط:

curl -i -X POST \
  "https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?catalog_segment_id=CATALOG_SEGMENT_ID \
  &partner_business_id=PARTNER_BUSINESS_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

لتحديث الإعدادات من خلال vendor_id فقط:

curl -i -X POST \
"https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?vendor_id=VENDOR_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

المعلمات

الاسمالوصف

business_id

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

مطلوب.
معرف النشاط التجاري الذي يتوفر فيه الكتالوج أو المورد.

catalog_segment_id

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

اختياري.
معرف شريحة الكتالوج المراد تحديثها. يتطلب إما هذا الحقل أو الحقل vendor_id.

vendor_id

string (سلسلة)

اختياري.
معرف المورد المراد تحديثه. يتطلب إما هذا الحقل أو الحقل catalog_segment_id.

partner_business_id

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

مطلوب.
معرف النشاط التجاري الخاص بالشريك المراد استرداده.

enable_extended_audience_retargeting

Boolean (قيمة منطقية)

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

enable_basket_insight

Boolean (قيمة منطقية)

مطلوب. يمكنك تمكين رؤى السلة أو تعطيلها.

retailer_custom_audience_config

JSON object (كائن للغة JSON)
{audience_id: array of strings}

مطلوب.
يحتوي على قائمة audience_ids المراد مشاركة شريحة الكتالوج معها. لتعطيل المشاركة، أدخل مصفوفة فارغة.

مثال:{'audience_id':[AUDIENCE_IDs]}

الاستجابة

{
  "status": "success"
}

الحصول على معرفات الجماهير من مركز التعاون

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

التعرف على المزيد