Zum Inhalt springen

Anleitung

In-App-Kauf- und Abopreise per Massenänderung anpassen

App Store Connect ändert Preise immer nur für ein Produkt. So ändern Sie zehn, fünfzig oder zweihundert In-App-Käufe und Abonnements auf einmal, ohne ein Wochenende zu verlieren oder die Hälfte Ihres Katalogs beim alten Preis zu lassen.

Aktualisiert am 9 Min. Lesezeit

Kann man In-App-Kauf-Preise in App Store Connect massenhaft ändern?

Nicht in einem Schritt. App Store Connect hat keinen Bildschirm, der viele In-App-Käufe oder Abonnements gemeinsam ändert: Sie öffnen jedes Produkt, planen seine Änderung und bestätigen sie. Um viele auf einmal zu ändern, wiederholen Sie das entweder pro Produkt, schreiben ein Skript für die App Store Connect API oder nutzen ein Tool, das die API für Sie ansteuert und nur eine Prüfung verlangt.

Warum App Store Connect dabei so langsam ist

Drei Dinge vervielfachen die Klicks. Erstens hat jeder In-App-Kauf und jedes automatisch verlängerbare Abonnement einen eigenen Preisplan, den Sie über eine eigene Seite erreichen. Zweitens gelten Preise pro Storefront: Apple erzeugt aus einem Basisland vergleichbare Preise für alle 175 Länder und Regionen (Preis für einen In-App-Kauf festlegen), aber jedes Storefront, das Sie von Hand festgelegt haben, bleibt so, bis Sie es erneut ändern. Drittens werden auch Abonnements pro Storefront geplant, mit einer Entscheidung über bestehende Abonnenten bei jeder Änderung (Preise für automatisch verlängerbare Abonnements verwalten).

„Alles um 10 % erhöhen“ bei drei Apps mit je acht Produkten sind also 24 einzelne Abläufe, jeder mit einer Prüfung von bis zu 175 Zeilen. Dort schleichen sich Fehler ein: ein übersprungenes Produkt, ein eigener Preis in einem Land, der überschrieben wird, ein Abonnement, das beim alten Preis bleibt, weil seine Gruppe eingeklappt war.

Der manuelle Weg, Produkt für Produkt

Mit einer Handvoll Produkte reichen die eingebauten Bildschirme. Apple unterscheidet drei Arten von Preisänderungen bei In-App-Käufen: global (ein neuer Basispreis, vergleichbare Preise überall sonst), temporär (Start- und Enddatum in ausgewählten Ländern) und benutzerdefiniert (Preise, die Sie in einigen oder allen Ländern selbst verwalten). Das Inkrafttreten lässt sich ab heute bis zum Ende des nächsten Kalenderjahres festlegen (Preisänderungen für In-App-Käufe planen).

  1. Wählen Sie unter „Apps“ die App und in der Seitenleiste „In-App-Käufe“ (nicht verlängerbare Abonnements stehen unter „Abonnements“).
  2. Öffnen Sie das Produkt und klicken Sie neben „Preisplan“ auf die Schaltfläche „Hinzufügen“ (+).
  3. Wählen Sie „Global“, „Temporär“ oder „Benutzerdefiniert“, legen Sie das Datum und den Preis im Basisland fest und prüfen Sie die vergleichbaren Preise.
  4. Bestätigen Sie und wiederholen Sie das Ganze für das nächste Produkt.
  5. Für jedes automatisch verlängerbare Abonnement: Öffnen Sie es, gehen Sie zu „Abonnementpreise“, wählen Sie „Abonnementpreisänderung planen“, bestimmen Sie Länder, Datum und Preis, entscheiden Sie, was mit bestehenden Abonnenten geschieht, und bestätigen Sie.

Exportieren Sie vorab, was Kunden heute zahlen: Die Preisseite jedes Abonnements bietet „Als CSV exportieren“ für aktuelle und künftige Preise. Bewahren Sie diese Datei auf. Sie ist Ihre Rückgängig-Liste.

Der API-Weg: So sieht die Arbeit aus

Die App Store Connect API kann alles, was die Bildschirme können, und ein Skript kann alle Produkte durchlaufen. Sie brauchen einen API-Schlüssel des Teams mit der Rolle „App-Manager“ oder „Admin“ (Rollenberechtigungen); die Einrichtung steht in API-Schlüssel für die Preisverwaltung erstellen. So sieht ein Massenjob aus:

