رهنمودهای شروع اسناد SKAdNetwork

رابط برنامه‌نویسی کاربردی SKAdNetwork اپل با هدف سنجش موفقیت کمپین‌های تبلیغاتی نصب اپلیکیشن، ضمن حفظ حریم خصوصی کاربر طراحی شده است. برای SKAdNetwork نسخه‌های ۲.۰ و ۲.۱، انتساب نصب برای تبلیغات رندر شده توسط StoreKit با کلیک روی تبلیغ که منجر به نصب اپلیکیشن توسط کاربر می‌شود، انجام می‌شود. SKAdNetwork نسخه ۲.۲ و نسخه‌های بعدی علاوه بر این، از تبلیغات مشاهده‌ای نیز پشتیبانی می‌کند که در آن انتساب فقط با مشاهده تبلیغ انجام می‌شود.

دستورالعمل‌های زیر برای اطمینان از اینکه SDK تبلیغات موبایلی گوگل می‌تواند انتساب SKAdNetwork را به درستی آغاز کند، ارائه شده است.

انتساب کلیکی برای تبلیغات موبایلی

انتساب SKAdNetwork توسط رویداد کلیک تبلیغ Google Mobile Ads SDK فقط در صورتی آغاز می‌شود که عمل کلیک به طور خاص در فروشگاه App اپل قرار گیرد. دلیل این الزام، جلوگیری از راه‌اندازی فروشگاه App توسط کلیک‌هایی است که برای باز کردن فروشگاه App در نظر گرفته نشده‌اند . این نوع اقدامات کلیک می‌تواند شامل، به عنوان مثال، پیمایش به صفحه Ad Choices باشد.

دستورالعمل‌ها

برای تضمین اینکه کلیک روی تبلیغات و نصب‌های بعدی اپلیکیشن منجر به انتساب SKAdNetwork شود، هنگام ساخت طرح‌های خلاقانه، مطمئن شوید که URL کلیک روی طرح خلاقانه یکی از موارد زیر باشد:

  • یک لینک مستقیم به برنامه تبلیغ شده در اپ استور، یا
  • از روش‌های تغییر مسیر، مانند HTTP 301، 302 یا انواع دیگر زنجیره‌های تغییر مسیر HTTP سمت سرور استفاده می‌کند که مقصد نهایی آنها فروشگاه برنامه است.

لینک‌ها به اپ استور، چه مستقیم و چه از طریق زنجیره‌ی ریدایرکت، در صورتی تأیید می‌شوند که آدرس اینترنتی (URL) با هر یک از الگوهای زیر شروع شود:

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

هرگونه صفحه فرود دیگر یا استفاده از هر روش تغییر مسیر سمت کلاینت دیگر، در اپ استور قرار نمی‌گیرد و ممکن است فرآیند تخصیص SKAdNetwork را آغاز نکند. مثال‌ها:

  • صفحه HTML که نیاز به اقدام کاربر برای هدایت به فروشگاه برنامه دارد
  • صفحه HTML که دارای اسکریپت ریدایرکت خودکار مبتنی بر جاوا اسکریپت به اپ استور است
  • تگ‌های به‌روزرسانی متا

بهترین شیوه‌ها برای انواع مختلف خلاقیت

عمل کلیک برای شروع انتساب SKAdNetwork را می‌توان برای انواع مختلف خلاقیت به شرح زیر تنظیم کرد:

خلاقیت‌های HTML
این می‌تواند به عنوان URL مقصد در تگ‌های لنگر اطراف عنصر قابل کلیک، یا به عنوان URL هدف عملیات window.location از رویدادهای کلیک مبتنی بر جاوا اسکریپت تنظیم شود.
ام‌آر‌آی‌دی
عمل کلیک برای شروع انتساب SKAdNetwork نیاز به فراخوانی Mraid.open() دارد.
ویدیوی گسترده
آدرس اینترنتی فروشگاه اپلیکیشن باید در عنصر ClickThrough در VAST XML تنظیم شود.
بومی
آدرس اینترنتی فروشگاه برنامه باید برای OpenRTB در فیلد native.link.url (یا برای پروتکل منسوخ شده Google RTB در فیلد native_ad.click_link_url ) تنظیم شود.

