API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

Network-wide reports

Customers that manage multiple advertiser accounts under Taboola are assigned a network account.

Using your network account, you can run network-wide reports.

Example 1: Stats per advertiser

(content_provider_breakdown dimension)

GET /backstage/api/1.0/demo-account-network/reports/campaign-summary/dimensions/content_provider_breakdown?start_date=2020-07-01&end_date=2020-07-07
{
    //...
    "results": [
        {
            "content_provider": "demo-account-001",
            "content_provider_name": "Demo Account 1",
            "clicks": 120,
            //...
        },
        {
            "content_provider": "demo-account-002",
            "content_provider_name": "Demo Account 2",
            "clicks": 250,
            //...
        }        
    ],
    "recordCount": 2,
    "metadata": {
        //...
        ]
    }
}

📘

The content_provider_breakdown dimension shows stats per advertiser (content provider) in the network.

You must pass a network account for this dimention - otherwise, the API returns 403 - Requested action is forbidden.

Example 2: Stats per campaign

(campaign_breakdown dimension)

GET /backstage/api/1.0/demo-account-network/reports/campaign-summary/dimensions/campaign_breakdown?start_date=2020-07-01&end_date=2020-07-07
{
   "results": [
      {
         "campaign_name": "Demo Campaign 1",
         "campaign": "101",
         "campaign_learning_state": "LEARNING",
         "clicks": 50,
         //...
      },
      {
         "campaign_name": "Demo Campaign 2",
         "campaign": "102",
         "campaign_learning_state": "LEARNING",
         "clicks": 70,
         //...
      },
      {
         "campaign_name": "Demo Campaign 3",
         "campaign": "103",
         "campaign_learning_state": "LEARNING",
         "clicks": 120,
         //...
      },
      {
         "campaign_name": "Demo Campaign 4",
         "campaign": "104",
         "campaign_learning_state": "LEARNING",
         "clicks": 130,
         //...
      }
   ],
   "recordCount": 4,
   "metadata": {
      //...
   }
}

📘

Network Account

The network account serves a special purpose - and is not used for managing campaigns.

For more information, see: Network Accounts.