Configurer un forfait freemium

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

Un forfait freemium permet aux développeurs d'applications d'utiliser sans frais le plan tarifaire pendant une période qui dépend de l'utilisation, de la durée ou des deux. Vous pouvez configurer un plan freemium pour tout type de plan tarifaire, à l'exception des notifications ajustables.

Configurer un forfait freemium à l'aide de l'interface utilisateur

Configurez un plan freemium pour un plan tarifaire, comme décrit ci-dessous.

Périphérie

Pour configurer un plan freemium à l'aide de l'interface utilisateur Edge lors de la création ou de la modification d'un plan tarifaire, sélectionnez un type de plan tarifaire (sauf Notification réglable) et, dans la section Freemium, activez le plan freemium et sélectionnez l'une des options suivantes:

  • Offre en fonction de l'utilisation (nombre d'appels d'API)
  • Offre par période
  • Selon la situation qui se présente en premier

En fonction de vos choix, configurez l'un des champs suivants ou les deux:

Champ Description
Utilisation du freemium (appels d'API) Remarque: Obligatoire si vous sélectionnez Offre par quantité ou selon la première option.

Nombre de transactions (ou valeur associée à un attribut personnalisé, enregistrée dans la règle d'enregistrement des transactions) pour lesquelles les développeurs ne sont pas facturés. Le volume est mesuré pour le produit API.
Période freemium Remarque: Obligatoire si vous sélectionnez Offre selon la durée ou selon la première échéance.

Intervalle de temps pendant lequel les développeurs ne sont pas facturés. Par exemple, 30 jours. Spécifiez le nombre et l'unité (jour, semaine ou mois).

Classic Edge (cloud privé)

Pour configurer un plan freemium à l'aide de l'interface utilisateur Classic Edge:

  1. Sélectionnez l'onglet Freemium.

  2. Saisissez les informations suivantes :
    Champ Description
    Package Freemium ?

    Durée de la période sans frais. Sélectionnez l'une des cases d'option suivantes:

    • Par quantité. La période d'essai sans frais est basée sur une quantité spécifiée dans le champ "Volume".
    • Par durée. La période sans frais est basée sur un intervalle de temps spécifié dans le champ Freemium Duration.
    • Selon la situation qui se présente en premier. La période sans frais prend fin lorsque la quantité indiquée dans le champ "Volume" ou l'intervalle de temps indiqué dans le champ "Freemium Duration" (Durée Freemium) est atteinte, selon la première échéance atteinte.
    • Non. Il ne s'agit pas d'un forfait Freemium. Il s'agit de la valeur par défaut.
    Volume de freemium

    Volume de transactions (ou volume associé à un attribut personnalisé enregistré dans la règle d'enregistrement des transactions) pour lesquels les développeurs sont facturés. Le volume est mesuré pour tous les produits du package d'API. Saisissez un numéro de volume, par exemple 5 000. Cela signifie que lorsque les développeurs commencent le forfait, ils ne sont pas facturés pour les 5 000 premières transactions (ni pour les 5 000 premières utilisations d'un élément lié à un attribut personnalisé). Ce champ n'est activé que si vous sélectionnez "Par quantité" ou "Quelle est la première échéance" dans le champ "Package Freemium ?".
    Durée freemium

    Intervalle pendant lequel les développeurs ne sont pas facturés. Saisissez un nombre et sélectionnez une période, par exemple "1 mois". Cela signifie que les développeurs ne sont pas facturés pendant un mois suivant la date de début du forfait acheté. Ce champ n'est activé que si vous sélectionnez "Par durée" ou "Quelle est la première échéance" dans le champ "Package freemium ?".

Configurer un plan freemium en plan tarifaire à l'aide de l'API

Vous pouvez ajouter un forfait freemium lorsque vous créez ou mettez à jour le plan tarifaire. Vous spécifiez les propriétés freemium dans le corps de la requête de l'appel.

Par exemple, la requête suivante crée un plan tarifaire standard avec une période freemium de 30 jours. Les spécifications liées au freemium sont mises en avant.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Simple rate plan",
     "currency": {
      "id" : "usd"
     },
     "description": "Simple rate plan",
     "displayName" : "Simple rate plan",
     "freemiumDuration": "30",
     "freemiumDurationType": "DAY",
     "monetizationPackage": {
      "id": "location_package"
     },
     "organization": {
      "id": "{org_name}
     },
     "published": "true",
     "ratePlanDetails": [
     {
      …
      }
      ],
     "startDate": "2013-09-15",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password

Pour spécifier une quantité basée sur le freemium (par exemple, le nombre de transactions impliquant le package d'API ou le volume correspondant à un attribut personnalisé enregistré dans la règle d'enregistrement des transactions), spécifiez-la en tant qu'unités freemium. Par exemple, l'attribution de propriété suivante spécifie que le freemium est basé sur 5 000 unités freemium:

"freemiumUnit": "5000"

Pour obtenir la liste complète des plans tarifaires, consultez la section Paramètres de configuration du plan tarifaire.