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 Transparansi Pelacakan Aplikasi

Guna menampilkan permintaan otorisasi App Tracking Transparency untuk mengakses IDFA, perbarui Info.plist Anda agar dapat 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 akan muncul di kotak dialog App Tracking Transparency:

Untuk menampilkan permintaan otorisasi, panggil requestTrackingAuthorizationWithCompletionHandler:. Sebaiknya tunggu callback penyelesaian sebelum memuat iklan. Dengan begitu, 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 memberikan pengalaman pengguna yang lebih baik, sebaiknya tambahkan penjelasan sebelum panggilan ke requestTrackingAuthorizationWithCompletionHandler: untuk menjelaskan izin dan penggunaan data kepada pengguna.

ID pihak pertama penayang, sebelumnya dikenal sebagai 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 yang 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 tinggi

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 dapat selalu 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 aplikasi mereka. Apple telah mengumumkan bahwa pengungkapan ini akan diwajibkan untuk aplikasi baru dan update aplikasi mulai 8 Desember 2020.

Pelajari lebih lanjut persyaratan pengungkapan data.