Distribuir apps "leitores" com um link para o seu site
Apps leitores são apps que têm como funcionalidade principal fornecer um ou mais dos seguintes tipos de conteúdo digital: revistas, jornais, livros, áudio, música ou vídeo. Com apps leitores, as pessoas podem iniciar sessão na conta criada fora do app para ver e aproveitar conteúdo de mídia comprado anteriormente ou assinaturas de conteúdo no dispositivo Apple. Se você quiser que seu app leitor também forneça um link para seu site para que as pessoas possam criar e gerenciar as contas, saiba como solicitar o entitlement External Link Account e consulte as diretrizes de uso e as informações de implementação.
Solicitar o entitlement External Link Account
Se você quiser usar esse entitlement, envie primeiro um formulário de solicitação. Você precisará ser o titular da conta no Apple Developer Program, responder a algumas perguntas sobre o app e aceitar os termos e condições do entitlement. As solicitações de entitlement são feitas usando o ID de pacote (identificador exclusivo do app), e os entitlements atribuídos só podem ser usados com o binário exclusivo associado ao ID de pacote. Para qualificação, o app deve cumprir os seguintes requisitos:
- Oferecer um ou mais dos seguintes tipos de conteúdo digital como a funcionalidade principal do app: revistas, jornais, livros, áudio, música ou vídeo.
- Permitir que as pessoas iniciem sessão em uma conta.
- Permitir que as pessoas acessem conteúdo ou serviços comprados anteriormente fora do app, como no seu site, ao iniciar uma sessão.
- Não oferecer compras no app no iOS, iPadOS ou tvOS enquanto estiver usando o entitlement External Link Account.
- Não intermediar serviços em tempo real que envolvam interação direta entre pessoas (como aulas particulares, consultas médicas, visitas a imóveis ou treinamento físico).
Nota: Apps que fornecem acesso a conteúdo digital, como música ou vídeo, mas não como sua funcionalidade principal, não são considerados apps leitores e não estão qualificados para o entitlement External Link Account. Por exemplo: um app de rede social que permite fazer streaming de conteúdo audiovisual não está qualificado.
Configurar e ativar o entitlement no Xcode
Depois que você tiver recebido uma confirmação por e-mail informando que o entitlement foi atribuído à sua conta e tiver configurado o App ID do seu app em Certificates, Identifiers, and Profiles (Certificados, Identificadores e Perfis) para oferecer suporte a esse entitlement, você precisará atualizar o projeto do Xcode, o arquivo plist de entitlements e o arquivo Info.plist para registrar o entitlement e os metadados.
Para fazer essas atualizações:
- No Project Navigator (Navegador do projeto), selecione o arquivo .entitlements. No Xcode 13 ou posterior, o nome do arquivo será precedido pelo ícone
. - No arquivo plist de entitlements, mantenha o cursor sobre a linha Entitlements File (Arquivo de entitlement) e clique no botão de adição (+) para incluir um novo par de chaves de entitlement.
- Forneça os seguintes valores para o entitlement:
- Key (Chave): com.apple.developer.storekit.external-link.account
- Type (Tipo): Boolean (Booleano)
- Value (Valor): True (Verdadeiro)
- Forneça os metadados necessários no arquivo Info.plist conforme descrito abaixo na seção "Atualizar o arquivo Info.plist".
Na próxima compilação para o dispositivo ou solicitação de distribuição no Xcode Organizer, o Xcode detectará a diferença entre o arquivo .entitlements e o perfil de provisionamento em cache e solicitará um novo perfil de provisionamento com base na configuração mais recente do App ID para concluir o processo de assinatura de código.
Atualizar o arquivo Info.plist
Cada entitlement tem requisitos exclusivos para os dados que devem ser inseridos no arquivo Info.plist do app.
Para atualizar os dados desse arquivo:
- Selecione o arquivo Info.plist no Project Navigator (Navegador do projeto).
- Forneça os seguintes valores para o entitlement:
- Key (Chave): SKExternalLinkAccount
- Type (Tipo): dicionário com valores de string
- Key (Chave): códigos de região como chaves e um único URL como o valor. É necessário ter uma chave com a string *, associada a um URL padrão.
- Value (Valor): um único URL de destino (link para o seu site)
Nota: Os URLs incluídos no arquivo Info.plist no Xcode devem sempre ser os mesmos do binário do app enviado para o App Review. Verifique se cada valor é uma string que:
- usa o esquema https;
- forma um URL válido e absoluto;
- não contém parâmetros de consulta; e
- contém no máximo 1.000 caracteres ASCII.
Saiba como gerenciar o arquivo Info.plist do seu app
Conhecer os requisitos de app e de link
Além de ativar um entitlement para seu app e implementar as APIs External Link Account necessárias, você deve cumprir os requisitos de uso criados para ajudar a proteger a privacidade e a segurança, evitar golpes e atividades fraudulentas, bem como manter a qualidade geral da experiência. Todo link fornecido em um app leitor deve cumprir os seguintes requisitos:
- direcionar para um site de sua propriedade ou responsabilidade;
- abrir uma nova janela no navegador padrão do dispositivo, sem abrir um modo de visualização da web;
- não transmitir parâmetros adicionais no URL, a fim de proteger o usuário (sua privacidade, por exemplo);
- ser enviado com o app leitor para a App Store e ser enviado novamente em caso de mudanças no URL;
- não incluir ou ser usado com texto que inclua o preço de itens disponíveis no site (exemplo de texto permitido: "acesse example.com para criar ou gerenciar sua conta");
- ser formatado como um link HTML padrão (ou seja, um texto azul sublinhado) e conter o nome de domínio do site;
- ser exibido somente uma vez em cada página do app e com a mesma mensagem em todas as ocorrências;
- ser definido de forma estática no valor da chave external-link.account no arquivo Info.plist do app antes do envio para a App Store; e
- direcionar diretamente para seu site sem qualquer link de redirecionamento, link ou página de destino intermediários.
Requisitos do sistema
O entitlement External Link Account é compatível com dispositivos iOS e/ou iPadOS, ou tvOS 16.4 ou posterior, e pode ser usado por apps leitores aprovados e distribuídos em qualquer país ou região em que a App Store esteja disponível.
De 1º de outubro de 2026 em diante, os apps leitores distribuídos na UE poderão promover ofertas de bens e serviços digitais fora do app sem um link acionável, independentemente de usarem o entitlement External Link Account do StoreKit. Essas ofertas devem aparecer em uma página separada de qualquer link que permita aos usuários criar ou gerenciar sua conta no site, e seu app deve usar o entitlement External Purchases or Offers do StoreKit.
Implementar a página modal dentro do app
Usar as APIs do StoreKit. Sempre que alguém tocar em um link para o seu site a fim de criar ou gerenciar uma conta, o app deve exibir uma página modal intersticial antes de direcionar para o site. O app deve chamar a função canMakePayments e confirmar se o usuário tem permissão para fazer pagamentos antes de exibir essa página.
Seguir as informações da página modal. Para iOS 16 e/ou iPadOS 16 ou posterior, e tvOS 16.4 ou posterior, esse recurso é implementado usando a API External Link Account. Para dispositivos com versões anteriores do iOS, iPadOS ou tvOS, você precisará implementar a página modal seguindo exatamente o design e o texto da página modal fornecidos abaixo.
Oferecer suporte a várias localidades. Para incluir URLs das versões do seu site destinadas a diferentes localidades, adicione-as ao arquivo Info.plist usado pelo app, na forma de um dicionário que contenha uma chave para cada região e a string de URL correspondente. Além disso, é necessário usar as strings de texto da localidade fornecidas pela Apple na sua implementação da página modal.
Baixar especificações de design (5 MB)
App
Página modal
Site
Enviar o app para análise no App Store Connect
Ao enviar o binário do app para análise no App Store Connect, certifique-se de cumprir os termos e condições do entitlement, as Diretrizes de Análise de Apps e o Contrato de Licença do Apple Developer Program.
Além disso, confirme se os seguintes requisitos foram atendidos:
- A página modal dentro do app foi implementada e testada corretamente.
- O site vinculado ao app é totalmente funcional.
- As capturas de tela da interface de usuário do app que contêm as informações de divulgação necessárias para usuários estão incluídas no envio.
Se o envio estiver incompleto, a análise poderá atrasar ou o app poderá ser rejeitado. Depois da análise, o status do app será atualizado no App Store Connect, e você receberá uma notificação.
Perguntas frequentes
Tenho um app leitor que já está publicado na App Store. O uso do entitlement é obrigatório?
Não. O entitlement External Link Account é opcional e deve ser usado somente em apps leitores que desejam direcionar para um site para criação e gerenciamento de contas. Os apps leitores podem continuar permitindo que os usuários criem contas em planos gratuitos e que os clientes existentes gerenciem suas contas no app, conforme a diretriz 3.1.3(a).
Posso incluir nos metadados do meu app um link para meu site, onde os usuários possam criar e gerenciar suas contas?
Não. Os apps leitores podem direcionar para um site externo que permite criação e gerenciamento de contas somente se utilizarem o entitlement External Link Account no app. Isso torna a experiência mais segura e transparente para usuários que estão saindo do ecossistema da Apple.
Eu distribuo vários apps leitores na App Store. Posso usar o mesmo entitlement atribuído em mais de um app?
Não. O entitlement External Link Account é atribuído por ID de pacote (identificador exclusivo do app). O entitlement atribuído só pode ser usado com o binário exclusivo associado ao ID de pacote. Se você tiver vários apps leitores, precisará fazer uma solicitação de entitlement separada para cada um.
Posso usar o entitlement em um app que oferece compras no app para direcionar os usuários à criação e ao gerenciamento de contas na web?
Apps que oferecem compras no app no iOS, iPadOS ou tvOS não estão qualificados para usar esse entitlement.
Meu app já está na App Store. Posso convertê-lo em um app leitor?
Depende. O modelo de negócios de um app pode mudar ao longo do tempo, à medida que desenvolvedores incluem novos conteúdos e recursos. No entanto, não é apropriado enviar uma atualização que altere significativamente a funcionalidade principal do app porque isso prejudica a experiência para usuários existentes. Se você tiver um novo conceito de app que gostaria de distribuir na App Store, recomendamos que crie um novo registro e um novo binário e envie para análise.
Eu recebi o entitlement External Link Account, mas quando enviei meu app para análise, informaram que meu app não é um app leitor qualificado. Como resolvo esse problema?
Todos os envios para a App Store estão sujeitos à aprovação do App Review. Se o app tiver o entitlement External Link Account e não for considerado um app leitor durante o processo de envio, ele não será aprovado. Consulte a mensagem no App Store Connect para obter mais informações.
Meu app precisará usar a API External Link Account?
Apps leitores que incluem o entitlement External Link Account e são executados no iOS 16, iPadOS 16 ou tvOS 16.4 ou versões posteriores precisam usar a API External Link Account. Se o app estiver na App Store, você precisará implementar a API nele e enviar uma atualização até 12 de outubro de 2022.