Aller au contenu

Tutoriel

Modifier en masse les prix des achats intégrés et abonnements

App Store Connect modifie les prix produit par produit. Voici comment en changer dix, cinquante ou deux cents d’un coup, achats intégrés et abonnements, sans y perdre un week-end ni laisser la moitié de votre catalogue à l’ancien prix.

Mis à jour le 9 min de lecture

Peut-on modifier en masse les prix des achats intégrés dans App Store Connect ?

Pas en une seule étape. App Store Connect n’a aucun écran qui modifie plusieurs achats intégrés ou abonnements ensemble : vous ouvrez chaque produit, planifiez son changement et le confirmez. Pour en changer beaucoup d’un coup, vous répétez cela produit par produit, vous scriptez l’API App Store Connect, ou vous utilisez un outil qui pilote l’API à votre place avec une seule vérification.

Pourquoi App Store Connect est lent pour ça

Trois choses multiplient les clics. D’abord, chaque achat intégré et chaque abonnement auto-renouvelable a son propre calendrier de prix, accessible depuis sa propre page. Ensuite, les prix existent par vitrine : Apple génère des prix comparables pour les 175 pays et régions à partir d’un pays de référence (définir le prix d’un achat intégré), mais toute vitrine que vous avez réglée à la main reste telle quelle jusqu’à ce que vous la changiez à nouveau. Enfin, les abonnements sont aussi planifiés par vitrine, avec un choix à faire pour les abonnés existants à chaque changement (gérer les prix des abonnements auto-renouvelables).

Ainsi, « tout augmenter de 10 % » sur trois apps de huit produits chacune représente 24 parcours distincts, chacun avec une vérification pouvant atteindre 175 lignes. C’est là que les erreurs se glissent : un produit oublié, un prix personnalisé écrasé dans un pays, un abonnement resté à l’ancien prix parce que son groupe était replié.

La voie manuelle, produit par produit

Si vous avez une poignée de produits, les écrans intégrés suffisent. Apple distingue trois sortes de changement de prix pour un achat intégré : global (un nouveau prix de référence, avec des prix comparables partout ailleurs), temporaire (une date de début et de fin dans des pays choisis) et personnalisé (des prix que vous gérez vous-même dans certains pays ou dans tous). Les dates d’effet peuvent être fixées à partir d’aujourd’hui et jusqu’à la fin de l’année civile suivante (planifier des changements de prix pour les achats intégrés).

  1. Dans Apps, sélectionnez l’app, puis Achats intégrés dans la barre latérale (les abonnements non renouvelables se trouvent sous Abonnements).
  2. Ouvrez le produit et, à côté de Calendrier des prix, cliquez sur le bouton d’ajout (+).
  3. Choisissez Global, Temporaire ou Personnalisé, sélectionnez la date et le prix du pays de référence, puis vérifiez les prix comparables.
  4. Confirmez, puis recommencez avec le produit suivant.
  5. Pour chaque abonnement auto-renouvelable : ouvrez-le, allez dans Prix de l’abonnement, choisissez Planifier un changement de prix d’abonnement, sélectionnez pays, date et prix, décidez ce qui arrive aux abonnés existants, puis confirmez.

Avant de commencer, exportez ce que les clients paient aujourd’hui : la page de tarification de chaque abonnement propose une option Exporter au format CSV pour les prix actuels et à venir. Gardez ce fichier. C’est votre liste d’annulation.

La voie API : à quoi ressemble le travail

L’API App Store Connect sait tout faire comme les écrans, et un script peut parcourir les produits en boucle. Il faut une clé API d’équipe avec le rôle Gestionnaire d’app ou Admin (autorisations par rôle) ; sa mise en place est décrite dans créer une clé API pour la tarification. La forme d’un traitement en masse :

ÉtapePoint d’accèsRemarques
Lister les produitsGET /v1/apps/{id}/inAppPurchasesV2, GET /v1/apps/{id}/subscriptionGroups, GET /v1/subscriptionGroups/{id}/subscriptionsUne fois par app ; achats intégrés, abonnements d’un groupe.
Trouver les paliers de prixGET /v2/inAppPurchases/{id}/pricePoints, GET /v1/subscriptions/{id}/pricePointsFiltrez par territoire ; Apple indique que le filtre deviendra obligatoire pour les abonnements (paliers de prix d’abonnement).
Les équivalents d’Apple ailleursGET /v1/subscriptionPricePoints/{id}/equalizations, GET /v1/inAppPurchasePricePoints/{id}/equalizationsLe palier correspondant dans les autres devises (égalisations).
Écrire un changement pour un achat intégréPOST /v1/inAppPurchasePriceSchedulesExige baseTerritory, inAppPurchase et manualPrices ; chaque prix a un startDate et un endDate facultatif (documentation).
Écrire un changement pour un abonnementPOST /v1/subscriptionPricesUn par territoire, avec startDate et preserveCurrentPrice (documentation).
Annuler un changement d’abonnement en attenteDELETE /v1/subscriptionPrices/{id}Seulement avant son démarrage.

