Unijny monit śledzenia w iOS 27.2: co wdrożyć

Od iOS 27.2 i iPadOS 27.2 aplikacja w Unii Europejskiej może pokazać alternatywny monit App Tracking Transparency, a aplikacja dystrybuowana we Francji, w Niemczech, we Włoszech, w Polsce lub w Rumunii dostaje wyłącznie tę wersję, zarówno z nowego wywołania, jak i ze starego. SDK bety 27.2 dodaje jedną metodę, requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:), dostępną w iOS 27.2 i niedostępną na macOS, tvOS, watchOS oraz visionOS, a także jeden opcjonalny klucz Info.plist, NSUserTrackingMarkdownUsageDescription. Poza UE nowe wywołanie zachowuje się jak stare, reguła mówiąca, kiedy trzeba zapytać, nie zmienia się, a użytkowników z UE można zapytać ponownie rok po ich poprzedniej odpowiedzi. Kroki wdrożenia znajdują się niżej. Na symulatorze bety 27.2, z regionem ustawionym na Stany Zjednoczone, Niemcy, Holandię lub Francję, każde wywołanie, które udało mi się powtórzyć po czystym starcie, pokazało standardowy alert, czyli dokładnie to, co Apple dokumentuje jako zachowanie zapasowe dla urządzenia spoza UE; na podstawie tych dowodów arkusz pozostaje testem na urządzeniu.¹²³⁴⁵ {.answer-block}

TL;DR

• Komunikat Apple z 16 września. „Beginning with iOS 27.2 and iPadOS 27.2, developers will have the option to use an alternative version of the App Tracking Transparency system prompt in the EU. The requirements for when you must seek permission to track users will remain the same. Due to legal requirements, only the alternative version of the system prompt is available for apps distributed in Germany, France, Italy, Poland, and Romania.” (od iOS 27.2 i iPadOS 27.2 można w UE użyć alternatywnej wersji systemowego monitu App Tracking Transparency; wymagania dotyczące tego, kiedy trzeba prosić o zgodę, pozostają bez zmian, a z uwagi na wymogi prawne tylko ta alternatywna wersja jest dostępna dla aplikacji dystrybuowanych w Niemczech, we Francji, we Włoszech, w Polsce i w Rumunii).¹
• Jedna nowa metoda. Plik ATTrackingManager.h z SDK bety 27.2 deklaruje requestTrackingAuthorizationUsingExpandedInterface:additionalInformationAction:completionHandler: z API_AVAILABLE(ios(27.2)) API_UNAVAILABLE(macos, tvos, watchos, visionos). Komentarz w nagłówku: „This method behaves identically to requestTrackingAuthorizationWithCompletionHandler: in non-EU countries.” (poza UE metoda działa identycznie jak stara).³
• Stare wywołanie również pokazuje arkusz w pięciu krajach. Strona dokumentacji Apple dla requestTrackingAuthorization(completionHandler:): „In France, Germany, Italy, Poland, and Romania, the system presents a full-page sheet; otherwise, the system prompts the person with an alert.” (w tych pięciu krajach system pokazuje pełnoekranowy arkusz, a poza nimi alert), a arkusz „displays the NSUserTrackingMarkdownUsageDescription string with support for rich-text elements if you include it in your app’s target configuration in Xcode.” Nowe wywołanie dokłada do tego arkusz w pozostałej części UE, przycisk „Additional Information” oraz parametr, który o niego prosi.⁴
• Jeden nowy klucz, a stary nadal wymagany. NSUserTrackingMarkdownUsageDescription to opcjonalny Markdown: „bold or italic style,” listy punktowane i podziały akapitów, „but it doesn’t support underline”; nagłówek mówi, że oryginalny NSUserTrackingUsageDescription „must be in” (musi znaleźć się w) Info.plist także przy nowym wywołaniu.³⁴
• Przycisk „Additional Information” to ani tak, ani nie. Nagłówek Apple: „If the user taps the ‘Additional Information’ button, the prompt dismisses without recording an authorization decision, your additionalInformationAction runs so you can surface your own privacy information, and the completion handler receives notDetermined.” (po jego naciśnięciu monit znika bez zapisania jakiejkolwiek decyzji, uruchamia się przekazana akcja, a completion handler dostaje notDetermined). Kod musi zapytać ponownie.³
• Ponowne pytanie, tylko w UE. „you can reprompt a user via the App Tracking Transparency system prompt one year after the user’s previous choice in your app’s App Tracking Transparency system prompt, regardless of whether that choice was to accept or reject,” czyli rok po poprzednim wyborze, niezależnie od tego, czy była to zgoda, czy odmowa, chyba że dana osoba wyłączyła „Allow Apps to Request to Track,” które w UE nosi nazwę „Allow Apps to Request to Link Your Activity Across Companies.”²
• Co pokazuje symulator. Na symulatorze iPhone 18 Pro na runtimie bety iOS 27.2, z regionem ustawionym na Stany Zjednoczone, Niemcy, Holandię lub Francję, nowe wywołanie z preferExpandedInterface: true wyświetliło standardowy alert z oryginalnym opisem użycia i bez przycisku „Additional Information”; tak samo zachowały się false, pusta akcja i stare wywołanie, a completion handler czekał na dotknięcie ze statusem notDetermined. Istnieje jedna droga do natychmiastowego notDetermined, którą da się odtworzyć na żądanie i którą opisuję niżej: monit wciąż oczekujący z wcześniejszego uruchomienia. Dwa francuskie uruchomienia 20 września również wróciły natychmiast, bez przyczyny, którą umiałbym odnotować, a te same konfiguracje pokazały monit przy kolejnych czystych startach.⁵

