diff --git a/docs/ad-placements/_category_.json b/docs/ad-placements/_category_.json index 264419ee..7493b2ba 100644 --- 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 index 9cb86bd2..4d04f76f 100644 --- 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 index d656a069..682b584e 100644 --- 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 index d7845c22..1a936199 100644 --- 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 index 52b201b2..ddd848e1 100644 --- 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 index a1a7f910..0c095239 100644 --- 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 index 1fecab86..a1170a61 100644 --- 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 index c1998c5e..eb95172a 100644 --- 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 index e5806816..17f863ea 100644 --- 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 index 2578b4ec..94355808 100644 --- 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 index 55bf3fd7..33468091 100644 --- 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 index ad73f1c3..86bd340a 100644 --- 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/)