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

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

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

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

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

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

الأذونات

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

• بمجرد إعداد النشاط التجاري في مدير الأرباح، انتقل إلى صفحة مطوّري فيسبوك وأنشئ تطبيق أعمال جديد

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

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

يمكنك أيضًا القيام بذلك بالانتقال إلى developers.facebook.com/apps وتحديد التطبيق الذي أنشأته للتو.

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

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

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

• دمج API المباشر من دون واجهة المستخدم
• دمج 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 يومًا وسيحتاج الشخص إلى إنشاء رمز جديد.
• تذكر أن البيانات المتوفرة من خلال هذا الرمز تعتمد بشكل كبير على الجهة التي تقوم بإدخال البيانات عبر دفق تسجيل دخول فيسبوك هذا ونوع البيانات التي وافقت على مشاركتها. لذا، إذا كان موظف النشاط التجاري يُدخل البيانات عبر هذا الدفق، فسيكون لرمز الوصول الناتج الأذونات ذاتها الموجودة لدى هذا الموظف.

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