Fidéliser les abonnés grâce à des offres de fidélisation

Les offres de fidélisation vous aident à réduire le taux de désabonnement volontaire en proposant une remise aux abonnés lorsqu'ils essaient de résilier leur abonnement sur Google Play.

Lorsqu'un abonné éligible commence à résilier son abonnement, Google Play lui présente une offre de fidélisation que vous avez configurée, par exemple "Conservez votre abonnement et bénéficiez de 50 % de remise pendant les deux prochains mois". Si l'abonné accepte l'offre, son abonnement n'est pas résilié. Le prix réduit est appliqué à la prochaine date de facturation.

Cette page explique comment fonctionnent les offres de fidélisation, comment les configurer, comment gérer les événements qui en résultent dans votre backend et comment les tester.

Avant de commencer

Avant de configurer des offres de fidélisation, assurez-vous d'avoir effectué les opérations suivantes :

Comme Google Play affiche les offres de fidélisation en dehors de votre application, vous n'avez pas besoin de modifier votre application ni de mettre à jour votre intégration de la bibliothèque Google Play Billing pour les utiliser. Tout le travail d'intégration s'effectue dans la Google Play Console et votre backend.

Fonctionnement des offres de fidélisation

Les offres de fidélisation n'apparaissent que dans la gestion des abonnements Google Play : l'application Google Play Store et Google Play sur le Web. Elles n'apparaissent pas dans votre application. La bibliothèque Google Play Billing ne renvoie pas d'offres de fidélisation dans les résultats queryProductDetailsAsync(). Elles ne sont donc pas incluses dans ProductDetails.getSubscriptionOfferDetails() et vous ne pouvez pas les vendre via launchBillingFlow(). Si votre application utilise des liens profonds pour rediriger les abonnés vers le centre des abonnements Google Play ou vers un abonnement spécifique afin qu'ils puissent le gérer ou le résilier, ces abonnés peuvent voir votre offre de fidélisation lorsqu'ils commencent à résilier leur abonnement.

Voici ce qui se passe lorsqu'un abonné tente de résilier son abonnement :

  1. L'abonné ouvre son abonnement dans Google Play et commence à le résilier.
  2. Google Play vérifie si l'abonné est éligible à l'une de vos offres de fidélisation, en fonction des règles d'éligibilité que vous avez définies pour l'offre ou selon que vous avez ciblé l'offre pour cet abonné.

  3. Si l'abonné est éligible, Google Play peut lui proposer l'offre de fidélisation comme alternative à la résiliation. Le respect de vos critères d'éligibilité ne garantit pas l'affichage de l'offre, car Google Play effectue également des vérifications supplémentaires au niveau de la plate-forme, telles que les exigences de conformité régionales. Si Google Play affiche l'offre, l'abonné peut effectuer l'une des opérations suivantes :

    • Accepter l'offre : l'abonné accepte l'offre d'un simple geste. L'abonnement reste actif et se renouvelle automatiquement. L'abonné n'est pas facturé immédiatement. Le prix réduit s'applique à partir de la période de facturation suivante.
    • Continuer la résiliation : l'abonné refuse l'offre et termine le processus de résiliation standard. Vous recevez la notification SUBSCRIPTION_CANCELED habituelle. Pour en savoir plus, consultez Annulations.

Si l'abonné quitte le flux de résiliation sans accepter l'offre ni résilier, son abonnement ne change pas. Cela s'applique à la fois à l'application Google Play Store et à Google Play sur le Web. Le fait de consulter une offre de fidélisation sans l'accepter n'est pas comptabilisé dans la limite de demandes de l'offre et ne déclenche pas le délai d'attente entre les offres. Google Play vérifie la limite de demandes lorsqu'il affiche l'offre, puis à nouveau lorsque l'abonné l'accepte. Une offre acceptée est décomptée de la limite de réclamation lorsque l'abonnement est renouvelé au prix réduit. Le délai d'attente entre les offres commence à la fin de la période de remise de l'offre de fidélisation précédente pour le même forfait de base. L'abonné pourra voir à nouveau l'offre la prochaine fois qu'il tentera de résilier son abonnement, à condition qu'il y soit toujours éligible.

