PRODUCT
Follow

What is Prisma?

Prisma is a workflow management platform used for managing paid media workflow including, planning, buying, billing, and paying of media invoices.

Prisma uses the Sizmek Ad Suite API to:

  • Create and update campaigns and placements in Sizmek.

  • View Sizmek campaign and placement delivery reporting and data within Prisma.

What is Required to Integrate with Prisma?

  • A Sizmek account that is fully migrated to Sizmek Ad Suite.

  • API user and API key.

Note

Note: A Sizmek Ad Suite API-enabled user is required for the Prisma integration.

Note to customer success managers

See integration instructions and additional information below.

Supported Ad Formats

Format

Supported

In-Banner

tick.gif

Tracking

tick.gif

In-Stream

tick.gif

Integration - Task Ownership

Campaign and Placement Setup

The campaign and placements are initially configured in Prisma and then pushed to Sizmek Ad Suite. The following table outlines the trafficking tasks and where they are managed.

TASK

PRISMA

Sizmek

Campaign Setup

tick.gif

Placement Setup

tick.gif

Attachment of Ads

tick.gif

Adding URLs and 3rd party tracking

tick.gif

Publishing Ads & Sending out code packages

tick.gif

Making changes to placements

tick.gif

Ad creation, ad assignment, setting of click-through URLs, tag generation, and tag distribution to publishers, takes place solely within the Sizmek platform. There is no Prisma involvement with these steps. For any issues related directly to trafficking of your campaign within Sizmek Ad Suite, please reach out to your customer success manager or to Support@Sizmek.com.

Rules and Guidelines

  • If you have a MDX2.0 account and are transitioning to Sizmek Ad Suite, please confirm with your customer success manager that your account has been fully migrated before setting up the Sizmek Ad Suite integration in Prisma

  • Sizmek recommends against setting up the same campaign in both MDX2.0 and Sizmek Ad Suite. If your campaign has started in MDX2.0, any new placements or campaign extension should continue in MDX2.0

  • If a campaign is set up in Sizmek Ad Suite but has to be moved to MDX2.0 for some reason, the campaign should be setup again using the MDX2.0 ad server. The campaign that has been set up in Sizmek Ad Suite can be deleted.

  • Sizmek may disable the setup of new placements in MDX2.0 once the Sizmek Ad Suite roll out is complete. If a user attempts to push a new campaign or placements to MDX2.0 once the setup option is disabled, Prisma will display the following error message: You are not the owner of the provided entity. If this happens, please ensure you have selected the Sizmek Ad Suite ad server so that the campaign is setup on Sizmek Ad Suite instead.

  • Media plan and placement optimizations and updates, such as changing the ordered units/booked impressions, start/end dates, cost model, rates, placement and or package names should be executed in Prisma first and then pushed to Sizmek Ad Suite.

  • Any media plan or placement modifications made directly in Sizmek Ad Suite will not reflect in Prisma and are likely to be overwritten/undone or cause errors when pushing through any subsequent updates from Prisma to Sizmek Ad Suite.

  • Updating the site, placement name, banner size, placement type, flight date, package name or media cost in Sizmek Ad Suite directly will break the connection between Sizmek Ad Suite and Prisma. Updating section or media buy channel (custom fields in Sizmek Ad Suite) will not however.

Known Issues

  • Sizmek Ad Suite does not support cost per period. If you select monthly costs, Prisma will display an error when pushing the placement to Sizmek Ad Suite. Select cumulative cost instead.

Sizmek Setup

  • Check with your customer success manager to ensure that your account is fully migrated to Sizmek Ad Suite before using this integration.

  • In addition, confirm creation of the required API user and the associated API key.

  • No other setup is required on the Sizmek side.

Note

Note: The API user credentials will not work in the Sizmek Ad Suite platform. If access to the platform is required, the user will need separate credentials under the agency account.

Prisma Setup and Implementation

Setup and implementation in Prisma is managed by the media agency user and not Sizmek. This section provides a brief summary of the setup and implementation steps required in Prisma, but for additional information and Prisma support, the media agency should contact the Prisma support team directly (prismahelp@mediaocean.com).

Importing the Sizmek Advertiser to the Prisma Client

Procedure
  1. In Prisma, Sizmek brands are mapped instead of Sizmek advertisers.

    Prisma Client Code = Sizmek Brand ID

  2. To get the Brand IDs from Sizmek Ad Suite, follow these steps:

    • In Sizmek Ad Suite, go to the Advertisers menu.

    • Customize the view to include brands by clicking the widget next to the ‘ADVERTISERS’ and selecting Customize View > Brands from the list.

    • Search for the advertiser.

    • Under the Brand column, click the hyperlink for the advertisers brands.

    • Make a note of the ID of the brand. If there are multiple brands, you can export the list to clipboard or .CSV file format using the Export button.

  3. In Prisma, go to the Admin tool and navigate to the Ad Server Instance Details for Sizmek and go to the Client Codes tab > Agencies > Ad Servers > Sizmek > Client Codes.

  4. Create and/or locate the Advertising Client via Prisma Name.

  5. In the Ad Server Code field, type the correspondingSizmek Ad Suite Advertiser ID. Make sure that Sizmek Ad Suite is set as the ad server name.

  6. Save updates in Prisma.

