fix: formatting across several pages (#13)

* updates notification.md * update news.md * updates casing in chart targeting.md * updates reporting.md formatting/casing * update reporting.md query string example formatting * update _category_.json to sentence casing * update _category_.json to sentence casing * updates create-an-ad-set.md to sentence casing * update create-an-ad.md to sentence casing * updates launch-your-campaign.md to sentence casing * updates policies.md to sentence casing * update _category_.json to sentence casing * formatting on news.md * fixes formatting for notification.md * fixes formatting on keyword.md
brave · Nov 21, 2023 · d5bc6c2 · d5bc6c2
1 parent 0a4ddd2
commit d5bc6c2
Show file tree

Hide file tree

Showing 12 changed files with 29 additions and 29 deletions.
diff --git a/docs/ad-placements/_category_.json b/docs/ad-placements/_category_.json
@@ -1,4 +1,4 @@
 {
-  "label": "Ad Placements",
+  "label": "Ad placements",
   "position": 2
 }
diff --git a/docs/ad-placements/brave-browser/news.md b/docs/ad-placements/brave-browser/news.md
@@ -2,7 +2,7 @@
 sidebar_position: 2
 ---
 
-# Newsfeed Ads
+# Newsfeed ads
 
 Brave News is a private, customizable news feed that appears in every new tab page of the Brave browser. Advertisers can insert paid native display placements that appear similar to the images and snippets shown in the news feed.
 
@@ -21,7 +21,7 @@ Brave News is a private, customizable news feed that appears in every new tab pa
   - MacOS, Windows, Linux, Android, iOS
 - By country
 
-***Note**: currently available only to browsers with English and Japanese language settings.
+**Note**: currently available only to browsers with English and Japanese language settings.
 
 ### Pricing
 - CPM
@@ -30,7 +30,7 @@ Brave News is a private, customizable news feed that appears in every new tab pa
 ### Best practices
 - Use multiple versions of ad creative for testing
 - Use engaging imagery such as products, or demonstrative illustrations
-- Use a specific call to action: “Learn More,” “Try Now,” “Buy Now,” “Sign Up,” etc.
+- Use a specific call to action: _Learn More, Try Now, Buy Now, Sign Up, etc._
 - Limit text in images, some text is fine
 - No clickbait headlines
 - No claims of high returns on investments (APY/APR)

diff --git a/docs/ad-placements/brave-browser/notification.md b/docs/ad-placements/brave-browser/notification.md
@@ -2,7 +2,7 @@
 sidebar_position: 3
 ---
 
-# Notification Ads
+# Notification ads
 
 Notification ads feature a title and short CTA; clicks drive users to the advertiser’s desired landing page. Ads are served over content at the browser level, not on web pages, within videos, or any of the more obtrusive practices of traditional display ads.
 
@@ -29,10 +29,10 @@ This unit is an ideal addition for advertisers looking to add engagement, qualit
 - CPSV (Per site-visit)
 
 ### Best practices
-- Add context to your title for clarity, e.g.“Masterclass. Learn from the best."
+- Add context to your title for clarity, e.g. _Masterclass. Learn from the best._
 - Use unique landing pages such as “advertiser.com/brave” to make measurement easier
 - Use multiple versions of ad creative for testing
-- Use a specific call to action: “Learn More,” “Try Now,” “Buy Now,” “Sign Up,” etc.
+- Use a specific call to action: _Learn More, Try Now, Buy Now, Sign Up, etc._
 - Use emojis to help tell your brand’s story with fewer characters
 - Vary copy to appeal to different audiences or product features
 - Share wisdom, Brave users love to learn

diff --git a/docs/ad-placements/brave-search/keyword.md b/docs/ad-placements/brave-search/keyword.md
@@ -21,10 +21,10 @@ Search keyword ads are similar to the text and url-based ads shown on search eng
 - CPC
 
 ### Best practices
-- Add context to your headline for clarity, e.g.“Masterclass. Learn from the best."
+- Add context to your headline for clarity, e.g. _Masterclass. Learn from the best._
 - Use unique landing pages such as “advertiser.com/brave” to make measurement easier
 - Use multiple versions of ad creative for testing
-- Use a specific call to action: “Learn More,” “Try Now,” “Buy Now,” “Sign Up,” etc.
+- Use a specific call to action: _Learn More, Try Now, Buy Now, Sign Up, etc._
 - Vary copy to appeal to different audiences or product features
 - No clickbait headlines
 - No claims of high returns on investments (APY/APR)

diff --git a/docs/campaign-performance/_category_.json b/docs/campaign-performance/_category_.json
@@ -1,4 +1,4 @@
 {
-  "label": "Campaign Performance",
+  "label": "Campaign performance",
   "position": 4
 }
diff --git a/docs/campaign-performance/reporting.md b/docs/campaign-performance/reporting.md
@@ -17,13 +17,13 @@ Blocked scripts will disable most, if not all, functions for third-party trackin
 Whether your campaign is purchased via Managed Service or Self-Service, all advertisers will have access to the Brave Ads reporting dashboard to report on the performance of campaigns. Campaign dashboards update hourly with the option to export reporting for Notification and Newsfeed ad campaigns on demand.
 
 ### Available reporting metrics in Brave Ads Manager
-| Metric            | Description                                                                                     | Search Keyword Ads | New Tab Takeover | Newsfeed Ads | Notification Ads |
+| Metric            | Description                                                                                     | Search keyword ads | New tab takeover | Newsfeed ads | Notification ads |
 |-------------------|-------------------------------------------------------------------------------------------------|--------------------|------------------|--------------|------------------|
 | Impressions       | Counted when an ad is displayed on screen for a minimum of one second.                          | X                  | X                | X            | X                |  
 | Clicks            | Counted when a user clicks on the ad. Does not include clicks to dismiss.                       | X                  | X                | X            | X                |
 | Dismissed         | Counted when a user clicks the “close” or “x” button to make an ad go away.                     |                    |                  | X            | X                |
-| 10-Second Visit   | Counted when a user spends at least ten seconds with the landing page in view in their browser. | X                  | X                | X            | X                |
-| Upvote & Downvote | Counted when a user either upvotes or downvotes an ad in their ad history.                      |                    |                  |              | X                |  
+| 10-Second visit   | Counted when a user spends at least ten seconds with the landing page in view in their browser. | X                  |                  | X            | X                |
+| Upvote & downvote | Counted when a user either upvotes or downvotes an ad in their ad history.                      |                    |                  |              | X                |  
 | Conversion        | Counted when a user reaches a designated conversion landing page.                               | X                  |                  | X            | X                |
 
 ### Conversion reporting in Brave Ads Manager
@@ -44,20 +44,20 @@ A referral or promo code (e.g. brave15) can be used at the time of checkout to r
 Click URL tracking parameters are allowed, but only when used in a way that your web server or web application can detect. Using third-party reporting such as Google Analytics will not show accurate data. Please note, only direct URLs are allowed for the click link—no redirects.
 
 ##### Clickthrough URL (UTM parameters)
-- Example: ``[https://example.com/product?utm_source=brave&utm_medium=push_notification&utm_campaign=test](https://example.com/product?utm_source=brave&utm_medium=push_notification&utm_campaign=test)``
-- Landing page:``[https://example.com/product](https://example.com/product)``
+- Example: ``https://example.com/product?utm_source=brave&utm_medium=push_notification&utm_campaign=test``
+- Landing page:``https://example.com/product``
 - Query string parameters (UTM): ``utm_source=brave&utm_medium=push_notification&utm_campaign=test``
 
 ##### Clickthrough URL (query string parameters)
-- Example: ``[https://example.com/product?ref=brave&type=push_notification&campaign=test](https://example.com/product?ref=brave&type=push_notification&campaign=test)``
-- Landing page: ``[https://example.com/product](https://example.com/product)``
+- Example: ``https://example.com/product?ref=brave&type=push_notification&campaign=test``
+- Landing page: ``https://example.com/product``
 - Query string parameters: ``ref=brave&type=push_notification&campaign=test``
 
 Parse values and set first-party cookies based on the query string parameters from the clickthrough URL. This entire query string can be set as the value or parsed into individual key value pairs.
 When the same user lands from a different channel, your same code snippet can append or overwrite the cookie values with the new parameter values depending on your preference.
 When the user completes the expected action and a network request is made back to your servers, the cookies should be attached to the request headers and you can see that a user has come from a Brave Ads campaign.
 
-### Verifiable Ad Conversions (VAC)
+## Verifiable Ad Conversions (VAC)
 Verifiable Ad Conversions (VAC) is an optional feature-set of Brave Ads Conversion Reporting. VAC provides Brave advertisers with the ability to determine their return on ad spend by privately reporting encrypted Conversion IDs. Advertisers can then audit the list of encrypted Conversion IDs to verify that the converted user can be attributed to a Brave Ads campaign.
 
 When an eligible user lands on the Conversion Page, a process is invoked that enables the advertiser to account for the specific transaction event, while maintaining user privacy and anonymity. Not even Brave can read or learn anything about that event (aside from the anonymously reported conversion event count). This enables privacy from end-to-end and allows users to feel better about their Conversion Event, knowing that no one can learn anything from the conversion.
@@ -66,10 +66,10 @@ Advertisers who choose to use VAC will generate a public-private key pair in the
 
 It’s crucial that the advertiser does not lose their private key for Verifiable Ad Conversions.
 
-##### Conversion Event ID details
+### Conversion event ID details
 Verifiable Ad Conversion Reporting is done by a Conversion ID. For your site, this may be an order number, a transaction ID, or something similar.
 
-##### Requirements:
+### Requirements:
 - The Conversion ID value must be unique for each conversion. Duplicate Conversion Event ID values will result in accounting discrepancies.
 - The Conversion ID must be between 1–30 characters long, contain only alphanumeric characters (as well as dashes), and match this regular expression: `` [-a-zA-Z0-9]{1,30}.``
 - Event values longer than 30 characters will fail, preventing the event from being accurately accounted for. You may check if your identifier is valid by using a site like [https://regex101.com/](https://regex101.com/).
@@ -87,10 +87,10 @@ Encrypted Conversion Envelopes will look like:
 }
 ```
 
-##### Implementation options
+### Implementation options
 Brave provides two implementation options for Verifiable Conversions using a URL pattern or DOM element pattern.
 
-**URL Pattern**
+#### URL Pattern
 
 An advertiser has a Conversion ID that is present as a query string parameter in the Conversion Page URL pattern. The advertiser must provide Brave with the query string key that identifies the Conversion ID.
 
@@ -101,7 +101,7 @@ When an eligible user lands on the Conversion Page URL, Brave will:
 
 Take, for example, the following Conversion Page URL: https://example.com/checkout?order=ABC-12345-xyz. Brave will look for the query string key order and encrypt the value ``ABC-12345-xyz``. 
 
-**DOM Element Pattern**
+#### DOM Element Pattern
 
 An advertiser has a Conversion ID that is present in the Document Object Model (DOM) of the Conversion Page URL.
 

diff --git a/docs/campaign-performance/targeting.md b/docs/campaign-performance/targeting.md
@@ -7,7 +7,7 @@ Brave has pioneered a new breed of privacy-respecting targeting that is matched
 
 Each of Brave’s ad units has a unique approach to achieve varying levels of ad relevance with the end user:
 
-| **Targeting**              | **Description**                                                                                                                                                   | **Search keyword ads** | N**ew Tab Takeover** | **Newsfeed Ads** | **Notification Ads** |
+| **Targeting**              | **Description**                                                                                                                                                   | **Search keyword ads** | **New tab takeover** | **Newsfeed ads** | **Notification ads** |
 |----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------|----------------------|------------------|----------------------|
 | **Keywords**               | Keywords entered into Brave Search.                                                                                                                               | X                      |                      |                  |                      |
 | **Country and state**      | Location determined by IP address. Only top level country and state level information is inferred (State level targeting is available only in the USA).           | X                      | X                    | X                | X                    |

diff --git a/docs/getting-started/_category_.json b/docs/getting-started/_category_.json
@@ -1,4 +1,4 @@
 {
-  "label": "Getting Started",
+  "label": "Getting started",
   "position": 3
 }
diff --git a/docs/getting-started/create-an-ad-set.md b/docs/getting-started/create-an-ad-set.md
@@ -2,7 +2,7 @@
 sidebar_position: 4
 ---
 
-# Create An Ad Set
+# Create an ad set
 
 After you’ve set basic parameters for your campaign, you’ll need to further define the targeting and delivery parameters of your ads. You can set up multiple ad sets within a campaign, for example, when you wish to target different ads to different device types or contextual segments. The ad set level is where you will set the following parameters:
 

diff --git a/docs/getting-started/create-an-ad.md b/docs/getting-started/create-an-ad.md
@@ -2,7 +2,7 @@
 sidebar_position: 3
 ---
 
-# Create an Ad
+# Create an ad
 There are two ways to create an ad in Brave Ads Manager:
 
 ## During campaign set up

diff --git a/docs/getting-started/launch-your-campaign.md b/docs/getting-started/launch-your-campaign.md
@@ -1,5 +1,5 @@
 ---
 sidebar_position: 5
 ---
-# Launch Your Campaign
+# Launch your campaign
 Once you’ve set campaign, ad set, and ad parameters, you’re ready to top up your account with a dollar balance and launch your campaign. Brave accepts USD and BAT. 
diff --git a/docs/policies.md b/docs/policies.md
@@ -2,7 +2,7 @@
 sidebar_position: 6
 ---
 
-# Policies and Restrictions
+# Policies and restrictions
 ## Policies
 
 - [Advertiser privacy policy](https://brave.com/privacy/advertiser/)