Welcome!
Welcome to the Marin Software Support Center. We're glad you're here. Here's what you can look forward to:
  • Real-time search so you can find what you need faster than ever.
  • Easy-to-follow video guides for our most popular articles.
  • Interactive simulations and Live Screenshots to make learning easy.
  • Regular content updates to ensure every word you read is accurate and up-to-date.
Home > English > Your Marin Account > Syncing > How To Articles: Syncing > Syncing Changes to Marin

Syncing Changes to Marin

Introduction

Our platform stores its own copy of each client's campaign structure separate from the publisher. When changes are made within the application, they must be synchronized with the content in the publishers' databases in order to achieve symmetry in both locations.

After making changes to campaigns using the application, you have the option to send changes to the publisher immediately, or wait until the application automatically sends them via its nightly sync with each publisher.

Similarly, our application must be kept in sync with changes that are made directly within the publisher. If changes are made in a publisher-specific editing tool such as Google AdWords Editor, a sync with our application is required in order to update the data.
 

This article is specific to syncing changes to the platform from the publishers. To learn more about posting changes from the platform to the publisher, please read our Support Center article. 

Why Synchronization Matters

It is important that campaign settings in our application are closely matched to those set within the publisher.

For example, if a bid has been changed at the publisher, but our application contains the old bid, our bidding algorithm will execute using settings and details for the old bid. This means that the application could possibly suppress a valid bid change or push out a bid change based on compromised data. As another example, if a Microsoft campaign is active within our application and is deleted or expired within Microsoft itself, any changes our application attempts to make to that campaign, or items within it, will be rejected by Microsoft.

We encourage you to make your campaign management changes using our application. Following the methods outlined below will ensure that changes will be properly recorded.

Bringing publisher changes into the platform

There are two ways to ensure that any changes made directly with publishers are reflected in our application: Manual Sync and Automatic Nightly Sync. We will outline each of these below.

Manual Sync (also known as Hard Sync)

Once you have made changes in the publisher, if you would like these setting to be immediately reflected in the platform, you can do this through a manual sync.

See the following article for details on How to Perform a Manual Sync.

Note: Sync updates will only change an object's attributes or settings (keyword, campaign, creative, group); metrics are not changed. If metrics within our application do not reconcile with those at the publisher, contact our Support Services department for assistance.

Automatic Nightly Sync

Automatic Nightly Sync is also known as Sync-From-Cost-Reports. This automated sync occurs by comparing objects in our application versus those that show up in the Nightly Cost Reports and looking for discrepancies in status or values. The cost reports are downloaded on a nightly basis to obtain previous day publisher metrics (impressions, clicks), and contain keywords and creatives that received impressions.

Note: Cost data for publisher accounts will be ready by 9am local account time. E.g. account is PST (GMT-8) will have data ready by 9am local time which is 17:00 GMT.

During the Automatic Nightly Sync, keywords and creatives are updated with the newest bids, quality score and destination URL found in the Nightly Cost Reports. If a new keyword or creative is identified, or a bid change is ambiguous, the Marin platform will sync the entire group level to ensure symmetry with the publisher. For example, if a keyword bid is changed in the cost report and now matches the group bid stored in the Marin platform, it is unclear whether the keyword bid should be updated or if this keyword is now using the group bid. In this case the Marin platform will perform a group sync. Alternatively, if the Marin platform identifies a new keyword bid that does not match the group bid, it will update the keyword bid directly within the application without initiating a group sync.

 

Note: Any items in the platform in the To be sent status will be pushed overnight at some point after 8pm in the account time zone.

Important notes about syncing

  • If a campaign has no click and impressions, as a best practice budgets, and other changes made in the publisher account should always be hard synced to ensure they are brought into the Marin platform.
  • The syncing process will never perform any create operations within the publisher, it will only ever pull in changes to the platform. If you see changes made by the System user, it's likely that this is the result of the platform syncing with the publisher. Find out more about the System user.
  • If you're concerned about a change made in the platform and who made it, it's a good idea to click on the object itself in the grid (keyword, creative, etc.) and go to the Settings sub-tab. Then scroll down to the History grid and you'll be able to see all recent changes and which user made them.
  • To check to make sure your campaigns and/or groups are syncing, navigate to the Campaigns and/or Groups tab, and click the filter icon in the Operation Status column (next to the checkboxes in the grid) and select the Syncing operation status. Look at the number of objects for this filter, and refresh the view after a few minutes. When the sync is processing through, the number of objects for this filtered view should be less.
  • Marin's default minimum bid change is 15 cents. Any bid change below 15 cents will not be updated through the nightly sync and will need to be sync manually.

  • For Upgraded or Advanced URL fields in Microsoft and Yahoo! Japan, you will need to have opted into the corresponding betas before syncing can begin. Please reach out to your platform representative to opt into these betas.

When and how changes are synced to the platform

KEY DESCRIPTION
daily Synced daily
impressions Synced only with impressions
hard sync Hard sync only
n/a Not applicable

 

