الإصدار 3.0

واجهة API التسويق

تم الإصدار في 1 مايو 2018 | متوفر حتى 1 فبراير 2019 | منشور المدونة

• الميزات الجديدة
• أهم التغييرات
• حالات إيقاف الاستخدام
• حالات إيقاف الاستخدام الفورية

الميزات الجديدة

إستراتيجية عرض الأسعار الأقل تكلفة، الحقل bid_strategy

طرحنا الحقل الجديد bid_strategy في {account-id}/adsets والذي يمكّنك من تحديد إستراتيجية عروض الأسعار للإعلانات بناءً على أهداف نشاطك التجاري. وتحتوي كل استرايجية على مزايا ومبادلات. وتتضمن الخيارات ما يلي:

• LOWEST_COST - يمكن الحصول على معظم النتائج بناءً على ميزانية المجموعة الإعلانية وعرض optimization_goal. وسيوفر Facebook تلقائيًا عرض أسعار أكبر حسب الحاجة لإنفاق ميزانيتك. ويمكنك تعيين حد أقصى لعرض الأسعار أو عدم تعيين حد باستخدام هذا الخيار.

• TARGET_COST - يمكن توفير متوسط التكاليف الثابتة لإعلاناتك أثناء زيادة ميزانية المجموعة الإعلانية لديك.

لمزيد من المعلومات، راجع شراء الإعلانات والتحسين، إستراتيجية عرض الأسعار

إعلانات المجموعة، الإنشاء

واجهة API جديدة لإنشاء إعلانات المجموعة - في السابق، كان Facebook ينشئ لوحة في الخلفية في كل مرة تنشئ خلالها إعلان مجموعة. وقد عمل ذلك على تقييد إمكانية وصولك إلى اللوحة الأساسية؛ لذا لم تتمكّن من استخدامها لإعادة استهداف الجماهير باستخدام جماهير التفاعل مع اللوحة. وعندما تنشئ الآن إعلان مجموعة من مجموعات المنتجات، يجب أيضًا أن تنشئ بوضوح لوحة بالعناصر الصحيحة. وعندما تستخدم هذه اللوحة في إعلان مجموعة، سينشئ Facebook إعلان المجموعة تلقائيًا. لمزيد من التفاصيل، راجع إعلانات المجموعة من مجموعات المنتجات.

أهم التغييرات

إدارة الإعلانات

• إبطال العمود الأيسر - نعمل على إبطال الإعلانات التي تستهدف موضع Facebook فقط، right_hand_column مع أهداف غير صالحة في right_hand_column على {ad_account_id}/adsets. وندعم الآن الموضع الأيسر فقط في التنسيقات الإعلانية المدعومة مع هذه الأهداف: الزيارات والتحويلات ومبيعات كتالوج المنتجات.

• تم إيقاف استخدام is_autobid و is_average_price_pacing في GET وPOST وذلك في الإصدار 3.0 والإصدارات الأحدث.

الجماهير واستهداف الإعلانات

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

  • الجماهير المخصصة من موقع الويب، قواعد الجمهور،

  • الجماهير المخصصة من تطبيق الهواتف المحمولة، قواعد الجمهور،

  • الجماهير المخصصة للتفاعل مع الصفحة،

  • جماهير التفاعل مع إعلانات تجميع بيانات العملاء المحتملين،

  • جماهير التفاعل مع اللوحة،

  • الجماهير المخصصة من التحويلات غير المتصلة.

الإعلانات الديناميكية

• الوصول إلى كتالوج المنتجات - للوصول إلى عناصر الكتالوج، يجب تحديد مجال الكتالوج الصحيح. وإذا لم يتطابق طلبك مع المجال الصحيح للكتالوج لديك، فستتلقى خطأ. فعلى سبيل المثال، إذا كان لديك كتالوج للتجارة الإلكترونية، فيجب الوصول إليه باستخدام نقطة النهاية المقابلة /products، مثل GET {catalog_id}/products أو GET {product_feed_id}/products أو GET {product_set_id}/products. ولا يمكنك الوصول إلى الكتالوج باستخدام نقاط نهاية تابعة لمجالات أخرى، مثل GET {catalog_id}/autos أو GET {product_feed_id}/hotels أو GET {product_set_id}/flights.