Co się zmieniło, słowami Apple

Apple opisało tę zmianę prozą trzy razy. Najpierw w komunikacie z 16 września, który podaje też powód: „As part of agreements with select European competition authorities, Apple is introducing changes to its App Tracking Transparency framework in the European Union.” (zmiany są częścią porozumień z wybranymi europejskimi organami ochrony konkurencji). Reszta komunikatu podaje regułę i pięć krajów.¹ Strona zasad App Store dokłada kształt monitu: „The alternative version of the App Tracking Transparency system prompt has modified formatting and language and provides you the option to use a text button labeled “Additional Information.” This allows you to surface additional information about your request to link user or device data collected from your app with user or device data collected from other companies’ apps, websites, or offline properties for targeted advertising or advertising measurement purposes, or to share user or device data with a data broker.”² A uwagi do wydania bety iOS i iPadOS 27.2, w sekcji App Tracking Transparency, New Features, streszczają to w jednym zdaniu: AppTrackingTransparency „now supports an alternative expanded prompt and re-prompting on a yearly basis for EU users. The alternative prompt is required for users in France, Germany, Italy, Poland, and Romania.” (obsługuje teraz alternatywny, rozszerzony monit oraz coroczne ponawianie pytania dla użytkowników z UE, a ten alternatywny monit jest wymagany we Francji, w Niemczech, we Włoszech, w Polsce i w Rumunii).⁶

Strona zasad mówi również, co zostaje bez zmian: obowiązek zapytania przed śledzeniem oraz odpowiedzialność za wszystko, co kryje się za przyciskiem. „Any additional information related to your request or more granular consent controls provided via the text button are entirely your responsibility. However, you cannot access the device’s advertising identifier, or otherwise collect and use device or user data from your app as described in the App Tracking Transparency system prompt, until the user has granted your app permission in that prompt.”²

API w SDK 27.2

Xcode 27.2 beta (27B5019j) niesie SDK iOS 27.2 jako build 24B5084k, a nagłówek jego AppTrackingTransparency.framework dokłada jedną metodę klasową obok tej, którą wywołuje się dzisiaj:³

+ (void)requestTrackingAuthorizationUsingExpandedInterface:(BOOL)preferExpandedInterface
                               additionalInformationAction:(nullable void(^)(void))additionalInformationAction
                                         completionHandler:(void(^)(ATTrackingManagerAuthorizationStatus status))completion API_AVAILABLE(ios(27.2)) API_UNAVAILABLE(macos, tvos, watchos, visionos);

