Planning

Export and import data in bulk

Planning enables you to change large amounts of project data at once by exporting the data to a file, editing the contents of the file, and importing the edited data back into Planning.

Exporting inventory files

You can export all placements, packages, and roadblocks in a project to a comma-separated values (CSV or .csv) file. This inventory file will contain information about the placements, packages, and roadblocks in your project. You can view and edit the file in any text editor, but we recommend importing it into a spreadsheet program for easier editing.

Importing inventory files

After you edit the values in the inventory files, you can import the changes into Planning. (Note that if you make your changes in a spreadsheet editor, you must save them as a .csv file before importing.) This is useful if you want to make changes to multiple placements at one time.

You can make any of the following changes in your inventory files and upload them back into Planning:

  • Create and edit placements
  • Create and edit placement groups (packages and roadblocks)
  • Create and edit in-group placements
  • Edit multiple flights for a placement or placement group

Keep these things in mind as you edit your spreadsheet:

  • Unlike in Campaign Manager, you can’t reassign an in-group placement from one group to another by changing its group assignment.
  • If you’re editing an existing in-group placement, its parent placement group doesn’t need to be in the spreadsheet, as long as you have the in-group placement’s ID in the “Placement ID” column.

The sections that follow explain how to perform each bulk action. Click the down arrow next to the action to open the section.

Create a new placement

Follow these steps to create placements in your project:

  1. In your spreadsheet, add a row for each placement you want to add to your project.
  2. In the “Action” column, enter “Create”.
  3. In the “Placement type” column, enter “Placement”.
  4. Complete all required fields:
    1. Site name
    2. Placement name
    3. Start date/End date
    4. Compatibility
    5. Width/Height (if the placement’s “Compatibility” is “Display”). These will be combined into a single value, "Dimensions", when the placements are imported.
    6. Payment source
    7. Cost structure
    8. Cap cost
    9. Units
    10. Rate (if the placement’s “Cost structure” is “CPM”, "vCPM - Active View", “CPC”, or “CPA”)
    11. Cost (if the placement’s “Cost structure” is “Flat rate - Impressions” or “Flat rate - Clicks”)
  5. Save the spreadsheet.
  6. Return to Planning. In the Inventory view for your project, click Import. Choose the file you just saved and click Open.
    1. You’ll receive an email notification at the account associated with your profile detailing the changes you’ve made, including any errors encountered while Planning processed the file.
  7. The placement rows you added in the file will create new placements in your project.
Create a new placement group (package or roadblock)

Follow these steps to create a new placement group containing one or more in-group placements:

  1. Add a row to your spreadsheet.
  2. In the “Action” column, enter “Create”.
  3. In the “Placement type” column, enter “Package” or “Roadblock”.
  4. Complete all required fields for the placement group:
    1. Site name
    2. Placement name
    3. Start date/End date
    4. Cost structure
    5. Cap cost
    6. Units
    7. Rate (if the placement group’s “Cost structure” is “CPM”, "vCPM - Active View", “CPC”, or “CPA”)
    8. Cost (if the placement group’s “Cost structure” is “Flat rate - Impressions” or “Flat rate - Clicks”)
  5. Optionally, add one or more placements to any of the groups, as described below.
  6. When you’re finished adding groups and in-group placements, save the spreadsheet.
  7. Return to Planning. In the Inventory view for your project, click Import. Choose the file you just saved and click Open.
    1. You’ll receive an email notification at the account associated with your profile detailing the changes you’ve made, including any errors encountered while Planning processed the file.
  8. The rows you added in the file will create new placement groups and in-groups placements in your project.
Add in-group placements to a new placement group

Follow these steps to add one or more in-group placements to a new placement group (see above):

  1. Add a row for the in-group placement you want to add to your project. Note: This row must be directly below the parent placement group or other in-group placements.
  2. In the “Action” column, enter “Create”.
  3. In the “Placement type” column, enter “In-group placement”.
  4. Complete all required fields:
    1. Placement name
    2. Is primary placement (If the placement group is a “Roadblock”. Note: Only one in-group placement may the primary placement of a roadblock.)
    3. Compatibility
    4. Width/Height (if the in-group placement’s “Compatibility” is “Display”) These will be combined into a single value, "Dimensions", when the placements are imported.
    5. Payment source
  5. Save the spreadsheet.
  6. Return to Planning. In the Inventory view for your project, click Import. Choose the file you just saved and click Open.
    1. You’ll receive an email notification at the account associated with your profile detailing the changes you’ve made, including any errors encountered while Planning processed the file.
  7. The rows you added in the file will create new placement groups and in-groups placements in your project.
