Persiapan untuk tvOS 14+

Panduan ini menguraikan perubahan yang diperlukan untuk menyiapkan aplikasi Anda untuk tvOS 14.

Prasyarat

• Interactive Media Ads SDK 4.3.2 atau yang lebih tinggi.

Meminta otorisasi App Tracking Transparency

Untuk menampilkan permintaan otorisasi App Tracking Transparency untuk mengakses IDFA, perbarui Info.plist untuk menambahkan kunci NSUserTrackingUsageDescription dengan pesan kustom yang menjelaskan penggunaan Anda. Berikut adalah contoh teks deskripsi:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

Deskripsi penggunaan muncul di kotak dialog App Tracking Transparency:

Untuk menampilkan permintaan otorisasi, panggil requestTrackingAuthorizationWithCompletionHandler:. Sebaiknya tunggu callback penyelesaian sebelum memuat iklan, sehingga jika pengguna memberikan izin App Tracking Transparency, Interactive Media Ads SDK dapat menggunakan IDFA dalam permintaan iklan.

Swift

import AppTrackingTransparency
import AdSupport
...
func requestIDFA() {
  ATTrackingManager.requestTrackingAuthorization(completionHandler: { status in
    // Tracking authorization completed. Start loading ads here.
    // loadAd()
  })
}

Objective-C

#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>
...
- (void)requestIDFA {
  [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    // Tracking authorization completed. Start loading ads here.
    // [self loadAd];
  }];
}

Untuk mengetahui informasi selengkapnya tentang kemungkinan nilai status, lihat ATTrackingManager.AuthorizationStatus.

Poin Penting: Untuk pengalaman pengguna yang lebih baik, sebaiknya tambahkan penjelasan yang mendahului panggilan ke requestTrackingAuthorizationWithCompletionHandler: untuk memperjelas izin dan penggunaan data kepada pengguna.

ID pihak pertama penayang, sebelumnya disebut kunci aplikasi sama

Catatan: Kunci aplikasi sama telah diganti namanya menjadi ID pihak pertama penayang. API kunci aplikasi sama dapat berubah untuk mencerminkan ID pihak pertama penayang dalam rilis SDK mendatang. Perubahan ini tidak akan memengaruhi aktivasi kunci aplikasi sama yang ada di IMA SDK 3.14.5+. Semua versi SDK yang berlaku akan memproses ID dengan lancar.

Prasyarat: IMA SDK untuk iOS 3.14.5 atau yang lebih baru

Interactive Media Ads SDK untuk iOS memperkenalkan ID pihak pertama Penayang, yang sebelumnya dikenal sebagai kunci aplikasi sama untuk membantu Anda menayangkan iklan yang lebih relevan dan dipersonalisasi menggunakan data yang dikumpulkan dari aplikasi Anda.

ID pihak pertama penayang diaktifkan secara default, tetapi Anda selalu dapat memilih untuk menonaktifkannya di aplikasi dengan menetapkan IMASettings::SameAppKeyEnabled ke false:

Swift

let settings = IMASettings()
// Disables Publisher first-party ID, formerly known as same app key.
settings.SameAppKeyEnabled = false
adsLoader = IMAAdsLoader(settings: settings)

Objective-C

IMASettings *settings = [[IMASettings alloc] init];
// Disables Publisher first-party ID, formerly known as same app key.
settings.SameAppKeyEnabled = false;
IMAAdsLoader *adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];

Mengungkapkan penggunaan data di App Store

Apple mewajibkan developer yang memublikasikan aplikasi di App Store untuk mengungkapkan informasi tertentu terkait penggunaan data oleh aplikasi mereka. Apple telah mengumumkan bahwa pengungkapan ini akan diperlukan untuk aplikasi baru dan update aplikasi mulai tanggal 8 Desember 2020.

Pelajari persyaratan pengungkapan data lebih lanjut.