Menyiapkan versi iOS

ID pihak pertama penayang, dan mengungkapkan penggunaan data di App Store untuk Google Interactive Media Ads (IMA) SDK untuk iOS.

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

Prasyarat

• Interactive Media Ads SDK 3.12.1 atau yang lebih baru.

Meminta otorisasi Transparansi Pelacakan Aplikasi

Poin Penting: Jika memutuskan untuk menyertakan Transparansi Pelacakan Aplikasi (ATT) di aplikasi, Anda dapat menggunakan User Messaging Platform (UMP) SDK untuk memicu penjelasan IDFA yang memberi pengguna konteks tentang alasan Anda meminta izin ini. Perlu diketahui bahwa penggunaan UMP SDK memengaruhi semua pengguna aplikasi Anda.

Jika Anda tidak menggunakan UMP SDK, bagian lain di halaman ini akan menunjukkan cara menerapkan permintaan otorisasi ATT tingkat OS secara manual.

Untuk menampilkan permintaan otorisasi Transparansi Pelacakan Aplikasi untuk mengakses IDFA, perbarui Info.plist untuk menambahkan kunci NSUserTrackingUsageDescription dengan pesan kustom yang menjelaskan penggunaan Anda. Berikut 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 Transparansi Pelacakan Aplikasi:

Untuk menampilkan permintaan otorisasi, panggil requestTrackingAuthorizationWithCompletionHandler:. Sebaiknya tunggu callback penyelesaian sebelum memuat iklan sehingga jika pengguna memberikan izin Transparansi Pelacakan Aplikasi, 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 mengklasifikasikan 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, sebelumnya disebut kunci aplikasi sama untuk membantu Anda menayangkan iklan yang dipersonalisasi dan lebih relevan menggunakan data yang dikumpulkan dari aplikasi.

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 diwajibkan untuk aplikasi baru dan update aplikasi mulai 8 Desember 2020.

Pelajari lebih lanjut persyaratan pengungkapan data.