Transition de forfait programmée

Lorsqu'un abonné accepte une offre de fidélisation, Google Play la modélise comme une transition de forfait planifiée sur l'achat existant de l'abonné. Cela diffère d'un remplacement différé, qui nécessite un nouveau parcours d'achat et crée un jeton d'achat. Avec une offre de fidélisation, l'abonné conserve le même purchaseToken, et seules les conditions de facturation futures changent.

Lorsque l'abonné accepte l'offre, Google Play effectue les opérations suivantes :

  • Envoie une RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) à votre backend.
  • Ajoute un objet planTransitionDetails au champ autoRenewingPlan de l'élément de campagne concerné dans la ressource SubscriptionPurchaseV2.

Pour en savoir plus sur la gestion de ces événements, consultez Gérer les événements d'offres de fidélisation dans votre backend.

Critères d'éligibilité

Un abonnement peut recevoir une offre de fidélisation à tout moment avant son prochain renouvellement, à condition que toutes les conditions suivantes soient remplies :

  • L'abonnement est actif et se renouvelle automatiquement. Les abonnements en période de grâce, en blocage de compte ou suspendus ne peuvent pas recevoir d'offres de fidélisation.
  • L'abonnement est un abonnement unique. Les offres de fidélisation ne sont pas compatibles avec les abonnements avec modules complémentaires.
  • L'abonnement n'utilise pas de forfait de base à versements échelonnés. Les forfaits de base avec paiement en plusieurs fois ne sont pas éligibles aux offres de fidélisation.
  • Le paiement suivant est au prix récurrent standard du forfait de base. Si l'abonné bénéficie d'un essai sans frais ou d'un prix découverte, l'offre n'est disponible que pendant la dernière période de facturation de cette phase, lorsque le prochain renouvellement est au prix standard.
  • L'abonné ne se trouve pas dans une période de facturation à prix réduit d'une offre de fidélisation précédemment acceptée. Un abonné qui bénéficie d'une offre de fidélisation à prix réduit ne peut pas profiter d'une autre offre de fidélisation tant que l'abonnement n'est pas renouvelé au prix du forfait de base standard.
  • L'abonnement n'a pas de transition de forfait programmée en attente. Un abonnement peut avoir au maximum une transition de forfait programmée en attente, qui est un objet planTransitionDetails à l'état IN_PROGRESS. Par exemple, un abonné qui a déjà accepté une offre de fidélisation qui n'a pas encore pris effet ne peut pas en recevoir une autre.
  • L'abonnement n'a pas de changement de prix non confirmé.
  • Le prix réduit de l'offre de fidélisation est inférieur ou égal au prix du prochain renouvellement du forfait de base de l'abonné.
  • L'abonné respecte les règles d'éligibilité que vous avez configurées pour l'offre. Pour une offre de rétention des utilisateurs, vous avez activé le ciblage de l'abonnement avec la méthode activateOfferTargeting.

Configurer des offres de fidélisation

Vous pouvez créer des offres de fidélisation dans la Google Play Console ou à l'aide de l'API Google Play Developer. Chaque offre de fidélisation utilise l'un des modes de ciblage suivants :

  • Ciblage basé sur des règles : Google Play détermine quels abonnés sont éligibles en fonction des règles d'éligibilité que vous définissez, comme une durée minimale d'abonnement payant.
  • Ciblage par utilisateur : votre backend décide quels abonnés peuvent voir l'offre en la ciblant sur des abonnements spécifiques.

Un forfait de base peut comporter plusieurs offres de fidélisation actives dans un même pays ou une même région. Lorsqu'un abonné est éligible à plusieurs offres, Google Play n'affiche qu'une seule offre de fidélisation dans le parcours de résiliation. Google Play choisit l'offre dans l'ordre suivant :

  1. Mode de ciblage : une offre ciblée par utilisateur (retentionPerUserRule) prévaut toujours sur une offre basée sur des règles (retentionRule), même si l'offre basée sur des règles propose un pourcentage de remise plus élevé.
  2. Pourcentage de remise : parmi les offres éligibles qui utilisent le même mode de ciblage, Google Play affiche l'offre avec le pourcentage de remise le plus élevé.
  3. Prix réduit : si les offres ont le même pourcentage de remise, Google Play affiche l'offre dont le prix réduit est le plus bas.
  4. ID d'offre : si les offres sont toujours à égalité, Google Play affiche l'offre dont l'offerId est le dernier par ordre alphabétique.

