Recent pages

Edit
page

New
page

Print
page
Page last modified 08:15, 20 Sep 2011 by Admin
13
Redirect
Page Notifications Off
Documentation Wiki > ExactTarget > Content > Portfolio

Portfolio

From $1

    TutorialIcon.png BlogIcon.png

    This document contains conceptual and procedural information about the portfolio file management feature. This document is intended for application users who need to understand the portfolio feature. The portfolio feature is available in all versions of the application.

    Portfolios

    ExactTarget customers automatically receive the portfolio for use in managing their email send assets online. If you opened your ExactTarget account before April  2009 the portfolio functionality appears alongside your image and document libraries. If you already store images and documents in your account, you may continue to use those libraries if you wish. However, you can begin using your portfolio at any time. In addition, your portfolio must be used for any activities involving Social Forward or Live Offers.

    The application interface and Web Service API both support most portfolio functionality. You cannot batch upload a compressed file to the portfolio with the Web Service API. Future enhancements will support this functionality.

    What Is a Portfolio

    A portfolio is a single entry point to manage the image, document, and media files that you use and refer to in your emails and microsites. You can see all of your stored digital assets together in the portfolio.

    The files in your portfolio retain the names that you specify when you upload them, allowing you to predict the URL of a file in your portfolio. For this reason, a file name in the portfolio must be unique. If you have administrative privileges, you can see the base URL for your next uploaded image on the Account Information screen of the Admin tab. Portfolio image URLs are the base URL plus the file name.

    Note: The Portfolio Base URL adds a suffix every 1000 files for large batches of uploads. For example, the first 1000 uploads would have a /1/ suffix, the next 1000 would have a /2/ suffix, and so on. This is done to protect the performance of the portfolio feature and does not affect how you store files in your application. However, in this case there may be some variability in your URLs, and you may not be able to overwrite files from your previous directory.

    In the Portfolio workspace, you can see your digital assets as thumbnails or in a listing. The workspace provides the ability to filter the files that you see to help you find files. You can upload, rename, and delete files from the workspace, giving you great flexibility in managing your files. For example, if your company uses a logo file named logo.gif in your emails and microsites, you can overwrite that file with a new logo file.

    Note: When you use the portfolio feature to manage your digital assets, deleting or renaming a file can break the references to it in existing emails and microsites.

    From the workspace you can also view the properties and preview the files.

    Supported File Types

    The following file types can be imported into your portfolio. Portfolio only accepts images at or less than 200KB in size. Other file types must be 1 MB or less in size.

    Note: Depending on your needs, your portfolio can support different file types than the ones listed below as well as non-image files larger than 1 MB in size. Contact the Customer Success Center for more information on enabling these features. 

    If you're uploading many files of the same file type, we recommend you use a random five digit value at the beginning of the file name. If you upload thousands of files with the same characters at the beginning of the name, this can impact performance and overall performance of image loading. 

    Each file in the Portfolio must have a unique name, even from files in other folders in the Portfolio. If you upload a file with the same name as a file in another folder, the file in the other folder will be overwritten and no longer appear in that folder. 

    Document, Text, and Office Files
    • .css
    • .csv (Sometimes when you upload a CSV file the application doesn't retain column widths. If you have this issue, save the spreadsheet in the XLS format)
    • .doc
    • .docx
    • .dot
    • .htm
    • .html
    • .ics (iCal and Outlook format only)
    • .js
    • .mdb
    • .mpp
    • .pdf
    • .pps
    • .ppsx
    • .ppt
    • .pptx
    • .rtf
    • .sxc
    • .sxi
    • .sxw
    • .txt
    • .vsd
    • .xls
    • .xlsx
    • .xml
    • .xsl
    • .xslt
    Graphic and Image Files
    • .bmp
    • .gif
    • .jpeg
    • .jpg
    • .png
    • .tif
    • .tiff
    Audio Files
    • .mp3
    • .ogg
    • .wav
    Video Files
    • .avi
    • .mov
    • .mpeg
    • .mpg
    • .swf
    Archive and Security Files
    • .gpg
    • .zip

    Filters

    The following filter choices are available for viewing the digital assets in your portfolio:

    • All items - Displays all of the files in your portfolio.
    • Images Only - Displays only JPG and GIF files.
    • No Image - Displays all files EXCEPT JPG and GIF files.
    • Microsoft Office Files - Displays files created by Microsoft Office applications, such as DOC, DOCX, XLS, and PPT.
    • PDF Files - Displays PDF files only.
    • Media Files - Displays MP3, SWF, and other media files.
    • Code Files - Displays HTML, PHP, PSP and other code file types
    • Unknown - Displays any file where the file type is unkown or unrecognizeable.

    Properties

    When you select a file and click the Properties button from the toolbar, the following information about the file appears for you to reference or edit:

    • File URL - The web location of the file. Use this value to refer to the file in an email or microsite.
    • Display name - The name of the file in the application. This name must be unique, regardless of the file type or the folder that the file resides in. For example, you could not have a .JPG file and a .PDF file with the same name. File names can contain only numbers, letters, and spaces.

    Even files that appear in separate subfolders in the Portfolio folder must have unique names. If you try to upload a file with the same name as a file that is already in your portfolio, the system prompts you to decide whether to replace the existing file with the new file or rename the file you are uploading.

    • External Key - The unique identifier of the file. Use this value to refer to the file using the Web Service API. This value is required. If you do not provide an external key, the system uses the file name.
    • Description - A text description of file. Future enhancements let you search for files based on the description.
    • Tag - One or more comma-separated keywords that describe or categorize the portfolio item. Future enhancements let you search for files based on the tags. Note: This feature is available in limited release and may not appear in your account.
    • Folder - The location of the file in your folder hierarchy within the Portfolio folder.
    • File type - The file type of the file.
    • File size - The size of the file.
    • (images only) Image width - The width of the image in pixels.
    • (images only) Image height - The height of the image in pixels.
    • Created - The date on which the image was created.
    • Modified - The last date on which the image was modified.

    You can edit the Display Name, External Key, Description, Tags, and Folder from the properties screen.

    Web Service API Support

    You can use the Web Service API to create, retrieve, update, and delete digital assets in your portfolio. The Web Service API uses the external key value to identify the file in the portfolio.

    You can import the images directly from an HTTP URL using the Web Service API, avoiding the need for an FTP process. If you use this process to upload a file with the same name as an existing file, the Web Service API defaults to overwriting the file. The External Key of the file defaults to the file name.

    Including Portfolio Items in Messages

    If you're creating content using the content tools, select an image from the portfolio.

    If you're creating an HTML email, use the <img> tag with the URL of the image.

    You may also use AMPscript. You can use the Image() function to include images from your portfolio in your emails. You may also use the AttachFile() function. See the AMPscript Guide for more information.

    Why Use a Portfolio

    Use a portfolio to simplify storage of your images and other files by maintaining them in a single folder.

    With the portfolio feature, you can retain the filename on a file you import, allowing you to predict the URL of a file.

    Using the portfolio feature, you can upload some file types, such as CSS and javascript files, that you cannot upload with other asset library features.

    Scenario

    Northern Trail Outfitters would like to use a few images for their new Birthday Discount email. While in the Content tab, they click Portfolio in the left navigation.

    To upload more than one file, they click the Batch Upload button BatchUploadButton.png.

    The following screen appears:

    BatchUpload1.png

    They select their zipped file of images by clicking Browse and selecting the zip file on their local machine. The file names appear in the Display Name field.

    BatchUpload2.png

    Northern Trail Outfitters clicks OK and the images upload to their Portfolio. They're now ready to create their email by using the files located in their Portfolio subfolder.

    Requirements and Best Practices for Files and Headers

    The following section contains requirements and best practices for images, documents, and headers to be used in emails.

    Images

    • Use only the supported formats listed above

    • The maximum width of the image depends on which content box contains the image. Each template layout option has different content box widths. For best results, consult the width specifications for content boxes in a standard email template later in this topic.

    Documents

    • You can upload any type of document that can be opened in a browser window. However, the subscriber clicking the document link must have the software necessary to open the file installed on his or her computer. For this reason, the recommended format for documents is PDF, as the Adobe Reader software necessary to open a PDF can be downloaded for free by any subscriber.

    Header Images

    • As a best practice, your header should consist of an image only, with Original selected as the image size.

    • Your header image should be exactly 600 pixels wide and no deeper than 150 pixels.

    • Use 72 dpi for your header image.

    Content Box Widths

    See the Template Size Guidelines document on 3sixty for the maximum base width (in pixels) for an image that you want to insert into a content box in your template-based email, depending on which layout was chosen for the template.

    Please note the following:

    • The image sizes shown are the absolute maximum widths, which can be used when you leave the content box border set to "off" and you change the margin setting to 0 (by default, the margin is set for a 4-pixel padding). If you add a border or include a margin, you'll need to decrease the width of the image accordingly.

    • If your header includes an image, set all of your content boxes' margins to 0 so as to avoid white space in the header. Having a margin greater than 0 widens the email, which adds padding around the header area, leading to white space around the header image.

    The border and margin settings are defined in the Borders/Background dialog box of the Content-Building wizard.

    This page was last updated by Adam Evans on Tue, 20 Sep 2011 12:15:11 GMT.

    If you require assistance with the ExactTarget application, please contact Global Support. If you wish to send Adam direct feedback, fill out the form below:

    Was This Page Helpful?
    Suggestions or Comments:
    Name (optional):
    Email Address (optional):
    Enter 6345 backwards:
       
    Tags: (Edit tags)
    • No tags
    Attach file or image
    Files (13)
    FileSizeDateAttached by 
    1.png
    No description
    		89.43 kB15:28, 5 Jul 2011AdminActions
    2.png
    No description
    		48.85 kB15:28, 5 Jul 2011AdminActions
    3.png
    No description
    		63.48 kB15:28, 5 Jul 2011AdminActions
    4.png
    No description
    		67.26 kB15:28, 5 Jul 2011AdminActions
    5.png
    No description
    		71.99 kB15:28, 5 Jul 2011AdminActions
    6.png
    No description
    		130.02 kB15:28, 5 Jul 2011AdminActions
    BatchUpload1.png
    No description
    		11.98 kB08:15, 20 Sep 2011AdminActions
    BatchUpload2.png
    No description
    		20.54 kB08:15, 20 Sep 2011AdminActions
    BatchUploadButton.png
    No description
    		841 bytes08:15, 20 Sep 2011AdminActions
    bday.png
    No description
    		70.13 kB15:28, 5 Jul 2011AdminActions
    BlogIcon.png
    No description
    		3.68 kB08:15, 20 Sep 2011AdminActions
    TutorialIcon.png
    No description
    		3.92 kB08:15, 20 Sep 2011AdminActions
    upload.png
    No description
    		107.15 kB15:28, 5 Jul 2011AdminActions
    Comments (0)
    You must login to post a comment.

     
    Powered by MindTouch 2010
    Admin