إرشادات بدء إحالة 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 إلى متجر التطبيقات
  • علامات إعادة التحميل الوصفية

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

يمكن إعداد إجراء النقر لبدء تحديد المصدر في 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، يُرجى العِلم أنّه يُسمح بالرد باستخدام إصدارات أقدم ما دام الإصدار مدرَجًا في هذه القائمة. ويتيح ذلك لشبكات الإعلانات مواصلة الرد باستخدام الإصدارات السابقة وتكييف الإصدارات الأحدث بالسرعة التي تناسبها.