From 398262f51db45e14c7005a808d0bf3fd98b5c509 Mon Sep 17 00:00:00 2001 From: patrikbraborec Date: Mon, 22 Sep 2025 12:24:29 +0200 Subject: [PATCH 1/2] docs: Add links to correct monetization docs --- .../actor-runs/actor-runs@{runId}@charge.yaml | 2 ++ sources/academy/ai/ai-agents.mdx | 6 ++++++ .../how_actor_monetization_works.md | 18 +++++++++++++++--- 3 files changed, 23 insertions(+), 3 deletions(-) diff --git a/apify-api/openapi/paths/actor-runs/actor-runs@{runId}@charge.yaml b/apify-api/openapi/paths/actor-runs/actor-runs@{runId}@charge.yaml index 68e533057a..0d7b050428 100644 --- a/apify-api/openapi/paths/actor-runs/actor-runs@{runId}@charge.yaml +++ b/apify-api/openapi/paths/actor-runs/actor-runs@{runId}@charge.yaml @@ -7,6 +7,8 @@ post: The event you are charging for must be one of the configured events in your Actor. If the Actor is not set up as pay per event, or if the event is not configured, the endpoint will return an error. The endpoint must be called from the Actor run itself, with the same API token that the run was started with. + For more details about PPE pricing, see our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event). + operationId: PostChargeRun parameters: - name: runId diff --git a/sources/academy/ai/ai-agents.mdx b/sources/academy/ai/ai-agents.mdx index 4e53884a28..157bf7ac66 100644 --- a/sources/academy/ai/ai-agents.mdx +++ b/sources/academy/ai/ai-agents.mdx @@ -251,6 +251,12 @@ Common issues and solutions: Apify's pay-per-event (PPE) pricing model allows charging users based on specific triggered events through the API or SDKs. +:::info How pay-per-event pricing works + +If you want more details about PPE pricing, please refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event). + +::: + ### Step 1: Define chargeable events You can configure charges for events like the Actor starting, a task completing successfully, or custom events such as specific API calls. diff --git a/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md b/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md index c7e986d1df..795b9a12d7 100644 --- a/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md +++ b/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md @@ -33,7 +33,11 @@ Monetizing your Actor on the Apify platform involves several key steps: - 2nd user starts their trial but pays next month. - 3rd user on a free plan finishes the trial without upgrading to a paid plan and can’t use the Actor further. -Learn more about the rental pricing model in our [documentation](/platform/actors/publishing/monetize#rental-pricing-model). +:::info Rental pricing details + +If you want more details about rental pricing, please refer to our [rental pricing documentation](/platform/actors/publishing/monetize/rental). + +::: ### Pay-per-result pricing model @@ -49,7 +53,11 @@ Learn more about the rental pricing model in our [documentation](/platform/actor - Dataset storage: $1 per 1,000 GB-hours - _Example_: you set a price of $1 per 1,000 results. Two users generate 50,000 and 20,000 results, paying $50 and $20, respectively. If the platform usage costs are $5 and $2, your profit is $49. -Learn more about the pay-per-result pricing model in our [documentation](/platform/actors/publishing/monetize#pay-per-result-pricing-model). +:::info Pay-per-result details + +If you want more details about PPR pricing, please refer to our [PPR documentation](/platform/actors/publishing/monetize/pay-per-result). + +::: ### Pay-per-event pricing model @@ -77,7 +85,11 @@ Learn more about the pay-per-result pricing model in our [documentation](/platfo - This comes up to $1.625 of total revenue - That means if platform usage costs are $0.365 for user A and $0.162 for user B your profit is $4.748 -Learn more about the pay-per-event pricing model in our [documentation](/platform/actors/publishing/monetize#pay-per-event-pricing-model). +:::info Pay-per-event details + +If you want more details about PPE pricing, please refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event). + +::: ## Setting up monetization From 954740d6ac0dd342d031b4d04ed3a9a60cb59a90 Mon Sep 17 00:00:00 2001 From: patrikbraborec Date: Mon, 22 Sep 2025 12:29:04 +0200 Subject: [PATCH 2/2] docs: Fix vale error --- .../store_basics/how_actor_monetization_works.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md b/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md index 795b9a12d7..b212ee9611 100644 --- a/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md +++ b/sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md @@ -116,7 +116,7 @@ The easiest way to understand your tool's value is to look around. Are there sim Try competitor tools yourself (to assess the value and the quality they provide), check their SEO (to see how much traffic they get), and note ballpark figures. Think about what your Actor can do that competitors might be missing. -Also, remember that your Actor is a package deal with the Apify platform. So all the platform's features automatically transfer onto your Actor and its value. Scheduling, monitoring runs, ways of exporting data, proxies, and integrations can all add value to your Actor (on top of its own functionalities). Be sure to factor this into your tool's value proposition and communicate that to the potential user. +Also, remember that your Actor is a package deal with the Apify platform. All the platform's features automatically transfer onto your Actor and its value. Scheduling, monitoring runs, ways of exporting data, proxies, and integrations can all add value to your Actor (on top of its own functionalities). Be sure to factor this into your tool's value proposition and communicate that to the potential user. ### Do research in Apify Store @@ -126,7 +126,7 @@ Learn more about what makes a good readme here: [How to create an Actor README]( ### Rental, pay-per-result (PPR), or pay-per-event (PPE) -Rental pricing is technically easier: you set the rental fee, and the user covers their CU usage. So all you have to define is how much you want to charge the users. With pay-per-result, you’ll need to include both CU usage and your margin. So you have to calculate how much the average run is going to cost for the user + define how much you want to charge them. +Rental pricing is technically easier: you set the rental fee, and the user covers their CU usage. All you have to define is how much you want to charge the users. With pay-per-result, you’ll need to include both CU usage and your margin. You have to calculate how much the average run is going to cost for the user + define how much you want to charge them. To figure out the average cost per run for users, just run a few test runs and look at the statistics in the Actor [**Analytics**](https://console.apify.com/actors?tab=analytics) tab.