docs: PPE+U pricing model for creators by VojtaKai · Pull Request #2235 · apify/apify-docs

VojtaKai · 2026-02-10T13:57:25Z

Developer facing documentation for PPE+U

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.

^{Written by Cursor Bugbot for commit e48241f. Configure here.}

apify-service-account · 2026-02-10T14:01:03Z

Preview for this PR was built for commit e48241f and is ready at https://pr-2235.preview.docs.apify.com!

apify-service-account · 2026-02-10T14:21:32Z

Preview for this PR was built for commit 9890891 and is ready at https://pr-2235.preview.docs.apify.com!

TC-MO

Some changes requested:

Cleaned up the language for conciseness and directness
Used bold instead of backticks for UI elements (Pay per event + usage -> Pay per event + usage) per style guide
Replaced "clicking" and "toggle button" - per Microsoft style guide, use "turn on/turn off" for toggles, and "toggle button" is redundant
Made caution admonition text more specific ("This pricing model" -> "Charging platform usage separately")

TC-MO · 2026-02-10T23:46:54Z

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

Suggested change

If you have difficulty estimating event prices and want to avoid negative profit margins, pass the platform usage costs directly to your users. With this option enabled, users pay for both the defined events and the underlying platform usage.

If you cannot accurately estimate event prices upfront and want to avoid negative profit margins, you can pass the platform usage costs directly to users. Users then pay both the defined events and the underlying platform usage.

TC-MO · 2026-02-10T23:47:10Z

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

Suggested change

:::caution Less transparent pricing

:::caution Reduced pricing transparency

TC-MO · 2026-02-10T23:47:40Z

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

Suggested change

This pricing model is less transparent for users. Disable this option once you determine accurate event pricing.

Charging platform usage separately is less transparent for users. Turn off this option once you determine accurate event pricing.

TC-MO · 2026-02-10T23:47:58Z

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

Suggested change

Enable this option by clicking the `Pay per event + usage` toggle button.

Turn on the **Pay per event + usage** toggle to enable this option.

TC-MO · 2026-02-10T23:57:07Z

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

Suggested change

To disable this option, change your pricing model to include accurate event costs and switch off the toggle button.

To stop passing platform usage to users, update your pricing model and turn off the **Pay per event + usage** toggle.

apify-service-account · 2026-02-11T12:19:36Z

Preview for this PR was built for commit 63d713a3 and is ready at https://pr-2235.preview.docs.apify.com!

apify-service-account · 2026-02-11T12:25:26Z

Preview for this PR was built for commit c0da9a0a and is ready at https://pr-2235.preview.docs.apify.com!

marcel-rbro · 2026-02-12T07:45:44Z

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

Suggested change