L’arithmétique compte. Un abonnement s’écrit une vitrine à la fois : 20 abonnements dans 175 vitrines, cela fait 3,500 écritures, sans compter les recherches de paliers de prix. Apple limite les requêtes par clé API sur une heure glissante, indique le reste dans l’en-tête X-Rate-Limit et rejette les appels en excès avec un HTTP 429 et RATE_LIMIT_EXCEEDED ; son propre exemple montre 3,500 requêtes par heure et précise que les limites réelles varient (identifier les limites de débit). Une boucle qui l’ignore s’arrête à mi-chemin, et vous vous retrouvez avec certains produits modifiés et d’autres non.

  • Lisez l’en-tête sur chaque réponse et ralentissez avant d’atteindre zéro ; mettez les 429 en file d’attente et réessayez plus tard plutôt qu’en boucle serrée.
  • Mettez en cache les paliers de prix par produit et par territoire. Ils constituent l’essentiel de vos lectures.
  • Attendez-vous à des erreurs par élément (un palier de prix qui n’existe pas dans une vitrine, une date trop proche) et consignez-les par produit et par pays pour ne renvoyer que les échecs.
  • Les jetons sont valables 20 minutes au plus ; un traitement long doit donc en générer de nouveaux.
  • Pour les achats intégrés, lisez d’abord le calendrier actuel et construisez le nouveau à partir de lui, afin que les pays que vous avez fixés à la main soient conservés volontairement et non par chance.
  • Les changements peuvent mettre jusqu’à une heure à apparaître dans le sandbox : des achats de test juste après une écriture peuvent donc afficher l’ancien prix.

Notre guide de tarification par API détaille un produit de bout en bout ; la comparaison avec la maintenance de votre propre script se trouve sur RepriceCat contre scripts API.

Un tableur pour de nombreux produits

Que vous cliquiez ou scriptiez, un tableur garde un changement en masse honnête. Une ligne par produit et par vitrine, avec le prix actuel à côté du nouveau, permet de trier, de filtrer et de contrôler l’ensemble du changement avant tout envoi.

  1. Exportez les prix actuels : une ligne par produit × vitrine, avec ID de produit, type, territoire, devise, prix actuel et tout changement planifié.
  2. Ajoutez des colonnes pour la règle (par exemple « +10 % »), le prix cible brut et le prix aligné, c’est-à-dire le prix le plus proche qu’Apple propose réellement dans cette devise.
  3. Filtrez les lignes où le prix aligné est égal au prix actuel, ou bouge beaucoup plus que prévu. Corrigez-les à la main.
  4. Ajoutez une colonne de date de début et, pour les abonnements, une colonne abonnés existants (conserver ou appliquer).
  5. Donnez la feuille terminée à votre script, ou ressaisissez-la produit par produit, et conservez la feuille datée comme trace.

Voici ce que « augmenter d’un pourcentage, arrondi au prix en .99 le plus proche » fait aux prix américains courants quand l’arrondi est fait naïvement. Remarquez les lignes qui bougent à peine ou pourraient retomber sur le prix actuel :

Prix actuelRègleCible brutePrix en .99 le plus procheVariation réelle
$2.99+20 %$3.59$3.99+33 %
$4.99+10 %$5.49$4.99 ou $5.99 (égalité)aucune, ou +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 %
Gratuit+10 %$0.00ignoréaucune

Une liste de contrôle avant l’envoi

VérificationPourquoi
Exporter les prix d’aujourd’huiC’est le seul moyen de revenir en arrière si un changement tourne mal. Gardez-les avec la date.
SimulationConstruisez chaque requête sans en envoyer aucune ; comptez les produits, les vitrines et les erreurs attendues.
Vérifier chaque ligneProduit × pays, ancien → nouveau. Cherchez les lignes inchangées, les grands écarts et les pays réglés à la main.
Choisir une date de débutUne date future laisse le temps d’annuler et aligne le changement entre les vitrines. Les heures de début varient selon la région (heures de début).
Décider pour les abonnés existantsConserver leur prix ou appliquer le nouveau ; les hausses appliquées aux abonnés existants suivent les règles d’Apple sur la notification et le consentement.
Vérifier ce qui est déjà planifiéUn nouveau changement d’abonnement remplace celui qui est déjà planifié pour cette vitrine.
Envoyer par lotsRespectez la limite de débit ; surveillez les échecs par produit et par pays.
Vérifier et consignerRelisez les calendriers, comparez avec votre feuille, archivez le résultat.

