Follow-ups from PPE docs refactor

[patrikbraborec]

simplicity <-> profit scaling: #1875 (comment)

As I mentioned that generally devs have to decide where on the scale of simplicity <-> profit scaling they want to sit.

We could illustrate it here by adding a competing example where the ai-analysis would be instead ai-analysis-$0.01 (or $0.001) (and better name :) ) and it would charge one event per cent that is spent on the LLM. This way we already do it in some places like our OpenRouter.

This would clearly ilustrate the trade-off that it is harder for user to predict but safer for dev to scale. I don't think we should prescribe one way or another.

• How to do it correctly? Add another example?

---

PPE vs PPR: #1875 (comment)

We should definitely have a section to encourage PPE vs PPR. The main thing is that PPR cannot charge for actor-start so it leads to more potential of profit-breaking 0 result runs.

• Where we should put it?

---

Legacy tag: #1875 (comment)

If we are saying here that something is to become Legacy I would expect a proper timeline. If we don't know the timeline yet I would remove mentiong of making it legacy and focus on this model being not compatibile with AI/MCP. The way it is framed right not I expect that it becoming legacy is somewhere in the future, not now.

• Let's add it with better message, and timeline.

[TC-MO]

I've seen the admonition for rental pricing model was deleted completely. I think it was good effort just wrong wording, might be good idea to work on it separately from the docs change NVM, I can't read -.- 🤦‍♂️

[metalwarrior665]

simplicity <-> profit scaling How to do it correctly? Add another example?

Yeah I would add another competing example for this event below and explain pros n cons

PPE vs PPR Where we should put it?

I would put it at start of PPR doc so they switch to PPE right away. WE should be getting relatively close to being able to migrate all PPR to PPE anyway.

[patrikbraborec]

Another topic:

• Improve synthetic start docs based on comments from @mnmkng: docs: Add synthetic start event #1915.

[patrikbraborec]

From @jirispilka:

• https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event#event-names - "To implement PPE pricing, you need to define specific events in your Actor code". Well this is at the end of the document. Too late to explain that I need to define specific events in the code

• https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event#charge-for-invalid-input the JS/Python code does not have Actor.charge at all
  10:25

• The explanation of PPE is great but the computations are super hard to read: https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event#example-of-a-ppe-pricing-model