Adding or Editing Objects Across Multiple Clients (Cross-Client Bulk Uploads)

If you work across multiple Marin client accounts, it is possible to submit a single bulk sheet and use it to edit objects in different client accounts. Objects may include keywords, creatives, groups, and so on.  To learn more about bulk uploads as a whole, check out our dedicated article. Supported File Types  Files can be either tab or comma deli...

Adding or Editing Objects via FTP

Bulk files, especially those with a large number of rows, can be uploaded via FTP, which can be useful for repetitive tasks such as keyword bid changes or monthly budget setting. The easiest way to connect to the platform via FTP is to use an FTP program. There are many of these available to download online. One such example is Filezilla, a free, op...

Bulk Upload Requirements

The following tables outline the requirements for some of the most popular types of fields used in bulk uploads and API requests.  In the tables below, columns with a Header that is in square brackets [ ] are optional, while those without brackets are required. If you'd like to learn more about bulk uploads,  check out our dedicated article . To lea...

Bulk Uploads

Using bulk uploads, you can create or edit hundreds – or even thousands – of campaigns, groups, keywords, or ads in just a few steps. If you would prefer to edit objects via multi-edit in the grid, check out our dedicated article.  What Is A Bulk Upload?  As a marketer, it can be very time-consuming to add objects (such as keywords or creatives) to ...

Managing Sitelinks via Bulk Upload

Sitelinks are an ad extension supported by Google and Microsoft that can be used to add extra links below your text ads in search results. Much like their natural search counterparts, they can drive clicks to deep content on your website. This article will explain how you can create, edit and delete your sitelinks via the platform’s bulk upload func...

Marin Scripts

Marin Scripts allows you to leverage the power of Python for streamlined reporting, management, and optimization to boost performance and save time. Scripts can run across the wide range of publishers supported by Marin. Using Marin Scripts, you can tag dimensions, change an object's status, set campaign budgets, set bids, and so much more! Handy Ti...

Renaming Campaigns & Ad Groups

Updating multiple campaign and ad group names is a non-trivial task for larger, more complex accounts. To streamline this process and save you time, you are able to edit the names of campaigns and groups in bulk by including the column Campaign ID or Group ID respectively in a bulk upload. Including Campaign ID Or Group ID In A Bulk File  To find th...

Tagging URLs via Bulk Upload

When integrating with MarinOne, often your URLs will need to be edited to include required tracking parameters. An easy way to tag URLs across all your publisher accounts is to create a bulk sheet to edit and then upload to MarinOne. How To Tag URLs Via Bulk Upload Create A Report To Edit All URLs In Your Account Depending on what objects you are ed...

Using Blank Rows, Blank Columns, and Default Values in Bulk Sheets

Including blank rows or columns in bulk sheets can lead to unexpected results. Therefore, it is a good idea to be aware of the effects of blank rows and columns before including them in an upload. Blank Rows In Bulk Sheets A completely blank row in a bulk sheet will cause that upload to fail. Therefore, blank rows should always be removed. Blank Col...

"Could Not Parse a Click Through URL from Destination URL" Message

When performing a bulk upload of keywords, you may see the following error message in the Results column of your bulk sheet: URL builder required params are missing from url., Could not parse a click through url from destination url.  What Causes The Issue? The first thing to note is that this message is in fact a warning, rather than an error messa...

"Failed Because There Were Too Many Error Lines"

When uploading bulk sheets to the platform, you may come across the following error message: Failed because there were too many error lines. Please fix and resubmit. What Causes The Issue? The platform detected too many errors within the bulk sheet itself, causing the process to fail.  How To Fix The Error If your bulksheet contains any unused colum...

"No Message Found Under Code 'GLOBAL_FAIL_ERROR_MSG' for Locale 'En_US'"

When uploading new keywords into the platform using a bulk upload, you may encounter the following error message when trying to continue after the Preview page: Error on new adgroups: Error: No message found under code 'GLOBAL_FAIL_ERROR_MSG' for locale 'en_US' Additionally, the upload does not make it to the  Activity Log to be posted to the publis...

"Property Headline is Not Valid"

When attempting to upload changes to your creatives (new or edit) via bulk sheet, the operation will fail and you may be presented with the following error message (or a variation thereof): Property headline is not valid. The following constraint violationswere detected MaxLengthWithSubstitutionValidator: What Causes The Issue? This error occurs whe...

"Submitted bulk input contains no valid lines. Please fill in data for all required fields"

