Skip to content

Commit 48b5ee2

Browse files
VojtaKaiclaudemarcel-rbro
authored
docs: PPE+U pricing model for creators (#2235)
Developer facing documentation for PPE+U <!-- CURSOR_SUMMARY --> --- > [!NOTE] > **Low Risk** > Documentation-only change; no runtime, API, or pricing logic is modified. > > **Overview** > Adds a new **"Pass platform usage to users"** section to the `pay_per_event.mdx` monetization docs, documenting the `Pay per event + usage` toggle that charges users for both PPE events and underlying platform usage. > > Includes a caution callout about reduced pricing transparency and an illustrative screenshot of the toggle UI. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit e48241f. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup> <!-- /CURSOR_SUMMARY --> --------- Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com> Co-authored-by: Marcel Rebro <marcel.rebro@apify.com>
1 parent 931fb52 commit 48b5ee2

3 files changed

Lines changed: 26 additions & 0 deletions

File tree

sources/academy/build-and-publish/apify-store-basics/how_actor_monetization_works.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,15 @@ Monetizing your Actor on the Apify platform involves several key steps:
2929

3030
- _How it works_: you charge users based on specific events triggered programmatically by your Actor's code. You earn 80% of the revenue minus platform usage costs.
3131
- - _Profit calculation_: `profit = (0.8 * revenue) - platform usage costs`
32+
33+
:::info Pass platform usage costs to users
34+
35+
Optionally, you can [pass costs associated with the platform usage](../../../platform/actors/publishing/monetize/pay-per-event#pass-platform-usage-to-users) to the users.
36+
37+
Profit calculation: `profit = 0.8 * revenue`
38+
39+
:::
40+
3241
- _Event cost example_: you set the following events for your Actor:
3342
- `Actor start per 1 GB of memory` at $0.005
3443
- `Pages scraped` at $0.002
193 KB
Loading

sources/platform/actors/publishing/monetize/pay_per_event.mdx

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,23 @@ An Actor's negative net profit does not affect the positive profit of another Ac
5757
1. _Test your pricing_: Run your Actor and analyze cost-effectiveness using a special dataset.
5858
1. _Communicate value_: Ensure pricing reflects the value provided and is competitive.
5959

60+
## Pass platform usage to users
61+
62+
During initial development or when testing pricing strategies, you can pass the platform usage costs directly to users to avoid negative profit margins. Users then pay for both the defined events and the underlying platform usage. Use this approach temporarily until you determine accurate event prices.
63+
64+
65+
:::caution Reduced pricing transparency
66+
67+
Charging platform usage separately is less transparent for users and may discourage them from using your Actor. This also negatively impacts your [**Actor quality score**](../quality-score). Turn off this option once you determine accurate event prices.
68+
69+
:::
70+
71+
Use the **Pay per event + usage** toggle to enable or disable this option in the monetization flow.
72+
73+
![Pay per event with usage toggle button](../images/pay_per_event_and_usage_toggle.png)
74+
75+
The option can be turned off at any time with immediate effect, as it is a positive change for the user. Turning it on will take 14 days.
76+
6077
## Respect user spending limits
6178

6279
Finish the Actor run once charging reaches user-configured maximum cost per run. Apify SDKs (JS and Python) return `ChargeResult` that helps determine when to finish.

0 commit comments

Comments
 (0)