We often return spocs from the same branch but with slightly different titles or images to test which of these performs best. We generally don't want multiple spocs from the same brand to show up on the same new-tab page.

• The API will send an integer spocs.spocs_per_brand.
• Brands can be identified by the domain field in the Spoc.
• The client should limit the number of spocs from the same domain per new-tab to spocs_per_brand.

:mathijs, what do you think about calling it spocs_per_domain to clarify the behavior? Also, we will be using the domain field from the JSON response and not the domain (host) of the link provided for the SPOC, right?

I'll use spocs_per_domain. I updated my description to clarify we will use the domain field in the spoc.

Nick, let's talk about this during the work week and decide on course of action for deduping spocs

I have a question that came up while doing this.

Which spoc should I take if I have two in a list. The first one, or the one with the highest item_score?

In the case of first one, that feels wrong because the second one would never get seen.

For item_score, I'm not sure what they means in the cases where we don't have these personalized.

Maybe this and personalization are strongly tied together.

Thoughts?

https://hg.mozilla.org/mozilla-central/rev/3d9f5f3d386b