Den Apple App Store verbinden
Einen App-Store-Connect-API-Schlüssel mit der richtigen Rolle erstellen, hinzufügen und Ihre Apps wählen.
Apple verwendet für Berichte kein Anmelde-Popup. Sie erstellen in App Store Connect einen API-Schlüssel, laden ihn einmal herunter und fügen seine Angaben in Revenue Sensor ein. In der Konsole heißt diese Quelle Apple IAP.
Bevor Sie beginnen
- Account-Holder- oder Admin-Zugriff auf App Store Connect, um Schlüssel erstellen zu können.
- Ihre Vendor Number, aus App Store Connect → Reports → Payments and Financial Reports. Sie wird oben links unter Ihrem Kontonamen angezeigt.
Ihren API-Schlüssel erstellen
- 1
Die Schlüsselseite unter Integrations öffnen
App Store Connect → Users and Access → Integrations → App Store Connect API.
- 2
Einen Schlüssel erzeugen
Klicken Sie auf das + neben Active und geben Sie dem Schlüssel einen Namen, den Sie wiedererkennen, etwa “Revenue Sensor”.
- 3
Ihm eine Reporting-Rolle geben
Wählen Sie unter Access die Rolle Sales, Finance oder Admin. Jede davon kann die Sales and Trends-Berichte lesen, die Revenue Sensor importiert. Nur Admin liefert zusätzlich exakte App Store Connect-Zahlen (siehe unten). Ein Schlüssel mit nur Developer- oder App Manager-Zugriff kann keine Umsätze lesen.
- 4
Die .p8-Datei herunterladen
Apple lässt Sie den privaten Schlüssel genau einmal herunterladen. Speichern Sie ihn an einem sicheren Ort, bevor Sie die Seite verlassen. Wenn Sie ihn verlieren, erzeugen Sie einen neuen Schlüssel und verwenden dessen neue Key ID und .p8-Datei.
Der mit Abstand häufigste Fehler
Wenn Umsätze leer zurückkommen oder das Konto “Your API key needs the Sales role” anzeigt, ist fast immer die Rolle des Schlüssels die Ursache: Geben Sie ihm in App Store Connect die Rolle Sales oder Finance und verbinden Sie sich dann erneut. Prüfen Sie außerdem, ob die Vendor Number zum selben App Store Connect-Konto gehört wie der Schlüssel.
Ihre Zugangsdaten hinzufügen
- Issuer ID: wird oben auf der Seite mit den App Store Connect-API-Schlüsseln angezeigt. Sie ist für jeden Schlüssel gleich.
- Key ID: wird in der Zeile des von Ihnen erstellten Schlüssels angezeigt.
- Privater Schlüssel: die heruntergeladene .p8-Datei. Laden Sie sie hoch oder ziehen Sie sie hinein. Sie wird verschlüsselt gespeichert und nie wieder angezeigt.
- Vendor Number: aus Payments and Financial Reports.
Ihre Apps auswählen
Revenue Sensor listet die veröffentlichten Apps auf, die der Schlüssel sehen kann. Wählen Sie die aus, die verfolgt werden sollen. Nur die ausgewählten Apps werden synchronisiert.
Was importiert wird
Der Umsatz ist Einheiten mal Developer Proceeds aus Apples täglichem Sales summary-Bericht. Proceeds sind das, was Apple Ihnen auszahlt, nach seiner Provision und eventuell von Apple erhobenen Steuern, daher ist Payout die einzige Umsatzbasis für diese Quelle. Eine Rückerstattung kommt als Zeile mit negativen Einheiten an und wird daher an dem Tag abgezogen, an dem Apple sie bearbeitet hat. Downloads und Rückerstattungen werden aus demselben Bericht importiert.
Reporting-Verzögerung
Apple veröffentlicht den Verkaufsbericht eines Tages erst nach dessen Ende, daher erscheint der heutige Tag noch nie. Die letzten Tage können sich leicht verschieben, wenn Apple sie korrigiert; jede Synchronisierung liest die letzten 14 Tage erneut.