Network Management for App Stores

From Mocean Mobile Wiki

Jump to: navigation, search

Contents

Network Login

To log in to a specific network, you need to use the email and password provided by Mocean when you registered.

Login Form

If you are successfully logged in, you will be redirected to the Dashboard page of the corresponding network.

Forgot A Password

Even if you have forgotten your password, you can still log in using a new temporary password. To obtain it, go directly to the network login page and select 'Forgot Your Password?' from the Member Login page.

File:forgot1.png

Then, specify your email and click on the Reset password button.

File:pwd_recover.png

After that, a new password will be sent to your inbox. Click on the URL in the Password Recovery Request Email to recover your password. Then go back to the network main page and try to log in using a temporary password specified in the Password Recovery Request Email.

File:forgot3.png

NOTE: DO NOT FORGET TO CHANGE YOUR TEMPORARY PASSWORD AS SOON AS YOU LOG IN TO THE NETWORK.

For this purpose, select the Profile tab from the main navigation bar. Then, enter the Current Password, the one you want to have in 'Password' and 'Confirm password' fields. Click 'Save' to save the changes.

Now, you are able to log in to the network using your specified password.


App Setup

The first step in the management of a network is to define the apps that will exist within the network.

Create Apps

Create Apps

Selecting ‘App Setup’ from the top navigation panel brings up the app creation user interface. This is where the applications within the particular network will be created and managed.

Each application has to be created individually with an application name, type, specified Content Verticals, accepted Ad Categories, and AppWorld link and description.

  1. Choose a network (entire network or sub-network) from the corresponding select-box.
  2. Select an App Type from the drop-down.
  3. Enter an application name.
  4. Enter an App URL.
    NOTE: This box is required for apps with the Mocean Mobile Marketplace check-box enabled.
  5. Add a description (which should be descriptive for identification and management purposes).
  6. Enable 3rd party feeds to be shown on the app by checking the "Enable 3rd Party Ad Feeds (Mediation)" box on.
    NOTE: This option is available only if you have the "Can Enable/Disable 3rd Party Ad Feeds (Mediation) on Site Level" permission enabled!
    If Disabled, then the 3rd party Ad Feed Configurations won't be assigned to this app and its zones, and will never serve to it.
  7. Enable Marketplace ad feeds (3rd party ad feed line items noted as Marketplace) to be shown on the app by checking the "Enable Mocean Mobile Marketplace" box on.
    NOTE: This option is available only if you have the "Can Enable/Disable Mocean Mobile Marketplace Ad Feeds On Site Level" permission enabled!
  8. Enable the "Over Age 18" option to mark the app as for adults only.
  9. Select the Content Verticals corresponding to the application in question via the check-boxes from the ‘Content Verticals’ panel.
  10. Select the Ad Categories representing the Ad Content you are willing to server to your app via the check-boxes from the ‘Ad Categories’ panel.
  11. Set invalid settings that will be enabled by default for the app's zones.
    Choose among the following options:
    • IP Check - Checks if the IP address of the click matches the IP address of the impression the click came from. If not, the click is stored as invalid.
    • UA Check - Checks if the user agent (UA) of the click matches the UA of the impression the click came from. If not, the click is stored as invalid.
    • Click Targeting Check - Will re-check the targeting on the campaign against the targeting on the click. If they don't match the click is marked as invalid.
      NOTE: The "Default Invalid Zone Settings" option is available only to users with the enabled "Can Edit Invalid Settings On Zone" permission. See User Permission Profile.
  12. Define a status (Active, Pending, Declined) for an App. This section is available to users with the "Can Approve Site" permission enabled.
    Active status is checked by default (when the app is created by a user with the "Can Approve Site" permission enabled). The status can be changed for Pending or Declined by a Network Manager or a user having permissions to do this.
    NOTE: How to set the user permissions see User Permissions Profile.
  13. Revenue Share for Direct Creatives - Set revenue share for the new app individually. By default it inherits the revenue share set at the network level. Un-check the check-box and enter the value you wish for this app.

Once all of the application information is entered, select ‘Save’, at which point the app name, description assigned, Content Verticals and Ad Categories will appear in the ‘Existing Apps’ list below. Additionally, the ‘App successfully saved’ message will appear at the top of the screen in green.

Mobile App/Inventory List


Manage Apps

The Manage Apps tab on the sub-navigation bar below App Setup allows for pricing floors to be set on an app down to the zone level. Additionally, it allows for each zone to be designated to contain a text ad, a banner ad, or both. The initial Manage Apps screen appears as below.

Manage Apps

The following options are available under the Manage Apps sub-navigation:

App Search

It is available to search among the existing apps by one of the following items.

  • App Name
  • App ID
  • App URL
  • Network ID (available for super-networks)
  • Network Subdomain (available for super-networks)
  • Zone ID
  • Zone Name

For searching, select “Advanced” option, then specify value for the searching parameter in interest, and select “Search”.

App Search


Filtering

The list of existing apps can be filtered by network or by app statuses right above the grid (All/Active/Declined/Pending/Deleted).

The following information is available under the Exsisting Apps list:

  • App Name (sortable)
  • App Network (sortable)
  • Status (sortable) - reflects app's status - Active, Pending or Declined - and allows to change the status (if it is allowed to a user by permissions).
  • Type (sortable)
  • Actions
Zones - lead to the app management panel. For every app, a default zone is automatically generated by the platform, and will appear in the Existing Zones list. While managing the app you are able to create, manage and delete its zones, to set competitive ad filter and competitive keyword filter as well. Find more information below
Zones Report - allows to get a CSV with the list of zones and their details.
Edit - allows you to change app settings: name, description, channels, link and type as well as set default invalid settings for zones of this app and the invalid settings for bulk editing of the app's zones. While editing you may also set 3rd Party Ad Feed Revenue Share for the app if you have the corresponding permission.
Approve - approves an app.
Pending - changes the status to Pending.
Decline - declines an app.
Delete - allows to delete an app. Multiple "Delete" action is allowed. For this purpose check the desired apps in the list and select ‘Delete selected’ at the bottom of the list.
Copy - allows to create a new app on the base of the existing one.
App Review - allows to view the app information at a glance in a pop-up window. Here you can change the app status as well.
View Verticals - allows to view the app's verticals at a glance in a pop-up window.
Manage App Actions


You can also delete several apps at the same time, and to do this check the desired apps and select ‘Delete selected’ at the bottom of the apps list.
Undelete
When you delete an app it is moved to the Deleted Apps list. So, if you have deleted an app by mistake, you have the ability to restore the app.
Undelete App
3rd Party Ad Feed Revenue Share

If you are granted the Edit 3rd Party Ad Feed Revenue Share permission (see User Permissions Profile), you may configure revenue share for individual ad feed networks in the separate form under the main app settings.
Please note that these settings for the app will override settings made on the network level.

Ad Feed Revenue Share
Bulk Edit

It is available to delete/undelete or change the status for some apps at a time.

In the list of existing apps check those that you wish to delete/undelete, or decline/approve, or make pending. Then select the desired action from the drop-down below the grid and apply it to the selected items.

Bulk Edit


You can get a CSV list of the existing apps by clicking at "Export CSV" below the grid.

Export AppsBETA

You can get a list of the existing apps by clicking at "Download" below the grid. Select the format you wish from the drop-down: CSV, XLSX, TSV, XML, or HTML.

Zones

Zones allow for the assignment of different ad types, placements and pricing within the apps over a network. The ‘Zones’ section of the ‘App Setup’, ‘Manage Apps’ sub-navigation allows for the defining of the zones used in the network.

To define a zone, simply create a name, and enter its description into the respective form fields.

Then enter the value for a custom field (if any is created under Network Admin Panel) and select the zone type that is what type of ads - text, graphic, richmedia or all - can be shown on this zone.

Choose to set a minimum CPC/CPM/CPA rate, or leave unchecked if there is no minimum associated.

Then specify eCPM Goal floors. This option allows publishers to set Target eCPM and Min eCPM Goal values for a zone. The ad server will run ad campaigns where the ad campaign eCPM meets at least the eCPM goal of the app, then checks every 10 minute to see if the ad's eCPM continues to be at least equal to or above the zone eCPM goal. If it is not, the ad is no longer eligible to serve on that zone.

Enable the "Test Zone" option if you want only test ads to be shown on the zone.

Enable the necessary options in Invalid Zone Settings form choosing among:

  • IP Check: Checks if the IP address of the click matches the IP address of the impression the click came from. If not, the click is stored as invalid.
  • UA Check: Checks if the user agent (UA) of the click matches the UA of the impression the click came from. If not, the click is stored as invalid.
  • Click Targeting Check: Will re-check the targeting on the campaign against the targeting on the click. If they don't match the click is marked as invalid.
In case any default/bulk edit invalid settings are enabled at the app level, they will be active for new/existing zones by default. If no invalid settings are enabled at the app level, network's ones set in the Control Panel will be inherited by the zone(-s).
NOTE: The invalid settings are available to users with the enabled "Can Edit Invalid Settings on Zone" permission. See User Permissions Profile.

Choose the method, either Logical or Physical, for determining the screen resolution that will be used while selecting the ad to serve on the zone. Physical one will use device resolution height and width, and Logical will use max image height and width. By default, the setting defined for the entire network will be used.

Minimum and Maximum Default Ad Sizes, both width and height, can also be specified at the zone level. Note that positive integer values only are allowed, Minimum Values cannot be greater than the Maximum Values and both height and width for Maximum or Minimum values should be either specified or left empty. The ad server will check the sizes specified in the Ad Request. If no size is specified there, the zone level will be checked for the specified default ad sizes for the specific zone. If there are no default ad sizes specified at the zone level, the ad size will be determined automatically for the device.

Revenue Share for Direct Creatives can be set for the zone level. By default the revenue share is inherited from the app level. To make it configurable un-check the check-box and enter the value you wish.

Manage Apps: Define Zones


Once the zone has been defined, select 'Save'. The newly created zone will appear in the list below, and the "Zone successfully saved" message will show up.


There is no limit to the number of zones that can be created. The default zone may be deleted or maintained, depending on whether it is planed to utilize it or not.

Existing Zones

To speed up the process of zone searching enter a Zone ID number and click on "Search" to find it in the list.

The following actions are allowed for an indicidual zone under the Manage Zones section:

