Verteilen von Reader-Apps mit einem Link zu Ihrer Website

Reader-Apps sind Apps, die einen oder mehrere digitale Inhaltstypen wie Zeitschriften, Zeitungen, Bücher, Audio, Musik oder Video als primäre Funktion der App bereitstellen. Mit Reader-Apps können sich Benutzer:innen bei ihren außerhalb der App erstellten Accounts anmelden und zuvor erworbene Medieninhalte oder Abonnements für Inhalte auf ihrem Apple-Gerät anzeigen und nutzen. Wenn Sie möchten, dass in Ihrer Reader-App auch ein Link zu Ihrer Website enthalten ist, auf der Benutzer:innen Accounts erstellen und verwalten können, finden Sie hier weitere Informationen über das Anfordern der Accountberechtigung für externe Links, zu den Nutzungsrichtlinien und zur Implementierung.

Die Accountberechtigung für externe Links anfordern

Wenn Sie an der Verwendung dieser Berechtigung interessiert sind, können Sie zunächst ein Antragsformular ausfüllen. Sie müssen Accountinhaber:in im Apple Developer Program sein, einige Fragen zu Ihrer App beantworten und den Nutzungsbedingungen der Berechtigung zustimmen. Berechtigungsanforderungen gelten pro Bundle-ID (die eindeutige Kennung der App) und zugewiesene Berechtigungen können nur mit der einzelnen Binärdatei verwendet werden, die mit der Bundle-ID verknüpft ist. Damit Sie die Berechtigung erhalten, müssen folgende Voraussetzungen erfüllt sein:

  • Stellen Sie als primäre Funktion Ihrer App einen oder mehrere der folgenden digitalen Inhaltstypen bereit: Zeitschriften, Zeitungen, Bücher, Audio, Musik oder Video.
  • Die App muss es Benutzer:innen ermöglichen, sich bei einem Account anzumelden.
  • Angemeldete Benutzer:innen müssen in der App die Möglichkeit haben, auf zuvor außerhalb der App erworbene Inhalte oder Dienste zuzugreifen, zum Beispiel auf Ihrer Website.
  • Wenn Sie die Accountberechtigung für externe Links verwenden, dürfen in der App keine Angebote für In-App-Käufe für iOS, iPadOS oder tvOS angezeigt werden.
  • Die App darf keine persönlichen Dienstleistungen in Echtzeit ermöglichen (z. B. Angebote für Nachhilfedienste, medizinische Beratung, Immobilienbesichtigungen oder Fitnesstraining).

Hinweis: Apps, die Benutzer:innen Zugriff auf digitale Inhalte wie Musik oder Videos gewähren, was jedoch nicht deren primäre Funktion darstellt, werden nicht als Reader-Apps angesehen und qualifizieren sich nicht für die Accountberechtigung für externe Links. Eine App für soziales Netzwerken, in der Benutzer:innen audiovisuelle Inhalte streamen können, ist beispielsweise nicht zulässig.

Die Berechtigung in Xcode konfigurieren und aktivieren

Nachdem Sie eine E-Mail-Bestätigung darüber erhalten haben, dass die Berechtigung Ihrem Account zugewiesen wurde, und Sie die App-ID Ihrer App unter Certificates, Identifiers, and Profiles (Zertifikate, Kennungen und Profile) für die Unterstützung der Berechtigung konfiguriert haben, müssen Sie Ihr Xcode-Projekt, Ihre plist-Datei für Berechtigungen und Ihre Info.plist-Datei aktualisieren, sodass die Berechtigung und die Metadaten aufgeführt werden.

Bildschirmfoto der Berechtigung, die in Xcode aktiviert istBildschirmfoto der Berechtigung, die in Xcode aktiviert ist

