iOS 27.2 的歐盟追蹤提示：這一版該做什麼

從 iOS 27.2 與 iPadOS 27.2 開始，歐盟境內的 App 可以顯示另一種 App Tracking Transparency 提示；而在法國、德國、義大利、波蘭或羅馬尼亞發行的 App，不論呼叫新方法還是舊方法，都只會拿到這個版本。 27.2 beta SDK 新增了一個方法 requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:)，只在 iOS 27.2 可用，macOS、tvOS、watchOS 與 visionOS 上都沒有；另外還加了一個選用的 Info.plist 鍵 NSUserTrackingMarkdownUsageDescription。在歐盟以外，新呼叫的行為和舊的一樣，何時必須詢問的規則也沒有改變，而歐盟使用者在上次回答滿一年後可以再被詢問一次。該做哪些事，本文逐項說明。在 27.2 beta 模擬器上，地區設為美國、德國、荷蘭或法國時，凡是我能在重新開機後重現的呼叫，出現的都是標準警示框，也就是 Apple 為不在歐盟的裝置所記載的後備行為；就這份證據來看，整頁表單得在實機上測。¹²³⁴⁵ {.answer-block}

重點摘要

• Apple 的公告，9 月 16 日。 「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.」（自 iOS 27.2 與 iPadOS 27.2 起，開發者可以在歐盟選用另一種 ATT 系統提示；必須取得追蹤許可的時機不變；因法規要求，在德國、法國、義大利、波蘭與羅馬尼亞發行的 App 只能使用這個版本。）¹
• 一個新方法。 27.2 beta SDK 的 ATTrackingManager.h 宣告了 requestTrackingAuthorizationUsingExpandedInterface:additionalInformationAction:completionHandler:，並標上 API_AVAILABLE(ios(27.2)) API_UNAVAILABLE(macos, tvos, watchos, visionos)。標頭檔註解寫著：「This method behaves identically to requestTrackingAuthorizationWithCompletionHandler: in non-EU countries.」（在非歐盟國家，這個方法的行為與舊方法完全相同。）³
• 那五個國家連舊呼叫也會拿到整頁表單。 Apple 為 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.」而這張表單會「displays the NSUserTrackingMarkdownUsageDescription string with support for rich-text elements if you include it in your app’s target configuration in Xcode.」（只要您在 Xcode 的 target 設定裡放進那段 Markdown 字串，表單就會以格式化文字顯示它。）新呼叫多給您的，是歐盟其餘國家的整頁表單、「Additional Information」按鈕，以及要求表單的那個旗標。⁴
• 多了一個鍵，舊的那個仍然必要。 NSUserTrackingMarkdownUsageDescription 是選用的 Markdown，支援「bold or italic style」、項目清單與段落分隔，「but it doesn’t support underline」；標頭檔則說，新呼叫同樣要求原本的 NSUserTrackingUsageDescription「must be in」Info.plist。³⁴
• 「Additional Information」按鈕既不是答應也不是拒絕。 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.」（使用者按下這顆按鈕時，提示會關閉而不記錄任何授權決定，您的 additionalInformationAction 會執行，讓您呈現自己的隱私說明，completion handler 則收到 notDetermined。）您的程式碼之後必須再問一次。³
• 重新詢問，只限歐盟。 「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」（使用者在您的 App 裡上次做出選擇滿一年後，不論當時是接受還是拒絕，您都可以再次以 ATT 系統提示詢問），除非對方關掉了「Allow Apps to Request to Track」，而這個設定在歐盟改名為「Allow Apps to Request to Link Your Activity Across Companies」。²
• 模擬器顯示的是什麼。 在 iOS 27.2 beta 執行環境的 iPhone 18 Pro 模擬器上，地區設為美國、德國、荷蘭或法國，以 preferExpandedInterface: true 呼叫新方法時，出現的是標準警示框，內容是原本的用途說明，沒有「Additional Information」按鈕；改成 false、傳 nil action、或改用舊呼叫，結果都一樣，而 completion 會一直等待點擊，狀態停在 notDetermined。有一種會立刻拿到 notDetermined 的情況可以隨時重現，下面會寫到：那是上一次啟動留下、還沒回答的提示。9 月 20 日另有兩次法國地區的啟動也是立刻返回，我找不到任何可以記錄的原因；而同樣的設定在後來幾次重新開機後的啟動都跳出了提示。⁵

Apple 自己怎麼說

