API ReferenceCommunity DiscussionAnnouncements
API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsLog In
Community Discussion
Start typing to search…

Community Discussion

Ask a Question
Back to All

How to activate/pause Site under campaign from API

almost 4 years ago by Varvara

I'd like to user Taboola API in order to activate site under particular campaign from the API
Do I get it correct that in this case I should run the The PATCH request and ADD publisher to targeting

In case if I'd like to pause it I need to REMOVE publisher from targeting. Is it correct?

publisher_targetingta
almost 4 years ago by Peter CimringAdmin

Hi, Varvara

The API allows you to manage a list of blocked publishers (aka 'sites') for a given campaign - or account.

In general, the flow is as follows:

  1. Use a POST request with type "EXCLUDE" to block an entire collection of publishers (overwrites any existing targeting). These are the publishers (sites) that the campaign will exclude.
  2. Use a PATCH request with "ADD" to add a site (or several sites) to the existing exclusions. This site will now be blocked.
  3. Use a PATCH request with "REMOVE" to remove a site (or several sites) from the existing exclusions. This site will no longer be blocked.

Make sense? :)

See also:

Cheers

PS: The API supports the management of exclusion lists for publishers - i.e. blocking. It does not (directly) support the management of inclusion lists.

almost 4 years ago by Varvara

Hi Peter

Thanks for your reply and clarifications!
Could you please confirm that this management of exclusion lists for publishers is similar to the actions I can do on the Taboola dashboard under particular campaign settings?
The toggle near to the site name?

almost 4 years ago by Peter CimringAdmin

Hi, Varvara

In Taboola Ads, you can exclude a publisher in several places:

  1. In the 'Edit Campaign' slide-out, you can manage a list of blocked publishers. When you click on 'Save', the result is similar to a POST request (item '1' above).
  2. Under the 'Sites' tab, you can toggle a given site as 'Active' or 'Inactive'. This is similar to a PATCH request (items '2' and '3' above).
    • Note that if you have a specific campaign selected, then the publisher is blocked on the campaign level.
    • Otherwise, the publisher is blocked on the account level.

Although the 'Sites' tab uses different terminology ('Active' or 'Inactive'), the result is the same - a site marked as 'Inactive' is added to the excluded list. (I also verified this by making a change via the UI, and then checking the data via the API.)

Does that clarify things? :)

Cheers
Pete

almost 4 years ago by Varvara

Hi Pete, thanks! Now everything is clear.

Varvara

almost 4 years ago by Peter CimringAdmin

Awesome! Glad we could help :)

almost 4 years ago by Peter CimringAdmin

PS: On a slightly different note, I just wanted to mention:

Our API Newsletter is a great way to stay current with the latest API changes.

If you have not already done so, you can subscribe here.

Cheers

ο»Ώ