دمج تسجيل دخول فيسبوك مع الإصدار 2 من API إعداد التقارير في Audience Network

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

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

أستخدم جهة خارجية للحصول على بيانات API إعداد التقارير

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

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

الأذونات

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

  • حدّد نشاطك التجاري الذي تم إنشاؤه حديثًا في حقل حساب الأعمال

تم الآن تأهيل تطبيقك لاستخدام Audience Network ويمكنه استخدام الإذن read_audience_network_insights. إذا لم تتمكن من رؤية read_audience_network_insights فتأكد من أن تطبيقك مرتبطًا بنشاط تجاري يمكنه الوصول إلى حساب الأعمال الخاص بمدير الأرباح.

إذا حصلت على الإذن read_insights permission سابقًا من خلال تسجيل دخول فيسبوك، فسيظل بإمكانك مواصلة العمل بهذا الإذن ولكننا نقترح الانتقال إلى الإذن read_audience_network_insights.

ستختلف طريقة التعامل مع الوصول إلى API إعداد التقارير حسب نوع الدمج لديك. يُرجى اتباع الإرشادات التي تنطبق على حالتك:

دمج API المباشر من دون واجهة المستخدم

إذا كان لديك دمجًا مخصصًا لواجهة API إعداد التقارير (مباشر) من دون واجهة مستخدم/واجهة أمامية واستخدمته للاستعلام عن بيانات النشاط التجاري فقط، فيمكنك استخدام الإرشادات التالية للوصول إلى API إعداد التقارير.

إنشاء رمز المستخدم من خلال مستكشف Graph API

  1. إذا كنت تستخدم بالفعل "API التسويق" في تطبيقك، فيمكنك تخطي هذه الخطوة. بخلاف ذلك، اتبع الإرشادات حول الحصول على الإذن read_audience_network_insights
  2. انتقل إلى مستكشف Graph API
  3. حدد التطبيق
  4. حدّد الإذن "read_audience_network_insights" (يمكن العثور عليه ضمن الأذونات > صفحات مجموعة الأحداث) وانقر على "إنشاء رمز وصول".
    1. يمكنك الآن الوصول إلى بيانات API إعداد التقارير في Audience Network لمدة قصيرة باستخدام هذا الرمز بدلاً من الرمز الذي يوفره مدير الأرباح
    2. إخلاء مسؤولية: ستنتهي صلاحية هذا الرمز في غضون ساعتين، وستحتاج إلى تحويله إلى رمز وصول طويل الأجل باستخدام الإرشادات أدناه.

تحويل هذا الرمز إلى رمز وصول طويل الأجل

  1. انتقل إلى أداة تصحيح أخطاء رموز الوصول
  2. أدخل الرمز واضغط على "تصحيح الخطأ"
  3. مرّر لأسفل الجدول الذي يحتوي على كل معلومات الرمز، وانقر على الزر "تمديد رمز الوصول"
  4. نسخ الرمز الناتج

يمكنك الآن الوصول إلى بيانات API إعداد التقارير في Audience Network باستخدام هذا الرمز.

دمج API المباشر في وجود واجهة المستخدم

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

يمكنك أيضًا التحقق من الفيديو التوضيحي الشامل في الدليل التالي الذي يتضمن خطوة الحصول على الأذونات أعلاه:

حدث خطأ ما
لدينا مشكلة في تشغيل هذا الفيديو.
  • في بوابة المطوّرين، حدّد تطبيق الأعمال الذي تم إنشاؤه مؤخرًا من الخطوات السابقة
  • إضافة منتج "تسجيل دخول فيسبوك" جديد إلى هذا التطبيق
  • حدّد الخيار "ويب" واتباع خطوات الدمج
  • أدخل عنوان URL موقع الويب حيث ستعرض تجربة تسجيل دخول فيسبوك. وتأكد من دعمه لبروتوكول HTTPS
  • في نهاية خطوات الدمج، ستحصل على رمز نموذجي لدمج تسجيل دخول فيسبوك في الموقع لديك. ومع ذلك، يمكنك نسخ هذا الرمز باستخدام الإذن read_audience_network_insights الذي تم الوصول إليه مؤخرًا بدلاً من أذونات "public_profile,email" المقترحة. في وجود الإذن المحدَّث، يجب أن يبدو رمز الزر هكذا:
<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>
  • تأكد من تمكين مجموعة SDK للغة JavaScript في صفحة إعدادات منتجات تسجيل دخول فيسبوك في تطبيقك
  • يمكن للمستخدمين الآن الخضوع إلى دفق تسجيل دخول فيسبوك في صفحتك لإنشاء رمز الوصول
  • سيتم إرجاع رمز الوصول كجزء من الوسيطة التي تم إدخالها في أسلوب statusChangeCallback بلغة JavaScript من الخطوات السابقة.
  • بشكل افتراضي، ستنتهي صلاحية هذا الرمز في غضون ساعتين تقريبًا
  • يمكن للمطوّرين طلب تمديد هذا الرمز ليصبح ضمن رموز الوصول طويلة الأجل دون الحاجة إلى أي تفاعل إضافي من جانب المستخدم.
    • يتم تحديث الرموز طويلة الأجل مرة واحدة يوميًا، عند إرسال طلب API إعداد التقارير إلى خوادم فيسبوك. إذا لم يتم إرسال أي طلبات، فستنتهي صلاحية الرمز بعد حوالي 60 يومًا وسيحتاج الشخص إلى إنشاء رمز جديد.
  • تذكر أن البيانات المتوفرة من خلال هذا الرمز تعتمد بشكل كبير على الجهة التي تقوم بإدخال البيانات عبر دفق تسجيل دخول فيسبوك هذا ونوع البيانات التي وافقت على مشاركتها. لذا، إذا كان موظف النشاط التجاري يُدخل البيانات عبر هذا الدفق، فسيكون لرمز الوصول الناتج الأذونات ذاتها الموجودة لدى هذا الموظف.

استكشاف الأخطاء وإصلاحها

رسالة الخطأما يعنيه ذلكالإجراء / كيفية الحل

قراءة رؤى خاصة بصفحة أو نشاط تجاري أو تطبيق أو نطاق أو مجموعة مصادر حدث غير مملوكة بواسطة التطبيق أو المستخدم الذي يُجري الاستعلام

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

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

البيانات مفقودة أو فارغة

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

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

read_audience_network_insights غير مرئي بالنسبة للرمز

التطبيق الذي تم إنشاؤه لإنشاء الرمز ليس محددًا بالنوع "أعمال" كما أن ذلك التطبيق قد تم ربطه بمدير الأرباح في Audience Network.

تأكد من إنشاء التطبيق المطلوب لتكوين رمز كتطبيق "أعمال". حاول إنشاء تطبيق جديد وتأكد من اتباع الإرشادات المتوفرة ضمن قسم "الأذونات". انتقل إلى developers.facebook.com/apps وحدّد التطبيق الذي لا يمكنك رؤية read_audience_network_insights فيه وحدد "Audience Network" وانقر على زر "الإعداد".

Error validating access token: Session has expired on ...

انتهت صلاحية الرمز

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

يوجد تطبيقان بالاسم ذاته

تحقق مما إذا كان يتوفر لدى أحد التطبيقات الأذونات read_audience_network_insights

استخدم التطبيق الذي لا يتوفر لديه إذن read_audience_network_insights الصحيح

(#200) لقد تم تغيير طريقة الوصول إلى الإصدار 2.0 من API إعداد التقارير. عليك الآن تنفيذ تسجيل دخول فيسبوك ليتمكن تطبيقك من الوصول إلى API هذه.

أنت لا تستخدم بيانات الاعتماد للوصول إلى API بالطريقة الجديدة.

تأكد من إنشاء تطبيق جديد من الصفر (ليتم استخدامه فقط لإنشاء الرموز) وأنه محدد بالنوع "أعمال".