Apple 已經用三份文字說明這項變更，最早是 9 月 16 日的公告，裡面也給了原因：「As part of agreements with select European competition authorities, Apple is introducing changes to its App Tracking Transparency framework in the European Union.」（作為與部分歐洲競爭主管機關協議的一部分，Apple 正在調整歐盟境內的 App Tracking Transparency 架構。）公告其餘部分給出規則和那五個國家。¹ App Store 政策頁面補上了提示的樣貌：「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.」（另一種 ATT 系統提示改了排版與措辭，並讓您可以加上一顆文字按鈕，用來進一步說明：您為何要把 App 收集到的使用者或裝置資料，與其他公司的 App、網站或線下管道收集到的資料結合，以投放或衡量廣告，或是把這些資料提供給資料仲介。）² 至於 iOS 與 iPadOS 27.2 beta 發行說明，在 App Tracking Transparency 的 New Features 底下只用一句話帶過：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.」⁶

政策頁面也寫明了哪些事沒有變：追蹤之前必須先問的義務，以及按鈕背後的一切由您自己負責。「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.」（透過文字按鈕提供的補充資訊或更細緻的同意選項，責任完全在您；在使用者於該提示中授權之前，您不得取得裝置的廣告識別碼，也不得以提示所述的方式收集或使用裝置或使用者資料。）²

27.2 SDK 裡的 API

Xcode 27.2 beta（27B5019j）內附的 iOS 27.2 SDK 組建編號是 24B5084k，其中 AppTrackingTransparency.framework 的標頭檔在您已經在呼叫的那個方法旁邊，多加了一個類別方法：³

+ (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);

在 Swift 裡它是 ATTrackingManager.requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:)，Apple 的參考頁面把它標為 iOS 27.2、iPadOS 27.2 與 Mac Catalyst 27.2，全部掛著 beta。標頭檔註解是 Apple 目前針對這兩個參數所公布最完整的說明，其中有四句話決定了這個呼叫該怎麼寫。³⁴

• 「Pass YES to preferExpandedInterface to request the alternative prompt where permitted; pass NO to request the original prompt.」（傳 YES 就在允許的地區要求另一種提示，傳 NO 則要求原本的提示。）而在參數說明裡：「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.」（在那五個國家，因法規要求，不論您傳入什麼，都只有擴充介面版本可用。）
• 「If you pass nil to additionalInformationAction, this button will not be shown.」（傳 nil 就不會出現這顆按鈕。）
• 「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.」
• 「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.」（在符合條件的地區，即使先前已有授權決定，iOS 使用者仍可能被定期重新詢問；若使用者不符合重新詢問的條件而先前的決定又存在，completion handler 會直接帶著那個決定回來，不顯示提示。）

參考頁面把標頭檔只是暗示的地區規則整理成了一張表。在法國、德國、義大利、波蘭與羅馬尼亞：「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.」在歐盟其餘國家：「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.」在其他所有地方：「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:).」頁面還補上了這套地區行為成立的條件：裝置必須「located in a specific European Union country and signed in with an Apple Account with a specific EU country or region.」（位於特定歐盟國家，且登入的 Apple Account 屬於特定歐盟國家或地區。）⁴

舊呼叫 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.」而在 target 屬性那一段：「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.」這個頁面沒有為表單標出版本，方法本身仍列在 iOS 14 而且沒有 beta 標記，所以它的 27.2 下限來自發行說明，不是來自這個頁面。兩邊合起來讀：新呼叫為您換來的是歐盟其餘國家的表單、那顆按鈕，以及對旗標的發言權；在那五個國家，表單無論怎麼呼叫都會出現。⁴⁶

兩個 Info.plist 鍵

NSUserTrackingUsageDescription 並沒有消失。新方法標頭檔裡的「Important」註記把舊要求一字不差地重述了一遍：這個鍵「must be in」Information Property List；而新鍵的參考頁面也說，「if your app’s target properties omit this key.」時，系統會退回使用它。³⁴

NSUserTrackingMarkdownUsageDescription 才是新增的，標示為 iOS 27.2 與 iPadOS 27.2 beta。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.」（字串格式是 Markdown，可以用粗體或斜體，但不支援底線，也可以放入項目清單與段落分隔。）它的地區規則和提示一樣：在那五個國家只要有就會用上，新舊呼叫皆然；在歐盟其餘國家，只有當您傳入 preferExpandedInterface: true 時才會用；在歐盟以外則被忽略。Apple 兩個頁面對中間這種情況的措辭並不一致，方法頁說只要「if you supply it」系統就會顯示 Markdown，鍵的頁面則多加了必須傳 true 的條件；鍵的頁面是比較嚴格的讀法，也是上面那張圖採用的版本。Apple 在這個頁面給的提醒，和原本那個追蹤用途鍵的頁面一樣：「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.」（說明要短、要具體；系統會在提示裡顯示您的 App 名稱，所以字串裡不必再寫一次。）⁴