SchrittEndpunktHinweise
Produkte auflistenGET /v1/apps/{id}/inAppPurchasesV2, GET /v1/apps/{id}/subscriptionGroups, GET /v1/subscriptionGroups/{id}/subscriptionsEinmal pro App; In-App-Käufe, Abonnements in einer Gruppe.
Preispunkte findenGET /v2/inAppPurchases/{id}/pricePoints, GET /v1/subscriptions/{id}/pricePointsNach Territorium filtern; laut Apple wird der Filter bei Abonnements künftig Pflicht (Preispunkte für Abonnements).
Apples Entsprechungen andernortsGET /v1/subscriptionPricePoints/{id}/equalizations, GET /v1/inAppPurchasePricePoints/{id}/equalizationsDer passende Preispunkt in anderen Währungen (Equalizations).
Änderung für einen In-App-Kauf schreibenPOST /v1/inAppPurchasePriceSchedulesErfordert baseTerritory, inAppPurchase und manualPrices; jeder Preis hat startDate und optional endDate (Dokumentation).
Änderung für ein Abonnement schreibenPOST /v1/subscriptionPricesEine pro Territorium, mit startDate und preserveCurrentPrice (Dokumentation).
Ausstehende Abonnementänderung abbrechenDELETE /v1/subscriptionPrices/{id}Nur vor ihrem Start.

Die Rechnung zählt. Ein Abonnement wird pro Storefront geschrieben, 20 Abonnements in 175 Storefronts sind also 3.500 Schreibvorgänge, noch ohne die Abfragen der Preispunkte. Apple begrenzt die Anfragen pro API-Schlüssel über eine gleitende Stunde, meldet den Rest im Header X-Rate-Limit und weist überzählige Aufrufe mit HTTP 429 und RATE_LIMIT_EXCEEDED ab; das eigene Beispiel nennt 3.500 Anfragen pro Stunde und weist darauf hin, dass die tatsächlichen Limits variieren (Rate Limits erkennen). Eine Schleife, die das ignoriert, bleibt auf halbem Weg stehen, und einige Produkte sind geändert, andere nicht.

  • Lesen Sie den Header bei jeder Antwort und bremsen Sie, bevor Sie null erreichen; stellen Sie 429-Antworten in eine Warteschlange und wiederholen Sie sie später, statt in einer engen Schleife.
  • Cachen Sie Preispunkte pro Produkt und Territorium. Sie machen den Großteil Ihrer Lesezugriffe aus.
  • Rechnen Sie mit Fehlern bei einzelnen Einträgen (ein Preispunkt, der in einem Storefront nicht existiert, ein zu naher Termin) und halten Sie sie pro Produkt und Land fest, damit Sie nur die fehlgeschlagenen erneut senden können.
  • Tokens sind höchstens 20 Minuten gültig, ein langer Job muss also neue erzeugen.
  • Lesen Sie bei In-App-Käufen zuerst den aktuellen Plan und bauen Sie den neuen darauf auf, damit von Hand bepreiste Länder absichtlich erhalten bleiben und nicht zufällig.
  • Änderungen können bis zu einer Stunde brauchen, bis sie in der Sandbox erscheinen; Testkäufe direkt nach einem Schreibvorgang zeigen deshalb eventuell noch den alten Preis.

Unsere Anleitung zur Preisverwaltung per API führt ein Produkt von Anfang bis Ende durch; der Vergleich mit dem Pflegen eines eigenen Skripts steht unter RepriceCat vs. API-Skripte.

Ein Tabellen-Workflow für viele Produkte

Ob Sie klicken oder skripten: Eine Tabelle hält eine Massenänderung ehrlich. Eine Zeile pro Produkt und Storefront, mit dem heutigen Preis neben dem neuen, lässt Sie sortieren, filtern und die ganze Änderung überblicken, bevor etwas gesendet wird.

  1. Exportieren Sie die aktuellen Preise: eine Zeile pro Produkt × Storefront mit Produkt-ID, Typ, Territorium, Währung, aktuellem Preis und jeder geplanten Änderung.
  2. Fügen Sie Spalten hinzu für die Regel (zum Beispiel „+10 %“), den rohen Zielpreis und den angepassten Preis, den nächstliegenden Preis, den Apple in dieser Währung tatsächlich anbietet.
  3. Filtern Sie nach Zeilen, in denen der angepasste Preis dem aktuellen entspricht oder sich viel stärker bewegt als beabsichtigt. Korrigieren Sie diese von Hand.
  4. Fügen Sie eine Spalte für das Startdatum hinzu und bei Abonnements eine Spalte für bestehende Abonnenten (behalten oder anwenden).
  5. Übergeben Sie die fertige Tabelle Ihrem Skript oder geben Sie sie Produkt für Produkt neu ein, und bewahren Sie die Tabelle mit Datum als Nachweis auf.