Code
Select this option to view install code samples.
Zone Code
Install codes allow to specify the place, number, type of ad to be shown on your zone as well as its look (header, borders, background and text color). You may also set keywords that will select only those ads for showing that are targeted to these keywords (see Keywords Ad Targeting). Some other parameters for ad selection can also be specified here for more precise ad selection.
Edit
Select this option to change zone settings: name, description, type and min rate.
Edit Zone


While editing the zone you may also set 3rd Party Ad Feed Revenue Share at the zone level if you have the corresponding permission.
By default revenue share is inherited from the associated app. If revenue share is not defined at the app level, network settings will be used.
Note that the zone level will override any higher level settings.
For example, in the case where an app is set at 90% revenue share and a zone under that app is set at 70% revenue share the zone setting will be used for ads run on that zone.
3rd Party Ad Feed Revenue Share


Delete
If you need to delete some zones, select the Delete option opposite the zone in question.
Delete Zone

Competitive Ad Filter

The Competitive Ad Filter ensures that ads from competitors' URLs do not appear on the network apps. There is no limit to the number of URLs entered here. Simply type the URLs to be blocked in the form field, and select, 'Add'. Note that only mobile web browser URLs (i.e. URLs that start with the prefix http:// or https://) can be entered into the Competitive Ad Filter. Entering a top-level domain will exclude all subdomains from appearing on your apps as well.

A csv list of URLs can be uploaded as well.

As they are added, the URLs will appear in the list below.

Competitive Ad Filter List
NOTE: Network Owner is able to upload a list of competitive URLs through the Network Admin Panel that will appear in Competitive Ad Filter lists of all the network's apps.

The Competitive Ad Filter will only be applied to the click through URL associated with a creative and a creative image or a landing page URL. Therefore, if a 3rd party external ad feed is targeting your apps, the filter list will not be applied to those ads. If you are using 3rd party feeds you can contact your feed provider directly for additional competitive filtering options.

Competitive Keyword Filter

Another way to filter out your competitors from advertising on your apps is to specify keywords on the ' Competitive Keyword Filter ' form. Words can be entered one by one or a csv list of words can be uploaded.

Keywords List

The Competitive Keyword Filter list will be applied to text associated with Mocean Mobile Orders, including Order Names, Line Item Names, Creative Names, Creative Text, and Ad Feed Names. Keywords entered will not be applied to the text found within mobile landing page content, Rich Media content, text within URLs, text within banner Creative, or text within 3rd Party Ad Feed Creative. If you are using 3rd party feeds you can contact your feed provider directly for additional competitive filtering options.


Manage Advertisers

Under the "Advertisers" tab of the main navigation menu you will find the "Manage Advertisers" subtab where an advertiser can be created for the network and advertiser permissions can be managed. A Network Manager may grant permissions directly to brands and/or advertisers to do several things – including manage their own ads or view their own custom reports. The Advertiser login will only allow access to activity directly relating to that advertiser; ad information across the network is only viewable to the Administrator or Network Manager.

The "Manage Advertisers" page contain the following information:

  • a form to add/edit an advertiser accompanied with the list of permissions for the chosen user profile;
  • default network advertiser (Network Owner) information tab;
  • the list of existing advertisers.

Below you will find more information on each part.

Add/Edit Advertiser

When adding an Advertiser, the following information should be specified:

  • network (Super-Network/Sub-Network),
  • status (Active/Inactive),
  • permissions profile (for more details, see Advertiser Permissions),
  • email address,
  • password (configured by the Network Manager),
  • company,
  • first name,
  • last name,
  • phone.

When you select a permission profile for the advertiser, the description/specific permissions of each permission profile will appear to the right of the form.

Advertisers Permissions


If you are granted the "Can Edit Invalid Settings On Line Item" permission, you may also set default invalid settings for future advertiser's line items. When you create a new advertiser, some options can be enabled by default based on invalid line item settings defined for the network.

Once advertiser details have been completed and the desired permission levels have been set, select ‘Save’ to create the advertiser account.

An email with the advertiser’s account information will be automatically generated and sent to the advertiser, unless the option to enable e-mail notifications has been disabled.

The option to resend the email to the advertiser is given via the ‘Re-Send Email’ button next to ‘Save’. If the advertiser does not receive the first email, or misplaces their account information, this can be used by the Network Manager to get that information back out to the advertiser.

After advertiser permissions have been set, they can be managed from the Existing Advertiser list at the bottom of the page (see Existing Advertisers).

Default Network Advertiser

The Default Network Advertiser panel provides users with the main information about the network owner (he is considered to be the default advertiser for his own network).

The following details about the default advertiser can be obtained from the panel.

  • Company name
  • First and last names
  • Network owned by him
  • His ID in the system
Default Network Advertiser

Search Advertisers

From the "Search" panel it is available to search an advertiser in the list of Existing Advertisers by his Account/Full name or E-mail.

Search Advertisers

Existing Advertisers

The Existing Advertisers panel at the bottom of the ‘Manage Advertisers’ tab allows for the management of existing advertiser accounts. Once an advertiser account is established, it will appear in the list similar to the example below.

Existing Advertisers

Use the Network Filter select-box to filter out existing advertisers of a certain sub-network.

Choosing a certain action from the first column allows the Network Manager to view advertiser's orders, edit his account settings or delete a certain advertiser account. Edit the advertiser account information here.

Choose the Action
Orders
Selecting ‘Orders’ allows the Network Manager to view any ad activity the advertiser may have. This selection delivers the user to the ‘Orders – Manage Orders’ tab, and defaults to the Active order view.
Edit
Select ‘Edit’ to change the advertiser account settings (see section Add/Edit Advertiser). All the fields are available for editing, except the Network one.
Besides the advertiser data you may add/subtract funds to advertiser's balance as well as regenerate the API Key for him.
You may also make invalid settings for existing line items belong the advertiser in question if you are granted the appropriate permission.
Delete
Select ‘Delete’ to remove the certain advertiser account.

The Existing Advertiser tab also displays advertiser account information, with a Local balance column, until funds are transferred or deposited from one of several sources (see section Advertiser Funding).

Invalid Line Item Settings

NOTE: The "Invalid Line Item Settings" functionality is available only to users with the enabled "Can Edit Invalid Settings On Line Item" permission. See User Permission Profile.

Bulk Edit Existing Line Items allows network managers/owners to change invalid settings for all existing line items owned by the advertiser being edited.

Choose among the following options and select ‘Update Existing Settings’.

  • IP Check: Checks the IP Address of the click to make sure that it matches the ip of the impression that the click was generated from. If they don't match the click is marked as invalid.
  • UA Check: Checks the User Agent of the click to make sure it matches the user agent of the impression where the click came from. If they don't match the click is marked as invalid.
  • Click Targeting Check: Will re-check the targeting on the campaign against the targeting on the click. If they don't match the click is marked as invalid.
  • Double Click: The first click is recorded as legitimate, but the duplicate click or clicks are marked as invalid.
  • Double Action: The first action is recorded as legitimate, but the duplicate action or actions are marked as invalid.
Bulk Invalid Line Item Settings

For more information see Fraud Detection page.

If any default invalid settings are set at the network level (under the Control Panel) they will appear in this form as enabled by default.

Advertiser API Key and Values

When editing advertiser's data it is possible to regenerate the API Key for him to be able to use Mocean SOAP API service.

To re-generate the API key click the “Regenerate API Key” button on the “API Key&Values” form. When the button is clicked, a small modal window asking the user, "Are you sure you want to regenerate the API Key?" with Yes and No buttons will appear. When Yes, the key is created. When No, the window closes and nothing happens.

API Key & Values form

Please, find more information about API Key Access here.

Advertiser Funding

When an Advertiser account is initially established by the Network Manager, Local Balance is set to $0.00.

Local Balance - the balance on the account assigned by the Network Manager. This would be related directly to amounts invoiced to the Advertiser.

There are two ways for funds to be added to an Advertiser account – via credit card (directly by the Advertiser or the Network Manager) or by the Network Manager if the Invoice Payment Option is enabled.

If the Network Manager has chosen to invoice the advertiser, he may add funds to advertiser’s local balance by editing the advertiser's account in question.

NOTE: BE SURE THAT THE CORRECT ACCOUNT HAS BEEN SELECTED FOR EDITING BY DOUBLECHECKING ACCOUNT DETAILS LIKE E-MAIL ADDRESS, COMPANY, USER NAME, ETC.

Once that has been established, enter the dollar amount to add to the advertiser’s local balance in the Local Balance box, and select ’Add’.

Adding Advertiser Funds

The funds will appear in the advertiser’s local balance in the Existing Advertisers panel, ready to be used by the advertiser.

Funded Advertiser

Once advertiser accounts have been created, it is time to move on to Order Setup (see section Create Orders).


Create Orders

User's ability to create Orders is determined by the user's permissions (see here).

Permissions

A user with “Manage Order/Line Item” Permissions enabled can create an Order for an Advertiser, select an appropriate IO for him and commence creating the Order from scratch with the IO’s Money set as the Order Budget.

Click "Orders" tab of the main navigation menu to access order management tab. You may create a new order by clicking on “Create Order” sub-tab or “Create New Order” button above the list of existing orders in the main navigation menu.

Orders tab
Create New Order Form

The form for order generation will appear.

Create order

Fill it in with the necessary information:

  • Order Name - fill in the order name. This must be unique within the account.
Order name
  • House Order check-box - This is unchecked by default. If the House Order check box is checked, the advertiser will be set to the Account of the user creating the House Order. NOTE: The House Order checkbox can not be viewed by advertisers and can only be enabled by Network Managers.
A house order is an order booked by the publishers themselves, using their own inventory to promote themselves. A House order can only be edited if the Orders line items haven’t started to run. If an order is defined as a House Order, all of its line items are House Line items. House Line Items do not have a dollar value and are not considered for billing.
House Orders are exempt from Publisher price minimums so they will run anywhere they are targeted with all metrics being tracked and reported on.
Once a House Order is set and saved it can not be changed from its original settings.
  • Test Mode check-box - Tthis is unchecked by default. The order can be set as test and its delivery within the network will be configured without actually having your order served in response to any ad requests. If an Order is created in Test Mode its "Create line item" form has "Set as Held Ad" check-box disabled and unavailable for editing.
