Introduction
Share Of Model Scoring connects the creative library in Pencil Pro with the Share of Model™ platform. It helps you streamline the creative evaluation workflow by automatically requesting Share of Model (SoM) Asset Evaluation Scores directly from Pencil.
This powerful integration simplifies the scoring process and provides seamless insights without leaving your Pencil workspace.
Learn more about the features and benefits here:
What is Share Of Model Scoring in Pencil Pro?
How to Configure Share of Model - Step by Step:
Step 1: Request the Share Of Model API Token
Before activating the integration, a Share Of Model API token must be generated.
Confirm that the client has an active SoM workspace
Request the API token from the dedicated Customer Success Manager (CSM) or use the Slack channel
#ask-usif unsure who to contactThis token identifies the workspace, tracks analysis usage, and stores the results
Step 2: Connect Share of Model to Pencil
Go to Settings > Scores in Pencil
Under Share of Model, click Connect
Paste the API token
Select the matching Organization and Workspace
Confirm to activate the integration
Step 3 – Launch a Share Of Model Scoring Request
From the Pencil creative library:
Select a creative to evaluate (image, video, or text-based)
Click Request Share Of Model Score
A form appears with the following fields:
Brand name
Category (e.g. “Luxury skincare”)
Attributes: Select 3 to 6 (e.g. “Trust”, “Expertise”, “Innovation”)
(Optional) Persona (e.g. “Eco-conscious 40-year-old female”)
Step 4 – View the Score in Pencil
Once processed, a summary score appears in Pencil
Includes breakdowns on:
Attribute alignment
Visual and textual representation
Suggestions for improvement
Step 5 (optional) – Access the Full Report in SoM
A full analysis entry is created in the connected SoM workspace
Open the workspace in SoM to explore full dashboards with LLM scoring, visual heatmaps, and perception charts
Step 6 (optional) – Manage Share Of Model Credit
Each scoring request deducts 1 analysis credit from the workspace quota
Credit usage is visible within the client's workspace in SoM
If needed, additional credits can be requested via the assigned CSM
Common Issues & Troubleshooting
Issue | Description | Solution |
How to get a SOM token? | The SoM token is required to enable the integration. | Contact the CSM or use the Slack |
Client doesn’t seem to have a workspace in SOM | Scoring requires an existing SoM workspace.Each scoring request deducts credit from the SoM workspace quota | Confirm with the CSM. Workspace setup is mandatory before using this feature. |
“Request Score” button is disabled | SOM token has not been added to the settings in Pencil | Verify the settings rules. |
SOM Score not returned | The scoring is still processing in the background. | Refresh after 1–2 minutes. |
Message "Quota reached" | The SOM workspace has no remaining credits. | Contact the CSM to top up quota. |
Invalid API token | The token may be expired, copied incorrectly, or for the wrong workspace. | Generate a new token with support from SoM CSM. |
More detailed information on Share of Model can also be found at the Share of Model help center.