Vous consultez la documentation Apigee Edge.
Accédez à la
documentation**Apigee X**. info
Un plan freemium permet aux développeurs d'applications d'utiliser le plan tarifaire sans frais pendant une période basée sur l'utilisation, la durée ou les deux. Vous pouvez configurer un plan freemium pour n'importe quel type de plan tarifaire, à l'exception des notifications ajustables.
Configurer un plan freemium à l'aide de l'interface utilisateur
Configurez un plan freemium pour un plan tarifaire, comme décrit ci-dessous.
Edge
Pour configurer un plan freemium à l'aide de l'interface utilisateur Edge lorsque vous créez ou modifiez un plan tarifaire, sélectionnez n'importe quel type de plan tarifaire (à l'exception des notifications ajustables) et dans la section Freemium , activez le plan freemium et sélectionnez l'une des options suivantes :
- Offre par utilisation (nombre d'appels d'API)
- Offre par période
- Le premier des deux
En fonction de votre sélection, configurez l'un des champs suivants ou les deux :
| Champ | Description |
|---|---|
| Utilisation freemium (appels d'API) | Remarque : Obligatoire si vous sélectionnez Offre par quantité ou Le premier des deux.
Nombre de transactions (ou valeur liée à un attribut personnalisé enregistré 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 d'API. |
| Période freemium | Remarque : Obligatoire si vous sélectionnez Offre par durée ou Le premier des deux.
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 (Private Cloud)
Pour configurer un plan freemium à l'aide de l'interface utilisateur Classic Edge :
- Sélectionnez l'onglet Freemium.
- Saisissez les informations suivantes :
Champ Description Package freemium ? Étendue de la période sans frais. Sélectionnez l'un des boutons radio suivants :
- Par quantité. La période 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 "Durée freemium".
- Le premier des deux. La période sans frais prend fin lorsque la quantité dans le champ "Volume" ou l'intervalle de temps dans le champ "Durée freemium" est atteint, selon ce qui se produit en premier.
- Non. Il ne s'agit pas d'un plan freemium. Il s'agit de la valeur par défaut.
Volume freemium Volume de transactions (ou volume lié à un attribut personnalisé enregistré dans la règle d'enregistrement des transactions) pour lesquelles les développeurs sont facturés. Le volume est mesuré sur tous les produits du package d'API. Saisissez un nombre de volume, par exemple 5 000. Cela signifie que lorsque les développeurs commencent à utiliser le plan, les 5 000 premières transactions (ou les 5 000 premières utilisations d'un élément lié à un attribut personnalisé) ne leur sont pas facturées. Ce champ n'est activé que si vous sélectionnez "Par quantité" ou "Le premier des deux" dans le champ "Package freemium ?".
Durée freemium Intervalle de temps 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 à compter de la date de début du plan acheté. Ce champ n'est activé que si vous sélectionnez "Par durée" ou "Le premier des deux" dans le champ "Package freemium ?".
Configurer un plan freemium pour un plan tarifaire à l'aide de l'API
Vous pouvez ajouter un plan 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 évidence.)
$ 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 lié à un attribut personnalisé enregistré dans la règle d'enregistrement des transactions ), spécifiez-la sous la forme d'un nombre d'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 options de plan tarifaire, consultez Rate plan configuration settings.