Créer une offre de fidélisation dans la Play Console

Pour créer une offre de fidélisation dans la Google Play Console, procédez comme suit :

  1. Accédez à Monétiser avec Play > Produits > Abonnements.
  2. Sélectionnez un abonnement, puis le forfait de base auquel vous souhaitez ajouter l'offre.
  3. Ajoutez une offre pour les abonnés existants qui tentent de résilier.
  4. Sélectionnez Offre de fidélisation au niveau de la cohorte ou Offre de fidélisation au niveau de l'utilisateur.

Créer une offre de fidélisation avec l'API Play Developer

Vous pouvez également créer et mettre à jour des offres de fidélisation de manière programmatique. Pour créer une offre, appelez la méthode monetization.subscriptions.basePlans.offers.create. Pour mettre à jour des offres existantes, appelez la méthode monetization.subscriptions.basePlans.offers.patch ou monetization.subscriptions.basePlans.offers.batchUpdate. Les trois méthodes sont compatibles avec les champs retentionRule, retentionPerUserRule, startTime et endTime. Dans l'objet SubscriptionOffer, définissez les champs suivants :

  • offerId : ID unique de votre offre de fidélisation.
  • targeting : définissez retentionRule sur un objet RetentionTargetingRule qui définit qui est éligible à l'offre. Pour connaître les champs disponibles, consultez Définir des règles d'éligibilité à la conservation. Pour choisir les abonnés éligibles à partir de votre backend, définissez retentionPerUserRule. Pour en savoir plus, consultez Cibler des abonnés spécifiques avec des offres de fidélisation.
  • phases[] : une offre de fidélisation n'accepte qu'une seule phase de tarification. Dans cette phase, définissez les champs suivants :
    • recurrenceCount : nombre de périodes de facturation pendant lesquelles la remise s'applique, de 1 à 52. Si recurrenceCount est supérieur à 1, la phase duration doit être égale à la période de facturation du forfait de base.
    • regionalConfigs[] : définissez relativeDiscount sur la remise sous la forme d'une fraction supérieure à 0 et inférieure à 1. Par exemple, utilisez 0.5 pour une remise de 50 %. Les offres de fidélisation n'acceptent que relativeDiscount. Les phases à prix fixe (price), à remise absolue (absoluteDiscount) et sans frais (free) ne sont pas acceptées.
  • startTime : facultatif. Heure à laquelle l'offre de fidélisation devient disponible pour les abonnés éligibles, sous la forme d'un code temporel RFC 3339. La définition de ce champ n'active pas l'offre. Si vous ne définissez pas ce champ, l'offre devient disponible en fonction de son état.
  • endTime : facultatif. Heure à laquelle l'offre de fidélisation n'est plus disponible, sous la forme d'un code temporel RFC 3339, quel que soit l'état de l'offre. Si vous ne définissez pas ce champ, l'offre n'a pas de date de fin. Si vous définissez ce champ, il doit être dans le futur et postérieur à startTime.

La méthode monetization.subscriptions.basePlans.offers.create crée toujours l'offre à l'état DRAFT, même si vous définissez startTime. Pour activer l'offre, appelez la méthode monetization.subscriptions.basePlans.offers.activate.

Définir des règles d'éligibilité à la conservation

