Skip to content

Commit 9a35701

Browse files
docs: main event mentioned in docs (#2253)
PR makes sure primary event is mentioned in docs <!-- CURSOR_SUMMARY --> --- > [!NOTE] > **Low Risk** > Documentation-only changes with no impact on runtime behavior; main risk is minor user confusion if the policy details are inaccurate. > > **Overview** > Updates the monetization setup steps to explicitly include defining pay-per-event (PPE) chargeable events and selecting a **primary event** that is highlighted on the Actor detail page. > > Reworks the “Changing monetization” section to clarify that some updates apply immediately, while *significant* changes (price increases, adding paid PPE events, or switching pricing model) require a 14-day notice period and are limited to once per month. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 2b594d9. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup> <!-- /CURSOR_SUMMARY -->
1 parent b4c6bed commit 9a35701

2 files changed

Lines changed: 14 additions & 2 deletions

File tree

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

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -104,11 +104,22 @@ If you want more details about rental pricing, refer to our [rental pricing docu
104104

105105
1. _Go to your Actor page_: navigate to the **Publication** tab and open the **Monetization** section.
106106
2. _Fill in billing details_: set up your payment details for payouts.
107-
3. _Choose your pricing model_: use the monetization wizard to select your model and set fees.
107+
3. _Choose your pricing model_: use the monetization wizard to select your model.
108+
4. _Define chargeable events (PPE)_: select the events users pay for (for example, per result, per API call, or per Actor start), then set clear names, descriptions, and prices.
109+
5. _Choose a primary event (PPE)_: select the event that best represents the main value of your Actor. This primary event is emphasized on the Actor detail page, so users can quickly understand what they are mainly paying for.
110+
108111

109112
### Changing monetization
110113

111-
Adjustments to monetization settings take 14 days to take effect and can be made once per month.
114+
Some monetization updates are applied immediately. However, significant pricing changes require a 14-day notice period.
115+
116+
Significant changes include:
117+
118+
- Increasing prices
119+
- Adding a new paid pricing event (PPE)
120+
- Changing the pricing model
121+
122+
You can make these significant changes only once per month.
112123

113124
### Tracking and promotion
114125

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ An Actor's negative net profit does not affect the positive profit of another Ac
5050

5151
1. _Understand your costs_: Analyze resource usage (e.g CPU, memory, proxies, external APIs) and identify cost drivers
5252
1. _Define clear events_: break your Actor's functionality into measurable, chargeable events.
53+
1. _Choose a primary event_: Pick the event that best represents the main value of your Actor. This primary event is highlighted on the Actor detail page, so users quickly understand what they are mainly paying for.
5354
1. _Common use cases_:
5455
1. _For scraping_: combine Actor start and dataset items pricing to reflect setup and per-result cost.
5556
1. _Beyond scraping_: Account for integrations with external systems or external API calls.

0 commit comments

Comments
 (0)