Appearance
<div style="display: none;" hidden="true" aria-hidden="true">Are you an LLM? You can read better optimized documentation at /guides/GoogleRecommendationsAi.md for this page in Markdown format</div>
Google Recommendations AI
Options in registry
Global
- global enabled - controls all recommendation actions (enable disable)
- api key - api key
- project - project id for recommendations
- catalog - catalog for recommendations
- event store - event store for recommendations
Home Page & Product Page
- placement id - placement for recommendation call
- event type - currently we support home-page-view and detail-page-view (detail-page-view needs product id)
- status - enumeration for disabled, only tracked users, all
Notes on
Global enabled setting would be set to enabled even without placements in order to train google recommendation models.
Status has 3 options because google recommendation can accept a request without a user id, but produces warnings in google console.
Also, as a client requirement, even if we don't have a ga user id yet, some recommendations are relevant. Home page requests are too generic for not supplying a user, whereas product page requests give relevant products.
Developer Notes
Set up
Marketing should set up google recommendations AI and settings in our backend
Views
We provide 2 generic sliders for recommendations (home page and product page) in main and default template. Style and position should be checked.
Code
This is still v1beta so we can expect some changes in api.
There is a better library for google recommendations that should be used (check Google Cloud Recommendations AI for PHP) but it needs a Service Account for authorization instead of api key token that was provided. Current github issue