إرشادات بدء إحالة SKAdNetwork

تهدف واجهة برمجة التطبيقات SKAdNetwork من Apple إلى قياس مدى نجاح الحملات الإعلانية التي تهدف إلى تثبيت التطبيقات مع الحفاظ على خصوصية المستخدمين. في الإصدارَين 2.0 و2.1 من SKAdNetwork، يتم تحديد مصدر الإحالات الناجحة للإعلانات المعروضة باستخدام StoreKit من خلال النقرات على الإعلان التي تؤدي إلى تثبيت المستخدم للتطبيق. يتيح الإصدار 2.2 من SKAdNetwork والإصدارات الأحدث أيضًا الإعلانات التي يتم تحديد مصدر إحالاتها الناجحة من خلال مشاهدة الإعلان فقط.

يتم تقديم الإرشادات التالية لضمان قدرة حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة على بدء تحديد المصدر في SKAdNetwork بشكل صحيح.

إحالة النقرات إلى مصدرها في الإعلانات على الأجهزة الجوّالة

يتم بدء تحديد المصدر في SKAdNetwork من خلال حدث النقر على الإعلان في حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة فقط إذا أدّى إجراء النقر إلى الانتقال إلى Apple App Store تحديدًا. والسبب في هذا الشرط هو منع إطلاق متجر التطبيقات من خلال النقرات التي لا يُقصد بها فتح متجر التطبيقات. يمكن أن تشمل أنواع إجراءات النقر هذه، على سبيل المثال، الانتقال إلى صفحة "خيارات الإعلانات".

الإرشادات

لضمان أن تؤدي إجراءات النقر على الإعلانات وعمليات تثبيت التطبيق اللاحقة إلى تحديد مصدر الإحالة الناجحة في SKAdNetwork، احرص عند إنشاء تصاميم الإعلانات على أن يكون عنوان URL للنقرة في تصميم الإعلان أحد الخيارَين التاليَين:

  • رابط مباشر إلى التطبيق المُعلَن عنه في متجر التطبيقات
  • تستخدِم طرق إعادة التوجيه، مثل HTTP 301 أو 302 أو أنواع أخرى من سلاسل إعادة التوجيه عبر بروتوكول HTTP من جانب الخادم التي تؤدي إلى وجهة نهائية في متجر التطبيقات.

يتم تأكيد الروابط المؤدية إلى متجر التطبيقات إما مباشرةً أو من خلال سلسلة إعادة توجيه إذا كان عنوان URL يبدأ بأي من الأنماط التالية:

  • https://apps.apple.com
  • https://itunes.apple.com
  • itms-apps://
  • itms://

أي صفحات مقصودة أخرى أو استخدام أي طرق أخرى لإعادة التوجيه من جهة العميل سيؤدي إلى عدم الوصول إلى متجر التطبيقات، وقد لا يؤدي إلى بدء عملية تحديد المصدر في SKAdNetwork. أمثلة:

  • صفحة HTML تتطلّب من المستخدم اتّخاذ إجراء لإعادة التوجيه إلى متجر التطبيقات
  • صفحة HTML تحتوي على نص برمجي آلي لإعادة التوجيه استنادًا إلى JavaScript إلى متجر التطبيقات
  • علامات Meta refresh

أفضل الممارسات لأنواع تصاميم الإعلانات المختلفة

يمكن إعداد إجراء النقر لبدء تحديد المصدر في SKAdNetwork لأنواع تصميمات الإعلانات المختلفة على النحو التالي:

المواد الإبداعية بتنسيق HTML
يمكن إعداد ذلك كعنوان URL مقصود في علامات الربط المحيطة بالعنصر القابل للنقر، أو كعنوان URL مستهدف لعمليات window.location من JavaScript استنادًا إلى أحداث النقر.
MRAID
يجب أن يستدعي إجراء النقر Mraid.open() لبدء تحديد المصدر في SKAdNetwork.
فيديو بتنسيق VAST
يجب ضبط عنوان URL لمتجر التطبيقات في العنصر ClickThrough ضمن ملف VAST XML.
مدمجة مع المحتوى
يجب ضبط عنوان URL لمتجر التطبيقات في الحقل native.link.url الخاص ببروتوكول OpenRTB (أو الحقل native_ad.click_link_url الخاص ببروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google المتوقّف نهائيًا).

تحديد مصدر الإحالة الناجحة بعد رؤية الإعلان فقط للإعلانات على الأجهزة الجوّالة

عندما تتوفّر ميزة تحديد المصدر المستنِد إلى مشاهدة الإعلان في الإصدار 2.2 من SKAdNetwork، تبدأ واجهة برمجة التطبيقات SKAdNetwork مؤقّت مرّة الظهور بمجرد عرض الإعلان ومشاهدته من قِبل المستخدِم. لا يُسمح بتحديد المصدر إلا للإعلانات التي تم عرضها لمدة 3 ثوانٍ على الأقل.

يُرجى العِلم أنّ الإصدارات 15.3 والإصدارات الأقدم من نظام التشغيل iOS تتيح استخدام مؤقّت واحد نشط لمرات الظهور في كل مرة، وفي هذه الحالة، قد يتعذّر بدء عملية تحديد مصدر الإحالة الناجحة من خلال المشاهدة إذا كانت هناك إعلانات متعددة لتحديد مصدر الإحالة الناجحة من خلال المشاهدة ضمن الشاشة نفسها. تم إلغاء هذا القيد في الإصدار 15.4 من نظام التشغيل iOS والإصدارات الأحدث، لذا تسمح SKAdNetwork الآن بتسجيل مرات ظهور متزامنة متعددة مفعّلة لتحديد المصدر من خلال المشاهدة.

الإرشادات

يحدّد حقل طلب عروض الأسعار BidRequest.imp.ext.skadn.fidelities أنواع دقة تحديد المصدر المتاحة. يتضمّن هذا الحقل نوع دقة VIEW_THROUGH_ADS في الإصدارات 2.2 أو الإصدارات الأحدث من SKAdNetwork.

تأكَّد من أنّ استجابة عرض السعر لا تتضمّن VIEW_THROUGH_ADS fidelities إذا لم يكن متاحًا تتبُّع المصدر من خلال مشاهدة الإعلان. سيؤدي الردّ باستخدام دقة VIEW_THROUGH_ADS عندما لا تكون متاحة إلى فلترة عرض السعر قبل المزاد.

التوافق مع الأنظمة القديمة

اعتبارًا من الإصدار 4.0 من SKAdNetwork، تتوافق طلبات الإعلانات المفعّلة لتحديد مصدر الإحالات الناجحة على SKAdNetwork مع الإصدارات السابقة. يتيح ذلك لشبكات الإعلانات الاستجابة باستخدام إصدارات SKAdNetwork الأقدم حتى عندما يتوافق طلب الإعلان مع الإصدارات الأحدث.

الإرشادات

يحدّد كلّ من إصدار نظام التشغيل على جهاز المستخدم وإصدار حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" في تطبيق الناشر ميزات SKAdNetwork التي يتوافق معها طلب الإعلان. يمكن تحديد ذلك في طلب عرض السعر باستخدام BidRequest.imp.ext.skadn.versions. تعرض هذه السمة جميع إصدارات SKAdNetwork التي يتيحها طلب الإعلان.

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