Field mappingWeb data source
Data source metadata tags and other content values map to Springboard fields.
Springboard ingests field values in the order of preference specified. If the first preference is available, Springboard will ingest it and ignore the others. If the first preference is unavailable, Springboard attempts to ingest the second value, and so on.
Web page fields
UI field | API field | Source |
---|---|---|
Title |
|
This value is ingested in the following order of preference:
|
Description |
|
This value is ingested in the following order of preference:
If no value exists for the fields above, a description is not included in search results for that page. |
URL |
|
Canonical URLs must be unique for each page. |
Excerpt |
|
This value is ingested in the following order of preference:
|
Data model type |
|
Content-Type HTTP header |
Language code |
|
This value is ingested in the following order of preference:
|
Thumbnail image |
|
If a value is declared, the thumbnail image displays in the Experience Optimizer’s searchahead and results. If this image does not load, Springboard loads a fallback image. |
Timestamp |
|
Last-Modified HTTP header |
Timestamp |
|
This value is ingested in the following order of preference:
|
File fields
File types include spreadsheets, PDF files, slide decks, and Word documents.
UI field | API field | Source |
---|---|---|
Title |
|
This value is ingested in the following order of preference:
|
URL |
|
Maps to the location of the file. |
Excerpt |
|
Maps to the text of file. |
Data model type |
|
Determined using extension type. For example, |
Language code |
|
This value is ingested in the following order of preference:
|
Timestamp |
|
Last-Modified HTTP header |
Timestamp |
|
This value is ingested in the following order of preference:
|
File extension processing
If a file extension exists in the URL, results display that value in the response. If the field cannot be parsed from the URL, the HTTP header Content-Type
MIME type is used to determine file.extension
based on the mapping in the table in this section. If file.extension
cannot be determined with either of these methods, the value is empty and it is not displayed in the response.
Older Microsoft Office MIME types are ambiguous, so the file.extension assigned during ingestion may differ from the original value. For example, original templates with .dot extensions use the application/msword MIME type and are ingested into Springboard with the .doc value.
|
MIME type | File extension |
---|---|
application/msword |
|
application/vnd.openxmlformats-officedocument.wordprocessingml.document |
|
application/vnd.ms-excel |
|
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
|
application/vnd.ms-powerpoint |
|
application/vnd.openxmlformats-officedocument.presentationml.presentation |
|
application/pdf |
|