So nehmen Sie diese Aktualisierungen vor:

  1. Wählen Sie im Project Navigator (Projektnavigator) die .entitlements-Datei aus. In Xcode 13 oder neuer ist dem Dateinamen ein gelbes Häkchen vorangestellt.
  2. Fügen Sie in der plist-Datei für Berechtigungen ein neues Schlüsselpaar für die Berechtigung hinzu, indem Sie den Cursor auf die Zeile „Entitlements File“ (Berechtigungsdatei) bewegen und auf die Taste zum Hinzufügen (+) klicken.
  3. Stellen Sie die folgenden Werte für die Berechtigung bereit:
    1. Key (Schlüssel): com.apple.developer.storekit.external-link.account
    2. Type (Typ): Boolean (Boolescher Wert)
    3. Value (Wert): True (Wahr)
  4. Stellen Sie die erforderlichen Metadaten in Ihrer Info.plist-Datei bereit, wie nachfolgend im Abschnitt Ihre Info.plist-Datei aktualisieren beschrieben.

Beim nächsten Build für Ihr Gerät oder Ihre Verteilungsanforderung in Xcode Organizer wird Xcode feststellen, dass die .entitlements-Datei und das zwischengespeicherte Bereitstellungsprofil nicht übereinstimmen. Basierend auf der neuesten Konfiguration der App-ID wird dann ein neues Bereitstellungsprofil angefordert, um den Prozess der Code-Signatur abzuschließen.

Ihre Info.plist-Datei aktualisieren

Für jede Berechtigung gelten unterschiedliche Anforderungen in Bezug auf die Daten, die in die Info.plist-Datei Ihrer App eingegeben werden müssen.

So aktualisieren Sie Daten in dieser Datei:

  1. Wählen Sie die Info.plist-Datei im Projektnavigator aus.
  2. Stellen Sie die folgenden Werte für diese Berechtigung bereit:
    1. Key (Schlüssel): SKExternalLinkAccount
    2. Type (Typ): Dictionary with string values (Schlüsselverzeichnis mit Zeichenfolgewerten)
      1. Key (Schlüssel): Ländercodes als Schlüssel und eine einzige URL als Wert. Hier muss ein Schlüssel mit der Zeichenfolge * enthalten sein, der einer Standard-URL zugeordnet ist.
      2. Value (Wert): Eine einzige Ziel-URL (der Link zu Ihrer Website)

Hinweis: Die von Ihnen in der Info.plist-Datei in Xcode bereitgestellten URLs müssen immer mit dem Wert in der Binärdatei der App übereinstimmen, die Sie für das App-Prüfungsverfahren übermittelt haben. Stellen Sie sicher, dass es sich bei jedem Wert um eine Zeichenfolge handelt, die:

  • dem https-Schema folgt;
  • eine gültige, eindeutige URL erzeugt;
  • keine Abfrage-Parameter enthält;
  • und höchstens 1.000 ASCII-Zeichen enthält.

So verwalten Sie die Info.plist-Datei Ihrer App

Anforderungen an App und Link verstehen

Zusätzlich zur Aktivierung einer Berechtigung für Ihre App und zur Implementierung der erforderlichen APIs für externe Links müssen Sie die Nutzungsbedingungen erfüllen, die zum Schutz der Privatsphäre und der Sicherheit beitragen, Betrug und betrügerischen Aktivitäten vorbeugen und die allgemeine Qualität der Nutzererfahrung aufrechterhalten. Jeder in einer Reader-App bereitgestellte Link muss folgende Voraussetzungen erfüllen:

  • Er muss eine Verknüpfung zu einer Website darstellen, die Ihnen gehört oder für die Sie verantwortlich sind.
  • Er muss ein neues Fenster im Standardbrowser auf dem Gerät öffnen und darf nicht in einer Web-Ansicht geöffnet werden;
  • Er darf keine zusätzlichen Parameter in der URL übergeben, um Benutzer:innen (z. B. in Bezug auf ihren Datenschutz) zu schützen.
  • Er muss zusammen mit Ihrer Reader-App an den App Store übermittelt werden und muss erneut übermittelt werden, wenn sich die URL ändert.
  • Er darf keine sprachlichen Hinweise enthalten oder mit solchen verwendet werden, die den Preis der auf der Website verfügbaren Produkte enthalten (eine angemessene Formulierung könnte sein: „Gehen Sie zu beispiel.de, um einen Account zu erstellen oder Ihren Account zu verwalten“).
  • Er muss wie ein standardmäßiger HTML-Link formatiert sein (d. h. blau unterstrichener Text) und den Domainnamen der Website enthalten.
  • Er darf nur einmal auf jeder App-Seite angezeigt werden und muss jedes Mal dieselbe Nachricht anzeigen.
  • Er muss im Schlüsselwert external-link.account in der Info.plist-Datei Ihrer App statisch definiert sein, bevor die Übermittlung an den App Store erfolgt.
  • Er muss direkt und ohne Weiterleitung zu Ihrer Website führen und darf zu keinen zwischengeschalteten Links oder Landingpages leiten.

