When you create a new article, the following two metadata items are required:
title
description
Title and description metadata are what Google and other search engines use to display content on the search engine results page (SERP). The title
metadata is not displayed on the article page; instead, the first heading (# <Title>
) is used.
Examples:
---
title: How to Use decryptPassword in Adobe Analytics
description: Decrypt a password stored in an external account with the decryptPassword function. Learn how to call in JSSP or SOAP call implementations with Adobe API.
---
Continue reading for important guidelines on title
and description
.
This metadata is required for articles. In each article, specify a title in both metadata (title:
) and as a heading (# <Head1>
), or page title. The title metadata is used for search results, the breadcrumb, and browser tabs. The page title heading is used for page display. These titles should correspond to one another (when not identical) because readers can see the breadcrumb and the page title at the same time.
Regarding the pipe (|) and Adobe + product name: The system automatically appends this to the title metadata when generating HTML output, so do not add it manually. For example, the metadata title Create an Activity displays as Create an Activity | Adobe Target in Google. Given that the maximum length is 60 characters (English), make sure that you consider the pipe and product name when determining your title name length in this field.
Examples of how you might use a title
and description
metadata, along with an article title:
---
title: What is Cohort Analysis and How Does it Work?
description: Dig deeper into the data around your audience and break into related groups with Cohort Analysis in Adobe Analytics.
---
# Overview of Cohort Analysis in Adobe Analytics
Important editorial guidelines for title
metadata
Capitalization: Use title case for title
, and sentence case for article (page) title.
60 characters is the maximum length for title
(English). 120 characters maximum for localization, including spaces and the pipe/product name (see the important note above). A useful tool for counting characters is the Google SERP snippet optimization tool.
The system appends | Adobe nameofproduct
when creating title
metadata for output. (See the important note above). Because of this, do not include the product name in your meta title unless it’s necessary to understand the meaning of the title.
The title
metadata will rarely match the article title heading (# Title
) word-for-word. Meaning, optimize the meta title
for SEO. Optimize the article title for reading when in the context of the help guide. For example:
Overview, by itself, isn’t useful as a metadata or article title…
Use keywords. Your most important keywords should be closer to the beginning of the title (for both the meta title and article title). The primary keywords are the feature name or article’s subject, and words people type when searching. For example:
Required for articles. Description is used by search engines and displays under the title
metadata on a search engine results page.
Maximum length is 160 characters. Ideally, the size is around 150-160 characters, but anything over 60 is acceptable. The goal is to use as much as the description as possible to target keywords for Google to rank the page higher.
If you need to shorten or otherwise edit the description of an article that’s linked to on a landing page, use landing-page-description
. Otherwise, the description
value is used in landing page links to articles.
Editorial guidelines for description
metadata
description:
Sign in to Adobe Analytics to start configuring and accessing reports, add users, and more. Follow these steps for a successful Adobe Analytics sign-in.description:
Decrypt a password stored in an external account with the decryptPassword function. Learn how to call in JSSP or SOAP call implementations with Adobe Analytics.Learn how to use Adobe xx
might be something users type rather than simply Overview of Adobe xx
.Some examples of effective descriptions:
description:
Dig deeper into the data around your audience and break into related groups with Cohort Analysis. Learn about Cohort Analysis with Adobe Analytics.description:
Learn how to use Data Warehouse in Analytics to get custom reports. Transform raw data into insights that reveal patterns. Get started with Adobe Analytics.