انتساب مشاهده از طریق تبلیغات موبایلی

وقتی از قابلیت انتساب نمایش از طریق SKAdNetwork نسخه ۲.۲ پشتیبانی می‌شود، API مربوط به SKAdNetwork پس از نمایش و مشاهده تبلیغ توسط کاربر، یک تایمر نمایش را شروع می‌کند. انتساب فقط برای تبلیغاتی مجاز است که حداقل ۳ ثانیه نمایش داده شده باشند.

توجه داشته باشید که نسخه‌های iOS 15.3 و قبل از آن فقط از یک تایمر نمایش فعال در یک زمان پشتیبانی می‌کنند، که در این صورت اگر چندین تبلیغ نمایش در یک صفحه وجود داشته باشد، ممکن است نمایش در شروع انتساب نمایش از طریق نمایش با شکست مواجه شود. این محدودیت در iOS نسخه 15.4 و بالاتر برداشته شده است، بنابراین SKAdNetwork اکنون امکان چندین نمایش همزمان را برای انتساب نمایش از طریق نمایش فراهم می‌کند.

دستورالعمل‌ها

فیلد درخواست پیشنهاد BidRequest.imp.ext.skadn.fidelities مشخص می‌کند که کدام نوع وفاداری نسبت‌دهی پشتیبانی می‌شود. این فیلد شامل نوع وفاداری VIEW_THROUGH_ADS در نسخه‌های SKAdNetwork نسخه ۲.۲ یا بالاتر است.

اگر از قابلیت مشاهده از طریق ویژگی پشتیبانی نمی‌شود، مطمئن شوید که پاسخ پیشنهاد شامل ویژگی‌های VIEW_THROUGH_ADS نباشد. پاسخ دادن با ویژگی‌های VIEW_THROUGH_ADS در صورت عدم پشتیبانی، باعث می‌شود پیشنهاد قبل از حراج فیلتر شود.

سازگاری معکوس

از نسخه ۴.۰ SKAdNetwork، درخواست‌های تبلیغاتی که برای انتساب SKAdNetwork فعال شده‌اند، با نسخه‌های قبلی سازگار هستند. این به شبکه‌های تبلیغاتی اجازه می‌دهد تا حتی زمانی که درخواست تبلیغ از نسخه‌های جدیدتر پشتیبانی می‌کند، با نسخه‌های قبلی SKAdNetwork نیز پاسخ دهند.

دستورالعمل‌ها

نسخه سیستم عامل دستگاه کاربر و نسخه SDK تبلیغات موبایل گوگل برنامه ناشر، هر دو تعیین می‌کنند که کدام ویژگی‌های SKAdNetwork توسط درخواست تبلیغ پشتیبانی می‌شوند. این موضوع را می‌توان با استفاده از BidRequest.imp.ext.skadn.versions در درخواست پیشنهاد قیمت تعیین کرد. این فهرست، تمام نسخه‌های SKAdNetwork پشتیبانی شده توسط درخواست تبلیغ را نشان می‌دهد.

برای جلوگیری از فیلتر شدن پیشنهاد قیمت، مطمئن شوید که نسخه SKAdNetwork مورد استفاده برای ساخت پاسخ، یکی از نسخه‌های ذکر شده در درخواست پیشنهاد قیمت باشد. علاوه بر این، هنگامی که نسخه‌های جدیدتر SKAdNetwork معرفی می‌شوند، توجه داشته باشید که پاسخ دادن با نسخه‌های قبلی تا زمانی که نسخه در این لیست باشد، مجاز است. این به شبکه‌های تبلیغاتی اجازه می‌دهد تا به پاسخ دادن با نسخه‌های قبلی ادامه دهند و نسخه‌های جدیدتر را با سرعت خود تطبیق دهند.