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

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

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

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

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

الإرشادات

لضمان أن تؤدي إجراءات النقر على الإعلانات وعمليات تثبيت التطبيقات اللاحقة إلى منجرٍ إلى تحديد مصدر الإحالة الناجحة على 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 لبروتوكول Google RTB الذي تم إيقافه نهائيًا).

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

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

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

الإرشادات

يحدِّد حقل طلب عرض السعر BidRequest.imp.ext.skadn.fidelities في OpenRTB (أو BidRequest.mobile.skadn.supported_fidelity_types في بروتوكول RTB من Google المتوقف نهائيًا) أنواع دقّة تحديد المصدر المتوافقة مع طلب عرض السعر. يتضمّن هذا الحقل نوع الدقّة VIEW_THROUGH_ADS في إصدارات SKAdNetwork 2.2 والإصدارات الأحدث.

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

التوافق مع الإصدارات السابقة

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

الإرشادات

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

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