L'objet RetentionTargetingRule contient les champs suivants :

  • scope : valeur obligatoire. Abonnements pris en compte par la règle. Pour les offres de fidélisation, la seule valeur acceptée est thisSubscription, l'abonnement dans lequel l'offre est définie. Définissez ce champ sur {"thisSubscription": {}}.
  • minDuration : valeur obligatoire. Durée minimale pendant laquelle un utilisateur doit avoir été abonné payant pour être éligible, exprimée en jours au format ISO 8601, de P0D à P1826D. Par exemple, utilisez P90D pour 90 jours. Pour ne pas exiger de durée d'abonnement payant minimale, définissez ce champ sur P0D.
  • allowMultipleClaims : facultatif. Indique si un abonné peut bénéficier de l'offre plusieurs fois. Si la valeur est false, un abonné qui a déjà bénéficié de cette offre ne pourra plus jamais en bénéficier. Si la valeur est true, un abonné peut redevenir éligible une fois que le délai indiqué dans minOfferCooldownDuration s'est écoulé depuis la fin de la période de remise de l'offre de fidélisation précédente. La valeur par défaut est false.
  • minOfferCooldownDuration : obligatoire si allowMultipleClaims est défini sur true. Délai minimal devant s'écouler après la fin de la période de remise de l'offre de fidélisation précédente avant que l'abonné ne soit de nouveau éligible, sous la forme d'une durée ISO 8601 en jours, de P1D à P1826D. Par exemple, utilisez P180D pour 180 jours. Ne définissez pas ce champ si allowMultipleClaims est défini sur false ou n'est pas défini.

L'exemple suivant montre les champs startTime, endTime et targeting d'un objet SubscriptionOffer pour une offre de fidélisation disponible pour les abonnés ayant payé pendant au moins 90 jours, et qu'ils peuvent réclamer à nouveau 180 jours après la fin de leur remise de fidélisation précédente :

{
  "offerId": "retention-50off-2m",
  "startTime": "2026-12-01T00:00:00Z",
  "endTime": "2027-03-01T00:00:00Z",
  "targeting": {
    "retentionRule": {
      "scope": {
        "thisSubscription": {}
      },
      "minDuration": "P90D",
      "allowMultipleClaims": true,
      "minOfferCooldownDuration": "P180D"
    }
  }
}

Cibler des abonnés spécifiques avec des offres de fidélisation

Au lieu de laisser Google Play décider de l'éligibilité avec un RetentionTargetingRule, vous pouvez proposer une offre de fidélisation uniquement aux abonnés choisis par votre backend. Par exemple, vous pouvez cibler une offre pour les abonnés que votre modèle de prédiction de l'attrition signale comme étant à risque, ou pour les abonnés qui lancent un parcours de résiliation dans votre application.

Les abonnés voient une offre de fidélisation par utilisateur dans le même flux de résiliation Google Play que toute autre offre de fidélisation, et vous gérez l'acceptation de la même manière. Pour en savoir plus, consultez Gérer les événements d'offres de fidélisation dans votre backend.