Systemanforderungen

Die Accountberechtigung für externe Links kann für genehmigte Reader-Apps verwendet werden, die in Regionen oder Ländern verteilt werden, in denen der App Store verfügbar ist, und ist mit Geräten mit iOS und/oder iPadOS oder tvOS 16.4 oder neuer kompatibel.

Das Modal-Sheet in der App implementieren

Verwenden von StoreKit APIs. Bei jedem Tippen auf einen Link zu Ihrer Website durch eine:n Benutzer:in zum Erstellen eines Accounts oder Verwalten eines vorhandenen Accounts muss Ihre App ein zwischengeschaltetes Modal-Sheet in der App anzeigen, bevor die App über den Link verlassen wird. Ihre App muss canMakePayments aufrufen und überprüfen, dass der:die Benutzer:in berechtigt ist, Zahlungen zu tätigen, bevor dieses Sheet angezeigt wird.

Befolgen der Anweisungen zu Modal-Sheets. In iOS 16 und/oder iPadOS 16 oder neuer und tvOS 16.4 oder neuer ist dies durch die Verwendung der Account-API für externe Links implementiert. Bei Geräten, die ältere Versionen von iOS und iPadOS ausführen, müssen Sie das Modal-Sheet implementieren, indem Sie sich exakt an das unten vorgegebene Design des Modal-Sheets und den Text halten.

Unterstützung mehrerer Sprachen. Um URLs für unterschiedliche Versionen Ihrer Website in verschiedenen Sprachen einzubeziehen, müssen Sie sie in die Info.plist-Datei einfügen, die Ihre App als Schlüsselverzeichnis verwendet und einen Schlüssel mit einer ihm zugewiesenen URL-Zeichenfolge für jede Region enthält. Verwenden Sie außerdem die von Apple bereitgestellten Textzeichenfolgen für Sprachen in Ihrer Implementierung des Modal-Sheets.

Designspezifikationen laden (5 MB)

App

Modal-Sheet

Website

Ihre App zur Überprüfung in App Store Connect übermitteln

Wenn Sie die Binärdatei Ihrer App zur Überprüfung an App Store Connect übermitteln, stellen Sie sicher, dass Sie die Nutzungsbedingungen der Berechtigung, die App-Prüfungsrichtlinien und die Apple Developer Program-Lizenzvereinbarung einhalten.

Stellen Sie darüber hinaus Folgendes sicher:

  • Ihr Modal-Sheet in der App wurde ordnungsgemäß implementiert und getestet.
  • Die in Ihrer App verlinkte Website ist voll funktionsfähig.
  • In Ihrer Einreichung sind Bildschirmfotos der Benutzeroberfläche Ihrer App enthalten, die die erforderlichen Offenlegungen für Benutzer:innen zeigen.