You may see this message in the Bulk Add/Edit Keywords screen when processing a bulk upload of keywords. "Submitted bulk input contains no valid lines. Please fill in data for all required fields" What Causes The Issue? This problem is most commonly caused by one of the following reasons: Having rows of invalid or unrecognized column values in the u...

"The File Must be in Unicode Text Format (*.txt) or CSV Format (*.csv). Please Change the Format and Resubmit."

This error message appears when using the bulk add/edit function and the file is not recognized as a Unicode Text (*.txt) or CSV (*.csv) format. Activity Log Error: The file must be in Unicode Text Format (*.txt) or CSV format (*.csv) Please change the format and resubmit. Why Does This Issue Occurred? This error occurs when the application cannot p...

"The Number of Entries in the Response Exceeds the System Limit" Error Message

When multi-editing groups or campaigns within the system, you may be presented with the following error: Error: The number of entries in the response exceeds the system limit This error seems to occur more frequently with device targeting edits, but can happen during any multi-edit operation. In addition to the error, you'll also notice that the sta...

"There Was a Problem with the Upload. The Server Did Not Accept It" Error Message

When performing a bulk upload, you may come across the following error message: There was a problem with the upload. The server did not accept it. What Causes The Issue? This error message can be displayed for a number of reasons. The most common reasons are: The bulk upload file (bulk sheet) is too large. Your connection speed is too slow and the u...

“Could Not Execute JDBC Batch Update”

When attempting to upload a new Custom Column or Campaign to the platform via bulk upload, you may encounter the following error message: Could Not Execute JDBC Batch Update What Causes The Issue? This problem is usually caused by the Custom Column being too long, or the Campaign name being too long. The platform has an in-built limitation of 1024 c...

“Missing Bulk Input. Please Paste in Bulk Information or Upload a Bulk File”

When working with bulk uploads in the platform, you may come across this error message on the Preview screen: Error Missing bulk input. Please paste in bulk information or upload a bulk file. What Causes The Issue? There are a couple of potential factors that can cause this problem: Blank rows in your bulk upload file or an incorrect column header A...

Avoiding Excel Character Encoding

When uploading changes via Excel file, Marin requires that the file be saved in Unicode (UTF-8) text format to avoid any errors related to formatting or encoding. However, even when saving in Unicode format, Excel will still encode certain characters. If the file is not saved and loaded with this format, Excel’s encoding of special characters will c...

Bulk Editing Objects Creates New Ones Instead of Editing Them

There may be occasions when bulk editing keywords and creatives that you are able to upload them with no error or warning, but the platform does not edit the objects, and instead creates new ones. Below we'll explain a few potential causes and solutions for this problem.  What Causes The Issue? There are multiple causes for this issue, as follows: S...

Bulk Uploading Keywords Not Succeeding Entirely

When bulk uploading keywords, you may encounter a situation whereby not every keyword is created or edited as expected. Below we'll explore some causes and potential solutions.  What Causes The Issue? There can be many reasons but here are some common examples: You used some account names which do NOT exist in the Publishers tab You used some accoun...

Bulk Uploading URLs Frequently Asked Questions

This article will answer some of the most common questions we receive regarding the platform's URL upload functionality, as well as when to use the Click Through URL column. Frequently Asked Questions What Is The URL Builder? URL Builder is used to automatically add tracking to URLs uploaded into the application. Am I Using URL Builder? To check if ...

Failed Bulk Uploads Troubleshooting

There are a number of reasons why your upload may fail when using MarinOne's bulk upload functionality. Please read through the list below before contacting our Customer Support team -- your issue may have a very quick and easy fix. Possible Reasons For Failed Uploads Please check that the following are true of your bulk sheet upload: The upload con...

Incorrectly Named Columns Causing Bulk Uploads to Fail

When working with bulk uploads in the platform, you may notice that your upload will fail if the columns are named incorrectly. For example, Account would process correctly, whereas Accounts would fail.  What Causes The Issue? This problem often occurs when a users tries to upload to the platform using bulk sheets that they've downloaded from extern...

Number of Objects Uploaded Doesn't Match Number of Objects Created

When adding or editing objects such as Campaigns, Groups, Keywords, or Creatives in bulk, you may notice that there are more rows in your bulk sheet than there are number of objects created after the upload is complete. What Causes The Issue? There are a number of reasons that this discrepancy could occur. Below are the two most common: There may be...

Marin API

Introduction The Marin API is one way to programmatically write data to Marin. It is a post-only REST API for select objects: campaigns, groups, keywords, ads and strategies. All operations are input using JSON in the request body. Structure Posting data to the API is accomplished by making HTTP POST requests to the various endpoints. Requests are m...