Orders in Test Mode are exempt from all targeting restrictions and Publisher price minimums. These orders will serve with all metrics tracked and reported on, but they won't be included in revenue numbers.
NOTE: Only one of the check-boxes - "House Order" or "Test Mode" - can be enabled for one order. The selected check-box can not be changed after the order is saved.
Order type
  • Advertiser - select an advertiser responsible for the order. This is auto-populated by default and can be changed if you have permission to create Order's for Advertisers.
  • Select the Type of Balance. 3 options are available:
- Unrestricted - In this case, the balance is infinite. That means there are no balance restrictions for an advertiser. This option is selected by default.
- Use Advertiser Balance - This option allows you to define the specific amount to use as the advertiser balance. The available budget is viewed in the below. The amount can be changed by adding funds to the advertiser's balance.
Advertiser Balance
When applying this option, within the pop-up window specify the amount of money to limit Advertiser balance too and select 'Add & Continue'.
Add funds
Funds can be added through PayPal. To do so, specify the amount of money and click the "Add Funds Via Pay Pal" option. Click at 'Add & Continue'.
PayPal option
- Use Insertion Order - Insertion orders are used for payments (only available under a specific advertiser!).
Select the desired insertion order from the list of existing insertion orders appearing below as soon as "Use Insertion Order" balance option is selected from the drop down.
IO Advertiser Balance
It is possible to create a new insertion order for the advertiser by clicking at "New IO" beside. In a pop-up window enter a necessary information and upload the file to create the insertion order (for more details on IO creation process see the Create Insertion Orders section).
NOTE: After saving, the selected balance type can not be changed.
  • Total Budget - This is derived as the sum of individual line item budgets, and is auto-populated. If a line item has unlimited set as a limit, the total budget will reflect that.
Order Budget
  • Timezone - This is the timezone for your order (line items) to serve in. By default, the timezone defined for the network as default is used. Once the order is saved, it can not be changed.
  • Start and End dates - specify start and end dates for the order to serve or select "Immediate/Indefinetly" from the drop-down.
Order Date
  • Custom Attribute - Enter Custom attributes here or save the auto-populated default value (if any exist). Custom UI Fields can be created within the Advanced Network Settings under Custom UI Field tab (see here).
Order Custom field
  • Advance Grouping - enable this check-box if you wish to restrict line items delivery at the order level. You have the ability to set the total and/or daily limits for impressions/clicks/actions/budget. If the group (meaning ANY line item in the group) reaches the specified caps, no lines in the group will be served.
Enable the Smooth delivery option for the order to optimize the delivery of ads within the order. Smooth Delivery can be enabled at the order level if Advance Grouping limits are set for the order and its flight is restricted.
NOTE: Order level daily limits (if they exist) will affect its line items even if a line item is a sponsorship. That line item (alongside with all the other line items of that order) will adhere to the Order level daily limit.
Advance Limit Grouping

After filling in all the necessary information click “Save” to save the order. After saving an order its ID can be viewed in the order form right below its name.

Order save

This Order will appear in the Manage Orders sub-tab and you will be able to create Line Items for the saved order (see below).

Manage Orders

Once an order has been created it can be managed using the Manage Orders panel. Here you can run and pause orders, edit or delete the specified orders, as well as get the fast access to an order hourly/daily/monthly report.


Filtering

The Existing Orders can be filtered by Order Name, Order ID, Order Custom Attribute, Line Item Name, Line Item Custom Attribute, Advertiser Name (Company), Advertiser ID, Network ID and Network Name (if you are in the super-network) as well as by Start/End Dates, Budget in the grid.

Order Filtering

Each order can have one of the following statuses:

  • Active: Order flight dates are valid (end date hasn't been met).
  • Deleted: The order was deleted and must be re-activated to edit line items.
  • Completed: Order flight end date has been reached.

The order list can be filtered by orders' statuses too.

Order Filtering

The following information is available under this tab:

  • Order Name - the name of the order,
  • IO - the number of insertion order if assigned to the order,
  • Start date - the order start date,
  • End date - the order end date,
  • Advertiser Name - the name of the advertiser, the order is assigned to,
  • Budget - the order's budget that is the sum of all its line items budgets,
  • Budget Spent - the budget spent to the order that is the sum of spent budgets of its line items,
  • Notifications - the notification message for the order that the advertiser balance is low, marked with or the order has been migrated and adjustments needed marked with . "Need Action" notification may also appear if one or many line items in this order have the status of PENDING, SAVED, or PAUSED.
  • Actions - the list of actions to apply to the order (see below).


Actions

The following actions can be applied to the order:

  • Edit – brings up the form for editing the order.
  • Copy – brings up the Order creation form with a new order created with all settings inherited from the parent order.
  • Logs – bring up the change logs screen for the order.
  • Report – brings up the report generation form.
  • Delete – allows to delete the order.
Order Actions

You may select/tick an order(-s) and choose an action – Delete or Undelete – from the Action tab below the orders list to implement it to the selected items at a time.

Order Multiaction

To download a CSV with all the information from the Manage Orders tab, click “Export CSV” below the existing orders table.

Export Order ListBETA

You can get all the information from the Manage Orders tab by clicking at "Download" below the grid. Select the format you wish from the drop-down: CSV, XLSX, TSV, XML, or HTML.

Export CSV

To view order's line items click on its name in the table. You will be moved to the order form.

All existing line items for the order are listed below the form.

Orser's Line Items

The following information is provided for each Line Item:

  • Line Item Name with an icon for its status (Running, Paused, Pending, Declined, Completed, Saved, Deleted or all). By clicking at the check-boxes next to status names you may include/exclude the line items with such statuses into/from the list.
  • IO number if the line item is funded by Insertion Order.
  • Start and End dates of the Line Item.
  • Advertiser the line item belong to.
  • Budget
  • Budget Spent
  • Pacing (Actual Delivery %/ Expected Delivery %)
  • Alerts
  • Order the line item is created for.
  • Action (Edit, Copy, Pause/Resume, Review, Creatives, Report, Delete) to manage the line item.

Line items in the list can be sorted by line item name, start and end dates, budget, pacing data.

Edit Order

While editing order's settings, user may change the following:

  • Order Name
  • Start and End Dates. NOTE: Start date can be changed only if it hasn't been reached yet.
  • Custom Parameters' value if they exist
  • Order Limits
  • Smooth Delivery Settings

Please pay attention to the fact that changes to the Order can affect the child line items. Any changes to an Order require approval by a user with the permissions to Approve Line Items.

In case the orders dates and/or limits are edited by a user with the 'Can Approve Line Items' permission, an additional approval section appears under the Advanced Settings.

The approval section contains the following options:

  • Line Items Approved (This Order) - this option is enabled by default and if enabled, Order's approved line items keep their 'Approved' status.
  • Line Items Pending (This Order) - if this option is enabled, Order's approved Line Items acquire 'Pending' status.

If the Order is edited by a user who does not have the 'Can Approve Line Items' permission, a warning message will appear instead of the approval section saying that Order's approved line items will receive the 'Pending' status.

Edit Order: Approval Section

Create Line Items

In this section you will know how to:

Once an Order is created you may assign a line item to it by clicking the "New Line Item" button above the list of order's line items. Line items contain all the settings for the Order including targeting, placement, delivery settings, creatives and ad feed settings. One Order may have multiple Line Items.

Create new LI default screen

In the appeared form you can see two panels. The upper one contains basic line item settings. Below specific settings for targeting, placement, delivery, creatives can be made.

Basic Settings

Basic Create Line Item functionality requires to specify:

  1. Line Item Name – Enter a name for the new Line Item. It should be unique within the system.
  2. Line Item Type – Line Item types allow users to flag what the line item represents and can be used for external billing processes. The definition of each depends on the users business model. This option doesn't affect ad serving or reporting in any way. There are 6 types of flags to choose between:
    a) Standard
    b) Priority
    c) Bonus
    d) Make Good
    e) Flat Fee
    f) Exchange
  3. Line Item Source – Defines if the ad is a direct creative or it is a 3rd Party Ad Feed. NOTE: Once selected and saved, Line Item Source can not be changed from it's original settings.
  4. Custom Attribute - Specify a Custom Attribute value if any is created for Line Items under Network Admin Panel (see here).
  5. Start/End Dates – Should be specified for the line item to determine its delivery period. Make sure the date range specified for the line item stays within the order date range.
  6. Ad Category – Specifies the sphere the ad concerns. NOTE: Ad Category is available for Direct Creatives only!
  7. Over 18 only - When the check-box is enabled the ad serves to apps allowed for adults only.
  8. Ad Type – can be set as:
    - Set as Held Ad
    Enabling this option makes the ad inaccessible for processing by the ad server so that it can't be returned on a certain request (similar to paused orders). All inventory will be reserved for the held ad. After the held period has expired (14 days or other period if set in the Network Settings), if the line item hasn't been run, the ‘Set as Held Ad’ check-box is reset to off, and the line item becomes Saved. NOTE: The check-box is not available to Advertisers as well as for orders in Test Mode.
Save New LI

Click Save Line Item when all the basic information is populated.

Special Settings

Some special settings are allowed for a line item such as targeting, placement, delivery, ad feed configurations, etc. that make your ad serve more efficiently.

Targeting

An ad can be targeted choosing a targeting group that can be created with a name and optionally be associated with an Advertiser or set as Network-wide (available to all users in the network).

NOTE: Only Users with “Can Use Targeting Group” permission enabled will be able to use the targeting groups.

Targeting groups available for the line item are listed under "Targeting" tab. To find the group use the search option - enter a search term in the box and click "Go" to get results.

Set the Targeting

Clicking at a targeting group name in the list or checking a radio-button next to a targeting group name allows to view the targeting group settings above the list.

You can see the name of the selected targeting group at the top of the review form. To edit its settings click on the "Edit" button next to the targeting group name. To de-select the targeting group from your line item click "Remove".

View the linked targeting

Once the necessary targeting group is selected and saved for the line item, it is marked as "Currently Saved" and pinned to the top of the list. It allows to always see what is linked to the line item even when looking through other targeting group's settings.

Currently saved targeting

To preview the group settings hover the mouse over the targeting group name and view the information in the pop-up window.

Actions for targeting

The following actions are available to be performed on a targeting group:

Edit
Allows to edit the group settings in the targeting pop-up window.
When editing a targeting group, it gets changed for all line items associated with that group. The information on the number of the line items linked to this targeting group is introduced in the targeting group list right opposite each targeting group name as well as in the modal window that appears when clicking on "Edit" and making changes to a targeting group.
View Linked Line Items
If the changes are not intended for all the linked line items, a user can unlink those that the edits should not affect. The "Unlinking" action removes the targeting group in question from the selected line items and sets a "[Custom targeting]" group in its place with the same targeting options selected. This way, any changes made to the targeting group (while editing) will only affect those line items that are still linked.
Unlink LIs
NOTE: In case the edits are made by a user without the "Can Approve Line Item" permission, "Unlink" or "Delete" actions set the linked line item(-s) to pending. It stops running till a user with appropriate permission approves it (them).
Copy
Allows to copy the group with all its settings.
When a user selects copying, the modal appears with the ‘Targeting Group: Custom Preset’ option unselected (which basically appears once creating a new targeting group), but containing (copied) all the targeting options from the original targeting group. Thus allowing for this new group to be set as a onetime use or renamed as a new targeting group.
Delete
Allows to delete a targeting group.
When deleting a targeting group, the modal will appear with all the line items associated with that targeting group and the "Delete" button at the bottom. Once selected, the targeting group will be deleted, removed from the list and all associated line items will no longer be targeted against any specific group.
Create Targeting Group

A new targeting group can be created by clicking at "New Targeting" button. A window appears where you are able to do your targeting settings.

Enter a name for the new group and check "Network-wide" check-box to set it available to all users in the network. If the check-box is disabled, the targeting group is created for the advertiser specified for the order the line item assigned to. NOTE: The "Network-wide" option can not be changed (checked/un-checked) after the targeting group is saved.

Detailed instructions on how to make the targeting settings can be found here.

NOTE: Only Users with enabled “Can Create Targeting Group” permissions will be able to create targeting groups containing any targets they want.

Placement

An ad can be placed on placement groups that can include the placement by Network/App/Zone and the Content Vertical placement and optionally be associated to an Advertiser or set as Network-wide (available for all users in the network).

NOTE: Only Users with “Can Use Placement Group” permission enabled have the ability to use placement groups.

A placement group can be searched among the existing using the searching option above the group list. Enter a term you would like to find a placement group by and push "Go" to view the results.

Setting a Placement

Clicking at a placement group name in the list or checking a radio-button next to a placement group name allows to view the placement group settings above the list.

You can see the name of the selected placement group at the top of the review form. To edit its settings click on the "Edit" button next to the placement group name. To de-select the placement group from your line item click "Remove".

View a Linked Placement

Once the necessary placement group is selected and saved for the line item, it is marked as "Currently Saved" and pinned to the top of the list. It allows to always see what is linked to the line item even when looking through other placement group's settings.

Currently Saved placement

To preview the placement settings hover the mouse over the placement group name in the list and view the information in the pop-up window.

Actions on Placements

The following actions can be performed on a placement group:

Edit
Allows to edit the group settings in the placement pop-up window.
When editing a placement group, it gets changed for all line items associated with that group. The information on the number of the line items linked to this placement group is introduced in the placement group list right opposite each placement group name as well as in the modal window that appears when clicking on "Edit" and making changes to a placement group.
View Linked Line Items
If the changes are not intended for all the linked line items, a user can unlink those that the edits should not affect. The "Unlinking" action removes the placement group in question from the selected line items and sets a "Custom placement" group in its place with the same placement options selected. This way, any changes made to the placement group (while editing) will only affect those line items that are still linked.
Unlink LIs
NOTE: In case the edits are made by a user without the "Can Approve Line Items" permission, "Unlink" or "Delete" actions set the linked line item(-s) to pending. It stops running till a user with appropriate permission approves it (them).
Copy
Allows to copy the group with all its settings.
When a user selects copying, the modal appears with the ‘Placement Group: Custom Preset’ option unselected (which basically appears once creating a new placement group), but containing (copied) all the placement options from the original placement group. Thus allowing for this new group to be set as a onetime use or renamed as a new placement group.
Delete
Allows to delete a placement group.
When deleting a placement group, the modal will appear with all the line items associated with that placement group and the "Delete" button at the bottom. Once selected, the placement group will be deleted, removed from the list and all associated line items will no longer be placed on any specific group.

To place your ad check the placement group with desired settings and click at "Save, Go To Next Tab" below the form.

Create Placement Group

A new placement group can be created by clicking at the 'New Placement' button under Placement sub-tab of the line item form.

NOTE: Only Users with “Can Create Placement Group” permission enabled are able to create placement groups containing any placements they want.

Placement by Content Vertical is available to users with “Can Place by Content Verticals” permission only.
Placement by Network/App/Zone is available to users with “Can Place by App and Zone” permission only.

In the appeared window enter the name for the new placement group to identify it later among the others existing in the network. Set it available for any line items in the network and its subnetworks by enabling the "Network-wide" option. Leave it unchecked if you do not wish to. It will be created for the user the order belongs to. NOTE: The "Network-wide" option can not be changed (checked/un-checked) after the placement group is saved.

Placement by Network/App/Zone
An ad can be placed on a desired network, app or/and zone explicitly.
  • Specify the desired placement setting.
A window appears where you are able to do your placement settings. Apps and zones are viewed in a tree structure together with their IDs. By default networks and subnetworks are seen and are expandable for their child apps and zones by clicking at “+” next to the subnetwork/app in interest. Select the network/app/zone you with your ad to be shown on.
Placement can be set as Run of Network and Run of App, that is explicit checking of a parent network/subnetwork/app implicitly checks its child apps and zones.
Along with RON/ROA selection the negative placement of individual zone or app IDs is possible. For that please click at the name of the app/zone you would like to exclude from RON/ROA selection.
Large number of apps and zones display is supported due to pagination (for Subnetwork and App lists) and vertical scrolling (for Zone list).
  • Filtering
The network map can be filtered by network OR app OR zone OR app IDs OR zone IDs.
  • Apps, zones and networks can be filtered by text.
Additionally, zpps can be filtered by content verticals and by the ability to serve 3rd Party Ad Feed Line Items or Marketplace Line Items.
NOTE: The appearance of 'marketplace enabled' and 'mediation enabled' filter options is controlled by corresponding permissions that can be enabled in the Manager profile.
  • Filtering by app ID or zone ID requires full ID to search by.
  • The “Choose action” drop-down allows the user to select or un-select the filtered results.
Site/Zone placement
  • “Choose action” drop-down allows to select or un-select the filtered results.
App/Zone placement
Placement by Content Verticals
Alongside with explicit placement on Networks/Apps/Zones a placement group may contain the Content Verticals Placement settings made at the "Content Vertical" sub-tab.
In case an ad is placed by content verticals it will be shown on those zones that have either of these content verticals in settings (unless these zones are excluded from the placement targeting).
While working in the super-network the ad can be shown on the apps and/or zones of the super-network as well as of its sub-network(-s) with the specified content vertical(-s).
  • Choose "All" or select several content verticals in the list.
Content Verticals placement
  • Apps the targeted content verticals affect become checked and marked with "Content Vertical Selected" on the Placement Targeting tab if they haven't been excluded before.
    App/zone exclusion is supported regardless if the placement was targeted indirectly through its parent in placement targeting or its content vertical.
Placement Exclusion
Placement Settings Implementation
Ad Serving decisions based on your Placement Targeting will use the following logic:
  • Placements (Networks/Apps/Zones) and content verticals will use - OR between the Placements and Content Verticals (e.g. when placed on App1, Zone2 and a Content Vertical that is defined for Zone3, an ad can be shown on App1, OR Zone2, OR Zone3).
  • Included placements will use- OR between the included placements, (see the example above).
  • Excluded placements will use-
AND NOT between the included and excluded placements, e.g. When placing an ad on Run of Network X and excluding some of the apps/zones, the ad will be shown on all apps/zones of the Network X AND NOT the excluded ones.
OR between the excluded placements themselves, e.g. When multiple placements are excluded, the ad will not show on excluded placements A, or B, or C.
  • Included and Excluded placements will use- AND, e.g. If the two previous options are applied to one placement group, an ad will be shown on App1, OR Zone2, OR Zone3, OR Network X, AND not on the excluded apps/zones.
In general, if the targeted apps, zones, and 2 content verticals are all inclusive placement items, the line item will run on the apps and zones explicitly targeted, and on the zones of apps that belong to the specified networks and have either of those 2 content verticals. If one of the content verticals has a zone which is excluded from the placement settings the ad will not be shown on that zone.


Orders in the super-network placed on specific content verticals can show ads on the apps and/or zones that belong to the super-network as well as those that belong to the sub-network(-s) with the specified content vertical(-s). If needed exclusions can be implemented to prevent this.
Save Placement Group

A placement group can be saved in two ways:

  1. Save the made settings for the newly-created placement group by clicking at the "Save Placements Settings" button at the bottom of the placement settings window. In this case the placement group is saved as unnamed and appears in the list of placement groups as [Custom placement]. It can be used once and will not be available for further use.
    Custom Placement Group
  2. Save the placement group by clicking at "Set as new preset" at the top of the window to be able to use it next time.
    set as preset
    Then enter a name for your placement group to identify it among others later and click at the "Save Placements Settings" button to save it to the library. To make your group available for other users in the network enable the "Network-wide" option for the new group.
    Name the Placement group
NOTE: The saved group is available for the line items only within that network it has been created in. It will not be available for sub-networks (if any exist and the group is created in the super-network) or for the super-network in case it is created in a sub-network.

Blocking/Invalid

Under this sub-tab the user is able to filter out apps by domain in order to prevent the ad from showing on them. Besides, the invalid settings for the line item can be made here.

The default form looks as shown below:

Blocking/Invalid sub-tab
  • Domain Blocking
NOTE: Advertiser/Manager can use Competitive Domain Blocking functionality if he has the respective permission enabled.
Competitive domains to block ad serving on can be manually typed into the box and added one by one, or added at once by uploading a CSV file.
NOTE: Each domain should start with http:// or https:// !
Domain Blocking
A domain can be deleted from the list by choosing the corresponding action from the drop-down opposite to the domain in interest.
There is an option to delete several domains at a time by selecting the domains in interest in the list and choosing the 'Delete' action from the drop-down below.
  • Invalid Settings
Invalid settings can be set at the line item level by users granted the "Can Edit Invalid Settings On Line Item" permission.
Available invalid settings:
  • IP Check - checks if the IP address of the click matches the IP address of the impression the click came from. If not, the click is stored as invalid.
  • UA Check - checks if the user agent (UA) of the click matches the UA of the impression the click came from. If not, the click is stored as invalid.
  • Recheck - Will re-check the targeting on the campaign against the targeting on the click. If they don't match the click is marked as invalid.
  • Double click - The first click is recorded as legitimate, but the duplicate click or clicks are marked as invalid.
  • Double Action - The first action is recorded as legitimate, but the duplicate action or actions are marked as invalid.