So wirkt sich „um einen Prozentsatz erhöhen und auf den nächsten .99-Preis runden“ auf gängige US-Preise aus, wenn die Rundung naiv erfolgt. Achten Sie auf die Zeilen, die sich kaum bewegen oder auf den heutigen Preis zurückrunden könnten:

Aktueller PreisRegelRoher ZielpreisNächster .99-PreisTatsächliche Änderung
$2.99+20 %$3.59$3.99+33 %
$4.99+10 %$5.49$4.99 oder $5.99 (Gleichstand)keine oder +20 %
$4.99+20 %$5.99$5.99+20 %
$9.99+15 %$11.49$10.99+10 %
$49.99+10 %$54.99$54.99+10 %
Kostenlos+10 %$0.00übersprungenkeine

Eine sorgfältige Checkliste vor dem Senden

PrüfpunktWarum
Heutige Preise exportierenDas ist der einzige Rückweg, wenn eine Änderung schiefgeht. Bewahren Sie den Export mit Datum auf.
ProbelaufBauen Sie jede Anfrage, ohne eine zu senden; zählen Sie Produkte, Storefronts und erwartete Fehler.
Jede Zeile prüfenProdukt × Land, alt → neu. Achten Sie auf unveränderte Zeilen, große Sprünge und von Hand bepreiste Länder.
Startdatum wählenEin Datum in der Zukunft lässt Zeit zum Abbrechen und gleicht die Änderung über Storefronts hinweg an. Die Startzeiten unterscheiden sich je nach Region (Startzeiten).
Über bestehende Abonnenten entscheidenIhren Preis behalten oder den neuen anwenden; Erhöhungen für bestehende Abonnenten folgen Apples Regeln zu Benachrichtigung und Zustimmung.
Bereits Geplantes prüfenEine neue Abonnementänderung ersetzt die bereits für dieses Storefront geplante.
In Stapeln sendenRichten Sie das Tempo am Rate Limit aus; beobachten Sie Fehler pro Produkt und Land.
Prüfen und festhaltenLesen Sie die Pläne zurück, vergleichen Sie sie mit Ihrer Tabelle und legen Sie das Ergebnis ab.

Fallstricke bei Massenänderungen

  • Anpassen auf Preispunkte. Kleine Prozentsätze bei niedrigen Preisen können auf den heutigen Preis zurückrunden (siehe $4.99 +10 % oben), und die Rundung kann aus +15 % ein +10 % oder aus +20 % ein +33 % machen. Stellen Sie sicher, dass eine Erhöhung immer über dem heutigen Preis landet und eine Senkung darunter, und prüfen Sie den angepassten Preis, nicht die Regel.
  • Kostenlose Produkte. Ein Prozentsatz von null ist null. Überspringen Sie kostenlose Produkte bei einer prozentualen Änderung oder geben Sie ihnen bewusst einen Preis.
  • Von Hand festgelegte Storefronts. Wenn Sie in einem Storefront einen eigenen Preis festlegen, passt Apple ihn nicht mehr an Steuern und Wechselkurse an. Eine globale Änderung vom Basisland aus ist dort womöglich nicht das, was diese Storefronts bekommen; entscheiden Sie pro Storefront.
  • Abonnements gelten pro Storefront und pro Änderung. Apple erlaubt je Storefront und Abrechnungsplan-Typ jeweils nur eine künftige Preisänderung; eine weitere zu planen überschreibt die erste (Apples Regeln zur Abopreisgestaltung).
  • Kein Rückgängigmachen nach dem Start. Eine Abonnementerhöhung, die in Kraft getreten ist, lässt sich nicht umkehren, und eine Senkung gilt immer auch für bestehende Abonnenten; Sie können nur eine weitere Änderung planen.
  • Abonnementgruppen. Wer den Monatsplan erhöht, den Jahresplan aber nicht, verändert den Rabatt des Jahresplans und kann einen Wechsel nach oben schlechter aussehen lassen als einen nach unten. Ändern Sie die Pläne einer Gruppe gemeinsam und prüfen Sie ihre Verhältnisse.
  • Apple passt Abopreise nicht an Steuern oder Wechselkurse an, kann aber Preise von In-App-Käufen in Storefronts anpassen, die es verwaltet. Wissen Sie, welche Ihrer Preise Apple noch verschieben kann.

Das Erhöhen von Abopreisen unterliegt eigenen Regeln zu Benachrichtigung und Zustimmung; lesen Sie So erhöhen Sie den Preis eines App-Store-Abonnements, bevor Sie eine Erhöhung auf bestehende Abonnenten anwenden.

