API جودة الدمج

تتوفر API هذه في الإصدار التجريبي. بالنسبة إلى الوصول، يُرجى الاتصال بممثل Meta.

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

حول جودة مطابقة الأحداث

جودة مطابقة الأحداث

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

طريقة الحساب

يتم حساب جودة مطابقة الأحداث عن طريق النظر إلى معلمات معلومات العميل التي يتم استلامها من الخادم عبر دمج واجهة API التحويلات وجودة المعلومات التي تم استلامها والنسبة المئوية لمثيلات الأحداث التي تتم مطابقتها مع حساب Meta.

طريقة الاستخدام

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

يتم حساب جودة مطابقة الأحداث في الوقت الفعلي. تعرف على المزيد حول أفضل ممارسات جودة مطابقة الأحداث EMQ هنا.

لا تتوفر ميزة EMQ حاليًا إلا لأحداث الويب. بالنسبة إلى أنواع الأحداث الأخرى مثل أحداث المتجر الفعلي والمتاجر غير المتصلة أو أحداث التطبيق أو بيانات العملاء المحتملين للتحويل أو أي عملية دمج ضمن مراحل الإصدار التجريبي أو الاختباري، تواصل مع ممثل Meta للحصول على إرشادات حول تحسين جودة المطابقة.

حالات الاستخدام الشائعة

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

المصادقة

مصادقة المعلن عبر مدير الأعمال

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

مصادقة منصة الشريك

يجب أولاً طلب التصريح لإرسال الأحداث نيابةً عن عملائك. تتوفر لديك خيارات المصادقة التالية:

تسجيل دخول فيسبوك للأعمال (موصى به)

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

ملحق Meta للأعمال (موصى به)

من خلال هذا الخيار، يقوم ملحق Meta للأعمال (MBE) بإرجاع كل المعلومات الضرورية اللازمة لإرسال الأحداث نيابةً عن العميل. يوفر ملحق MBE نقطة نهاية لاسترداد رموز وصول مستخدم النظام التي يتم إنشاؤها في مدير الأعمال الخاص بالعميل. تتضمن هذه العملية أذونات لإرسال أحداث الخادم وتتم تلقائيًا وبشكل آمن. يتوفر ملحق MBE حاليًا في الإصدار التجريبي، يُرجى الاتصال بممثل Meta للحصول على إمكانية الوصول.

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

مشاركة العميل لبيكسل Meta مع مدير أعمال الشريك

من خلال هذا الخيار، يشارك العميل بيكسل Meta مع الشريك عبر إعدادات مدير الأعمال أو عبر API. بعد ذلك، يمكن للشريك تعيين مستخدم نظام شريك إلى بيكسل العميل وإنشاء رمز وصول لإرسال أحداث الخادم.

استرداد معلومات جودة دمج البيكسل

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

نقطة النهاية

https://graph.facebook.com/v21.0/<pixel_id>/integration_quality

المعلمات

المعلمة الوصف

المعلمة	الوصف
`agent_name` string (سلسلة)	اختياري. يتم استخدام القيمة العادية لحقل partner_agent فقط لفلترة الأحداث المرسلة من خلال معلمة partner_agent في طلب POST /{pixel_id}/events (راجع أفضل ممارسات إسناد الأحداث هنا وهنا). على سبيل المثال، إذا كانت قيمة partner_agent هي `[partner_name]_[majorversion]_[minorVersion]`، فستكون قيمة سلسلة الوكيل العادية هي `partner_name` بأحرف صغيرة. يسمح لك `agent_name` بتعيين معرف المنصة الخاص عند إرسال الأحداث نيابةً عن العميل. إذا كنت تمثل وكالة/شريكًا مدارًا، فيمكنك التواصل مع ممثل Meta الذي تتعامل معه للاتفاق على معرف لمنصتك. إذا كنت معلنًا، ففي معظم الأوقات لن تحتاج إلى القلق بشأن إسناد `agent_name`. إذا لم توفر `agent_name`، فسيتم تضمين كل الأحداث في عملية حساب جودة مطابقة الأحداث EMQ بغض النظر عما إذا تم إرسالها بواسطة وكيل أم لا.

