--- title: Unified Ads Management API — Truto Unified API slug: ads canonical: "https://truto.one/unified-apis/ads/" --- # Advertising Management Unified API Integrate Advertising Management data across 3 providers with one API. 7 normalized resources, real-time pass-through, fully customizable. **Base URL:** `https://api.truto.one/unified/ads` **Resources:** 7 **Integrations:** 3 ## Resources ### Accounts Accounts are the top level resource in the Ads API. Each account has a unique ID and contains a set of campaigns. (10 fields) - `id` (string) — The unique identifier for the account. - `name` (string) — The name of the account. - `currency_code` (string) — The currency code for the account. - `status` (string) — The status of the account. - `timezone` (object) — The timezone for the account. - `type` (array) — The type of the account. - `spend` (object) — The spend for the account. - `disable_reason` (string) — The reason the account is disabled. - `created_at` (string) — The date and time the account was created. - `updated_at` (string) — The date and time the account was last updated. ### Ad Groups Ad Groups are the third level resource in the Ads API. Each ad_group has a unique ID and contains a set of ads. (23 fields) - `id` (string) — The unique identifier for the ad_group. - `name` (string) — The name of the ad_group. - `status` (string) — The status of the campaign. - `account_id` (string) — The unique identifier for the account. - `campaign_id` (string) — The unique identifier for the campaign. - `labels` (array) — The labels for the ad_group. - `attribution_spec` (string) — The attribution spec for the ad_group. - `bid` (object) — The bid for the ad_group. - `billing_event` (string) — The billing event for the ad_group. - `budget` (object) — The budget for the ad_group. - `spend` (object) — The spend for the ad_group. - `impressions` (object) — The impressions for the ad_group. - `destination` (object) — The destination type for the ad_group. - `start_time` (string) — The start time for the ad_group. - `stop_time` (string) — The stop time for the ad_group. - `issues` (array) — The issues for the ad_group that prevented ads from being delivered. - `optimization_goal` (string) — The optimization goal for the ad_group. - `promoted_object` (object) — The promoted object for the ad_group. - `targeting` (object) — The targeting for the ad_group. - `targeting_optimization_types` (array) — - `schedule` (object) — The schedule for the ad_group. - `created_at` (string) — The date and time the ad_group was created. - `updated_at` (string) — The date and time the ad_group was last updated. ### Ads Ads are the fourth level resource in the Ads API. Each ad has a unique ID and contains a set of creatives. (18 fields) - `id` (string) — The unique identifier for the ad. - `name` (string) — The name of the ad. - `type` (string) — The type of the ad - `status` (string) — The status of the ad. - `account_id` (string) — The unique identifier for the account. - `ad_group_id` (string) — The unique identifier for the ad_group. - `campaign_id` (string) — The unique identifier for the campaign. - `labels` (array) — The labels for the ad. - `schedule` (object) — The schedule for the ad. - `bid` (object) — The bid for the ad. - `conversion_domain` (string) — The conversion domain for the ad. - `creative` (object) — The creative for the ad. - `creative_id` (array) — The unique identifier for the creative. - `issues` (array) — The issues for the ad that prevented the ad from being delivered. - `preview_url` (array) — The preview URL for the ad. - `tracking_specs` (array) — The tracking specs for the ad. - `created_at` (string) — The date and time the ad was created. - `updated_at` (string) — The date and time the ad was last updated. ### Assets The assets like images, videos, etc. which can be used in the ads and creatives. (14 fields) - `id` (string) — The unique identifier for the asset. - `type` (string) — The type of the asset. - `account_id` (string) — The unique identifier for the account. - `creative_id` (array) — The unique identifiers for the creatives. - `hash` (string) — The hash for the asset. - `height` (integer) — The height for the asset. - `width` (integer) — The width for the asset. - `name` (string) — The name for the asset. - `original_height` (integer) — The original height for the asset. - `original_width` (integer) — The original width for the asset. - `status` (string) — The status for the asset. - `urls` (array) — The URLs for the asset. - `created_at` (string) — The date and time the asset was created. - `updated_at` (string) — The date and time the asset was last updated. ### Campaigns Campaigns are the second level resource in the Ads API. Each campaign has a unique ID and contains a set of ad_groups. (18 fields) - `id` (string) — The unique identifier for the campaign. - `name` (string) — The name of the campaign. - `status` (string) — The status of the campaign. - `type` (string) — The type of the campaign - `account_id` (string) — The unique identifier for the account. - `labels` (array) — The labels for the campaign. - `objective` (string) — The objective of the campaign. - `bid_strategy` (object) — The bid strategy for the campaign. - `buying_type` (string) — The buying type for the campaign. - `budget` (object) — The budget for the campaign. - `spend` (object) — The spend for the campaign. - `primary_attribution` (string) — The primary attribution for the campaign. - `special_ad_categories` (array) — The special ad categories for the campaign. - `special_ad_category` (string) — The special ad category for the campaign. - `start_time` (string) — The start time for the campaign. - `stop_time` (string) — The stop time for the campaign. - `created_at` (string) — The date and time the campaign was created. - `updated_at` (string) — The date and time the campaign was last updated. ### Creatives Creatives provide the layout and content for an ad. (18 fields) - `id` (string) — The unique identifier for the creative. - `name` (string) — The name of the creative. - `status` (string) — The status of the creative. - `account_id` (string) — The unique identifier for the account. - `labels` (array) — The labels for the creative. - `applink_treatment` (string) — The applink treatment for the creative. - `authorization_category` (string) — The authorization category for the creative. - `body` (string) — The body for the creative. - `call_to_action_type` (string) — The call to action type for the creative. - `image_crops` (object) — The image crops for the creative. - `image_hash` (string) — The image hash for the creative. - `image_url` (string) — The image URL for the creative. - `properties` (array) — The properties for the creative. - `spec` (object) — The spec for the creative. - `interactive_components` (object) — The interactive components for the creative. - `urls` (array) — The URLs for the creative. - `created_at` (string) — The date and time the creative was created. - `updated_at` (string) — The date and time the creative was last updated. ### Custom Audiences (10 fields) - `id` (string) — The unique identifier for the custom audience. - `name` (string) — The name of the custom audience. - `description` (string) — The description of the custom audience. - `type` (string) — The type of custom audience. - `source` (string) — The source of custom audience. - `status` (string) — The status of the custom audience. - `account_id` (string) — The unique identifier for the account. - `members` (array) — A list of audience members. - `created_at` (string) — The date and time the account was created. - `updated_at` (string) — The date and time the account was last updated. ## Supported integrations - [Google Ads](https://truto.one/integrations/detail/googleads/) - [LinkedIn](https://truto.one/integrations/detail/linkedin/) - [Meta Marketing API](https://truto.one/integrations/detail/metamarketing/)