For more information see Fraud Detection page.
If any default invalid settings are set at the 'Add/Edit Advertiser' form they will appear in this section as active by default. But in case no advertiser's default invalid settings are set, the network's default invalid settings are inherited by the line item(-s).

Delivery

The line item will be delivered during the period specified in the date range of basic settings. But the Delivery Tab allows to customize the delivery settings for your line item and set more caps. For Line Item with Direct Creative source when firstly accessed the screen will appear as below:

Delivery Default Type

Fill in the form with the following information:

Goal & Price – Allows to set the desired pricing model (CPM, CPC, CPA) for the line item and set the cost (in dollar equivalent).

Goal&Price
Bid Price Information


CPA Optimization

NOTE: The CPA optimization functionality is enabled for users with the 'Can Set CPA Optimization Limits' permission.
CPA Optimization functionality allows for optimization of line item delivery to increase conversions in attempt to meet CPA goals.
Once the CPA bid price is selected on the Delivery tab, the CPA Optimization check-box appears below. Enable the "Specify CPA optimization" option to view the form below:
CPA Optimization
Set the number of impressions, clicks and the default eCPM for seeding period.
NOTE: The amount of impressions can not be less than 1000, but can be more.
The specified amount of impressions and/or clicks will be used by the system as a baseline before optimization starts. Optimization starts once impressions number reaches 1000 AND at least one of the specified clicks or impressions min limits is reached.
The Default eCPM for seeding period is the initial eCPM for this line item. The eCPM value will be recalculated for this line item based on real statistics (it appears as one of the set limits is reached).

Fees

NOTE: The option is available for Network Owners/Managers only in case the "Can Use Line Item Fees" permission is granted to them.
Fees can be deducted from the price that runs across the publisher app to allow for markup. Fees can be deducted from the gross (before deduction) or adjusted gross (total gross after deductions).
Under "Goal&Price" a "Fee" option can be enabled in order to subtract the fee's total price from the line item CPM.
The fee option is available for CPM and CPC bid types.
Once it is checked, the form to set fees appears.
In the drop-down select among the types and click on "Add" to add the fee type to the list of fees applicable to the Line Item price where settings for fees can be re-defined.
Goal&Price Fees
NOTE: The list of available fee types is determined by those enabled in the Network Settings Profile of the Control Panel.
In the "Goal & Price After Fees" box the end price is automatically recalculated for the fees subtracted from the set bid price by the following fashion.
 Goal & Price After Fees = Goal & Price - Fees (Applied to Gross) - Fees (Applied to Adjusted Gross)


For Line Item with 3rd Party Ad Feed source the Line Item eCPM is available instead of "Goal&Price" option. It allows to set manual eCPM for the line item so a user could define an eCPM value for Ad Networks which do not have integrated reporting, and those that want to override any system generated value.
Manual ad feed line item eCPM
Enable the "Manual eCPM" check-box and enter the desired value.
In case the eCPM is not set manually, it will be calculated by the system as an average value of Default Auto-optimized eCPM of the ad feed creatives that belong to the line item. Default Auto-optimized eCPM values for 3rd Party Feeds can be set at Network Settings Panel.

In accordance with the selected pricing model and the specified price the ad is paid for by the advertiser till the budget is depleted. Once the budget limit is reached the ad stops serving.

Priority Type - You have an opportunity to set different priorities for your line items by setting Priority Types.

Priority type
  • Sponsorship
  • Ranked Priority
  • Fixed Percentage
  • Performance Based
  • Backfill

Total Limits and Daily Limits for Impressions, Clicks, Actions and Budget.

"Unlimited" is enabled by default. That will let your ad continue indefinitely until you have zero balance in your account or the end date of the line item is reached.
To set the limits enter the desired values into the boxes.
Limits
Total limits are set for the whole period of the ad activity.
  • Total Impressions - is the maximum number of ad shows allowed during the ad serve period for this line item. Once the limit is reached, the ad stops serving.
  • Total Clicks - is the maximum number of ad clicks allowed during the ad serve period for this line item. Once the limit is reached, the ad stops serving.
  • Total Actions - is the maximum number of user actions registered for the ad serve period for this line item. Once the limit is reached, the ad stops serving.
  • Total Budget - is the total amount of money in dollars for the ad delivery. Once the limit is reached, the ad stops serving. The value should be of the format 1000.00.
In accordance with the values specified for total limits you may set daily limits for your ad delivery.
Daily limits are set for a day period of the ad activity.
  • Daily Impressions - is the maximum number of ad shows allowed per a day for this line item. Once the limit is reached, the ad stops serving for this day.
  • Daily Clicks - is the maximum number of ad clicks allowed per a day for this line item. Once the limit is reached, the ad stops serving for this day.
  • Daily Actions - is the maximum number of user actions registered for the ad per day. Once the limit is reached, the ad stops serving for this day.
  • Daily Budget - is the amount of money in dollars for the ad delivery per a day. Once the limit is reached, the ad stops serving for this day. The value should be of the format 1000.00.
NOTE: In case the Smooth Delivery feature is enabled, the daily limits become not editable and are calculated automatically.
NOTE: Daily limits cannot be set for line items with the Sponsorship priority type. Sponsorship line item can adhere to the Order level daily limits only.
When multiple caps specified the ad is delivered up to the moment one of the limits is reached.
NOTE: When setting multiple limits make sure the specified values do not contradict each other. For instance, daily limits should not exceed total limits.

“Smooth Delivery” check box enables the smooth delivery functionality for the ad if checked. This allows to calculate daily limits using efficient algorithms.

Once enabled, the Smooth Delivery feature allows to run the ad evenly through its end date. In accordance with the ad date range and total limits set the daily limits are calculated automatically to optimize the daily ad delivery through out its active period and maximize the impact.
NOTE: It can be enabled if the three following requirements are met:
  • Dates are specified;
  • At least one total limit is set;
  • Priority Type is not Sponsorship.
Smooth delivery
Showing advanced preferences you may choose a catch up method to be used and the type of the last hour/day delivery.
Catch Up Method
You are allowed to choose a scenario as you wish: Slow Catch Up or Quick Catch Up.
  • Slow Catch Up scenario is intended for line items that ads are desired to be delivered smoothly over time even for the remaining time period. It has the following features:
• Delivery limits are recalculated daily on the base of the remaining time period and remaining number of Impressions/Clicks/Actions/Budget.
• This approach gradually increases a pace of delivery that allows avoiding spikes in delivery in case the line item fell behind the schedule.
  • Quick Catch Up scenario is intended for line items desired to catch up to original delivery goals when behind. It has the following features:
• Planned trajectory is calculated based on Start/End dates of the line item and Total Impressions/Clicks/Actions/Budget values.
• Daily limits will be set to the total Impressions/Clicks/Actions/Budget needed to quickly catch up.
• This approach may cause spikes in delivery.
End Of Line item Delivery
You can choose a type of the last hour/day of the line item delivery: Hold Smooth Delivery or Disable Smooth Delivery.
  • Hold Smooth Delivery features:
• The whole delivery period is counted for hourly/daily limits calculations without any reservations.
ADVANTAGE: this approach guarantees smooth delivery for the full period of time.
DISADVANTAGE: last hour limits sometimes won’t be reached and the line item will end not delivered in full.
  • Disable Smooth Delivery features:
• Last 10% (no more than 24 hours) of the delivery period is reserved to ensure full delivery and is not counted in smooth delivery limits calculation.
• If the line item has not been delivered in full yet as 90% of delivery period is over, the system uses the remaining time to ensure full delivery by removing all hourly/daily limits.
ADVANTAGE: if there are enough inventories for the line item, this approach guarantees full delivery for the line item.
DISADVANTAGE: smooth delivery is guaranteed only for 90% of the time interval.

Frequency Capping determines the frequency of ad shows for a defined period of time. This feature allows to limit a number of ads desired to be shown per a certain period of time by setting frequency capping limits.
NOTE: Frequency Capping can be set at the line item or creative level. If both are defined, the creative level frequency capping is used. If defined for a line item and a single creative, the creative will use it's Frequency Capping, while the remaining creative impressions are applied to the line item frequency capping.

Set the desired number of shows per a period of time. Click "+" to save the entered data.
You may set several frequency capping limits. Make sure the specified caps do not contradict each other and are in line with total/daily limits set for the line item.
Frequency Capping


Direct Request
Select from the drop-down if you wish your ad to be available by direct request:

  • Enabled - serve ads by direct request (exposes 'GET URL');
  • Disabled- serve ads any time they are eligible.
Ad Mode

Creatives

This tab is available only if the Line Item Source is a Direct Creative. The Creative tab contains 2 panels, the left one for creative management and the right one for creative settings (to view or edit).

NOTE: Creative Management availability is determined by corresponding user permissions.

You can click "New Creative" to create a new creative or choose a template from the library to view or edit its settings.

Creative default screen
New Creative
To create a new creative click "New" at the top-right corner. A form will appear at the right panel where you should specify the following information:
Creative Name - Specify the name for the new creative.
"Copy to Library" check-box - Allows to you to save the creative to the library for further use.
Creative Type - Choose a creative type from the drop-down selecting among:
  • Text Ad
Creating a Text Ad
  • Graphic Ad
Creating a Graphic Ad
  • RichMedia Ad
Create a Richmedia Ad
Click-thru URL - Specify a click-thru URL here.
  • Select "Don't click thru" if there is no URL to specify.
NOTE: A click thru URL must be defined when using %LINK% in the code for richmedia.
  • Select "External landing page" if the creative should click-thru to an external page.
  • Select "Hosted landing page" if the creative should click-thru to a Mocean-hosted page. Choose from the drop-down a landing page you need or select "New Landing Page" to create a new one.