Optionally, you can pass costs associated with the platform usage to the users. [Learn more](../../../platform/actors/publishing/monetize/pay-per-event#pass-platform-usage-to-users)

You can optionally [pass platform usage costs to users](/platform/actors/publishing/monetize/pay-per-event#pass-platform-usage-to-users).

I will not apply this because it reiterates the title of the info message

My issue is mainly that the link is on [Learn more]. You can just move the link to "pass the costs":

Suggested change

Optionally, you can pass costs associated with the platform usage to the users. [Learn more](../../../platform/actors/publishing/monetize/pay-per-event#pass-platform-usage-to-users)

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.```

marcel-rbro · 2026-02-12T07:47:02Z

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

Suggested change

:::info Pass platform usage to users

:::info Pass platform usage costs to users

marcel-rbro · 2026-02-12T07:48:00Z

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

Extra blank line

Suggested change

marcel-rbro · 2026-02-12T07:48:38Z

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

I'd just keep this simple without formatiing.

Suggested change

_Profit calculation_: `profit = (0.8 * revenue)`

Profit calculation: `profit = (0.8 * revenue)`

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

apify-service-account · 2026-02-16T10:59:37Z

Preview for this PR was built for commit 2f9539aa and is ready at https://pr-2235.preview.docs.apify.com!

stetizu1 · 2026-02-16T13:37:09Z

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

It seems a bit too mild. User should not do this for "Actor Q score" but mainly for the pricing transparency.
Maybe something like

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**](I would add a link here, not everyone know what it is). Turn off this option once you determine accurate event pricing.

I really like this suggestion. I felt like something was missing, too. - may discourage them from using your Actor this is it.

stetizu1 · 2026-02-16T13:40:24Z

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

+## Pass platform usage to users
+
+If you cannot accurately estimate event prices upfront and want to avoid negative profit margins, you can pass the platform usage costs directly to users. Users then pay for both the defined events and the underlying platform usage.
+


I would add something like

This is useful during initial development or when testing pricing strategies, but should be temporary.

as introduction to warning below

stetizu1 · 2026-02-16T13:43:05Z

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

I don't like this sentence this much. Not sure what "update pricing model" here is.

I think Use the Pay per event + usage toggle to enable or disable this option in ... (pricing flow?... or something similar would be fine there.

The pricing model should have referred to the PPE+U because it charges users differently than regular PPE but maybe it's unnecessarily adding a new term which only brings confusion.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

apify-service-account · 2026-02-17T11:23:42Z

Preview for this PR was built for commit 1416420e and is ready at https://pr-2235.preview.docs.apify.com!

stetizu1

Thanks 👍 Looks good

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

apify-service-account · 2026-02-17T13:21:16Z

Preview for this PR was built for commit b02b1473 and is ready at https://pr-2235.preview.docs.apify.com!

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

apify-service-account · 2026-02-18T10:46:53Z

Preview for this PR was built for commit f4c2fd39 and is ready at https://pr-2235.preview.docs.apify.com!

marcel-rbro

👍

apify-service-account · 2026-02-18T10:50:38Z

Preview for this PR was built for commit be006b37 and is ready at https://pr-2235.preview.docs.apify.com!

PPE+U pricing model

e48241f

VojtaKai self-assigned this Feb 10, 2026

VojtaKai requested a review from TC-MO as a code owner February 10, 2026 13:57

VojtaKai requested a review from marcel-rbro February 10, 2026 13:57

github-actions bot added this to the 134th sprint - Cash & Community team milestone Feb 10, 2026

github-actions bot added the t-c&c Team covering store and finance matters. label Feb 10, 2026

VojtaKai requested a review from stetizu1 February 10, 2026 14:04

PPE_U disablement

9890891

TC-MO requested changes Feb 11, 2026

View reviewed changes

PPE+U mentioned, applied suggestions, AQ impact mentioned

63d713a

VojtaKai requested a review from honzajavorek as a code owner February 11, 2026 12:15

fixed linter bold sign

c0da9a0

VojtaKai requested a review from TC-MO February 11, 2026 12:23

marcel-rbro requested changes Feb 12, 2026

View reviewed changes

Apply review feedback on PPE+U profit calculation and formatting

2f9539a

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

VojtaKai requested a review from marcel-rbro February 16, 2026 10:57

stetizu1 requested review from mhamas and removed request for honzajavorek February 16, 2026 12:20

stetizu1 reviewed Feb 16, 2026

View reviewed changes

Add quality score impact and timing details for PPE+U option

1416420

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

VojtaKai requested a review from stetizu1 February 17, 2026 11:21

stetizu1 approved these changes Feb 17, 2026

View reviewed changes

Add PPE+U toggle timing and effect details

b02b147

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

TC-MO approved these changes Feb 17, 2026

View reviewed changes

VojtaKai and others added 2 commits February 18, 2026 11:41

Improve link text for platform usage cost documentation

f4c2fd3

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Merge branch 'master' into docs/ppe-plus-creator-facing

be006b3

marcel-rbro approved these changes Feb 18, 2026

View reviewed changes

marcel-rbro merged commit 48b5ee2 into master Feb 18, 2026
13 checks passed

marcel-rbro deleted the docs/ppe-plus-creator-facing branch February 18, 2026 10:50

	If you have difficulty estimating event prices and want to avoid negative profit margins, pass the platform usage costs directly to your users. With this option enabled, users pay for both the defined events and the underlying platform usage.
	If you cannot accurately estimate event prices upfront and want to avoid negative profit margins, you can pass the platform usage costs directly to users. Users then pay both the defined events and the underlying platform usage.

	:::caution Less transparent pricing
	:::caution Reduced pricing transparency

	This pricing model is less transparent for users. Disable this option once you determine accurate event pricing.
	Charging platform usage separately is less transparent for users. Turn off this option once you determine accurate event pricing.

	Enable this option by clicking the `Pay per event + usage` toggle button.
	Turn on the Pay per event + usage toggle to enable this option.

	To disable this option, change your pricing model to include accurate event costs and switch off the toggle button.
	To stop passing platform usage to users, update your pricing model and turn off the Pay per event + usage toggle.

	Optionally, you can pass costs associated with the platform usage to the users. [Learn more](../../../platform/actors/publishing/monetize/pay-per-event#pass-platform-usage-to-users)
	You can optionally [pass platform usage costs to users](/platform/actors/publishing/monetize/pay-per-event#pass-platform-usage-to-users).

	Optionally, you can pass costs associated with the platform usage to the users. [Learn more](../../../platform/actors/publishing/monetize/pay-per-event#pass-platform-usage-to-users)
	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.```

	:::info Pass platform usage to users
	:::info Pass platform usage costs to users

	_Profit calculation_: `profit = (0.8 * revenue)`
	Profit calculation: `profit = (0.8 * revenue)`

		## Pass platform usage to users

		If you cannot accurately estimate event prices upfront and want to avoid negative profit margins, you can pass the platform usage costs directly to users. Users then pay for both the defined events and the underlying platform usage.

Conversation

VojtaKai commented Feb 10, 2026 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apify-service-account commented Feb 10, 2026

Uh oh!

apify-service-account commented Feb 10, 2026

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Feb 11, 2026

Uh oh!

apify-service-account commented Feb 11, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Feb 16, 2026

Uh oh!

stetizu1 Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Feb 17, 2026

Uh oh!

stetizu1 left a comment

Choose a reason for hiding this comment

Uh oh!

apify-service-account commented Feb 17, 2026

Uh oh!

apify-service-account commented Feb 18, 2026

Uh oh!

marcel-rbro left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

apify-service-account commented Feb 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

VojtaKai commented Feb 10, 2026 •

edited by cursor bot

Loading

stetizu1 Feb 16, 2026 •

edited

Loading