Ad
Stay organized with collections Save and categorize content based on your preferences.
| Fields |
|---|
resource_name
| string
Immutable. The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
|
final_urls[]
| string
The list of possible final URLs after all cross-domain redirects for the ad. |
final_app_urls[]
| FinalAppUrl
A list of final app URLs that will be used on mobile if the user has the specific app installed. |
final_mobile_urls[]
| string
The list of possible final mobile URLs after all cross-domain redirects for the ad. |
url_custom_parameters[]
| CustomParameter
The list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, use url custom parameter operations. |
type
| AdType
Output only. The type of ad. |
device_preference
| Device
The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. |
url_collections[]
| UrlCollection
Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. |
system_managed_resource_source
| SystemManagedResourceSource
Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. |
id
| int64
Output only. The ID of the ad. |
tracking_url_template
| string
The URL template for constructing a tracking URL. |
final_url_suffix
| string
The suffix to use when constructing a final URL. |
display_url
| string
The URL that appears in the ad description for some ad formats. |
added_by_google_ads
| bool
Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing. |
name
| string
Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd. |
Union field ad_data
ad_data. Details pertinent to the ad type. Exactly one value must be set. ad_data can be only one of the following: |
text_ad
| TextAdInfo
Immutable. Details pertaining to a text ad. |
expanded_text_ad
| ExpandedTextAdInfo
Details pertaining to an expanded text ad. |
call_ad
| CallAdInfo
Details pertaining to a call ad. |
expanded_dynamic_search_ad
| ExpandedDynamicSearchAdInfo
Immutable. Details pertaining to an Expanded Dynamic Search Ad. This type of ad has its headline, final URLs, and display URL auto-generated at serving time according to domain name specific information provided by dynamic_search_ads_setting linked at the campaign level. |
hotel_ad
| HotelAdInfo
Details pertaining to a hotel ad. |
| ShoppingSmartAdInfo
Details pertaining to a Smart Shopping ad. |
| ShoppingProductAdInfo
Details pertaining to a Shopping product ad. |
image_ad
| ImageAdInfo
Immutable. Details pertaining to an Image ad. |
video_ad
| VideoAdInfo
Details pertaining to a Video ad. |
video_responsive_ad
| VideoResponsiveAdInfo
Details pertaining to a Video responsive ad. |
responsive_search_ad
| ResponsiveSearchAdInfo
Details pertaining to a responsive search ad. |
legacy_responsive_display_ad
| LegacyResponsiveDisplayAdInfo
Details pertaining to a legacy responsive display ad. |
app_ad
| AppAdInfo
Details pertaining to an app ad. |
legacy_app_install_ad
| LegacyAppInstallAdInfo
Immutable. Details pertaining to a legacy app install ad. |
responsive_display_ad
| ResponsiveDisplayAdInfo
Details pertaining to a responsive display ad. |
local_ad
| LocalAdInfo
Details pertaining to a local ad. |
display_upload_ad
| DisplayUploadAdInfo
Details pertaining to a display upload ad. |
app_engagement_ad
| AppEngagementAdInfo
Details pertaining to an app engagement ad. |
| ShoppingComparisonListingAdInfo
Details pertaining to a Shopping Comparison Listing ad. |
smart_campaign_ad
| SmartCampaignAdInfo
Details pertaining to a Smart campaign ad. |
app_pre_registration_ad
| AppPreRegistrationAdInfo
Details pertaining to an app pre-registration ad. |
demand_gen_multi_asset_ad
| DemandGenMultiAssetAdInfo
Details pertaining to a Demand Gen multi asset ad. |
demand_gen_carousel_ad
| DemandGenCarouselAdInfo
Details pertaining to a Demand Gen carousel ad. |
demand_gen_video_responsive_ad
| DemandGenVideoResponsiveAdInfo
Details pertaining to a Demand Gen video responsive ad. |
demand_gen_product_ad
| DemandGenProductAdInfo
Details pertaining to a Demand Gen product ad. |
travel_ad
| TravelAdInfo
Details pertaining to a travel ad. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-25 UTC."],[[["The \"Ad\" resource represents an advertisement within a Google Ads account and can be of various types, including text, video, image, and more."],["Ads can target specific devices, use custom parameters for tracking, and have various fields for different ad formats."],["An ad can be identified by its resource name, which follows a specific format, and may have a unique ID assigned by the system."],["Depending on the ad type, additional information is provided in the \"ad_data\" field, offering details specific to each format."],["Ad URLs can be tracked using templates, suffixes, and collections, enabling detailed performance analysis and redirection control."]]],["This document details the structure and attributes of ads within the Google Ads platform. Key information includes ad resource names, which follow a specific format (`customers/{customer_id}/ads/{ad_id}`), and various URL-related fields, such as `final_urls`, `final_mobile_urls`, and `tracking_url_template`, used for directing traffic. Ads can be tailored for specific devices using `device_preference`. The document also lists various ad types, each with its own specific data, like text ads, video ads, and app ads. Certain details can be system managed or added by Google Ads.\n"]]