Contents

VisionKit Live Text Usage

Review information about how people interact with Live Text.

Overview

The data in this report contains aggregated details about interactions with live text. It includes the length of selections, the word counts, and the total words found in the image.

  • Territories: Worldwide

  • Platforms: iOS, iPadOS. For more information about iOS and iPadOS, see the Platforms section in Data Completeness and Corrections.

  • Availability:

    • Daily: Every day.

  • History: On request, data is available beginning with iOS 17.4 and iPadOS 17.4.

  • Completeness: Data from devices that contribute to this report can arrive as late as 8 days after the date it generates on device. You can download recent data daily, but it might be incomplete, and data updates incrementally daily, until all late-arriving events are available.

  • Privacy:

    • Includes data from users who have opted to share their data with Apple and developers.

    • Individual rows will only appear if they have a value of 5 or more.

  • Data Context: You can analyze your data with additional context by comparing it with the data in the App Sessions Context report, which provides a count of unique devices that use your app on a specific day. For example, if your app performed an action detailed in this report on 10 unique devices on a specific day, and the App Sessions Context report shows there were 100 unique devices running your app that day, then you can approximate that 10% of the devices running your app performed that action.

Report Fields

Report Field

Description

Data Type

Count

Number of times the event occurred

integer

Territory

Country or region in which the event occurred

string

Date

Date when the event occurred

string

Platform

OS version on the device on which the event occurred

string

Device

Type of device on which the event occurred

string

Build

Build of device on which event occurred

string

Unique Devices

The count of unique devices

integer

Release Type

Type of software release

string

Event Type

Whether the user interacts with live text via a selection change, copying, or selecting all

string

Rich Pasteboard

Whether the selected text has rich pasteboard content

boolean

Selection Length

The character count of the user’s selection

integer

Selection Word Count

The number of words in the user’s selection

integer

Total Text Length

The full length of all of the text found in the image

integer

Glossary

Dimension

Value

Definition

Event Type

SelectionChanged

Triggered if a selection changes

Event Type

Copy

Triggered if copy is invoked

Event Type

SelectAll

Triggered if select all is invoked

See Also

Framework Usage