> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allgoodhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prepare the Campaign Brief

## Overview

Campaign brief is a document that contains Campaign information to run a new Marketo Program. This includes Template
Program information to be cloned, new program name, and the folder name. Also, specify all the token information in the
program that Mary will automatically update within the program.

allGood will provide a sample template Campaign brief. But the format is not restricted to the sample as long as it
contains the necessary information.

# Supported Format

There are two formats supported.

* Upload MS Word docx(.docx)

* Google Docs

  * Via Direct link

  * Via download as **MS Word docx** and upload the file

  * Make sure your Google integration user is accessible with the doc by **anyone with the link** or **shared with the
    user**

<img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image3.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=97d8633c643712ce3bf0c6b8c354203f" alt="Google doc is shared publicly with the link" width="924" height="194" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image3.png" />

<img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image2.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=9778b7c5c7d975628c700469c56181ef" alt="Google doc is shared with Google integration user in allGood" width="898" height="210" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image2.png" />

* Check out more details for Google Setup [allGood - Google Setup Guide](../../integrations/google.mdx)

# Campaign Brief components

## Program Details

Program details must include:

* The name of the program to be cloned

* The name of the new program

* The name of folder you would like the new program to be cloned into

<Frame caption="Sample of Program Details">
  <img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image5.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=1a3d049af30257490594754cf6b7031f" alt="Image5" width="1720" height="476" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image5.png" />
</Frame>

## Email Content

List out all tokens in 2-column table format with their respective token names in Marketo.

* (optional) We recommend you split up the tokens into two categories:

  * Email Basics and Email Content

<Frame caption="Sample of Email Content">
  <img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image4.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=83aa6125f522700d48f0e87ec6112b4f" alt="Image4" width="2048" height="1795" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image4.png" />
</Frame>

## Content Formatting

Mary will pass any of the formatting of the content over to the email

* Don’t be shy when adding multiple types of formatting to one token

* As long as the token is a Rich Text token, Mary will be able to add the correct formatting