Les pièges du traitement en masse

  • L’alignement. De petits pourcentages sur des prix bas peuvent retomber sur le prix actuel (voir $4.99 +10 % plus haut), et l’arrondi peut transformer +15 % en +10 % ou +20 % en +33 %. Veillez à ce qu’une hausse tombe toujours au-dessus du prix actuel et une baisse en dessous, et vérifiez le prix aligné, pas la règle.
  • Les produits gratuits. Un pourcentage de zéro reste zéro. Ignorez les produits gratuits dans un changement en pourcentage, ou donnez-leur un prix volontairement.
  • Les vitrines réglées à la main. Si vous fixez votre propre prix dans une vitrine, Apple cesse de l’ajuster pour les taxes et les taux de change. Un changement global à partir du pays de référence n’est peut-être pas ce que reçoivent ces vitrines ; décidez vitrine par vitrine.
  • Les abonnements sont par vitrine et par changement. Apple n’autorise qu’un changement de prix futur à la fois par vitrine et par type de formule de facturation ; en planifier un autre écrase le premier (règles de tarification des abonnements d’Apple).
  • Pas d’annulation une fois en ligne. Une hausse d’abonnement entrée en vigueur ne peut pas être annulée, et une baisse s’applique toujours aux abonnés existants ; vous ne pouvez que planifier un autre changement.
  • Les groupes d’abonnements. Augmenter le mensuel sans l’annuel modifie la remise de la formule annuelle et peut faire paraître une montée en gamme moins avantageuse qu’une descente. Changez ensemble les formules d’un groupe et vérifiez leurs rapports.
  • Apple n’ajuste pas les prix des abonnements pour les taxes ou les taux de change, mais peut ajuster ceux des achats intégrés dans les vitrines qu’elle gère. Sachez lesquels de vos prix Apple peut encore déplacer.

Augmenter le prix d’un abonnement obéit à ses propres règles de notification et de consentement ; lisez comment augmenter le prix d’un abonnement App Store avant d’appliquer une hausse aux abonnés existants.

Le faire avec RepriceCat

RepriceCat se connecte à votre clé d’équipe App Store Connect et exécute tout ce parcours avec une seule vérification. « Modifier plusieurs prix » vous permet de choisir jusqu’à 200 produits dans vos apps, avec des sélections rapides pour tous les abonnements, mensuels, annuels, achats intégrés ou prix d’app, puis d’augmenter ou de baisser d’un pourcentage ou de fixer un nouveau prix unique. Rien n’est envoyé à Apple tant que vous n’avez pas vu la vérification et confirmé.

  • Les changements en pourcentage sont arrondis au prix en .99 le plus proche d’Apple, et une hausse passe toujours au moins au prix supérieur suivant (une baisse au moins au prix inférieur suivant), si bien que rien ne retombe sur le prix actuel. Les produits gratuits sont ignorés et chaque ligne alignée est signalée dans la vérification.
  • Paliers régionaux activés ou non : les autres pays reçoivent le prix de leur palier, ou les prix propres d’Apple en conservant ceux que vous avez fixés à la main.
  • Tout de suite ou à une date, et pour les abonnements « les abonnés existants gardent leur prix » (preserve-current-price d’Apple).
  • Un tableau de vérification produit × pays, prix actuel → nouveau prix, et une simulation qui n’envoie rien.
  • Aller-retour par tableur : exportez les prix actuels vers Excel, Numbers ou CSV, modifiez, importez ; les erreurs sont listées en premier et les lignes importées deviennent des changements en attente que vous vérifiez.
  • Activité consigne chaque changement par pays, liste les pays en échec avec le motif d’Apple pour ne renvoyer que ceux-là, et peut annuler un changement.

Voyez comment cela fonctionne sur modifier en masse les prix App Store, ou commencez avec un mois offert.

Questions fréquentes

Puis-je modifier tous les prix des achats intégrés d’un coup dans App Store Connect ?

Pas depuis un seul écran. App Store Connect modifie les prix produit par produit ; pour en changer beaucoup d’un coup, vous scriptez l’API App Store Connect ou vous utilisez un outil construit dessus.

Comment mettre à jour en masse les prix des abonnements ?

Planifiez un changement de prix par abonnement et par vitrine, dans App Store Connect ou avec POST /v1/subscriptionPrices dans l’API. Décidez pour chaque changement si les abonnés existants gardent leur prix actuel.

Un changement de prix en masse affectera-t-il mes abonnés existants ?

Seulement si vous l’appliquez à eux. Pour une hausse, vous pouvez conserver le prix actuel des abonnés existants ; une baisse leur est toujours appliquée. Les hausses appliquées aux abonnés existants suivent les règles d’Apple sur la notification et le consentement.

Pourquoi mon augmentation de 10 % n’a-t-elle pas changé certains prix ?

Les prix doivent tomber sur l’un des paliers de prix d’Apple. Un petit pourcentage sur un prix bas, comme $4.99 plus 10 %, peut retomber sur le prix actuel. Vérifiez le prix aligné de chaque ligne avant d’envoyer.

Quelle limite de débit s’applique aux changements de prix en masse via l’API ?

Apple limite les requêtes par clé API sur une heure glissante et indique le reste dans l’en-tête X-Rate-Limit. Son exemple montre 3,500 par heure, mais les limites réelles varient : cadencez votre traitement et réessayez les erreurs 429 plus tard.

Puis-je annuler un changement de prix en masse ?

Vous pouvez supprimer les changements qui n’ont pas encore commencé. Une fois un changement en ligne, vous en planifiez un autre pour revenir aux anciens prix, d’où l’importance d’exporter d’abord les prix actuels.

Essayer

Fixez les prix de tous les territoires à partir d’un seul prix de base

Paliers, arrondi aux paliers de prix, un seul tableau de vérification, une seule confirmation — via l’API App Store Connect. Premier mois offert, puis 1 $ par app et par mois.