W Swifcie jest to ATTrackingManager.requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:), a strona dokumentacji Apple oznacza tę metodę jako iOS 27.2, iPadOS 27.2 i Mac Catalyst 27.2, wszystko w becie. Komentarz w nagłówku to najpełniejszy opis obu parametrów, jaki Apple opublikowało, i cztery zdania z niego decydują o tym, jak zapisać wywołanie.³⁴

• „Pass YES to preferExpandedInterface to request the alternative prompt where permitted; pass NO to request the original prompt.” A przy samym parametrze: „Note that in France, Germany, Italy, Poland, and Romania, due to legal requirements, only the expanded interface version of the ATT prompt will be available regardless of what is passed in to preferExpandedInterface.” (w tych pięciu krajach dostępna jest wyłącznie wersja rozszerzona, niezależnie od przekazanej wartości).
• „If you pass nil to additionalInformationAction, this button will not be shown.” (po przekazaniu nil przycisk się nie pojawia).
• „If the user taps the ‘Additional Information’ button, the prompt dismisses without recording an authorization decision, your additionalInformationAction runs so you can surface your own privacy information, and the completion handler receives notDetermined.” (monit znika bez zapisania decyzji, a completion handler dostaje notDetermined).
• „iOS users may be re-prompted in eligible regions on a periodic basis even after a previous authorization decision. If the user is not eligible to be re-prompted and a previous authorization decision exists, the completion handler is called with that prior decision without showing the prompt.” (w uprawnionych regionach pytanie bywa ponawiane okresowo, a gdy dana osoba nie jest uprawniona i istnieje wcześniejsza decyzja, completion handler zwraca ją bez pokazywania czegokolwiek).

Strona dokumentacji rysuje tabelę regionalną, którą nagłówek jedynie sugeruje. We Francji, w Niemczech, we Włoszech, w Polsce i w Rumunii: „The system displays markdown text you supply via NSUserTrackingMarkdownUsageDescription in a full-page sheet regardless of what you set for preferExpandedInterface, and includes an Additional Information button if you supply an action.” W pozostałej części Unii Europejskiej: „The system displays markdown text in the NSUserTrackingMarkdownUsageDescription, if you supply it. The system displays the full-page sheet if you set preferExpandedInterface to true, and includes an Additional Information button if you supply an action.” Wszędzie indziej: „Outside of the European Union, the system doesn’t use either parameter, and presents a system alert displaying the original NSUserTrackingUsageDescription, which is equivalent to calling requestTrackingAuthorization(completionHandler:).” Strona dodaje warunek tego regionalnego zachowania: urządzenie musi być „located in a specific European Union country and signed in with an Apple Account with a specific EU country or region.” (zlokalizowane w konkretnym kraju Unii Europejskiej i zalogowane na Apple Account z krajem lub regionem z UE).⁴

Strona starego wywołania, requestTrackingAuthorization(completionHandler:), mówi dziś, że pięć krajów dostaje arkusz również z niego: „In France, Germany, Italy, Poland, and Romania, the system presents a full-page sheet; otherwise, the system prompts the person with an alert.” oraz, w części o właściwościach targetu, „In France, Germany, Italy, Poland, and Romania, the full-page sheet displays the NSUserTrackingMarkdownUsageDescription string with support for rich-text elements if you include it in your app’s target configuration in Xcode.” Ta strona nie podaje żadnej wersji dla arkusza i wymienia metodę przy iOS 14 bez oznaczenia bety, więc próg 27.2 bierze się z uwag do wydania, a nie ze strony. Czytane razem: nowe wywołanie kupuje arkusz w pozostałej części UE, przycisk i wpływ na parametr, a w pięciu krajach arkusz i tak się pojawi.⁴⁶

Dwa klucze Info.plist

NSUserTrackingUsageDescription nie znika. Uwaga „Important” z nagłówka przy nowej metodzie powtarza stary wymóg słowo w słowo: klucz „must be in” (musi znaleźć się w) Information Property List, a strona dokumentacji nowego klucza mówi, że system sięga po stary, „if your app’s target properties omit this key.” (jeśli właściwości targetu pomijają nowy klucz).³⁴

