Skip to content

docs: Update best practices for PPE Actors and mention negative profit#2770

Open
szaganek wants to merge 6 commits into
masterfrom
ppe-best-practices
Open

docs: Update best practices for PPE Actors and mention negative profit#2770
szaganek wants to merge 6 commits into
masterfrom
ppe-best-practices

Conversation

@szaganek

@szaganek szaganek commented Jul 15, 2026

Copy link
Copy Markdown
Contributor
  • Adds a section on events
  • Adds a section on graceful abort
  • Adds a section on avoiding negative profit
  • Extends the section on respecting user limits
  • Removes fluff and repeated info

Preview: https://pr-2770.preview.docs.apify.com/actors/publishing/monetize/pay-per-event

Closes #2634.

@szaganek
szaganek requested review from a team, TC-MO, lisvrijsen and stetizu1 July 15, 2026 10:09
@szaganek szaganek self-assigned this Jul 15, 2026
@szaganek szaganek added documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team. labels Jul 15, 2026
@apify-service-account

apify-service-account commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

✅ Preview for this PR (commit ef50ce62) is ready at https://pr-2770.preview.docs.apify.com (see action run).

@lisvrijsen lisvrijsen left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks and reads really good. Huge improvement!

What do you think about explicitly stating that the developer should test their Actor with an invalid input? Just charging for an invalid input doesn't necessarily cover the entire platform cost. If the Actor takes 10 min to handle the invalid input, and it charges for 1 event only, then the cost is still a lot higher.

@stetizu1 stetizu1 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry I did not say which comments are actually important and which are nits (the most important are the ones that I see something factual is confusing)

  • and in some you do have the information that I was missing, it is just more down the document. In these cases, maybe add a link. Thanks.

- AI/MCP compatibility
- Predictable user costs
- Store discounts
- Standard 20% commission

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure if this is actually the benefit, but I see it was presented like that 😅

Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx Outdated
Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx Outdated
Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx Outdated
Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx Outdated
Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx
Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx Outdated
Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx
Limit the number of events. Fewer events make it easier for users to understand your pricing and predict the costs.

For Actors that produce data, events should map to something concrete in the user's dataset or storage.
Avoid cases where producing a single result triggers too many events. It makes your Actor more expensive.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, this goes against our google maps scraper 😅 Do we want to present this? It seems like common knowledge.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't underestimate people 🥲

Comment thread sources/platform/actors/publishing/monetize/pay_per_event.mdx Outdated
@szaganek
szaganek requested a review from stetizu1 July 20, 2026 07:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify how to deal with negative profit

5 participants