Pour cibler des abonnés spécifiques avec des offres de fidélisation, procédez comme suit :

  1. Créez une offre de rétention par utilisateur. Lorsque vous appelez la méthode monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch ou monetization.subscriptions.basePlans.offers.batchUpdate, définissez targeting sur un objet retentionPerUserRule au lieu d'un objet retentionRule. L'objet RetentionPerUserTargetingRule ne comporte aucun champ. Une offre peut utiliser retentionRule ou retentionPerUserRule, mais pas les deux.

    {
      "offerId": "retention-peruser-30off",
      "targeting": {
        "retentionPerUserRule": {}
      }
    }
    

    Activez l'offre avant de la cibler pour les abonnés. Si vous appelez la méthode activateOfferTargeting pour une offre qui n'a jamais été activée, l'appel échoue avec un code d'état HTTP 400 Bad Request et un état d'erreur INVALID_ARGUMENT. Pour en savoir plus, consultez Gérer les erreurs de ciblage. Même lorsque l'offre est active, Google Play ne la présente qu'aux abonnés dont vous ciblez les abonnements à l'étape suivante.

  2. Ciblez l'offre sur un abonnement. Appelez la méthode purchases.subscriptionsv2.activateOfferTargeting avec le nom du package de votre application, le purchaseToken de l'abonnement et le offerId de l'offre de rétention par utilisateur :

    POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting
    
    {
      "offerId": "retention-peruser-30off"
    }
    

    Un appel réussi renvoie un code d'état HTTP 204 No Content sans corps de réponse. Google Play stocke le ciblage avec l'abonnement. Vous n'avez donc pas besoin d'appeler l'API au moment où l'abonné résilie son abonnement. La prochaine fois que l'abonné commencera à résilier son abonnement sur Google Play, Google Play pourra afficher l'offre, à condition que l'abonnement respecte les critères d'éligibilité. Le ciblage par utilisateur ne remplace que les règles d'éligibilité définies par un retentionRule. Tous les autres critères d'éligibilité et les vérifications au niveau de la plate-forme effectuées par Google Play, telles que les exigences de conformité régionales, s'appliquent toujours.

    Vous pouvez cibler plusieurs offres de rétention par utilisateur pour un même abonnement. Pour ce faire, appelez la méthode activateOfferTargeting une fois pour chaque offre. Google Play n'affiche toujours qu'une seule offre de fidélisation au maximum dans le flux de résiliation. Pour savoir comment Google Play choisit l'offre, consultez Configurer des offres de fidélisation.

    La méthode activateOfferTargeting est idempotente. Si vous l'appelez pour une offre déjà ciblée par l'abonnement, l'appel aboutit et Google Play met à jour le activateTime de l'offre à l'heure de la dernière requête.

  3. Supprimez le ciblage si nécessaire. Si vous ne souhaitez plus qu'un abonné reçoive l'offre, par exemple parce que son risque de désabonnement a changé, appelez la méthode purchases.subscriptionsv2.deactivateOfferTargeting avec le même nom de package, purchaseToken et offerId. Les appels réussis affichent le code d'état HTTP 204 No Content avec un corps de réponse vide.

    La méthode deactivateOfferTargeting est également idempotente. Si l'offre n'est pas ciblée sur l'abonnement, par exemple parce que vous n'avez jamais activé le ciblage, l'appel aboutit et n'a aucun effet.

Le ciblage s'applique à un seul purchaseToken et n'expire pas tant que l'abonnement est actif et se renouvelle automatiquement. Elle reste en place une fois que l'abonné a vu, accepté ou refusé l'offre. Google Play ne le supprime que lorsque vous appelez la méthode deactivateOfferTargeting ou 60 jours après l'expiration de l'abonnement. Si un changement de forfait ou un réabonnement crée un nouveau purchaseToken, le ciblage n'est pas reporté.

Pour vérifier quelles offres de rétention par utilisateur sont ciblées pour un abonnement, appelez la méthode purchases.subscriptionsv2.get. Le champ developerTargetedOffers de chaque élément de campagne liste les offres ciblées. Chaque entrée contient l'offerId et l'activateTime lorsque vous avez activé le ciblage :

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "developerTargetedOffers": [
        {
          "offerId": "retention-peruser-30off",
          "activateTime": "2026-12-03T15:04:05Z"
        }
      ]
    }
  ]
}

Gérer les erreurs de ciblage

En cas d'échec d'un appel de la méthode activateOfferTargeting ou deactivateOfferTargeting, la réponse contient un code d'état HTTP et un état d'erreur qui en décrit la cause. Le tableau suivant répertorie les codes d'état HTTP et les états d'erreur que ces méthodes peuvent renvoyer :

Code d'état HTTP État d'erreur Méthodes Cause
404 Not Found NOT_FOUND Les deux purchaseToken n'existe pas.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting Le offerId n'existe pas dans le forfait de base actuel de l'abonnement, ou l'offre est toujours à l'état de brouillon et n'a jamais été activée.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting La valeur targeting de l'offre n'est pas définie sur retentionPerUserRule.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting L'abonnement a déjà expiré.

La méthode activateOfferTargeting ne vérifie pas si un abonnement non expiré est éligible à l'offre. Par exemple, si l'abonnement est résilié, mais n'a pas encore expiré, l'appel aboutit et Google Play stocke le ciblage. Google Play évalue l'éligibilité de l'abonnement lorsque l'abonné accède au flux de résiliation.

Gérer les événements d'offres de fidélisation dans votre backend

Lorsqu'un abonné accepte une offre de fidélisation, puis lorsque le renouvellement à prix réduit a lieu, Google Play envoie des RTDN à votre backend. Après avoir reçu chaque notification, appelez la méthode purchases.subscriptionsv2.get avec le purchaseToken de la notification pour obtenir le dernier état de l'abonnement.