Frequency Capping - Set the number of shows for the creative per a period of time.
NOTE: Frequency Capping can be set at the line item or creative level. If both are defined, the creative level frequency capping is used. If defined for a line item and a single creative, the creative will use it's Frequency Capping, while the remaining creative impressions are applied to the line item frequency capping.
Tag this creative - Tag your creative for identification (optional). To add new creative tag, enter the data into the tag field and click ’Add’.
Enable Pixel Tracking
Having this option enabled, you are able to deliver all creatives within the campaign with a 1x1 img pixel tracker. An impression is counted only when this pixel is rendered on the end mobile device.
"Preview" button shows a preview of your ad in a pop-up window. Select a device from the drop down to view how the ad is displayed on that device.
Image preview
NOTE: The preview function is not available for rich media ads.
When all the settings are made click "Save Creative" at the form bottom.
Save Creative
Creative Management
At the left panel of creative tab you can find 3 sub-tabs that allow to manage your creatives.
Under "Creatives" sub-tab all creatives saved for this line item are listed.
They can be searched through the search box. Enter a term, creative name, etc. to quickly find the desired creative in the list.
Delivery - Specify the type of the ad delivery choosing among the options:
  • Even - Even delivery Creatives are all given equal distribution, and will deliver evenly or as close as possible over the life of the line item.
  • Weighted - The ad delivery is weight based.
Weighted delivery Creatives are all given their own individual weights (values from 1 to 100 are allowed), which are calculated against the total creative weights to determine what percentage of total ad request traffic each creative will receive from that line item. The system uses these weights to create a percentage chance for each creative to be selected within a line item. The delivered impressions will generally match this weight, but may differ due to varying ad sizes availability for each creative.
Weighted creative
If weighting is used, those creative with the same weight will have the same percentage of traffic. Those with higher or lower weight will have more or less traffic, and how much more or less depends on how many creatives are in the line item and on the distribution between them. The simple math around weighting is:
 (Creative Weight 1) / (Total Weight/100) = (% of Line traffic to Creative 1)
(Creative Weight 2) / (Total Weight/100) = (% of Line traffic to Creative 2)
(Creative Weight 3) / (Total Weight/100) = (% of Line traffic to Creative 3)
Sample calculations illustrate how the traffic is distributed among the creatives.
Weight
Creative 1 75
Creative 2 50
Creative 3 25
Total 150


Creative 1 gets 75/(150/100) = 50 % of Line Item Traffic
Creative 2 gets 50/(150/100) = 33.33 % of Line Item Traffic
Creative 3 gets 25/(150/100) = 16.66 % of Line Item Traffic
To edit the weight value click on it in the grid and enter the desired value in the pop-up window. Click "Save" to implement the edits.
Edit creative weight
  • Performance (CTR) - The ad delivery is CTR based.
Performance delivery Creatives are served based on their CTR performance, which uses daily statistics for the current day. The creative that performs the best will be served most often, but we do select the lesser performing creative from time to time so they can garner some traffic and potentially improve their performance over time
Check up a creative in the list to view its settings at the right-hand panel. From the loaded form the creative can be started or paused by clicking at "Run/Pause" button in the 'Creative Status' section.
View Creative
Make the necessary settings and click "Save Creative" below the form to save the changes.
You can delete the selected creative clicking at "Delete" button at the bottom-right corner and confirming your intention in the pop-up window. This creative will appear under "Deleted" sub-tab. It can be restored from this tab for further serving (see below).
Delete Creative
Creative Library
Under "Library" sub-tab creatives created with "Copy to Library" option enabled are listed. Here you may find the templates to create creatives on the base of.
NOTE: If a template is created in the super-network, it can be available in subnetworks.
Under the "Library" tab a user can view and manage only the creative templates of his own orders i.e. creative templates created under the orders the user is assigned as an Advertiser to.
Network Owner/Manager can see all the templates created in the network. In the Library for Network Owner/Manager a template name is accompanied with an "owner" name i.e. the name of an advertiser assigned to the order the template has been created at.
Advertiser's Name for Creative Template
The necessary template can be searched out through the search option. Enter a creative name to quickly find the desired template in the list.
Check up the creative in the list to view/edit its settings at the right-hand panel and create a new creative on its base.
Click "Delete Forever" to delete the template without a chance to restore it later.
Delete Creative Template
Deleted Creative
If any creative has been deleted, it appears under "Deleted" sub-tab. Creatives listed here can not be viewed/edited till they are restored. Click "Restore" opposite the creative in interest and confirm your intention in the pop-up window.
Deleted Creative to restore
Now the restored creative can be found under "Creatives" sub-tub and it is available for management.

Ad Feed Settings

The tab is available only in case the Line Item Source is a 3rd Party Ad Feed. Under the "Ad Feed Settings" tab you are able to create an external creative (an ad feed configuration) as well as edit/run/pause/delete/undelete the existing ones. The tab consists of two parts: at the left-hand panel ad feed configurations can be managed; at the right-hand panel ad feed configuration settings can be viewed/created.

Create Ad Feed Settings

To create a new ad feed configuration click at "New" or choose a template from the library sub-tab to create the external creative on the base of the existing settings.

At the right side the ad feed creation form appears.

To make the settings proceed with the following steps:

Step #1. Select an ad feed from the list. To speed up the search process use the "Search" option above to find an ad feed by its name, Ad Network name or a tag in the list. Use paging below or extend the number of items shown at the page to view the full list of ad feeds. Click "Next" at the bottom to move to the next step.
Step 1
Step #2. Fill in the form for this ad feed. Each feed requires different levels of account information, so it will be necessary to create individual accounts with each of the networks and add the information in the Feed Manager. Line Item approval and reporting will be done on an individual network basis, and login to the individual networks is required for these features.
For an ad feed specify the following:
Ad feed name - Enter a name for the ad feed.
Copy to Library check-box - Copy the template of this ad feed to the library for further use if necessary.
Enter the account information. Each feed requires different levels of account information. What information is required for each Ad feed partner you can find at the Ad Feed Parameters page.
Ad Feed Parameter - If you are granted the "Can Edit Ad Feed Parameters" permission, you are able to manage outgoing ad feed parameters that will be added to/replaced in/deleted from a request to the external network. List of ad feed parameters is set by account manager at the Network Settings for each ad feed type. Users are also allowed to use MACROs for ad feed parameters values. Please, find the detailed information at the Ad Feed Translation Level page.
Frequency Capping - It is available to limit a number of ads desired to be shown per a certain period of time by setting frequency capping limit.
Select Plus to save the entered limit. Additional limits are allowed to set.
NOTE: Frequency Capping can be set at the line item or creative level. If both are defined, the creative level frequency capping is used. If defined for a line item and a single creative, the creative will use it's Frequency Capping, while the remaining creative impressions are applied to the line item frequency capping.
Reporting Credentials - Select appropriate reporting credentials from the drop down if any exist for this ad feed in the network. These are ad feed configurations created under "Edit external reporting feeds" option of the Network Admin Panel.
Tag This Ad Feed - Tag this external creative for identification (optional). To add new creative tag, enter the data into the tag field and click ’Add’. To delete the tag previously created, click on the tag.
Enable Pixel Tracking - Check the box to enable pixel tracking for the creative. Having this option enabled, you are able to deliver all creatives within the line item with a 1x1 img pixel tracker. An impression is counted only when this pixel is rendered on the end mobile device.
Once the form is completed click "Save Changes" at the bottom to save the creative. After saving it appears in the list of ad feeds at the left-hand panel.
Step 2
Click "Back" to get back to the first step and select another ad feed.
Manage Ad Feed Settings

After saving the ad feed appears in the list of existing ad feeds at the left-hand panel.

To view and, if necessary, change ad feed settings select it in the list. From the loaded form the creative can be started or paused by clicking at "Run/Pause" button below the ad feed settings name. Perform other updates if necessary and click at "Save Changes" to save the settings.

View an ad feed
Ad Feed Library

In case an external creative is saved with the "Copy to Library" option enabled it appears under the "Library" tab. It can be used further as a template for other ad feed settings creation.
Select an external creative template in the list to get the setting form in the right-side panel.

Ad Feed Library

Make the necessary changes and click "Save Changes" to save a new external creative. It will appear under the ad feed tab.

An ad feed template can be deleted from the library beyond recovery.

Delete a template
Deleted Ad Feed Settings

To delete an ad feed configuration click select it in the list and click at "Delete" below the table and confirm your intention in the pop-up window. A deleted ad feed configuration appears under "Deleted" sub-tab. Any time you can get back to it and restore it if you wish by clicking at "Restore" opposite the ad feed configuration in interest. The searching option is available here as well to speed up the process of searching for a desired external creative.

Deleted ad feeds

Review

The final step is to review your order information before saving. Under "Review" tab all the information on the line item is summarized.

Order Information allows to view the main information on the order the line item belongs to.

Order Review

Line Item Information section contains the main basic information on the line item.

Line Item Review

Targeting section shows the targeting settings made for the line item.

Targeting Review

Placement section contains the placement settings made for the line item.

Placement Review

Domain Blocking enumerates all competitive domains specified for blocking, if any.

Domain Blocking Review

Delivery allows to view the delivery settings - Goal&Price, if the ad is available by direct request only, its total and daily limits. A link at the top of the section brings up a forecasting report for the line item. For line items with the "Set as Held Ad" option enabled the Held Expire Date can be reviewed here at the bottom of the section.

Delivery Review

Creatives allows to view the list of creatives with their delivery method.

Creatives Review
For the line item with enabled Direct Request option you may get information on Image URL, Click URL and Click Tracking URL for each creative. Click on "Get URL" next to the creative in interest. In the appeared pop-up window choose the placement you would like to get URL's for.
Creatives Review - Get URL
NOTE: Click Tracking URL works only for line items with NO targeting assigned. This particular URL was built on the assumption that Publisher will first check targeting before sending Click Tracking URL.

Approval section allows users to set to approve or decline a line item.
NOTE: This section of the Review tab is available to users who have the appropriate permission only.

Select Pending if the line item needs other user's approval.
You may approve the line item if it is checked.
If you decline a line item, a decline reason must be provided in the modal window. In this case a Line Item Notification Email will be sent to the user informing him that the line item has been declined with the reason.
Approval Check-box

If any changes are needed get back to the corresponding tab and update the settings. Do not forget to save them.

It is available to print the information from the Review tab. For this click at "Print" below the grid.

Quick Summary

All the line item settings are summarized under the Quick Summary panel at the right side.

Quick Summary

When clicking at a section name the main information can be viewed below:

Order Summary including its name, advertiser, start and end dates, ad mode (if it is in test mode or not).

Line Item Summary including its name, type, source, star and end dates, ad category.

Targeting including the targeting group the line item is targeted for. To view the targeting settings hover your mouse over the targeting group name and the information will appear in the pop-up window.

