Outlines what data is currently used by the bubbles

bubbles-data.md

From Myft API follows data

Returns array of concepts:

[
    {
        conceptId,
        conceptName
    },
    ...
]

conceptId

• used build the stream page URL here

conceptName

• used to render the bubble label https://github.com/Financial-Times/ft-app/blob/master/lib/components/myft/bubble/index.js#L61
• used to render the placeholder bubble when the topic has no stories https://github.com/Financial-Times/ft-app/blob/master/lib/components/myft/bubble/index.js#L14

From Personalised Feed data

Returns array of concepts, each containing article/teaser data:

[
    {
        id,
        items: [
            {
                id,
                teaser: {
                    publishedDate,
                    image: { url },
                    metaLink: { id }
                }
            },
            ...
        ]
    },
    ...
]

id Concept ID

• used build the stream page URL here

items[] List of articles published for a topic

• [tracking] length of this array used to determine if a stale topic was clicked on https://github.com/Financial-Times/ft-app/blob/cd2ad0c0fc7ff414dc5a270b9f2bd6eb7d3b1aeb/lib/components/page/slots/myft/helpers.js#L46

items[].id Article ID

• [tracking] trigger an event if the stream page is not up to date. About 10% of bubble clicks are to out of date stream pages, however I think the deduping might be affecting this.

items[].teaser.publishedDate Article published date

• used to determine if the purple dot should be put on the bubble https://github.com/Financial-Times/ft-app/blob/master/lib/components/page/slots/myft/helpers.js#L57
• used to sort the bubbles https://github.com/Financial-Times/ft-app/blob/master/lib/components/page/slots/myft/helpers.js#L99
• [tracking] used to work out how out of date a stream page was. These durations seem very high, possibly the deduping has affected this too.

items[].teaser.image.url Article image

• used as the url for the bubble
• [tracking] used to determine how many duplicate images there are shown to a user https://github.com/Financial-Times/ft-app/blob/master/lib/components/page/slots/myft/helpers.js#L148
• [tracking] used to determine if a bubble click was a duplicate https://github.com/Financial-Times/ft-app/blob/master/lib/components/page/slots/myft/helpers.js#L92

items[].teaser.metaLink.id

• [tracking] used to track if the bubble being clicked on was a display topic