L'acceptation d'une offre de fidélisation ne crée pas d'achat. Le purchaseToken reste le même. Vous n'avez donc pas besoin de confirmer l'achat à nouveau, et Google Play ne génère pas de linkedPurchaseToken. Conservez les droits existants de l'abonné. Traitez la commande de renouvellement à prix réduit de la même manière que tout autre renouvellement d'abonnement.

Type de notification Quand les données sont envoyées Que faire ?
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Lorsqu'un abonné accepte une offre de fidélisation dans le flux de résiliation. Appelez la méthode purchases.subscriptionsv2.get et vérifiez planTransitionDetails. La valeur de transitionState est IN_PROGRESS. L'abonnement reste actif et se renouvelle automatiquement. Continuez donc à accorder l'accès.
SUBSCRIPTION_RENEWED (2) Lorsque la période de facturation en cours se termine et que l'abonnement est renouvelé au prix de l'offre de fidélisation à prix réduit. Appelez la méthode purchases.subscriptionsv2.get, confirmez que offerDetails.offerId est l'ID d'offre de fidélisation et que planTransitionDetails n'est plus présent, puis prolongez l'accès de l'abonné au nouveau expiryTime.

L'objet planTransitionDetails contient les champs suivants :

  • productId : ID produit du forfait vers lequel l'abonnement est transféré. Pour une offre de fidélisation, il s'agit du même produit.
  • basePlanId : ID du forfait de base vers lequel l'abonnement est transféré.
  • offerId : ID de l'offre de fidélisation acceptée par l'abonné. Utilisez ce champ pour identifier l'offre de fidélisation qui a été utilisée.
  • transitionInfo.transitionState : état de la transition. Pour les offres de fidélisation, l'état est IN_PROGRESS tant que la transition est en attente.
  • transitionInfo.expectedTransitionTime : date à laquelle les conditions de l'offre de fidélisation doivent prendre effet.

Google Play n'inclut planTransitionDetails que pendant la transition. Lorsque l'abonnement est renouvelé au prix de l'offre de fidélisation, la transition est terminée et Google Play supprime planTransitionDetails de la réponse purchases.subscriptionsv2.get. À partir de ce moment, l'élément de campagne lui-même affiche la remise de fidélisation active :

  • offerDetails.offerId est l'ID de l'offre de fidélisation acceptée.
  • offerPhase est de {"introductoryPrice": {}} pendant les périodes de facturation avec remise. Une fois les périodes de facturation à prix réduit terminées et l'abonnement renouvelé au prix de base standard, offerPhase devient {"basePrice": {}}.

Réponse après que l'abonné a accepté l'offre

Une fois que l'abonné a accepté l'offre de fidélisation, la période de facturation en cours se poursuit sans modification. L'objet planTransitionDetails affiche la transition planifiée avec un transitionState de IN_PROGRESS :

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2026-12-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base"
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "planTransitionDetails": {
          "productId": "premium_monthly_sub",
          "basePlanId": "monthly-base",
          "offerId": "retention-50off-2m",
          "transitionInfo": {
            "transitionState": "IN_PROGRESS",
            "expectedTransitionTime": "2026-12-15T10:00:00Z"
          }
        }
      }
    }
  ]
}

Réponse après le renouvellement à prix réduit

Une fois la date de renouvellement passée et le prix réduit facturé à l'abonné, offerDetails.offerId affiche l'offre de fidélisation, offerPhase affiche introductoryPrice et la réponse n'inclut plus planTransitionDetails :

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2027-01-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base",
        "offerId": "retention-50off-2m"
      },
      "offerPhase": {
        "introductoryPrice": {}
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "recurringPrice": {
          "currencyCode": "USD",
          "units": "9",
          "nanos": 990000000
        }
      }
    }
  ]
}

Interactions liées au cycle de vie