Placement including the placement group the line item is placed on. To view the placement group settings hover your mouse over its name and the information will appear in the pop-up window.

Domain Blocking including the list of blocked domains for the line item.

Delivery including the goal type and its price, daily and total limits for views, clicks, actions, budget, line item priority type.

Creatives including the pixel tracking information and the list of creatives under the line item. For a line item of the 3rd Party Ad Feed type this tab of the Quick Summary section is named "Ad Feeds" and contain the list of ad feeds of this line item.


Save Line Item

As soon as all the settings are made and reviewed click "Save and Start" at the right-bottom corner to finalize the process of line item creation and launch it. If the user have permission to approve line items and the line item is approved, it will be launched and the "Edit Order" screen will appear with the new line item included into the list of existing line items below.

If the line item needs approve it will be saved as a Pending line item.

If the process of the line item creation hasn't been completed yet or any changes are needed, click on ‘Save’ to save the made settings and continue line item creation later.

Before saving it is available to add a comment to the savings. Click at "Include comment" at the left-bottom corner of the form and enter the information in the pop-up window, then submit and save the line item. It will be reflected in Comments for the log under the Logs tab. Click "Close Window" to close the comment window without saving the comment.


A newly saved Line Item is available at the Manage Line Items tab in the list of "Saved" line items as it is not launched yet. How to start a line item as well as pause it, edit, copy or delete and perform any other action on it is described in the Manage Line Items section below.

Manage Line Items

Once a line item has been created it can be managed using the Manage Line Items panel. The Manage Line Items tab allows to view and manage the existing line items. The screen under this tab appears as shown below:

Manage LI default screen

Here you can run and pause line items, edit or delete the specified line items, overview line item's creatives as well as get the fast access to ad hourly/daily/monthly reports.

When it is reached at the first time, the running line items only are visible.


The following information is available under this tab:

  • Line Item Name - the name of the line item,
  • IO - the number of insertion order if assigned to the line item's order,
  • Start date - the date the line item delivery starts,
  • End date - the date the line item delivery ends,
  • Advertiser - the name of the advertiser, the order is assigned to,
  • Budget - the line item's budget specified under the 'Delivery' tab,
  • Budget Spent - the budget spent to the line item (is calculated basing on the 'Goal&Price' value set under the 'Delivery' tab),
  • Pacing - the pacing report on line item delivery. The values (% Delivered/ % Expected) show what % of the line item has been delivered to date and what % of delivery should be at the current moment in order to deliver in full. The on-schedule status is determined with a color:
  • Pacing red Red - 15% ahead or behind the Expected Pace,
  • Pacing yellow Yellow - 5-15% ahead or behind the Expected Pace,
  • Pacing green Green - 0-5% ahead or behind the Expected Pace.
  • eCPM - (effective cost per thousand impressions) earnings from every 1000 ad shows; eCPM value is calculated on the base of the statistic data:
    eCPM = 1000 x Total Revenue / Imps
Thus, the eCPM is not available in the grid (N/A) until the ad starts serving and statistic data is generated.
As soon as the statistics data appears, the eCPM is shown as calculated in the following way:
For direct line items with CPM value specified as a bid price under "Delivery" tab this value is shown for eCPM in the grid.
For line items with specified CPC or CPA value as a bid price the eCPM is calculated as
eCPM = CPC x CTR x 1000
or
eCPM = CPA x CTR x 1000
In case the calculated eCPM value is too small (less than 0.0001) the minimum allowed eCPM of 0.000001 is set by default.
For 3rd party line items eCPM value is shown as Line Item eCPM manually specified under the "Delivery" tab. Manual eCPM can be edited from the "Delivery" tab of the line item or right from the "Manage Line Items" grid by clicking on the eCPM value and entering a new on in the pop-up window.
Edit Manual eCPM
In case no manual eCPM is specified under the "Delivery" tab for a 3rd Party Line Item it is auto-calculated on the base of the statistics data for the line item (for all its ad feed creatives).
NOTE: For 3rd Party Line Items the eCPM is recalculated on the base of the statistic data for the previous day.
  • Alerts - the notification for the line item. In this column the icon File:Alerts_icon.png appears to inform a user of the line items limits reached or the balance low. To view the message hover your mouse over the icon and read the information in the pop-up window:
  • "The Advertiser balance is zero. Please add funds." - appears in case the advertiser balance tends to its minimum (0 by default).
  • "Line Item has not yet started. It is before the start date." - appears for an approved, saved and started line item the start date of which is in the future. It is saved as a running line item but it will start serving at the specified date in the future.
  • For reached limits:
  • "Total limit of clicks reached."
  • "Total limit of impressions reached."
  • "Hourly limit of clicks reached."
  • "Daily limit of clicks reached."
  • "Hourly line item budget reached."
  • "Total line item budget reached."
  • "Daily line item budget reached."
  • "Hourly limit of impressions reached."
  • "Daily limit of impressions reached."
  • "Placement is not defined."- appears in case no placement set for the line item.
  • Order - the order the line item belongs to,
  • Actions - the list of actions to apply to the line item (see below).


Filtering

The list of existing line items can be sorted by line item status:

  • Running - Campaigns that have been launched and can be shown at the moment;
  • Paused - Campaigns that have been launched and then paused by a user, or launched ads that are before a start date;
  • Pending - Launched ads waiting for a user approval;
NOTE: A user can approve or decline a line item if he has a permission for this. How to set user permissions is described at User Permissions Profile.
  • Declined - Launched line items declined by a user responsible for line item approval;
  • Completed - Ad delivery has already finished due to one of the following reasons:
• the expiration date has come;
• the line item total clicks/views limits have been reached;
• the budget limit of the ad has been reached.
  • Saved - line items that have been saved but not launched yet;
  • Held - line items with the 'Set as Held Ad' option enabled; these line items are not running at the moment but expected to run (and require some inventory) in future. After the held period has expired (14 days or other period set in the Network Settings), if the line item hasn't been run, the ‘held’ check-box is reset to off, and the line item becomes Saved.
  • Deleted - line items deleted by a user; these ads can be restored, though, by selecting the 'Undelete' action.
NOTE: When exporting a CSV file, the line item statuses are more detailed and not in strict adherence to the ones in UI. In the exported CSV you may find the following statuses for line items:

"None" - stands for active running line item(-s) with no special notifications,
"Pause" - for paused or saved or held line item(-s),
"Deleted" - for deleted line items(-s),
"Unapproved" - corresponds to pending line item(-s) that have been saved and launched but need other user's approval,
"Balance" - notifies the line item's advertiser balance is depleted,
"NullPlacement" - notifies that placement settings are not specified for the line item(-s),
"BeforeStartDate" - stands for saved and started ad(-s) with the start date in future (in UI it is with 'Running' status).
"AfterEndDate" - for completed line item(-s) with expired date.
"MaxShowsHour" - notifies the line item has reached its hour limit for impressions,
"MaxShowsToday" - notifies the line item has reached its daily limit for impressions,
"MaxShowsOverall" - notifies the line item has reached its total limit for impression (in UI it is with 'Completed' status),
"MaxClicksHour" - notifies the line item has reached its hour limit for clicks,
"MaxClicksToday" - notifies the line item has reached its daily limit for clicks,
"MaxClicksOverall" - notifies the line item has reached its total limit for clicks (in UI it is with 'Completed' status),
"MaxMoneyHour" - notifies the line item has reached its hour limit for budget,
"MaxMoneyToday" - notifies the line item has reached its daily limit for budget,
"MaxMoneyOverall" - notifies the line item has reached its total limit for budget (in UI it is with 'Completed' status).

Sorting by Line Item Name, IO number, Start/End Dates, Advertiser and Budget is available as well in the list.

To speed up the searching of the necessary Line Item the filter option can be used. Filter line items by the name. To reach more filtering parameters click “Advanced” and specify those you wish to filter the line items by:

  1. Choose Active Period. Custom Range is chosen by default. Set 'Begin' and 'End' dates using the pop-up calendar. Or choose any other period from the drop-down list.
  2. Specify an Advertiser entering his ID, email address or name.
  3. Specify IO Number to filter the necessary line item.
  4. Specify Order ID Number to filter the line items belonging to the explicit order.
  5. Specify Order Name to filter the line items belonging to the explicit order.
  6. Specifiy Line Item ID Number to locate the line item with a specific ID.
  7. Specify Line Item Source - to filter out the line items of the desired source - Direct Creative or 3rd Party Ad Feed.
  8. Specify Creative Tag to filter the line items containing specific creatives.
  9. Specify Network Name to filter the line items belonging to the explicit network (available for super-networks).
  10. Specify Network ID Number to filter the line items belonging to the explicit network (available for super-networks).
Sorting LIs

Click Reset to drop all the filtering settings and change them if you wish.

A newly created line item is set as Pending by default when created by a user with no permission to approve line items. It can be Approved/Declined by an Advertiser or a Network Manager or by any other user having such permission.

NOTE: How to set the permission so that a user could approve or decline an ad see User Permissions Profile


Actions

The following actions can be applied to a line item:

LI Actions
Edit

To edit the line item click on its name or choose Edit from the 'Actions' drop-down. You will be moved to the line item form to edit the necessary settings. When all the changes are made click 'Save' to save the line item.

Copy

A new line item can be generated on the base of the existing one using 'Copy' action. You will be moved to the line item form. The new line item inherits all the settings of the parent line item. These settings can be edited if needed and saved.

Pause/Resume

From the "Manage Line Items" page the line item can be set Paused or Resumed (started) by choosing the corresponding action from the drop-down. NOTE: This action is available for approved line items.

Review

To view the information concerning the order, the line item, its targeting and placement settings, delivery and other settings click at the "Review" action and view the result in the pop-up window. In the modal window you can change the lie item's status

Creatives

The creative review option is available from the "Manage Line Items" tab. Selecting the "Creatives" action from the drop-down allows to view the data on creatives existing under the chosen line item. View their name, type, click-thru URL, weight, frequency capping, scaled images (if it is a graphic ad) in the pop-up window. It also allows to manage creatives. Opposite the creative in interest in the "Actions" column select the desired action from the drop-down: you can pause/run the creative, delete it. If deleted, it appears in the list of deleted creatives where it can be restored from.

Logs

To view the latest updates to the line item choose "Logs" from the actions drop-down. You will be moved to the change log tab to view the information on the changes applied to the line item.

Report

This action allows to get the report on the line item activity. You will be moved to the "Custom Report" tab to view the data for the whole line item flight period till the current day.