Eine unvollständige Einreichung kann zu Verzögerungen bei der Überprüfung oder zur Ablehnung Ihrer App führen. Sobald Ihre App überprüft wurde, wird ihr Status in App Store Connect aktualisiert und Sie erhalten eine Benachrichtigung.

Häufig gestellte Fragen

Meine Reader-App ist bereits im App Store veröffentlicht. Muss ich eine Berechtigung verwenden?

Nein. Die Accountberechtigung für externe Links ist optional und nur für Reader-Apps erforderlich, die einen Link zu einer externen Website enthalten sollen, auf der Accounts erstellt und verwaltet werden können. Gemäß Richtlinie 3.1.3(a) können Reader-Apps weiterhin die Möglichkeit bieten, innerhalb der App kostenlose Probeaccounts zu erstellen und vorhandene Accounts zu verwalten.

Kann ich in den Metadaten meiner App einen Link zu meiner Website für die Erstellung und Verwaltung von Accounts einschließen?

Nein. Reader-Apps müssen die Accountberechtigung für externe Links verwenden, um zu einer externen Website zur Erstellung und Verwaltung von Accounts weiterleiten zu können. So wird für Benutzer:innen ein sichereres und transparenteres Erlebnis geschaffen, wenn sie das Ökosystem von Apple verlassen.

Ich verteile mehrere Reader-Apps über den App Store. Kann ich dieselbe zugewiesene Berechtigung für mehr als eine App verwenden?

Nein. Die Accountberechtigung für externe Links gilt pro Bundle-ID (die eindeutige Kennung der App) und zugewiesene Berechtigungen können nur mit einer einzigen mit der Bundle-ID verknüpften Binärdatei verwendet werden. Wenn Sie über mehrere Reader-Apps verfügen, müssen Sie eine separate Berechtigungsanforderung für jede dieser Reader-Apps stellen.

Kann ich die Berechtigung in einer App verwenden, die In-App-Käufe anbietet, um die App über einen Link zum Erstellen und Verwalten von Accounts im Web zu verlassen?

Apps, die In-App-Käufe in iOS, iPadOS oder tvOS anbieten, qualifizieren sich nicht für die Berechtigung.

Kann ich meine App, die bereits im App Store ist, in eine Reader-App umwandeln?

Das ist bedingt möglich. Das Geschäftsmodell einer App kann sich mit der Zeit ändern, indem Entwickler neue Inhalte und Funktionen hinzufügen. Das Vornehmen eines Updates, das die primäre Funktion einer App signifikant ändert, wird jedoch nicht als angemessen erachtet, da hierdurch das Erlebnis bestehender Benutzer:innen erheblich beeinträchtigt wird. Wenn Sie über ein neues App-Konzept verfügen, das Sie über den App Store verteilen möchten, empfehlen wir Ihnen, einen neuen App-Datensatz und eine neue Binärdatei zu erstellen, die Sie zur Überprüfung einreichen.

Die Accountberechtigung für externe Links wurde mir zugewiesen. Bei der Übermittlung meiner App zur Überprüfung hieß es jedoch, es handle sich nicht um eine qualifizierte Reader-App. Wie kann ich dieses Problem lösen?

Alle Einreichungen für den App Store unterliegen einer Genehmigung durch das App-Prüfungsverfahren. Wenn sich während des Einreichungsprozesses herausstellt, dass Ihre App nicht als Reader-App qualifiziert ist, erhält sie keine Genehmigung, solange sie die Accountberechtigung für externe Links enthält. Weitere Informationen finden Sie in der Nachricht in App Store Connect.

Ist es erforderlich, dass meine App eine Account-API für externe Links verwendet?

Reader-Apps, die die Accountberechtigung für externe Links einschließen und auf denen mindestens iOS 16, iPadOS 16 oder tvOS 16.4 installiert ist, müssen die API für externe Links verwenden. Wenn Ihre App im App Store ist, müssen Sie die API in Ihre App implementieren und bis zum 12. Oktober 2022 ein Update einreichen.

Ressourcen