Tenez compte des comportements suivants lorsque vous gérez des offres de fidélisation :

  • Fin de la remise : une fois les périodes de facturation à prix réduit terminées, l'abonnement est automatiquement renouvelé au prix de base standard du forfait. Vous recevez une notification SUBSCRIPTION_RENEWED, comme pour tout autre renouvellement, et l'état offerPhase de l'élément de campagne passe à {"basePrice": {}}. L'abonné n'a aucune action à effectuer.
  • Récupération du paiement après la remise : si le renouvellement au prix du forfait de base standard après la fin de la remise est refusé et que l'abonnement entre dans un délai de grâce ou un blocage de compte, la récupération du paiement facture le prix du forfait de base standard. Google Play n'applique pas la remise de l'offre de fidélisation terminée. Si le paiement du premier renouvellement à prix réduit est refusé, la transition en attente est conservée et le prix de l'offre de fidélisation s'applique lorsque le paiement est rétabli.
  • Facturation différée : si vous appelez la méthode purchases.subscriptionsv2.defer alors qu'une transition d'offre de fidélisation est IN_PROGRESS, la transition en attente est conservée et s'applique au renouvellement différé. Pour connaître la nouvelle date de renouvellement, consultez la section expiryTime de l'élément de campagne.
  • Changement de forfait avant la transition : une offre de fidélisation ne s'applique qu'au purchaseToken de l'abonnement pour lequel l'abonné l'a acceptée. Si l'abonné passe à un autre forfait de base ou abonnement avant le expectedTransitionTime, Google Play génère un nouveau jeton d'achat, annule la transition planifiée et efface planTransitionDetails. L'offre de fidélisation en attente ne s'applique pas au nouveau forfait.
  • Résiliation et restauration : si un abonné résilie son abonnement après avoir accepté une offre de fidélisation, la transition planifiée reste en attente et transitionState reste IN_PROGRESS. Si l'abonné restaure l'abonnement avant son expiration, la remise de l'offre de fidélisation s'applique toujours lors du renouvellement.
  • Expiration et réabonnement : si l'abonnement expire sans être restauré, Google Play annule la transition en attente. Si l'utilisateur se réabonne ou se réinscrit ultérieurement, Google Play crée un nouvel achat d'abonnement, et l'offre de fidélisation précédemment acceptée ne s'applique pas.
  • Modifications de l'offre : si vous modifiez la remise ou les périodes de facturation d'une offre de fidélisation, la modification ne s'applique qu'aux futures utilisations. Les abonnés qui ont déjà accepté l'offre conservent les conditions d'origine.
  • Désactivation d'une offre : si vous désactivez une offre de fidélisation ou si elle arrive à expiration, les abonnés qui l'ont déjà acceptée conservent les conditions qu'ils ont acceptées. Les abonnés qui ont effectué une transition IN_PROGRESS bénéficient toujours de la remise lors de leur prochain renouvellement, et les abonnés qui se trouvent déjà dans les périodes de facturation avec remise conservent la remise pendant toute la durée convenue.
  • Modifications tarifaires : les modifications tarifaires du forfait de base s'appliquent toujours. Google Play ne migre un abonné vers un nouveau prix que si celui-ci paie le prix normal et qu'aucune transition d'offre de fidélisation n'est en attente. Pour en savoir plus, consultez Modifier le prix des abonnements.
  • Remboursements : vous pouvez rembourser un abonné à l'aide des API de remboursement et de révocation standards, telles que la méthode purchases.subscriptionsv2.revoke. Le paiement le plus récent est alors remboursé et l'accès de l'abonné est résilié.

Tester les offres de fidélisation

Google Play n'affiche que les offres de fidélisation actives dans le flux de résiliation et évalue les règles d'éligibilité en temps réel. Pour tester les offres de fidélisation avec un compte de testeur de licence, utilisez l'une des méthodes suivantes :

Avant d'utiliser l'une ou l'autre de ces méthodes, accédez à Paramètres > Tests de licence dans la Google Play Console, puis ajoutez le compte Google de test en tant que testeur de licence.

Tester une offre de fidélisation par utilisateur

