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 o seu site para que as pessoas possam criar e gerenciar as contas, saiba como solicitar o direito para contas com link externo, as diretrizes de uso e as informações de implementação.

Solicitar o direito para contas com link externo

Se você quiser usar esse direito, 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 direito. As solicitações de direito são feitas usando o ID de pacote (identificador exclusivo do app), e os direitos 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 dentro do app no iOS, iPadOS ou tvOS enquanto estiver usando o direito para contas com link externo.
  • Não promover serviços de pessoa para pessoa em tempo real (como serviços de aulas particulares, consultas médicas, tours em 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 a funcionalidade principal, não são considerados apps leitores e não estão qualificados para o direito para contas com link externo. Por exemplo: um app de rede social que permite fazer streaming de conteúdo audiovisual não está qualificado.

Configurar e ativar o direito no Xcode

Depois que você tiver recebido uma confirmação por e-mail informando que o direito 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 direito, você precisará atualizar o projeto do Xcode, o arquivo plist de direitos e o arquivo Info.plist para registrar o direito e os metadados.

Captura de tela da ativação do direito no XcodeCaptura de tela da ativação do direito no Xcode

Para fazer essas atualizações:

  1. No Project Navigator (Navegador do projeto), selecione o arquivo .entitlements. No Xcode 13 ou posterior, o nome do arquivo será precedido pelo ícone símbolo de marca de seleção amarelo
  2. No arquivo plist de direitos, mantenha o cursor sobre a linha Entitlements File (Arquivo de direitos) e clique no botão de adição (+) para incluir um novo par de chaves de direito.
  3. Forneça os seguintes valores para o direito:
    1. Key (Chave): com.apple.developer.storekit.external-link.account
    2. Type (Tipo): Boolean (Booliano)
    3. Value (Valor): True (Verdadeiro)
  4. 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 direito tem requisitos exclusivos para os dados que devem ser inseridos no arquivo Info.plist do app.

Para atualizar os dados desse arquivo:

  1. Selecione o arquivo Info.plist no Project Navigator (Navegador do projeto).
  2. Forneça os seguintes valores para o direito:
    1. Key (Chave): SKExternalLinkAccount
    2. Type (Tipo): dicionário com valores de string
      1. Key (Chave): códigos de região como chaves e um único URL como o valor. É necessário ter uma chave com a string * que direciona para um URL padrão.
      2. 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 direito para seu app e implementar as APIs de contas com link externo 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:

  • vincular 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 intermediário ou página de destino.

Requisitos do sistema

O direito para contas com link externo é 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.

Implementar a página modal dentro do app

Com o uso de APIs do StoreKit. Sempre que alguém tocar em um link para o seu site a fim de criar uma conta ou gerenciar uma conta existente, 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.

Siga 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 de contas com link externo. Para dispositivos com versões anteriores do iOS e iPadOS, você precisará implementar a página modal seguindo exatamente o design e o texto da página modal fornecidos abaixo.

Suporte para várias localidades. Para incluir URLs de versões de localidades específicas do seu site, você precisará incluí-los no arquivo Info.plist usado pelo app como um dicionário com uma chave para cada região e um valor de string de URL associado. 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 direito, as Diretrizes de Análise de Apps e o Contrato de Licença do Apple Developer Program.

Além disso, você precisará confirmar os seguintes requisitos:

  • A página modal dentro do app foi implementada e testada corretamente.
  • O site vinculado ao app funciona completamente.
  • 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 direito é obrigatório?

Não. O direito para contas com link externo é opcional e deve ser usado somente em apps leitores que desejam direcionar para um site para a criação e o gerenciamento de contas. Os apps leitores podem continuar a oferecer criação de conta para níveis gratuitos e funcionalidade de gerenciamento de conta para clientes existentes no app de acordo com a diretriz 3.1.3(a).

Posso incluir um link para o site nos metadados do app para a criação e o gerenciamento de contas?

Não. Os apps leitores podem direcionar para um site externo para a criação e o gerenciamento de contas somente se utilizarem o direito para contas com link externo no app. Esse método fornece uma 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 direito atribuído em mais de um app?

Não. O direito para contas com link externo é atribuído por ID de pacote (identificador exclusivo do app). O direito 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 direito separada para cada um.

Posso usar o direito em um app que oferece compras dentro do app para direcionar para a criação e o gerenciamento de contas na web?

Apps que oferecem compras dentro do app no iOS, iPadOS ou tvOS não estão qualificados para usar esse direito.

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 do app e envie para análise.

Eu recebi o direito para contas com link externo, mas quando enviei meu app para análise, fui informado de 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 direito para contas com link externo 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 de contas com link externo?

Apps leitores que incluem o direito para contas com link externo e são executados no iOS 16, iPadOS 16 ou tvOS 16.4 ou versões posteriores precisam usar a API de contas com link externo. Se o app estiver na App Store, você precisará implementar a API em seu app e enviar uma atualização até 12 de outubro de 2022.

Recursos