CAMPAIGN GOOGLE Y! Gemini Microsoft CRITEO Yahoo! JAPAN
Deleted daily n/a daily daily daily
Rename daily impressions daily daily daily
Status: Activated daily n/a daily daily daily
Status: Paused daily n/a daily daily daily
Status: Deleted daily n/a daily n/a daily
Attribute: End Date daily n/a n/a n/a daily
Attribute: Budget daily n/a daily daily daily
Attribute: Distribution daily impressions daily n/a daily
Negative Keywords daily n/a daily n/a daily
Ad Targeting daily n/a n/a n/a daily
Geo-Targeting daily n/a daily n/a daily
Language Targeting daily n/a n/a n/a n/a
Bid Settings: CPC vs. CPM daily impressions n/a n/a n/a
Device Targeting daily n/a daily n/a daily
Tracking Template daily n/a daily n/a daily
Custom Parameters daily n/a daily n/a daily

 

GROUP GOOGLE Y! Gemini Microsoft CRITEO Yahoo! JAPAN
New daily impressions impressions impressions impressions
Status: Deleted daily n/a hard sync hard sync hard sync
Rename daily impressions impressions impressions impressions
Status: Activated hard sync n/a impressions impressions impressions
Status: Paused hard sync n/a hard sync hard sync hard sync
Group Search Bid daily n/a hard sync hard sync hard sync
Group Content Bid n/a impressions hard sync n/a n/a
Negative Keywords hard sync n/a hard sync n/a hard sync
Ad Targeting n/a n/a hard sync n/a n/a
Geo-Targeting n/a n/a hard sync n/a n/a
Language Targeting n/a n/a hard sync n/a n/a
Attribute: Distribution n/a impressions hard sync n/a n/a
Tracking Template impressions n/a hard sync n/a hard sync
Custom Parameters impressions n/a hard sync n/a hard sync

 

KEYWORD GOOGLE Y! Gemini Microsoft CRITEO Yahoo! JAPAN
New impressions impressions impressions n/a impressions
Status: Deleted impressions n/a hard sync n/a hard sync
Status: Activated impressions n/a impressions n/a hard sync
Status: Inactive hard sync n/a n/a n/a hard sync
Status: Paused hard sync n/a hard sync n/a hard sync
Destination URL n/a impressions hard sync n/a hard sync
Landing Page impressions n/a impressions n/a impressions
Mobile Landing Page impressions n/a impressions n/a impressions
Tracking Template impressions n/a impressions n/a impressions
Custom Parameters impressions n/a impressions n/a impressions
Keyword Search Bid impressions impressions impressions n/a hard sync
Keyword Minimum Bid impressions n/a n/a n/a hard sync
Pending n/a n/a hard sync n/a hard sync
Quality Score impressions n/a n/a n/a n/a

 

CREATIVE GOOGLE Y! Gemini Microsoft CRITEO Yahoo! JAPAN
New impressions impressions impressions n/a impressions
Status: Deleted impressions n/a hard sync n/a hard sync
Status: Activated impressions impressions impressions n/a hard sync
Status: Paused impressions impressions hard sync n/a hard sync
Attribute: Any Text impressions n/a n/a n/a n/a
Destination URL n/a n/a n/a n/a n/a
Landing Page impressions n/a impressions n/a impressions
Mobile Landing Page impressions n/a impressions n/a impressions
Tracking Template impressions n/a impressions n/a impressions
Custom Parameters impressions n/a impressions n/a impressions
Approval Status impressions n/a impressions n/a impressions

 

PLACEMENTS GOOGLE Y! Gemini Microsoft CRITEO
New impressions n/a n/a n/a
Status: Deleted hard sync n/a n/a n/a
Status: Activated impressions n/a n/a n/a
Status: Inactive hard sync n/a n/a n/a
Status: Paused hard sync n/a n/a n/a
Destination URL impressions n/a n/a n/a
Landing Page impressions n/a n/a n/a
Mobile Landing Page impressions n/a n/a n/a
Tracking Template impressions n/a impressions n/a
Custom Parameters impressions n/a impressions n/a
Placement Content Bid impressions n/a n/a n/a
Placement Minimum Bid impressions n/a n/a n/a
PRODUCT GROUPS GOOGLE Microsoft
New (active or excluded) with no impressions hard sync hard sync
Status: Deleted / Subdivided impressions impressions
Status: Active impressions impressions
Status: Excluded impressions impressions
Tracking Template impressions n/a
Custom Parameters impressions n/a
Destination URL n/a impressions

Important information about publisher synchronization

  • Please note that if you have exceptionally large campaigns, the synchronization may likewise take an exceptionally long time. If you see the Sending Now status message for longer than usual, please first check that these campaigns are not simply very large and taking a while to process. Processing time can be upwards of 10 hours for very large campaigns.
  • Note that, for Google and Microsoft campaigns, we synchronize all sitelinks on a daily basis. This is not the case for publishers other than Google and Microsoft. 
  • If objects are deleted in the publisher and do not exist in the platform, the system cannot sync down these objects and corresponding data.
  • Discrepancies between the platform and the publisher can occur if you make changes in the publisher without syncing the change with the platform (either because that object is paused and we did not pull it in with the cost report or because the change required a manual sync). This scenario can cause confusion which is why we recommend only making your edits through the platform.
  • The platform cannot sync down cost data from the publisher for deleted objects.
  • Triggering a Hard Sync for campaigns or groups in the To Be Sent or Held statuses will overwrite any pending changes for these objects which already exist in the Activity Log. However, the corresponding jobs for these pending changes in the Activity Log will still be visible. That said, and even though the option to post this job to the publisher is available, selecting it will actually result in no changes on the publisher's side.

 

 

 

Last modified

Tags

Classifications

This page has no classifications.

 

wiki.page("Internal/Mindtouch_Launch_Sandbox/js.cookie.js")