Picture1.png

Importing the Sizmek Sites to the Prisma Supplier

Procedure
  1. In Sizmek Ad Suite, select Admin > Sites. Search for the required sites. Set and make a note of the IDs. If there are multiple sites, you can export the list to clipboard or .CSV file format using the Export button.

  2. In Prisma, navigate to the Ad Server Instance for Sizmek and go to the Supplier Codes tab. Agencies > Ad Servers > Sizmek > Supplier Codes

  3. Locate and click the Prisma Name of the publisher site or ad network supplier.

  4. In the Ad Server Code field, type the corresponding Sizmek Ad Suite SiteID.

  5. In the Ad Server Name field, type the corresponding Sizmek Ad Suite SiteName.

  6. Save updates in Prisma.

Picture2.png

Troubleshooting

  • Prisma: If you cannot find the desired client (Sizmek advertiser) or supplier (Sizmek site) listed in Prisma, reach out directly to your MediaOcean support contact.

  • Sizmek: If you cannot find the desired Sizmek advertiser listed in Sizmek, make sure the advertiser has been created in Sizmek first before reaching out to your Sizmek contact. If you cannot find the desired Sizmek site listed in Sizmek, reach out directly to your Sizmek contact.

Campaign and Placement Setup in Prisma

  • Follow Prisma instructions on Media Plan creationPlacement Creation in Prisma.

  • Follow Prisma instructions on Media Placement creation.

In-Banner (HTML5/Flash Standard and Rich Ads)

Prisma settings for In Banner placement setup:

  • Primary ad server: Sizmek Ad Suite

  • Placement Type: In-Banner

  • Served by: 3rd party

  • Tag Size: When served by = 3rd party, Tag Size will default to dimension size selected (160x600, 300x250, 728x90, etc.)

Tracking Only

Prisma settings for Tracking Only placement setup:

  • Primary Ad server: Sizmek Advertising Suite

  • Placement Type: In-Banner

  • Served by: Site

  • Tag Size: 1x1 (tracking only)

In-Stream Video

Prisma values for In-Stream Video placement setup:

  • Primary Ad server: Sizmek Advertising Suite

  • Placement Type: In-stream video

  • Served by: 3rd party

  • Tag Size: When served by 3rd party, Tag Size will default to N/A (In-stream Video)

In-Stream Video Tracking

Prisma settings for In-Stream Video Tracking placement setup:

  • Primary Ad server: Sizmek Advertising Suite

  • Placement Type: In-stream video

  • Served by: Site

  • Tracking description: ‘Video’ is the default (or select from the drop-down list)

  • Tag Size: When served by = Site (Placement type = ‘In-stream video’), Tag Size will default to ‘1x1 (In-stream video tracking)’

Picture3.png
Picture4.png
Picture5.png
Picture6.png

Pushing Media Plan and Placement Details from Prisma into Sizmek

Once the media plan and placement details have been entered into Prisma, you can now push the media plan and placements into Sizmek from the Prisma Ad Server tab.

Sizmek guidelines for adding data to the media plan and placement names in Prisma:

  • Sizmek Ad Suite character limit: The maximum number of supported characters is 300 applies to the media plan name (campaign name in Sizmek) and placement names.

  • Non-supported characters: Sizmek does not support the following characters: , >, and <.

Pulling in/Refreshing Delivery Data from Sizmek into Prisma

Once the campaign is live, you can now retrieve and refresh the campaign’s delivery data from the Prisma Delivery tab.

Pushing the Same Placement to Multiple Ad Servers

Prisma can push the same placement to multiple ad servers. An example use case would be a client that wants to serve the creative in Sizmek, but wants to also have the placement in DFA to generate 1 x 1 trackers. Previously, a placement would have to be duplicated for this to be possible, but you now many have multiple ad servers on the same placement. The "Primary" server will receive the actual creative placement (for example 300 x 250 in-banner) while the secondary server will receive a 1 x 1 placement.

Procedure
  1. Access the Delivery Data view.

    Picture7.png
  2. Select an ad server to view in the grid.

    Picture8.png
  3. Click Traffic, to view traffic.

    Picture9.png