每年一次的重新詢問

政策頁面給出了歐盟的規則：「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.」（上次選擇滿一年後，不論當時是接受或拒絕都可以再問一次；但若使用者在裝置的「設定」中關掉了那個開關，就不能再被詢問。）² 標頭檔則從 App 這一側描述了機制，而且講了兩次。在舊方法上：「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.」在新方法上：不符合重新詢問條件、但先前已有決定的使用者，會從 completion handler 拿回那個決定，「without showing the prompt」，所以再呼叫一次是安全的，而且決定要不要顯示提示的是系統，不是您的程式碼。³ 兩份文件都沒有給的，是在呼叫之前先問出某位使用者是否符合條件的辦法；呼叫本身就是查詢。

27.2 beta 模擬器的實際表現

我寫了一支單檔 SwiftUI 探測 App，對著 iPhoneSimulator 27.2 SDK 建置，Info.plist 裡兩個鍵都放了：NSUserTrackingUsageDescription 設為「Probe: the standard usage description.」，NSUserTrackingMarkdownUsageDescription 則放了一個粗體字、一段斜體，再加一份兩項的項目清單；接著在 iOS 27.2 beta 執行環境（24B5084k）的 iPhone 18 Pro 模擬器上執行，每一輪之前都先重開模擬器，並透過全域的 AppleLocale 偏好設定地區。9 月 19 日跑了六輪：美國、德國、荷蘭都用 preferExpandedInterface: true 加一個 action；德國再跑一次 false；法國用 true 但不給 action；德國再用舊呼叫跑一次。⁵

9 月 19 日每一輪的結果都一樣：標準警示框，標題是「Allow “ATTProbe” to track your activity across other companies’ apps and websites?」，顯示原本的用途說明，帶著「Ask App Not to Track」與「Allow」兩顆按鈕，沒有第三顆。Markdown 文字始終沒有出現，十六秒的擷取期間裡沒有任何 completion handler 觸發，而在五輪擴充介面的執行中，trackingAuthorizationStatus 在十二秒內每隔三秒檢查一次都讀到 notDetermined；用舊呼叫的那一輪印出 mode=legacy 之後就沒有下文，同樣一直等著。⁵ 這正是 Apple 參考頁面對不在歐盟的裝置所預測的行為，而模擬器的地區設定是語言環境，不是位置；表單、Markdown 文字與那顆按鈕，得用一台登入歐盟地區 Apple Account 的實機來測。

9 月 20 日重開 Mac 之後重跑，美國、德國與荷蘭那幾輪和先前一樣跳出提示，但法國那一輪在送出請求的同一秒就把 notDetermined 交回 completion handler，而且沒有顯示警示框。當天早上另外兩次法國啟動也是如此，第三次則跳出了提示；三次立刻返回之中，只有 7:23 那次和檔案裡記錄到的事情重疊，也就是另一支腳本正在底下重新安裝探測 App，7:21 與 7:26 那兩次則沒有任何可記錄的原因。在沒有別的東西碰模擬器的情況下，又跑了三次全新開機的啟動，法國帶 action、法國不帶 action，以及美國，全部都跳出提示並等待。所以同樣的法國設定在後來的全新開機裡都跳出了提示，我沒有任何關於法國的規則可以報告，只有一個提醒：在 beta 模擬器上，沒有警示框而立刻返回的 notDetermined，要先在全新開機後重現一次，才值得相信。⁵

9 月 19 日，地區設為德國的 iOS 27.2 beta 模擬器，在擴充介面呼叫之後：標準警示框、原本的說明、兩顆按鈕。這張圖是那天其餘檔案被重開機清掉之前，唯一匯出成功的一張。

會穩定重現的那條歧路，是還沒回答的提示。啟動探測 App，把警示框放著不答，移除再重新安裝，然後再啟動一次：第二次啟動的擴充呼叫在送出請求的同一秒就把 notDetermined 交回 completion handler，而警示框還留在畫面上；第三次改用舊呼叫也一樣，一秒內就印出 legacy-request status=0 (notDetermined)。這正是標頭檔描述的情況：「The authorization prompt doesn’t display if another permission request is pending user confirmation. Concurrent requests aren’t preserved by iOS.」（若另一個權限請求還等著使用者確認，授權提示就不會顯示；iOS 不會保留同時發出的請求。）後面接著要您檢查 trackingAuthorizationStatus 是否為 notDetermined，「to determine if you need to make an additional call,」；而舊呼叫的頁面也把它列在系統不顯示提示、直接執行您的 completion handler 的情況之一：「An existing permission request is pending.」³⁴⁵ 重新開機就會清掉。如果您的 App 會從多個地方詢問，或是會按時程再問一次，那麼第二個呼叫者拿到的就是這種立刻返回的 notDetermined。

