> For the complete documentation index, see [llms.txt](https://daton-sarasanalytics.gitbook.io/daton/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://daton-sarasanalytics.gitbook.io/daton/integrations/data-sources/analytics/taboola-v2/schema-information.md).

# Schema Information

## Tables/APIs 

The following table is associated with the Taboola v2 connector:

* [AllCampaginsItems](#allcampaginsitems) 
* [AllCampaigns](#allcampaigns) 
* [AllConversionRules](#allconversionrules) 
* [AllCustomAudiences](#allcustomaudiences) 
* [CampaignSummaryReport](#campaignsummaryreport) 
* [RealTimeAdsReport](#realtimeadsreport) 
* [RealTimeReport](#realtimereport) 

### AllCampaginsItems  

Retrieve detailed information about all individual campaign items, providing insights into specific elements within Taboola campaigns.

For more information, see [Taboola- AllCampaginsItems](https://developers.taboola.com/backstage-api/reference/campaign-items-overview).

**FIELDS** 

<table><thead><tr><th width="126">Field Name</th><th width="64">Data Type</th></tr></thead><tbody><tr><td>id</td><td>STRING</td></tr><tr><td>campaign_id</td><td>STRING</td></tr><tr><td>type</td><td>STRING</td></tr><tr><td>url</td><td>STRING</td></tr><tr><td>thumbnail_url</td><td>STRING</td></tr><tr><td>title</td><td>STRING</td></tr><tr><td>approval_state</td><td>STRING</td></tr><tr><td>is_active</td><td>BOOLEAN</td></tr><tr><td>status</td><td>STRING</td></tr><tr><td>creative_focus</td><td>RECORD</td></tr></tbody></table>

### AllCampaigns

Access comprehensive details about all campaigns in Taboola, offering a holistic view of your advertising initiatives.

For more information, see [Taboola- AllCampagins](https://developers.taboola.com/backstage-api/reference/campaigns-overview).

**FIELDS**&#x20;

<table><thead><tr><th width="90">Field Name</th><th width="64">Data Type</th></tr></thead><tbody><tr><td>id</td><td>STRING</td></tr><tr><td>advertiser_id</td><td>STRING</td></tr><tr><td>name</td><td>STRING</td></tr><tr><td>branding_text</td><td>STRING</td></tr><tr><td>tracking_code</td><td>STRING</td></tr><tr><td>pricing_model</td><td>STRING</td></tr><tr><td>cpc</td><td>NUMERIC</td></tr><tr><td>safety_rating</td><td>STRING</td></tr><tr><td>daily_cap</td><td>NUMERIC</td></tr><tr><td>daily_ad_delivery_model</td><td>STRING</td></tr><tr><td>spending_limit</td><td>NUMERIC</td></tr><tr><td>spending_limit_model</td><td>STRING</td></tr><tr><td>cpa_goal</td><td>NUMERIC</td></tr><tr><td>country_targeting</td><td>RECORD</td></tr><tr><td>sub_country_targeting</td><td>RECORD</td></tr><tr><td>dma_country_targeting</td><td>RECORD</td></tr><tr><td>region_country_targeting</td><td>RECORD</td></tr><tr><td>city_targeting</td><td>RECORD</td></tr><tr><td>postal_code_targeting</td><td>RECORD</td></tr><tr><td>contextual_targeting</td><td>RECORD</td></tr><tr><td>platform_targeting</td><td>RECORD</td></tr><tr><td>publisher_targeting</td><td>RECORD</td></tr><tr><td>auto_publisher_targeting</td><td>RECORD</td></tr><tr><td>os_targeting</td><td>RECORD</td></tr><tr><td>connection_type_targeting</td><td>RECORD</td></tr><tr><td>publisher_bid_modifier</td><td>RECORD</td></tr><tr><td>comments</td><td>STRING</td></tr><tr><td>spent</td><td>NUMERIC</td></tr><tr><td>bid_type</td><td>STRING</td></tr><tr><td>bid_strategy</td><td>STRING</td></tr><tr><td>traffic_allocation_mode</td><td>STRING</td></tr><tr><td>external_brand_safety</td><td>RECORD</td></tr><tr><td>learning_state</td><td>STRING</td></tr><tr><td>start_date</td><td>DATE</td></tr><tr><td>end_date</td><td>DATE</td></tr><tr><td>start_date_in_utc</td><td>DATETIME</td></tr><tr><td>end_date_in_utc</td><td>DATETIME</td></tr><tr><td>approval_state</td><td>STRING</td></tr><tr><td>is_active</td><td>BOOLEAN</td></tr><tr><td>status</td><td>STRING</td></tr><tr><td>audience_segments_multi_targeting</td><td>RECORD</td></tr><tr><td>contextual_segments_targeting</td><td>RECORD</td></tr><tr><td>custom_contextual_targeting</td><td>RECORD</td></tr><tr><td>audiences_targeting</td><td>RECORD</td></tr><tr><td>custom_audience_targeting</td><td>RECORD</td></tr><tr><td>segments_targeting</td><td>RECORD</td></tr><tr><td>marking_label_multi_targeting</td><td>RECORD</td></tr><tr><td>lookalike_audience_targeting</td><td>RECORD</td></tr><tr><td>marketing_objective</td><td>STRING</td></tr><tr><td>activity_schedule</td><td>RECORD</td></tr><tr><td>policy_review</td><td>RECORD</td></tr><tr><td>browser_targeting</td><td>RECORD</td></tr><tr><td>type</td><td>STRING</td></tr><tr><td>is_spend_guard_active</td><td>STRING</td></tr></tbody></table>

### AllConversionRules &#x20;

This API provides insights into all conversion rules within Taboola, enabling effective tracking and optimization of your conversion strategies.

For more information, see [Taboola- AllConversionRules](https://developers.taboola.com/backstage-api/reference/get-all-conversion-rules).

**FIELDS** &#x20;

<table><thead><tr><th width="127">Field Name</th><th width="64">Data Type</th></tr></thead><tbody><tr><td>id</td><td>NUMERIC</td></tr><tr><td>display_name</td><td>STRING</td></tr><tr><td>look_back_window</td><td>NUMERIC</td></tr><tr><td>view_through_look_back_window</td><td>NUMERIC</td></tr><tr><td>category</td><td>STRING</td></tr><tr><td>status</td><td>STRING</td></tr><tr><td>type</td><td>STRING</td></tr><tr><td>event_name</td><td>STRING</td></tr><tr><td>condition</td><td>RECORD</td></tr><tr><td>include_in_total_conversions</td><td>BOOLEAN</td></tr><tr><td>include_in_total_value</td><td>BOOLEAN</td></tr><tr><td>aggregation_type</td><td>STRING</td></tr><tr><td>exclude_from_campaigns</td><td>BOOLEAN</td></tr><tr><td>advertiser_id</td><td>STRING</td></tr><tr><td>last_modified_by</td><td>STRING</td></tr><tr><td>last_modified_at</td><td>DATE</td></tr></tbody></table>

### AllCustomAudiences &#x20;

This API obtains data on all custom audiences in Taboola, empowering you to tailor your advertising efforts to specific audience segments.

For more information, see [Taboola- AllCustomAudiences](https://developers.taboola.com/backstage-api/reference/custom-audience-quick-reference).

**FIELDS** &#x20;

<table><thead><tr><th width="135">Field Name</th><th width="64">Data Type</th></tr></thead><tbody><tr><td>id</td><td>NUMERIC</td></tr><tr><td>display_name</td><td>STRING</td></tr><tr><td>look_back_window</td><td>NUMERIC</td></tr><tr><td>view_through_look_back_window</td><td>NUMERIC</td></tr><tr><td>category</td><td>STRING</td></tr><tr><td>status</td><td>STRING</td></tr><tr><td>type</td><td>STRING</td></tr><tr><td>event_name</td><td>STRING</td></tr><tr><td>exclude_from_campaigns</td><td>BOOLEAN</td></tr><tr><td>advertiser_id</td><td>STRING</td></tr><tr><td>last_modified_by</td><td>STRING</td></tr><tr><td>last_modified_at</td><td>DATE</td></tr><tr><td>audience_size</td><td>NUMERIC</td></tr></tbody></table>

### CampaignSummaryReport &#x20;

Generates a comprehensive report summarizing key campaign metrics, aiding in a quick and insightful overview of your Taboola campaigns.

For more information, see [Taboola- CampaignSummaryReport](https://developers.taboola.com/backstage-api/reference/campaign-summary-report-overview).

**FIELDS** &#x20;

<table><thead><tr><th width="171">Field Name</th><th width="64">Data Type</th></tr></thead><tbody><tr><td>date</td><td>STRING</td></tr><tr><td>date_end_period</td><td>STRING</td></tr><tr><td>clicks</td><td>NUMERIC</td></tr><tr><td>impressions</td><td>NUMERIC</td></tr><tr><td>visible_impressions</td><td>NUMERIC</td></tr><tr><td>spent</td><td>NUMERIC</td></tr><tr><td>conversions_value</td><td>NUMERIC</td></tr><tr><td>roas</td><td>NUMERIC</td></tr><tr><td>ctr</td><td>BIGNUMERIC</td></tr><tr><td>vctr</td><td>BIGNUMERIC</td></tr><tr><td>cpm</td><td>NUMERIC</td></tr><tr><td>vcpm</td><td>NUMERIC</td></tr><tr><td>cpc</td><td>NUMERIC</td></tr><tr><td>campaigns_num</td><td>NUMERIC</td></tr><tr><td>cpa</td><td>NUMERIC</td></tr><tr><td>cpa_actions_num</td><td>NUMERIC</td></tr><tr><td>cpa_conversion_rate</td><td>BIGNUMERIC</td></tr><tr><td>currency</td><td>STRING</td></tr></tbody></table>

### RealTimeAdsReport &#x20;

This API gives a real-time data access on the performance of your ads in Taboola, facilitating timely adjustments and optimizations.

For more information, see [Taboola- RealTimeAdsReport](https://developers.taboola.com/backstage-api/reference/realtime-ads-report).

**FIELDS** &#x20;

<table><thead><tr><th width="131">Field Name</th><th width="64">Data Type</th></tr></thead><tbody><tr><td>id</td><td>STRING</td></tr><tr><td>data_type</td><td>STRING</td></tr></tbody></table>

### RealTimeReport&#x20;

This API fetches real-time reports providing instant insights into various metrics within the Taboola platform, supporting agile decision-making.

For more information, see [Taboola- RealTimeReport](https://developers.taboola.com/backstage-api/reference/realtime-ads-report).

**FIELDS**&#x20;

<table><thead><tr><th width="107">Field Name</th><th width="64">Data Type</th></tr></thead><tbody><tr><td>id</td><td>STRING</td></tr><tr><td>data_type</td><td>STRING</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://daton-sarasanalytics.gitbook.io/daton/integrations/data-sources/analytics/taboola-v2/schema-information.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.