تُعد ميزة تسجيل دخول فيسبوك طريقة جديدة للسماح بالوصول إلى بيانات API إعداد تقارير في Audience Network. سيحل هذا النهج محل رمز مستخدم النظام القديم الذي يتم نسخه ولصقه من واجهة مدير الأرباح. ويُعد هذا النهج طريقة أكثر أمانًا لمنح الوصول إلى بياناتك، نظرًا لخطر الكشف عن رمز مدير الأرباح خارج النشاط التجاري.
يركز هذا المستند على توفير إرشادات حول عمليات دمج 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 إعداد التقارير في Audience Network باستخدام هذا الرمز.
يُعد الدليل التالي مفيدًا للناشرين والشركاء الذين لديهم واجهة المستخدم الخاصة حيث يمكن وضع زر تسجيل دخول فيسبوك. سيكون هذا الدليل مفيدًا للناشرين الذين ينوون الوصول إلى بياناتهم الخاصة، بالإضافة إلى الشركاء الذين يرغبون في الوصول إلى بيانات أرباح الناشرين الآخرين باستخدام هذا الإذن.
يمكنك أيضًا التحقق من الفيديو التوضيحي الشامل في الدليل التالي الذي يتضمن خطوة الحصول على الأذونات أعلاه:
read_audience_network_insights
الذي تم الوصول إليه مؤخرًا بدلاً من أذونات "public_profile,email
" المقترحة. في وجود الإذن المحدَّث، يجب أن يبدو رمز الزر هكذا: <fb:login-button scope="read_audience_network_insights" onlogin="checkLoginState();"> </fb:login-button>
statusChangeCallback
بلغة JavaScript من الخطوات السابقة.رسالة الخطأ | ما يعنيه ذلك | الإجراء / كيفية الحل |
---|---|---|
قراءة رؤى خاصة بصفحة أو نشاط تجاري أو تطبيق أو نطاق أو مجموعة مصادر حدث غير مملوكة بواسطة التطبيق أو المستخدم الذي يُجري الاستعلام | بالنسبة إلى رمز تسجيل دخول فيسبوك، يشير هذا إلى أن رمز التطبيق الذي تم إصداره لا تتوفر فيه أذونات كافية ( | يحتاج مسؤول مدير الأعمال إلى توفير صلاحية الوصول إلى كل الخصائص لدى المستخدم الذي يريد إنشاء الرمز أو أنشأ الرمز بالفعل. |
البيانات مفقودة أو فارغة | هذا يعني عادةً أن كل البيانات أو بعضها قد تمت فلترتها باستخدام تجميع الخصوصية. يمكن أيضا التحقق من البيانات بمقارنتها مع بيانات MoMa. | تحقق مما إذا كانت هناك مصفوفة |
| التطبيق الذي تم إنشاؤه لإنشاء الرمز ليس محددًا بالنوع "أعمال" كما أن ذلك التطبيق قد تم ربطه بمدير الأرباح في Audience Network. | تأكد من إنشاء التطبيق المطلوب لتكوين رمز كتطبيق "أعمال". حاول إنشاء تطبيق جديد وتأكد من اتباع الإرشادات المتوفرة ضمن قسم "الأذونات". انتقل إلى developers.facebook.com/apps وحدّد التطبيق الذي لا يمكنك رؤية |
| انتهت صلاحية الرمز | يُرجى التأكد من تحويل الرمز إلى رمز طويل الأجل. اتبع الإرشادات المتوفرة ضمن قسم "تحويل هذا الرمز إلى رمز وصول طويل الأجل"، حيث يتم تحديث الرموز طويلة الأجل مرة واحدة يوميًا، عند إرسال طلب API إعداد التقارير في خوادم فيسبوك. إذا لم يتم إرسال أي طلبات، فستنتهي صلاحية الرمز بعد حوالي 60 يومًا وسيحتاج الشخص إلى إنشاء رمز جديد. |
يوجد تطبيقان بالاسم ذاته | تحقق مما إذا كان يتوفر لدى أحد التطبيقات الأذونات | استخدم التطبيق الذي لا يتوفر لديه إذن |
(#200) لقد تم تغيير طريقة الوصول إلى الإصدار 2.0 من API إعداد التقارير. عليك الآن تنفيذ تسجيل دخول فيسبوك ليتمكن تطبيقك من الوصول إلى API هذه. | أنت لا تستخدم بيانات الاعتماد للوصول إلى API بالطريقة الجديدة. | تأكد من إنشاء تطبيق جديد من الصفر (ليتم استخدامه فقط لإنشاء الرموز) وأنه محدد بالنوع "أعمال". |