• سلسلة فارغة في علامات القالب - لم نعد نسمح باستخدام السلاسل الفارغة كمعلمات للإعلانات الديناميكية، خيارات علامة القالب. فعلى سبيل المثال، إذا حاولت تمرير سلسلة فارغة إلى {{trip.checkin_date date_format:}}، فستتلقى خطأ. للحصول على المعلومات الأساسية، راجع الإعلانات الديناميكية، إدارة الإعلانات.

رؤى الإعلانات والقياس

• فترات مهلة الرؤى - إذا كنا نتوقع أن يؤدي طلب واجهة API الرؤى إلى انتهاء المهلة قبل الاكتمال، فسنقوم بإرجاع خطأ برمز الخطأ 100 والرمز الفرعي 1504033. ونقدر ذلك بناءً على حجم الطلب ومدى تقدم المعالجة فيما يتعلق بحدود المهلة. وإذا تلقيت هذا الخطأ، فيجب تقديم طلب غير متزامن لواجهة API الرؤى فيما يتعلق بهذه البيانات. لذا يرجى الرجوع إلى الوظائف غير المتزامنة لواجهة API الرؤى.

• القيم السالبة في بيانات الأحداث - إذا نشرت بيانات الأحداث في {data_set_id}/events مع وجود قيمة سالبة، فستفشل العملية. ويؤثر ذلك على الحقل data في POST /{data_set_id-id}/events.

• رؤى حول تحسين ميزانية الحملة الإعلانية - تقوم adset_budget_value الآن بإرجاع using campaign budget عندما تستخدم حملتك الإعلانية ميزة تحسين ميزانية الحملة الإعلانية. ويؤثر ذلك على:

  • GET {adaccount-id}/insights,

  • GET {campaign-id}/insights,

  • GET {adset-id}/insights,

  • GET {ad-id}/insights,

  • POST {adaccount-id}/insights,

  • POST {campaign-id}/insights,

  • POST {adset-id}/insights,

  • POST {ad-id}/insights.

• الفرز الافتراضي للبيكسل - اذا أجريت استدعاءً لعنصر الربط GET {account_id}/adspixel على حساب أعمال أو حساب إعلاني، فسنقوم بإرجاع نتائج تم فرزها وفقًا للإعدادات الافتراضية حسب اسم البيكسل بدلاً من وقت تشغيل البيكسل الأخير.

• إعادة تسمية حقل إحصاءات البيكسل - لقد أعدنا تسمية الحقل timestamp في عنصر ربط إحصاءات البيكسل ليكون start_time. يمثل ذلك وقت البدء عندما نبدأ في تجميع البيانات كل ساعة فيما يتعلق بعمليات تشغيل البيكسل. ونقوم بإرجاع ذلك الآن بتنسيق ISO 8601 وبتضمين إزاحة المنطقة الزمنية. ويعمل ذلك على إصلاح المشكلة المتعلقة بإرجاع الطوابع الزمنية Unix غير الصالحة. ستتأثر نقاط النهاية التالية: GET {ads-pixel-id}/stats.

حالات إيقاف الاستخدام

مدير الأعمال

تم إيقاف نقطة النهاية POST {pixel-id}/shared_agencies. ويرجى استخدام واجهة مستخدم مدير الأعمال لمشاركة بيكسل الإعلانات مع الوكالات.

إدارة الإعلانات

• تم إيقاف استخدام kpi_custom_conversion_id وkpi_type وkpi_results من /{ad_campaign_id} و/ad_account_ID/campaigns.