Guidelines for Pushing Prisma Data to Sizmek

  • Sizmek Ad Suite User Name and Password are required in order to push the Media Plan and Placement details into Sizmek Ad Suite. When prompted, enter your Sizmek Ad Suite username and password for the Sizmek API user. Remember, API users cannot log into Sizmek Ad Suite; you will need a separate UI-enabled user.

  • Excluding a placement in Prisma, which was previously pushed through to Sizmek Ad Suite, will delete the corresponding placement in Sizmek Ad Suite. Please note that any reporting and delivery against the excluded/deleted placement is not lost and can be retrieved directly from the Sizmek Ad Suite platform under the Analytics options.

  • To create a Sizmek Ad Suite Tracking Only placement from Prisma, you’ll need to designate the Prisma placement as site served from the Prisma served by/tracking options drop down.

  • Under the placement details in Prisma, make sure that the ad server is set to Sizmek Ad Suite.

  • When pulling in media plan and placement delivery from Sizmek Ad Suite into Prisma: campaign and placement delivery (impressions, clicks, CTR, and actions/conversions) can be pulled into and viewed through Prisma under the Delivery tab.

  • Media delivery reporting will be available from campaign activity start through the previous day’s activity, per the industry standard 24 hr reporting lag.

  • The Sizmek Ad Suite user name and password may be required in order to refresh/update the media plan and placement delivery stats. When prompted, enter your Sizmek Ad Suite user name and password exactly as you would if you were logging directly into the Sizmek Ad Suite platform.

Sizmek User Credentials Guidelines

If you receive a security authentication or permissions error message after entering and submitting your Sizmek login credentials, please check the following:

  • Case Sensitivity: As Sizmek Ad Suite user name and passwords are case sensitive. Double check that your Caps Lock is Off and that you’re correctly entering your credentials with matching case.

  • Sizmek Ad Suite Password is Correct: Double check your email history to see if you’ve recently reset/updated your password. If you cannot remember your Sizmek Ad Suite password, you can reset it by going to http://platform.sizmek.com/#/login and clicking Forgot Password?. Once reset, try using the updated credentials in Prisma.

  • Sizmek User account is enabled and active: If it has been a while since you’ve logged into Sizmek, either directly or through Prisma, your user account might have been automatically locked/disabled. Check with your Sizmek Support contact to confirm and or request your account be unlocked and enabled.

If none of the above resolve the issue, please take a screenshot of the resulting error message or warning and send it to your Prisma and Sizmek contacts, with step by step details of what is occurring.

Prisma to Sizmek Field Mapping

Value/Field

Prisma

Sizmek

Considerations

MediaPlanAndPlacementSetup

Client

Advertiser

New advertisers must first be created in Sizmek. You cannot create new Sizmek adverterisers through Prisma.

Client Code

Advertiser ID

Supplier

Site

New sites must first be created in Sizmek. You cannot create new Sizmek sites in Prisma.

Suppler Code

SiteID

Media Plan Name

Campaign Name

300 character limit. Do not use &lt;, &gt;, or ".

Placement Name

Placement Name

300 character limit. Do not use &lt;, &gt;, or ".

Package Name

Package Name

300 character limit. Do not use &lt;, &gt;, or ".

Campaign Dates

Campaign Dates

Sizmek campaign start and end dates reflect the earliest start and latest end date taken from placements in the campaign.

Section

Site Section

You cannot create new Sizmek site sections through Prisma. If you are setting up the placement under a preexisting Sizmek site section, the Prisma section entry must be an EXACT match to the intended site section as it appears in Sizmek. Otherwise (or if left blank), the section/site section will default and reflect as ROS when the placement is pushed over to Sizmek from Prisma.

Units

Booked Impressions

Please note that you cannot update, and push through from Prisma to Sizmek, a units/booked impressions value that is less than what has actually served in Sizmek (for example, Sizmek actual impressions).

Cost Method

Cost Model

CPM, CPC, CPA, CPE, CPV, CPCV

Flat

Flat Fee

Free

Zero cost

Rate

CPM/CPC/CPA ($) or Cost

Dimensions

Banner Size

If you have an odd or new Prisma dimension that is not recognized in Sizmek, you will receive an "invalid dimension" error when pushing over to Sizmek. To fix this issue, submit a request to your Sizmek Support contact to create the desired banner size in Sizmek. You cannot create new Sizmek banner sizes through Prisma. Once the new banner size has been created in Sizmek, push the placement from Prisma to Sizmek again.

Placement Type

In Banner

Tracking

In-Stream Video

For placements that support VAST video formats, you should verify that the supplier is a VAST-certified Sizmek site. Upon confirmation and after pushing the placement through from Prisma to Sizmek, the VAST support box (located in the placement setup options in Sizmek), needs to be selected manually, directly from within the Sizmek platform, to allow the VAST ads to be assigned.

In-Stream Video Tracking

Site Served

Tracking Only

To create a Sizmek Tracking Only placement from Pisma, you must designate the Prisma placement as Site Served from the Prisma Tracking Options list.

Delivery

Imps

Served Impressions

Media delivery reporting will be available from the campaign activity start through the previous day's activity, according to the industry standard 24-hour reporting lag.

Clicks

CTR

Actions

Total Conversions

Support

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

Comments