Edit an existing placement, placement group, or in-group placement

Follow these steps to edit existing placements, placement groups, or in-group placements in your project:

  1. In the exported spreadsheet, find the row for placement you want to add to your project. Or, add a new row and enter the ID of the placement you want to edit in the “Placement ID” column.
  2. In the “Action” column, enter “Update”.
  3. Edit one or more of the following fields (note: all required fields must be present):
    1. Site name
    2. Placement name
    3. Start date/End date
    4. Compatibility
    5. Width/Height (if the placement’s “Compatibility” is “Display”) These will be combined into a single value, "Dimensions", when the placements are imported.
    6. Payment source
    7. Cost structure
    8. Cap cost
    9. Units
    10. Rate (if the placement’s “Cost structure” is “CPM”, "vCPM - Active View", “CPC”, or “CPA”)
    11. Cost (if the placement’s “Cost structure” is “Flat rate - Impressions” or “Flat rate - Clicks”)
  4. Save the spreadsheet.
  5. Return to Planning. In the Inventory view for your project, click Import. Choose the file you just saved and click Open.
    1. You’ll receive an email notification at the account associated with your profile detailing the changes you’ve made, including any errors encountered while Planning processed the file.
  6. The placement rows you edited in the file will edit existing placements, placement groups, and in-group placements in your project.
Add flights to a new placement or placement group

Follow these steps to add flights to a new placement or group:

  1. In your spreadsheet, go to the row for which you’re adding the flight(s).
  2. Create a new row under the placement row.
  3. Leave the “Action” column blank in the new row.
  4. In the “Placement type” column, enter “Flight”.
  5. Complete all required fields:
    1. Start date
    2. End date
    3. Rate (if the placement’s “Cost structure” is “CPM”, "vCPM - Active View", “CPC”, or “CPA”)
    4. Cost (if the placement’s “Cost structure” is “Flat rate - Impressions” or “Flat rate - Clicks”)
  6. Repeat steps 2 - 5 if you need to add more flights. When you’re finished, save the spreadsheet.
  7. Return to Planning. In the Inventory view for your project, click Import. Choose the file you just saved and click Open.
    1. You’ll receive an email notification at the account associated with your profile detailing the changes you’ve made, including any errors encountered while Planning processed the file.
  8. The flights you added in the file will be added to the placement or group in Planning.
Add flights to an existing placement or placement group

Follow these steps to add flights to an existing placement or group:

  1. In your spreadsheet, go to the row for which you’re adding the flight(s).
  2. In the “Action” column, enter “Update”.
  3. Create a new row under the placement row.
  4. Leave the “Action” column blank in the new row.
  5. In the ”Placement type” column, enter “Flight”.
  6. Complete all required fields:
    1. Start date
    2. End date
    3. Rate (if the placement’s “Cost structure” is “CPM”, "vCPM - Active View", “CPC”, or “CPA”)
    4. Cost (if the placement’s “Cost structure” is “Flat rate - Impressions” or “Flat rate - Clicks”)
  7. Repeat steps 3 - 6 if you need to add more flights. When you’re finished, save the spreadsheet.
  8. Return to Planning. In the Inventory view for your project, click Import. Choose the file you just saved and click Open.
    1. You’ll receive an email notification at the account associated with your profile detailing the changes you’ve made, including any errors encountered while Planning processed the file.
  9. The flights you added in the file will be added to the placement or group in Planning.
Remove flights from an existing placement or placement group

Follow these steps to remove flights from an existing placement or placement group:

  1. In your spreadsheet, go to the row for the placement from which you want to remove a flight.
  2. In the “Action” column, enter “Update”.
  3. Delete the row for the flight you want to remove from the placement.
  4. Repeat step 3 if you need to remove more flights. When you’re finished, save the spreadsheet.
  5. Return to Planning. In the Inventory view for your project, click Import. Choose the file you just saved and click Open.
    1. You’ll receive an email notification at the account associated with your profile detailing the changes you’ve made, including any errors encountered while Planning processed the file.
  6. The flights you removed in the file will be removed from the placement or group in Planning.