Mit RepriceCat erledigen

RepriceCat verbindet sich mit dem Teamschlüssel Ihres App Store Connect und führt diesen ganzen Ablauf mit einer Prüfung aus. Mit „Viele Preise ändern“ wählen Sie bis zu 200 Produkte aus all Ihren Apps, mit Schnellauswahl für alle Abonnements, monatlich, jährlich, In-App-Käufe oder App-Preise, und erhöhen oder senken dann um einen Prozentsatz oder setzen einen neuen Preis. Nichts geht an Apple, bevor Sie die Prüfung gesehen und bestätigt haben.

  • Prozentuale Änderungen werden auf Apples nächsten .99-Preis gerundet, und eine Erhöhung rückt immer mindestens auf den nächsthöheren Preis (eine Senkung mindestens auf den nächstniedrigeren), sodass nichts auf den heutigen Preis zurückrundet. Kostenlose Produkte werden übersprungen, und jede angepasste Zeile ist in der Prüfung markiert.
  • Regionale Preisstufen an oder aus: Andere Länder erhalten den Preis ihrer Stufe oder Apples eigene Preise, wobei Ihre von Hand gesetzten erhalten bleiben.
  • Sofort oder zu einem Datum, und bei Abonnements „bestehende Abonnenten behalten ihren Preis“ (Apples preserve-current-price).
  • Eine Prüftabelle aus Produkt × Land, heutiger Preis → neuer Preis, und ein Probelauf, der nichts sendet.
  • Tabellen-Rundreise: Exportieren Sie aktuelle Preise nach Excel, Numbers oder CSV, bearbeiten Sie sie und importieren Sie sie; Fehler werden zuerst aufgelistet, und importierte Zeilen werden zu ausstehenden Änderungen, die Sie prüfen.
  • Die Aktivität protokolliert jede Änderung pro Land, listet fehlgeschlagene Länder mit Apples Begründung auf, sodass Sie nur diese erneut senden können, und kann eine Änderung zurücknehmen.

Wie es funktioniert, sehen Sie unter App-Store-Preise massenhaft ändern, oder starten Sie mit einem kostenlosen Monat.

Häufige Fragen

Kann ich in App Store Connect alle In-App-Kauf-Preise auf einmal ändern?

Nicht von einem einzigen Bildschirm aus. App Store Connect ändert Preise immer nur für ein Produkt; um viele auf einmal zu ändern, schreiben Sie ein Skript für die App Store Connect API oder nutzen ein darauf aufbauendes Tool.

Wie aktualisiere ich Abopreise massenhaft?

Planen Sie eine Preisänderung pro Abonnement und Storefront, entweder in App Store Connect oder mit POST /v1/subscriptionPrices in der API. Entscheiden Sie bei jeder Änderung, ob bestehende Abonnenten ihren aktuellen Preis behalten.

Wirkt sich eine Preisänderung im Bulk auf meine bestehenden Abonnenten aus?

Nur, wenn Sie sie darauf anwenden. Bei einer Erhöhung können bestehende Abonnenten ihren aktuellen Preis behalten; eine Senkung gilt immer auch für sie. Erhöhungen für bestehende Abonnenten folgen Apples Regeln zu Benachrichtigung und Zustimmung.

Warum hat meine Erhöhung um 10 % manche Preise nicht verändert?

Preise müssen auf einem von Apples Preispunkten landen. Ein kleiner Prozentsatz bei einem niedrigen Preis, etwa $4.99 plus 10 %, kann auf den aktuellen Preis zurückrunden. Prüfen Sie vor dem Senden bei jeder Zeile den angepassten Preis.

Welches Rate Limit gilt für Massenpreisänderungen über die API?

Apple begrenzt die Anfragen pro API-Schlüssel über eine gleitende Stunde und meldet den Rest im Header X-Rate-Limit. Das Beispiel nennt 3.500 pro Stunde, die tatsächlichen Limits variieren aber; takten Sie Ihren Job also und wiederholen Sie 429-Fehler später.

Kann ich eine Massenpreisänderung rückgängig machen?

Änderungen, die noch nicht begonnen haben, können Sie löschen. Ist eine Änderung aktiv, planen Sie eine weitere zurück auf die alten Preise – deshalb ist es wichtig, zuerst die aktuellen Preise zu exportieren.

Ausprobieren

Jedes Land aus einem Basispreis neu bepreisen

Preisstufen, Anpassung an Preispunkte, eine Prüftabelle, eine Bestätigung – über die App Store Connect API. Erster Monat gratis, danach 1 $ pro App und Monat.