agent_name

string (سلسلة)

اختياري.
يتم استخدام القيمة العادية لحقل partner_agent فقط لفلترة الأحداث المرسلة من خلال معلمة partner_agent في طلب POST /{pixel_id}/events (راجع أفضل ممارسات إسناد الأحداث هنا وهنا).

على سبيل المثال، إذا كانت قيمة partner_agent هي [partner_name]_[majorversion]_[minorVersion]، فستكون قيمة سلسلة الوكيل العادية هي partner_name بأحرف صغيرة.

يسمح لك agent_name بتعيين معرف المنصة الخاص عند إرسال الأحداث نيابةً عن العميل. إذا كنت تمثل وكالة/شريكًا مدارًا، فيمكنك التواصل مع ممثل Meta الذي تتعامل معه للاتفاق على معرف لمنصتك.

إذا كنت معلنًا، ففي معظم الأوقات لن تحتاج إلى القلق بشأن إسناد agent_name.

إذا لم توفر agent_name، فسيتم تضمين كل الأحداث في عملية حساب جودة مطابقة الأحداث EMQ بغض النظر عما إذا تم إرسالها بواسطة وكيل أم لا.

الحقول

الحقل	الوصف
`event_name` string (سلسلة)	اسم حدث قياسي أو حدث مخصص.
`event_match_quality` AdsPixelCAPIEMQ	تشير جودة مطابقة الأحداث إلى مدى فعالية معلومات العميل المرسلة من جانب الخادم في مطابقة مثيلات الأحداث بحساب فيسبوك.

مثال

مستكشف Graph API

GET/v21.0/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>

cURL

curl -X GET -G \
  -d 'fields="event_match_quality,event_name"' \
  -d 'agent_name="&lt;AGENT_NAME&gt;"' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality

استجابة API

{
  "data": [
    {
      "event_match_quality": {
        "composite_score": 5.1,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          }
        ]      
      },
      "event_name": "pLTVPurchase"
    },
    {
      "event_match_quality": {
        "composite_score": 7.2,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "phone",
            "coverage": {
              "percentage": 69.1
            }
          },
          {
            "identifier": "fbp",
            "coverage": {
              "percentage": 96.7
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "fbc",
            "coverage": {
              "percentage": 3.2
            }
          }
        ]
      },
      "event_name": "CompleteRegistration"
    }
  ]
}

الأسئلة المتكررة

What is the access token used for?

The access token is used when partners send signal events or access the Setup Quality API on behalf of advertisers. The client system user access token onboarding method is not compatible with the EMQ API at the moment.

الرابط الثابت

How should the partner_agent field be formatted?

The partner_agent value in your API GET request should be a normalized lowercase format. This field is now optional.

الرابط الثابت

معرفة المزيد

أفضل ممارسات واجهة API التحويلات.
تحسين الأداء من خلال الإعداد المحسّن لواجهة API التحويلات.
أفضل الممارسات لتأهيل واجهة API التحويلات للشركاء
إرشادات جودة إعداد واجهة API التحويلات من مركز مساعدة الأعمال من Meta:

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

عرض تفاصيل أحداث الخادم في مدير الأحداث من Meta. بعد أن تقوم الأنشطة التجارية بإعداد واجهة API التحويلات، يمكنها استخدام هذه المقالة للتعرف على كيفية التحقق من الأحداث والمعلمات للتأكد من عمل الإعداد بشكل فعال ولتحديد فرص التحسين. كما يمكنها أيضًا استخدام هذه المقالة للتعرف على كيفية استخدام تفاصيل حدث الخادم (مطابقة الأحداث [جودة مطابقة الأحداث/EMQ])، حداثة البيانات ونظرة عامة على الأحداث وإلغاء تكرار الأحداث) في مدير الأحداث لتحسين إعداد واجهة API التحويلات.