NSUserTrackingMarkdownUsageDescription to nowość, oznaczona jako iOS 27.2 i iPadOS 27.2 beta. Strona Apple: „The format of the string is Markdown text; you can apply bold or italic style, but it doesn’t support underline. You can include bullet lists and paragraph breaks.” (format to Markdown, z pogrubieniem lub kursywą, listami punktowanymi i podziałami akapitów, ale bez podkreślenia). Klucz jest regionalny tak samo jak monit: używany w pięciu krajach zawsze, gdy jest obecny, zarówno przez stare, jak i przez nowe wywołanie; używany w pozostałej części UE, gdy przekazane zostanie preferExpandedInterface: true; i ignorowany poza UE. Dwie strony Apple opisują przypadek pośredni inaczej: strona metody mówi, że system wyświetla Markdown „if you supply it” (jeśli go dostarczysz), a strona klucza dokłada warunek przekazania true. Strona klucza to odczyt surowszy i to za nim idzie diagram powyżej. Wskazówka Apple na tej stronie jest tą samą, którą daje na stronie oryginalnego klucza śledzenia: „Keep the text of your description short and specific. The system displays your app name in the prompt so you don’t need to include it in the string.”⁴

Coroczne ponawianie monitu

Strona zasad ustala regułę dla UE: „you can reprompt a user via the App Tracking Transparency system prompt one year after the user’s previous choice in your app’s App Tracking Transparency system prompt, regardless of whether that choice was to accept or reject. A user cannot be re-prompted if they have disabled “Allow Apps to Request to Track” (renamed to “Allow Apps to Request to Link Your Activity Across Companies” in the EU) in their device’s Settings.”² Nagłówek opisuje ten mechanizm od strony aplikacji, dwukrotnie. Przy starszej metodzie: „In eligible regions, iOS users may be re-prompted after a year has passed since their last decision; otherwise the system remembers the user’s choice and doesn’t prompt again unless the user uninstalls and then reinstalls the app on the device.” Przy nowej: nieuprawniony użytkownik z wcześniejszą decyzją dostaje tę decyzję z powrotem z completion handlera „without showing the prompt,” więc drugie wywołanie jest bezpieczne, a o tym, czy monit się pojawi, decyduje system, nie kod aplikacji.³ Czego nie daje żaden z tych dokumentów, to sposobu na sprawdzenie przed wywołaniem, czy dana osoba jest uprawniona: wywołanie jest zapytaniem.

Co robi symulator bety 27.2

Zbudowałem jednoplikową sondę w SwiftUI wobec SDK iPhoneSimulator 27.2, z obydwoma kluczami w jej Info.plist: NSUserTrackingUsageDescription z wartością „Probe: the standard usage description.” oraz NSUserTrackingMarkdownUsageDescription z pogrubionym słowem, frazą kursywą i dwupunktową listą. Uruchomiłem ją na symulatorze iPhone 18 Pro na runtimie bety iOS 27.2 (24B5084k), restartując symulator przed każdym przebiegiem i ustawiając region przez globalną preferencję AppleLocale. Sześć przebiegów 19 września: Stany Zjednoczone, Niemcy i Holandia z preferExpandedInterface: true oraz akcją; Niemcy z false; Francja z true i bez akcji; Niemcy ze starym wywołaniem.⁵

19 września każdy przebieg dał to samo: standardowy alert, zatytułowany „Allow “ATTProbe” to track your activity across other companies’ apps and websites?”, z oryginalnym opisem użycia, z „Ask App Not to Track” i „Allow”, bez trzeciego przycisku. Tekst w Markdownie nie pojawił się ani razu, żaden completion handler nie zadziałał w ciągu szesnastosekundowego nagrania, a w pięciu rozszerzonych przebiegach trackingAuthorizationStatus wskazywał notDetermined przy każdym trzysekundowym sprawdzeniu przez dwanaście sekund; przebieg ze starym wywołaniem zapisał swoją linię mode=legacy i nic po niej, i czekał tak samo.⁵ Dokładnie to przewiduje strona dokumentacji Apple dla urządzenia, które nie znajduje się w UE, a ustawienie regionu w symulatorze to ustawienie językowe, nie lokalizacja: arkusz, tekst w Markdownie i przycisk pozostają testem na urządzeniu z Apple Account z regionu UE.