Google Play n'affiche une offre de fidélisation par utilisateur que pour les abonnements que vous ciblez. Vous pouvez donc la tester sur un forfait de base de production sans l'exposer aux abonnés réels. Pour tester une offre de rétention des utilisateurs, procédez comme suit :

  1. Créez une offre de fidélisation par utilisateur sous le forfait de base, puis activez-la. Dans la Google Play Console, sélectionnez Offre de fidélisation au niveau de l'utilisateur. Avec l'API Google Play Developer, définissez targeting sur un objet retentionPerUserRule. Pour en savoir plus, consultez Cibler des abonnés spécifiques avec des offres de fidélisation.
  2. Si vous venez d'activer l'offre, attendez 10 à 15 minutes que la modification se propage, puis videz le cache de l'application Google Play Store.
  3. Sur l'appareil de test, connectez-vous avec le compte de testeur de licence, puis achetez le forfait de base dans votre application.
  4. Depuis votre backend, appelez la méthode purchases.subscriptionsv2.activateOfferTargeting avec le nom du package de votre application, le purchaseToken du testeur de licence et le offerId de l'offre de fidélisation.
  5. Dans l'application Google Play Store, accédez à Paiements et abonnements > Abonnements, sélectionnez l'abonnement, puis appuyez sur Annuler l'abonnement. L'offre de fidélisation s'affiche dans le flux de résiliation.
  6. Acceptez l'offre, puis vérifiez que votre backend reçoit la notification RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED et gère le renouvellement à prix réduit.

Tester une offre de fidélisation basée sur des règles

Une fois que vous avez activé une offre de fidélisation basée sur des règles, Google Play peut la proposer à tous les abonnés éligibles au forfait de base. Pour éviter d'exposer l'offre aux utilisateurs en production, testez-la dans une application de test hors production ou sur un plan de base de test dédié auquel les utilisateurs en production ne peuvent pas accéder. Pour tester une offre de fidélisation basée sur des règles, procédez comme suit :

  1. Dans votre application de test ou sur votre forfait de base de test, créez une offre de fidélisation basée sur des règles, puis définissez minDuration sur P0D (0 jour). Dans la Google Play Console, sélectionnez Offre de fidélisation au niveau de la cohorte. Avec l'API Google Play Developer, définissez targeting sur un objet retentionRule. Pour en savoir plus, consultez Définir des règles d'éligibilité à la conservation.
  2. Activez l'offre, attendez 10 à 15 minutes que la modification se propage, puis videz le cache de l'application Google Play Store.
  3. Sur l'appareil de test, connectez-vous avec le compte de testeur de licence, puis achetez le forfait de base de test.
  4. Dans l'application Google Play Store, accédez à Paiements et abonnements > Abonnements, sélectionnez l'abonnement, puis appuyez sur Annuler l'abonnement. Comme l'offre ne nécessite pas de durée d'abonnement payant minimale, vous pouvez lancer la procédure de résiliation juste après l'achat. L'offre de fidélisation s'affiche dans le flux de résiliation.
  5. Acceptez l'offre, puis vérifiez que votre backend reçoit la notification RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED et gère le renouvellement à prix réduit.

Après avoir validé l'intégration, créez et activez l'offre de fidélisation basée sur des règles sur votre forfait de base de production.

Résoudre les problèmes liés aux tests des offres de fidélisation

Si l'offre de fidélisation n'apparaît pas, vérifiez les points suivants :

  • L'offre de fidélisation est active et l'heure actuelle se situe entre ses valeurs startTime et endTime, si vous les avez définies.
  • Pour une offre de rétention des utilisateurs par utilisateur, le champ developerTargetedOffers de la réponse purchases.subscriptionsv2.get pour le purchaseToken du testeur de licence inclut l'offre.
  • L'abonnement est un abonnement unique, et non un abonnement avec des modules complémentaires.
  • L'abonnement n'est pas en délai de grâce, en blocage de compte ni en pause.
  • L'abonnement n'a pas de changement de forfait ni de prix en attente.
  • Le prochain renouvellement se fera au prix standard du forfait de base. Pour les essais sans frais et les offres de découverte, l'offre de fidélisation n'est disponible que pendant la dernière période de facturation de l'essai ou de la phase de découverte.
  • Vous avez attendu 10 à 15 minutes après avoir activé ou modifié l'offre, et vous avez vidé le cache de l'application Play Store.