Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: formatting across several pages #13

Merged
merged 15 commits into from
Nov 21, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/ad-placements/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Ad Placements",
"label": "Ad placements",
"position": 2
}
6 changes: 3 additions & 3 deletions docs/ad-placements/brave-browser/news.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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
Expand All @@ -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)
Expand Down
6 changes: 3 additions & 3 deletions docs/ad-placements/brave-browser/notification.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/ad-placements/brave-search/keyword.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 1 addition & 1 deletion docs/campaign-performance/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Campaign Performance",
"label": "Campaign performance",
"position": 4
}
26 changes: 13 additions & 13 deletions docs/campaign-performance/reporting.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.
Expand All @@ -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/).
Expand All @@ -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.

Expand All @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion docs/campaign-performance/targeting.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/_category_.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Getting Started",
"label": "Getting started",
"position": 3
}
2 changes: 1 addition & 1 deletion docs/getting-started/create-an-ad-set.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/create-an-ad.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/launch-your-campaign.md
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 1 addition & 1 deletion docs/policies.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
sidebar_position: 6
---

# Policies and Restrictions
# Policies and restrictions
## Policies

- [Advertiser privacy policy](https://brave.com/privacy/advertiser/)
Expand Down