Powtórzone 20 września, po restarcie Maca, te same sześć przebiegów pokazało monit dla Stanów Zjednoczonych, Niemiec i Holandii tak jak wcześniej, ale przebieg francuski zwrócił notDetermined do completion handlera w tej samej sekundzie co swoje żądanie i nie pokazał żadnego alertu. Dwa kolejne francuskie uruchomienia tego ranka zrobiły to samo, a trzecie pokazało monit; z trzech natychmiastowych powrotów tylko ten o 7:23 zbiega się z czymkolwiek, co zapisały pliki, czyli z drugim skryptem przeinstalowującym sondę pod spodem, a te o 7:21 i 7:26 nie mają żadnej odnotowanej przyczyny. Gdy nic innego nie dotykało symulatora, trzy kolejne uruchomienia po czystym starcie, Francja z akcją, Francja bez niej i Stany Zjednoczone, pokazały monit i czekały. Te same francuskie konfiguracje pokazały więc monit przy późniejszych czystych startach i nie mam żadnej reguły o Francji do zaraportowania, tylko przestrogę: natychmiastowe notDetermined bez alertu na symulatorze z betą to wynik, który trzeba powtórzyć po czystym starcie, zanim się w niego uwierzy.⁵

Symulator bety iOS 27.2 z regionem ustawionym na Niemcy, po wywołaniu z rozszerzonym interfejsem 19 września: standardowy alert, oryginalny opis, dwa przyciski. To jedyny eksport wykonany przed restartem, który zabrał resztę plików z tamtego dnia.

Ślepa uliczka, którą da się odtworzyć na żądanie, to oczekujący monit. Wystarczy uruchomić sondę, zostawić alert bez odpowiedzi, odinstalować i zainstalować aplikację ponownie, a potem uruchomić ją jeszcze raz: rozszerzone wywołanie z drugiego uruchomienia zwróciło notDetermined do completion handlera w tej samej sekundzie co swoje żądanie, podczas gdy alert nadal był na ekranie, a trzecie uruchomienie ze starym wywołaniem zrobiło to samo, legacy-request status=0 (notDetermined) w ciągu sekundy. To przypadek opisany w nagłówku: „The authorization prompt doesn’t display if another permission request is pending user confirmation. Concurrent requests aren’t preserved by iOS,” (monit się nie wyświetla, gdy inne żądanie uprawnień czeka na potwierdzenie, a iOS nie zachowuje równoległych żądań), po czym następuje polecenie sprawdzenia, czy trackingAuthorizationStatus ma wartość notDetermined, „to determine if you need to make an additional call,” a strona starego wywołania wymienia ten przypadek wśród sytuacji, w których system uruchamia completion handler bez monitu: „An existing permission request is pending.”³⁴⁵ Czysty start to czyści. Jeśli aplikacja pyta z więcej niż jednego miejsca albo ponawia pytanie według harmonogramu, to właśnie natychmiastowe notDetermined dostanie drugi z wywołujących.

Co wdrożyć, krok po kroku

1. Zachować NSUserTrackingUsageDescription. Klucz nadal jest wymagany i to jego tekst zobaczy każdy użytkownik spoza UE oraz każdy użytkownik z UE bez klucza markdownowego.³⁴
2. Dodać NSUserTrackingMarkdownUsageDescription z tą samą prośbą w krótkim Markdownie: pogrubienie lub kursywa, punkty, podziały akapitów, żadnego podkreślenia, bez nazwy aplikacji.⁴
3. Uzależnić nowe wywołanie od dostępności i zostawić stare jako wariant zapasowy: na iOS 27.2 i nowszym wywoływać requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:), a wcześniej requestTrackingAuthorization(completionHandler:). Przekazanie true daje arkusz w pozostałej części UE, a pięć krajów i tak ignoruje ten parametr. Postać, która przechodzi kontrolę typów wobec SDK 27.2 przy progu iOS 26:³⁴⁵