Delete

To delete the line item click on "Delete" opposite to the line item in interest. It is possible to undelete it through the 'Actions' drop-down as well.

NOTE: A deleted line item is restored with the same status that it has been deleted with. For instance, if non-approved line items have been deleted with Pending or Saved statuses they are restored as Pending or Saved line items. An approved line item with Paused status is restored as a Paused line item. The only exception is a running line item. When an approved Running line item is deleted and then restored it acquires the Paused status.

An action can be applied to several line items at a time by ticking them in the list and then choosing an action from 'Action' drop-down below the grid to implement to the selected: Run, Pause, Delete, Undelete.

NOTE: It is possible to restore line items of deleted orders. In this case the order will be restored together with this only line item. A message appears to inform you of that the order this line item belongs to is deleted and you are offered to confirm your intention to restore the order together with the line item.

The Line Items list can be downloaded in CSV format to your computer. Click “Export CSV” below the existing Line Items list and wait for a while to get the file to view/save it to your computer.

Export Line Item ListBETA

The Line Items list can be downloaded to your computer. Click at "Download" below the grid. Then select the format you wish from the drop-down: CSV, XLSX, TSV, XML, or HTML.

Insertion Orders

"Manage Insertion Orders" sub-tab allows to create new insertion orders as well as view and adjust the existing ones.

Default screen for manage Insertion Orders

NOTE: To be able to use insertion orders for payment ‘Manage Insertion Orders’ permission is to be enabled for a certain network manager (see User Permissions Profiles).

Create Insertion Order

At creating an insertion order fill in:

  • Advertiser - select an advertiser from the drop-down to be invoiced by this insertion order.
  • Specify the amount of money.
  • Choose a Salesperson from the drop-down.
If the salesperson in interest doesn't exist in the network, he can be added by clicking at "Add New" next to Salesperson select-box and filling in the appeared form.
Propagate the Add Sales Manager form with data (network - if you are in super-network, e-mail, first name and last name) and click at "Save".
Add New Salesperson
  • Choose an Account Manager from the drop-down.
If no account manager exist in the network click on "Add New" to create an account manager.
In the appeared form enter the information on the account manager and click "Save" to save the data.
Create Account Manager
  • Upload a file of Insertion Order.
  • Save Insertion order.
Save Insertion order

Once the insertion order is added, it appears in the list of insertion orders bellow.

Insertion Orders List
Adjust Insertion Order

The IO Balance can be adjusted by checking the insertion order in interest and clicking at "Adjust IO". Every time IO balance is changed you should proceed the following:

  • Enter the amount of money.
  • Select the action applied to the specified amount: add to the IO balance or subtract from the IO balance.
  • Select a Sales Manager.
  • Select an Account Manager.
  • Upload a file based on that the IO is adjusted.
Adjust IO

When the insertion order is adjusted a new row is appeared in the table, and IO balance for the insertion order that have been adjusted is updated.

IO Adjustment Result
IO Filter

The necessary IO can be promptly selected from the list using "IO Filter" above the table. IOs can be filtered by Advertiser, or/and by Salesperson, or/and by Account Manager, or/and by IO Number. After filtering criteria are set click at "Search" to get the result.

Export Insertion OrdersBETA

The insertion order list with information for them can be downloaded to your computer. Click at "Download" below the grid. Then select the format you wish from the drop-down: CSV, XLSX, TSV, XML, or HTML.

Reports

The Reporting interface for the Mocean for App Stores solution enables the creation of very customized and very detailed reports. The process to create a report is described in detail at Mocean Reporting page.

Dashboard

The Dashboard is the default login screen whether the login is at the Network Manager or the Advertiser/Brand level. The Dashboard provides a quick look into the network activity as it applies to the owner of the account. For example, if the Network Manager logs in, he will see activity over all of the campaigns running in the network. If the Advertiser/Brand logs in, he will see only information as it relates to his campaigns specifically.

Network Manager Dashboard

The Dashboard is separated into several sections: Overview, Messages, Daily Stats, Quick Reports and Orders.

Dashboard Overview

The Dashboard Overview provides a daily, weekly, monthly, quarterly, bi-annual and annual view of the network activity.

Dashboard Overview Time Intervals

The default view shows impressions over all applications for today, but the chart can be updated across any number of time, application and metric parameters to provide any level of desired information. Each application included in the network will appear in the Apps dropdown, and the available metric parameters include impressions, clicks, revenue, CTR, eCPM, Fillrate and Requests.

Dashboard Chart Metrics

To see a quick view of the number of clicks garnered by all the applications in the last month, simply select This Month from the tab at the top of the chart, select Revenue from the Chart metric drop down menu, and then select GO! to run update the graph.

Quick View Dashboard Graph

The data can also be output to CSV for easy dissection and analysis.

Export Dashboard Overview ReportBETA

Downloading the overview report is available from the Dashboard so users can easily download, dissect, and analyze data for any defined period such as: Today, This week, This month, This 3 months. Click at "Download" below the chart. Then select the format you wish from the drop-down: CSV, XLSX, TSV, XML, or HTML. To analyze the data over 3 months use Custom reports instead.

Dashboard Messages

The Messages panel on the Dashboard tab generally states the estimated net revenue for the network, however other announcements will appear here.

Messages Panel

Estimated Net Revenue is overall internal revenue for the network life. It is calculated based on bid price set in campaigns and the amount of generated impressions, clicks, and actions.

This revenue is considered estimated as it can be changed due to data reconciliation.

Things like system maintenance dates, special announcements, or the release of new features will appear here in addition to the estimated network revenue when available.

Dashboard Stats

The Stats panel in the Dashboard gives an overview of clicks, impressions, requests, applications, CTR, fill rate and CPM and internal revenue over the network for the specific time frame.

NOTE: THE IMAGE BELOW CONTAINS TEST DATA. WITH ACTUAL NETWORK DATA, REQUESTS, APPLICATIONS, AND FILL RATE WOULD NOT BE EQUAL TO ZERO WHEN CLICKS, IMPRESSIONS, CTR AND CPM HAVE DATA ASSOCIATED WITH THEM.

Dashboard Daily Stats

Quick Reports

Quick Reports are reports that can be saved during the report creation process (see Create Report). Quick Reports makes it easy to access reports that are run with frequency, and can be saved as reports are being built.

Quick Reports

Saving a report as a quick report would be done during the Create Report phase by checking out the ‘Quick Reports’ from the View Report screen (see Save Custom Report for details).

The review a certain quick report, click on the report shown up in the Quick Reports list.

Dashboard Orders

All orders that have been created in your network will appear at the bottom of the Dashboard. From this grid, orders can be edited or deleted. Order logs as well as an order performance report can be viewed.

The list of existing orders can be filtered by Order ID, Order Name, Advertiser ID, Advertiser Name (Company), Line Item selected from the drop-down. Besides orders can be sorted in the grid by order name, dates, advertiser name, budget and budget spent.

Clicking at the "Create New Order" button above the table brings up a create order form for you to make settings and save a new order.

Settings for an existing order can be viewed by clicking at the order name in the grid.

Orders

To edit the details of the order, select ’Edit’ from the action list next to the order in question. This will bring up the order details, allowing for a step through of the order details in the same workflow as the order creation process. For a step-by-step walk-through of the edit order process, see above beginning with section Create Order.

To copy an order click at "Copy" from the Actions drop-down. It brings up the "Create Orders" form with order data copied from the parent order. Edit it if necessary and click "Copy Order" to save the order.

Selecting ’Delete’ from the Orders action list will bring up a confirmation dialog box. The order will not be deleted until this failsafe is triggered. Once the order is deleted, there will be no history of it in the account.

The option to view order logs is available from the Orders action list. To perform this action, you will be moved to "Change Log" tab to view the changes applied to this order.

The order list (including deleted ones) with information for them can be downloaded to your computer in .CSV format using the "Export CSV" option at the right-bottom corner.

Export Dashboard OrdersBETA

The order list (including deleted ones) with information for them can be downloaded to your computer. Click at "Download" below the grid. Then select the format you wish from the drop-down: CSV, XLSX, TSV, XML, or HTML.

Profile

The Profile tab gives you the ability to change specific details about your account information: password, first and last names, company and phone number as well as regenerate the API Key for this network.

Profile Screen


To change your specified email address or something else beyond the items that appear in the screen above (account owner, etc.) contact Mocean support.

To change your current password, enter it in the 'Current Password' field, then specify a new one in the 'Password' field and then repeat it in the Confirm password field. Then, click Save . After that you will be able to log in to the network using your new password.

Update Password

Click Clear to clear all active sessions.

Under the "Profile" tab the information on the user's API Key is available (if allowed by the specific permission). You may regenerate the API Key clicking on "Regenerate" to get it for the network. Please, find more information about API Key here.

Profile API Key Panel

Logs

The information about user actions can be obtained under the Logs section.

Logs Screen

The following actions are shown here:

  • any create action (whether it’s a user creation, order, line item, creative/ad feed, app, zone or placement/targeting group creation, etc.)
  • any modify action (modifying user accounts, order/line item/creative/ad feed settings, app and zone attributes, placement/targeting group, etc.)
  • any delete action (whether it’s a user, order, line item, creative/ad feed, app, zone or placement/targeting group, etc.)
  • un-deliting apps/zones
  • approving/declining line items as well as pausing/resuming orders and line items
  • adding/deleting app filters and keywords, and some others.

Clicking on "modified" in the raw for a specific log brings up a detailed description of the change, the comment to this change (if you have left any) as well as previous and new values.

Change Details

Use Filters to search for specific actions in the logs list.

Change Log Filters

Apply the filters required, then select Search. The result will be appeared in the table below.

All the change logs can be exported in a .csv format clicking on Export .CSV above the table.

Export Change Log ListBETA

All the change logs can be exported and downloaded to your computer. Click at "Download" below the grid. Then select the format you wish from the drop-down: CSV, XLSX, TSV, XML, or HTML.

Radar (BETA)

A “Radar” section in the main navigation panel allows users to quickly and easily see messages about reports and forecasts completion and notifications requiring their attention. At the moment the following notifications are provided:

  • Notifications for completed reports and forecasts.
  • Notifications about pausing line items for the reason that some network permissions were changed.
Radar Alert
NOTE: Notifications dealing with pausing line items can be deleted from Radar only by network owners since network permissions changes affect all the network users.

Personal tools