• تم إيقاف استخدام العلامة "إعادة التنزيل" من نقاط النهاية التالية لتبسيط واجهة API:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  لا يزال بإمكانك قراءة هذه المعلومات باستخدام المعلمة "الحقول".

• تم إيقاف استخدام الحقل zipbytes من POST act_{ad-account-id}/adimages وإزالة القدرة على تحميل الملفات المضغوطة بعنصر الربط هذا. يرجى استخدام صورة بالامتدادات التالية: jpg أو jpeg أو gif أو bmp أو png أو tiff أو tif.

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

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

شراء الإعلانات وعرض الأسعار

• تم إيقاف استخدام الحقلين is_autobid وis_average_price_pacing من نقطتي النهاية وهما: POST {ad-account-id}/adsets وPOST {adset-id}. وبدلاً من ذلك، استخدم الحقل الجديد bid_strategy لتحديد إستراتيجية عرض أسعار معينة للمجموعة الإعلانية. لمزيد من المعلومات، راجع عروض الأسعار والتحسين.

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

  • الحقل bid_estimate،

  • المعلمة currency،

  • المعلمة daily_budget،

  • المعلمة optimize_for

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

• تم إيقاف استخدام النتيجة التي تم إرجاعها من الحقل curve_budget_reach في GET /{rf-prediction-id}. ونقوم الآن بإرجاع الخريطة وأوقفنا استخدام قيمة عرض سلسلة بلغة JSON المتسلسلة. ويؤثر ذلك على: GET /{rf-prediction-id}.

• تم إيقاف استخدام عنصر الربط GET /{ad-account-id}/ratecard.

• تم إيقاف استخدام عدة حقول تتعلق بالفوترة في /ad_accounts. ويتضمن ذلك ما يلي:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• تم إيقاف استخدام الحقلين pixel_id وexternal_event_source في GET /customaudience.

رؤى الإعلانات والقياس

• تم إيقاف استخدام matched_unique_users في OFFLINE_EVENT_SET_ID الذي تم إرجاعه بواسطة GET /{data-set-id} وGET /{data-set-upload-id}. لذا يرجى الرجوع إلى واجهة API التحويلات غير المتصلة.

• تم إيقاف استخدام عنصر الربط attributed_events والحقل attribute_stats في GET /{data_set_id} API. استخدم واجهة API في GET /{data_set_id}/stats للحصول على إحصاءات الأحداث التي تم إسنادها.

• تم إيقاف استخدام الحقل matched_unique_users في OFFLINE_EVENT_SET_ID الذي تم إرجاعه بواسطة GET /{data-set-id} و/{data-set-upload-id} لطلب GET.

• تم إيقاف استخدام إرجاع القيم الافتراضية في GET {data_set_upload_id}. ولم يعد ذلك يقوم بإرجاع الحقول التالية افتراضيًا: first_upload_time وlast_upload_time وapi_calls وvalid_entries وmatched_entries وduplicate_entries وevent_time_min وevent_time_max وevent_stats وmatched_unique_users.

• تم إيقاف استخدام إرجاع القيم الافتراضية في GET {data_set_id}/stats. ويقوم ذلك الآن بإرجاع إحصاءات العدد افتراضيًا. ولتحديد الإحصاءات التي يجب إرجاعها، استخدم المعلمة fields أو المعلمة summary للإحصاءات التراكمية مثل average_upload_delay.

• تم إيقاف استخدام إرجاع القيم الافتراضية في GET {data_set_id}. ولم يعد ذلك يقوم بإرجاع الحقول التالية افتراضيًا: attribute_stats وduplicate_entries وevent_stats وevent_time_max وevent_time_min وmatched_entries وmatched_unique_users وusage وvalid_entries.

• تم إيقاف استخدام عنصر الربط GET {data-set-upload-id}/stats. ويرجى استخدام الحقل valid_entries أو matched_entries من GET {data-set-upload-id} بدلاً من ذلك.

• تم إيقاف استخدام canvas_component_avg_pct_view من واجهة API الرؤى.