#if os(iOS)
if #available(iOS 27.2, *) {
    ATTrackingManager.requestTrackingAuthorization(usingExpandedInterface: true,
                                                   additionalInformationAction: showPrivacyDetails) { status in
        handle(status)
    }
} else {
    ATTrackingManager.requestTrackingAuthorization { status in handle(status) }
}
#endif

1. Zdecydować w sprawie przycisku. Akcję warto przekazać tylko wtedy, gdy jest strona albo ekran do pokazania. Gdy akcja się uruchomi, należy potraktować status jako notDetermined, pokazać własne informacje i, słowami strony zasad, „you can redirect the user back to the App Tracking Transparency system prompt for your app to ensure their choice is recorded,” (można odesłać daną osobę z powrotem do systemowego monitu, aby jej wybór został zapisany), ale „you should not redirect users to your ATT prompt if they have opted out of all relevant legal consent choices in the screen or page surfaced.”²³
2. Zaplanować ponowne pytanie jako wywołanie, nie jako minutnik. Ponowne wywołanie w UE jest sposobem na sprawdzenie, czy minął rok; completion handler zwraca wcześniejszą decyzję, gdy dana osoba nie jest uprawniona.²³
3. Testować na urządzeniu z kontem z regionu UE. Ilekroć symulator pokazał monit, w każdym regionie i po czystych startach, był to standardowy alert i nigdy arkusz, a warunkiem Apple jest lokalizacja urządzenia plus region Apple Account, więc pełnoekranowy arkusz pozostaje testem na urządzeniu.⁴⁵
4. Sprawdzić target dla Maca. Nagłówek oznacza metodę jako niedostępną na macOS, tvOS, watchOS i visionOS, więc wspólne miejsce wywołania potrzebuje #if os(iOS) wokół wywołania i if #available(iOS 27.2, *) w środku; samo sprawdzenie dostępności nadal nie przechodzi kompilacji, z komunikatem 'requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:)' is unavailable in macOS, co odnotowuje przypis 5. Wpis Mac Catalyst 27.2 na stronie dokumentacji i API_UNAVAILABLE(macos) z nagłówka opisują tę samą linię z dwóch stron: dla #if os(iOS) Catalyst liczy się jako iOS.³⁴⁵

Często zadawane pytania

Czy trzeba przyjąć alternatywny monit?

We Francji, w Niemczech, we Włoszech, w Polsce i w Rumunii alternatywny monit jest jedyną wersją dostępną dla aplikacji tam dystrybuowanych, zgodnie z komunikatem Apple, a na 27.2 dostaje się go z obu wywołań: nowe pokazuje tam pełnoekranowy arkusz „regardless of what you set for preferExpandedInterface,” a strona Apple dla starego wywołania mówi „In France, Germany, Italy, Poland, and Romania, the system presents a full-page sheet; otherwise, the system prompts the person with an alert,” z kluczem markdownowym pokazywanym „if you include it in your app’s target configuration in Xcode.” Przyjęcie nowego wywołania daje arkusz w pozostałej części UE, przycisk „Additional Information” oraz wpływ na parametr.¹³⁴⁶

Czy zmienia się to, kiedy trzeba prosić o zgodę?

Nie. Apple: „The requirements for when you must seek permission to track users will remain the same.” (wymagania dotyczące tego, kiedy trzeba prosić o zgodę na śledzenie, pozostają bez zmian).¹

Czy klucz markdownowy zastępuje NSUserTrackingUsageDescription?

Nie. Oryginalny klucz nadal jest wymagany przy obu wywołaniach, a system sięga po niego zawsze, gdy klucza markdownowego brakuje albo gdy urządzenie znajduje się poza UE.³⁴

Czy można zapytać ponownie po odmowie?

W UE tak, rok po poprzednim wyborze, „regardless of whether that choice was to accept or reject,” chyba że dana osoba wyłączyła ustawienie, które Apple przemianowało w UE na „Allow Apps to Request to Link Your Activity Across Companies.”²

Czy nowe API istnieje na macOS albo visionOS?

Nie. Nagłówek SDK 27.2 oznacza je jako API_UNAVAILABLE(macos, tvos, watchos, visionos), a strona dokumentacji wymienia iOS, iPadOS i Mac Catalyst 27.2.³⁴

Źródła