Lokalisierung von ASC-Abonnements
Verwenden Sie diesen Skill, um Anzeigenamen (und Beschreibungen) für Abonnements, Abonnementgruppen und In-App-Käufe in allen App Store Connect Locales massenhaft zu erstellen oder zu aktualisieren. Dies eliminiert den mühsamen manuellen Prozess, bei dem Sie jede Sprache in App Store Connect einzeln anklicken müssen, um denselben Anzeigenamen festzulegen.
Voraussetzungen
- Authentifizierung konfiguriert (
asc auth loginoderASC_*-Umgebungsvariablen). - Kennen Sie Ihre App-ID (
ASC_APP_IDoder--app). - Abonnementgruppen und Abonnements existieren bereits.
Unterstützte App Store Locales
Dies sind die von App Store Connect für Abonnement- und IAP-Lokalisierungen unterstützten Locales:
ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant
Arbeitsablauf: Massenlokalisierung eines Abonnements
1. IDs auflösen
# Abonnementgruppen finden
asc subscriptions groups list --app "APP_ID" --output table
# Abonnements innerhalb einer Gruppe finden
asc subscriptions list --group "GROUP_ID" --output table
2. Vorhandene Lokalisierungen prüfen
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Dies zeigt an, welche Locales bereits einen Namen gesetzt haben. Erstellen Sie nur Lokalisierungen für fehlende Locales.
3. Lokalisierungen für alle fehlenden Locales erstellen
Führen Sie für jedes Locale, das noch keine Lokalisierung hat, Folgendes aus:
asc subscriptions localizations create \
--subscription-id "SUB_ID" \
--locale "LOCALE" \
--name "Anzeigename"
Um beispielsweise "Monthly Pro" für alle Locales zu setzen:
# Ein Befehl pro Locale (überspringen Sie alle, die bereits existieren)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Monthly Pro"
4. Überprüfen
asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table
Arbeitsablauf: Massenlokalisierung einer Abonnementgruppe
Abonnementgruppen haben ebenfalls einen eigenen Anzeigenamen pro Locale (dies ist der "Gruppenname", der Benutzern im Abonnementverwaltungsblatt angezeigt wird).
1. Vorhandene Gruppenlokalisierungen prüfen
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
2. Für fehlende Locales erstellen
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Gruppen-Anzeigename"
Optional: Legen Sie einen benutzerdefinierten App-Namen für die Gruppe fest:
asc subscriptions groups localizations create \
--group-id "GROUP_ID" \
--locale "LOCALE" \
--name "Gruppen-Anzeigename" \
--custom-app-name "Meine App"
3. Überprüfen
asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table
Arbeitsablauf: Massenlokalisierung eines In-App-Kaufs
IAPs haben ihre eigenen Lokalisierungsbefehle mit demselben Muster.
1. IAP-ID auflösen
asc iap list --app "APP_ID" --output table
2. Vorhandene Lokalisierungen prüfen
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
3. Für fehlende Locales erstellen
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Anzeigename"
Optionale Beschreibung:
asc iap localizations create \
--iap-id "IAP_ID" \
--locale "LOCALE" \
--name "Alle Funktionen freischalten" \
--description "Einmaliger Kauf zum Freischalten aller Premium-Funktionen"
4. Überprüfen
asc iap localizations list --iap-id "IAP_ID" --paginate --output table
Aktualisieren vorhandener Lokalisierungen
So ändern Sie den Anzeigenamen für vorhandene Lokalisierungen:
Abonnements
asc subscriptions localizations update --id "LOC_ID" --name "Neuer Name"
Abonnementgruppen
asc subscriptions groups localizations update --id "LOC_ID" --name "Neuer Gruppenname"
In-App-Käufe
asc iap localizations update --id "LOC_ID" --name "Neuer Name"
Für eine Massenaktualisierung listen Sie zuerst die vorhandenen Lokalisierungen auf, extrahieren Sie die IDs und aktualisieren Sie dann jede.
Massenlokalisierung aller Abonnements in einer App
Für eine vollständige App mit mehreren Abonnementgruppen und Abonnements:
# 1. Alle Gruppen auflisten
asc subscriptions groups list --app "APP_ID" --paginate
# 2. Für jede Gruppe die Gruppe selbst lokalisieren
# (Arbeitsablauf zur Gruppenlokalisierung oben wiederholen)
# 3. Für jede Gruppe Abonnements auflisten
asc subscriptions list --group "GROUP_ID" --paginate
# 4. Für jedes Abonnement dieses lokalisieren
# (Arbeitsablauf zur Abonnementlokalisierung oben wiederholen)
Agentenverhalten
- Listen Sie immer zuerst die vorhandenen Lokalisierungen auf, um doppelte Erstellungsfehler zu vermeiden.
- Überspringen Sie Locales, die bereits eine Lokalisierung haben; erstellen Sie nur fehlende.
- Wenn der Benutzer einen einzelnen Anzeigenamen angibt, verwenden Sie diesen für alle Locales (gleicher Name überall).
- Wenn der Benutzer übersetzte Namen pro Locale angibt, verwenden Sie den lokalspezifischen Namen für jedes.
- Wenn eine Beschreibung angegeben wird, übergeben Sie
--descriptionbeim Erstellen. Andernfalls lassen Sie ihn weg. - Verwenden Sie
--output tablefür Überprüfungsschritte, damit der Benutzer visuell bestätigen kann. - Verwenden Sie die Standard-JSON-Ausgabe für Zwischenautomatisierungsschritte.
- Führen Sie nach der Massenerstellung immer den List-Befehl aus, um die Vollständigkeit zu überprüfen.
- Bei Apps mit vielen Abonnements verarbeiten Sie diese sequentiell pro Gruppe, um die Ausgabe lesbar zu halten.
- Wenn ein Create-Aufruf für ein Locale fehlschlägt, protokollieren Sie das Locale und den Fehler und fahren Sie mit den verbleibenden Locales fort. Melden Sie nach Abschluss des Batches alle Fehler gemeinsam, damit der Benutzer sie beheben kann.
Hinweise
- Abonnement-Anzeigenamen werden Benutzern im Abonnementverwaltungsblatt und in Kaufdialogen angezeigt.
- Das Erstellen einer Lokalisierung für ein Locale, das bereits existiert, schlägt fehl; überprüfen Sie immer zuerst.
- Es gibt keine Bulk-API; jedes Locale erfordert einen separaten Create-Aufruf.
- Verwenden Sie
--paginatebei List-Befehlen, um sicherzustellen, dass alle vorhandenen Lokalisierungen zurückgegeben werden. - Verwenden Sie den Skill
asc-id-resolver, wenn Sie nur App-Namen anstelle von IDs haben.