該做什麼，一步一步來

1. 保留 NSUserTrackingUsageDescription。 它仍然是必填的，而且所有歐盟以外的使用者，以及沒有 Markdown 鍵的歐盟使用者，看到的都是這段文字。³⁴
2. 加上 NSUserTrackingMarkdownUsageDescription，用簡短的 Markdown 寫同一個請求：粗體或斜體、項目符號、段落分隔，不要底線，也不要寫 App 名稱。⁴
3. 把新呼叫包在可用性檢查裡，並把舊呼叫留作後備：iOS 27.2 以上呼叫 requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:)，更早的版本則呼叫 requestTrackingAuthorization(completionHandler:)。傳 true 才能在歐盟其餘國家拿到表單；那五個國家會忽略這個旗標。以 iOS 26 為部署下限、對著 27.2 SDK 能通過型別檢查的寫法如下：³⁴⁵

#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. 決定要不要放那顆按鈕。 只有當您真的有一個頁面或畫面可以顯示時，才傳入 action。action 執行時，請把狀態當作 notDetermined，顯示您的說明，並且照政策頁面的說法，「you can redirect the user back to the App Tracking Transparency system prompt for your app to ensure their choice is recorded,」（可以把使用者導回您的 ATT 系統提示，確保他們的選擇有被記錄下來），但是「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. 把重新詢問當成一次呼叫，而不是一個計時器。 在歐盟，再呼叫一次就是您查出滿一年了沒的方式；使用者不符合條件時，completion handler 會回傳先前的決定。²³
3. 用一台登入歐盟地區帳號的實機測。 模擬器每次跳出提示時，不管地區為何、也不管是不是全新開機，出現的都是標準警示框，從來不是表單；而 Apple 給的條件是裝置位置加上 Apple Account 地區，所以整頁表單必須在實機上測。⁴⁵
4. 檢查 Mac 這個 target。 標頭檔把這個方法標為在 macOS、tvOS、watchOS 與 visionOS 上不可用，所以共用的呼叫點需要用 #if os(iOS) 把呼叫包住，裡面再放 if #available(iOS 27.2, *)；只做可用性檢查仍然編譯不過，錯誤是 'requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:)' is unavailable in macOS，註腳 5 有記錄。參考頁面的 Mac Catalyst 27.2 條目與標頭檔的 API_UNAVAILABLE(macos) 說的是同一條界線的兩面：對 #if os(iOS) 來說，Catalyst 算 iOS。³⁴⁵

常見問題

我一定要改用另一種提示嗎？

在法國、德國、義大利、波蘭與羅馬尼亞，依 Apple 的公告，在當地發行的 App 只有這個版本可用；而在 27.2 上，兩種呼叫都會給您它：新呼叫在那裡「regardless of what you set for preferExpandedInterface」都會顯示整頁表單，Apple 為舊呼叫寫的頁面也說「In France, Germany, Italy, Poland, and Romania, the system presents a full-page sheet; otherwise, the system prompts the person with an alert.」，而 Markdown 鍵只要「if you include it in your app’s target configuration in Xcode.」就會一起顯示。改用新呼叫換到的，是歐盟其餘國家的表單、「Additional Information」按鈕，以及對旗標的發言權。¹³⁴⁶

它會改變我必須詢問的時機嗎？

不會。Apple：「The requirements for when you must seek permission to track users will remain the same.」（必須取得追蹤許可的時機維持不變。）¹

Markdown 鍵會取代 NSUserTrackingUsageDescription 嗎？

不會。兩種呼叫都仍然需要原本那個鍵，而且只要 Markdown 鍵不存在、或裝置在歐盟以外，系統用的就是它。³⁴

使用者拒絕之後我可以再問嗎？

在歐盟可以，上次選擇滿一年之後，「regardless of whether that choice was to accept or reject」（不論當時是接受還是拒絕），除非對方關掉了那個 Apple 在歐盟改名為「Allow Apps to Request to Link Your Activity Across Companies」的設定。²

macOS 或 visionOS 上有這個新 API 嗎？

沒有。27.2 SDK 的標頭檔把它標為 API_UNAVAILABLE(macos, tvos, watchos, visionos)；參考頁面列出的是 iOS、iPadOS 與 Mac Catalyst 27.2。³⁴

資料來源