| Formatting        | Supported                 | Example                                                                                                                             |
| ----------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Bold              | Yes                       | **Bold text**                                                                                                                       |
| Italic            | Yes                       | *Italic text*                                                                                                                       |
| Link              | Yes                       | Click [here](https://allgoodhq.com) for more information                                                                            |
| List              | Yes (Bullet and Numbered) | - Bullet list 1 <br /> - Bullet list 2<br />- Bullet list 3<br />1. Numbered list 1<br />2. Numbered list 2<br />3. Numbered list 3 |
| Underline         | Yes                       | <u>Underlined text</u>                                                                                                              |
| Strikethrough     | Yes                       | ~~Strikethrough~~                                                                                                                   |
| Special Character | Yes                       | © ® ™                                                                                                                               |
| Indent            | Yes (Only 1-level indent) | Single indent works (~~Nested indent does not work~~)                                                                               |
| Alignment         | No \*                     | <center>Aligning center is not supported</center>                                                                                   |
| Line height       | No \*                     | Custom line-height is not supported                                                                                                 |
| Color             | No \*                     | This is not supported                                                                                                               |
| Highlight color   | No \*                     | This is <mark>not supported</mark>                                                                                                  |
| Font size         | No \*                     | This is not supported                                                                                                               |
| Font style        | No \*                     | This is not supported                                                                                                               |
| Emojis            | No \*                     | 😀 is not supported                                                                                                                 |

*Table: Supported Content formatting*

<Frame caption="Sample of Content Formatting">
  <img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image7.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=687d375ba49c4898f0f45672f72f61e8" alt="Image7" width="1294" height="440" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image7.png" />
</Frame>

> **Inline CSS Support**
>
> NOTE: While text styling such as font size, color, and alignment are not directly supported, you can still specify
> inline CSS in the content. For example, to change the font size, you can use
> `<span style="font-size: 20px;">Your Text Here</span>`.
>
> However, please note that not all email clients may render
> inline CSS consistently, so it's advisable to test the email across different clients to ensure the desired appearance.

If you are interested in formatting that is unsupported or not in the list above, please drop us a message, and we can
look into how Mary can learn new formatting skills.

## Handling Images

Images are supported with **Text** tokens and directly uploaded into your Marketo assets. Note that **The Image token is
not supported.**

### Token naming convention

To tell Mary to process image properly, make sure to have “**image-URL**” in the name of the tokens explicitly, for
example

* Header-image-URL

* Banner-image-URL

* Footer-image-URL

### Add images

There are two ways to fill out images in your token

* Add image URL

  * Make sure the image URL is publicly accessible

* Embed image

  * You can directly embed an image in the image URL

<Frame caption="Two ways of providing image URLs">
  <img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image10.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=963ddc784d543940f8fddc4346750bdd" alt="Image10" width="789" height="339" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image10.png" />
</Frame>

### Specify image dimensions

Mary will follow the image dimensions in the token and transform the image with the dimensions before uploading the
image.

<Frame caption="Specify image dimensions (300x200 px)">
  <img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image6.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=2a4d393bfe2421fdf95440ecc2dec692" alt="Image6" width="316" height="104" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image6.png" />
</Frame>

### Specify File name

By default, Mary uploads images in Marketo following this rule.

* Public URL is provided

  * If the image file name is on the URL, Mary will upload the image with the name.

    * For
      example - [https://cdn.prod.website-files.com/6537ecf8dd6837236ee1b763/671928c38a76da7c1f729de7\_8408aba1e79257bb7eeefff1117c6e1e\_maryv2-p-1080.png](https://cdn.prod.website-files.com/6537ecf8dd6837236ee1b763/671928c38a76da7c1f729de7_8408aba1e79257bb7eeefff1117c6e1e_maryv2-p-1080.png)

    * File name would be “**671928c38a76da7c1f729de7\_8408aba1e79257bb7eeefff1117c6e1e\_maryv2-p-1080.png**”

  * If the image file name is not identifiable, Mary will upload the image with this naming convention

    * **\<Program ID>\_\<Token name>\_\<Random ID>.png**

    * For example) 1131\_Image-URL2\_V3FKDPDA.png

* Embeded image is provided

  * Mary will upload the image with this naming convention

    * **\<Program ID>\_\<Token name>\_\<Random ID>.png**

    * For example) 1131\_Image-URL2\_V3FKDPDA.png

This is annoying to manage randomly created images in your Marketo assets. Mary supports a specific file name by adding
**File name: \<your managed file name>.**

Then Mary will follow with the file name instead of the default behavior above.

<Frame caption="Specify a specific File name in your image URL.">
  <img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image9.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=9bb1ea5bb5857f25a9dcd6f6799b7475" alt="Image9" width="789" height="435" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image9.png" />
</Frame>

### Where can I find the images uploaded in my Marketo?

You can find all the images uploaded In your Marketo -> Design Studio -> Images and Files

<Frame caption="Find uploaded images in Marketo">
  <img src="https://mintcdn.com/allgoodtechnologyinc/288g9iAAi6PnQz-I/images/use-cases/email-builder/prepare-the-campaign-brief/media/image8.png?fit=max&auto=format&n=288g9iAAi6PnQz-I&q=85&s=0fa17b24b3efb41fa044d7969e155e15" alt="Image8" width="1614" height="541" data-path="images/use-cases/email-builder/prepare-the-campaign-brief/media/image8.png" />
</Frame>

## Advanced: Add Mary Instructions

You can tell Mary how you want to process your tokens.

There are some use cases:

* Append UTM parameters in every links

* Remove “https\://” or specific text in the brief doc.

* Validate specific token values

Learn more on [Feature: Add Mary Instructions](./feature-add-mary-instructions.md)

## Advanced: Email Layout Optimization

Learn more on [Feature: Email Layout Optimization](./feature-email-layout-optimization.md)