When you import an inventory file into Planning, you'll see these results:

  • The changed values will be propagated into your project.
  • You receive a email confirming the import. If any errors occurred, some are reported in this email.
  • A spreadsheet containing the data you imported is attached to the email. Some import errors, if any, are shown in this spreadsheet.

Inventory file format

Assuming you edit the .csv file as a spreadsheet, a row in the inventory file represents a placement, package, or roadblock. When you export an inventory file, all relevant values for each placement, package, and roadblock will be present. When you import an inventory file, you’ll need to provide the required values for the placements, packages, and roadblocks you want to update.

The table below shows the columns in the inventory file and the types of values you should use for them.

Field name

Required?

Value

Action

Required

How the row will be processed during import. Value is one of the following (case-insensitive):

  • View - Values will be ignored
  • Update - Values will be used to update an existing placement, package, or roadblock
  • Create - Values will be used to create a new placement, package, or roadblock

Placement type

Required

What type of object the row represents. When creating a new object, this value is required. Value is one of the following (case-insensitive):

  • Placement
  • Package
  • Roadblock

Note that you can’t change the type of an object after it’s created.

Site name

Required

The site to which the placement belongs. Value is a string (case sensitive) entered in a free-form text field.

Placement name

Required

The name of the placement, package, or roadblock. Value is a string (case sensitive).

Placement ID

Required for “Update” action

The ID of the placement, package, or roadblock. This value is required when the row action is “Update”. (When the action is “Create”, the ID is ignored, and the placement is automatically assigned a new ID.)

Is primary placement

Required for exactly one in-group placement in a roadblock

Whether the in-group placement is the primary placement in the roadblock. Value is one of the following (case-insensitive):

  • Y (the placement is the primary)
  • N (the placement is not the primary)

Group assignment

Required for “Create” action

The ID of the existing placement group that this new in-group placement should be assigned to.

When creating an in-group placement for a new placement group, this cell should be left blank.

Start date End date

Required

The start and end dates for the placement. If the row action is “Create”, these dates will be used as the start and end dates for a single flight that will be automatically created. Values: date in yyyy-mm-dd format.

Number of flights

Ignored during import

The number of flights in the placement. This value is ignored during import.

Compatibility

Required for placement rows; ignored for package and roadblock rows

The compatibility type of the placement. (Packages and roadblocks do not have a compatibility type.) Value is one of the following (case-insensitive):

  • Display
  • Display interstitial
  • In-stream video
Width
Height

Required for placements with compatibility type “Display”

The dimensions of the placement. Width and height are applicable only to placements with compatibility type “Display”. Value is an integer. These will be combined into a single value, "Dimensions", when the placements are imported.

Payment source

Required for placement rows; ignored for package and roadblock rows

Which of the agency or the publisher will pay fees for the placement. values: Value is one of “Agency” or “Publisher” (case-insensitive).

Cost structure

Required

How the cost of the placement will be calculated. Value is one of the following (case-insensitive):

  • CPM
  • vCPM - Active View
  • CPC
  • CPA
  • Flat rate - impressions
  • Flat rate - clicks

Cap cost

Required

How costs should be capped for the placement, if at all. Value is one of the following (case-insensitive):

  • None
  • Monthly
  • Cumulative
Units

Required

Number of units (impressions or clicks) for the placement. If the placement has more than one flight, you will not be able to update it via inventory file import. Value is an integer.

Rate

Required if cost structure is CPM, CPC, or CPA; ignored for other cost structures

Cost per unit for the placement. If the placement has more than one flight, you will not be able to update it via inventory file import. During export, the rate value will be omitted if the placement has more than one flight. Value is a decimal expressed up to ten-thousandths.

Cost

Required if cost structure is “Flat rate - impressions” or “Flat rate - clicks”; ignored for other cost structures. Required for credits.

Total cost for the placement. If the placement has more than one flight, you will not be able to update it via inventory file import. Value is a decimal expressed up to hundredths. A credit must be expressed as a negative value.

In plan?

Optional

Whether the placement is in the plan. Value is one of the following (case-insensitive):

  • Y (the placement is in the plan)
  • N (the placement is not in the plan)

Description

Optional

Optional description of the placement or placement group.

Campaign Manager placement ID

Ignored during import

The ID of the Campaign Manager placement to which the Planning placement is linked, if any.

Errors

Ignored during import

Reports any problems with the row during import. This column is populated by Planning. It is ignored during import.

Was this helpful?
How can we improve it?