Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Öğeler; görüntülü, YouTube ve uygulama mağazası gibi birden fazla biçimde farklı türlerde reklamlar oluşturmak için kullanılan, paylaşılabilir veri birimleridir (ör. resimler, videolar, başlıklar ve açıklamalar).
Nesneler
API'deki en temel nesneler şunlardır:
Asset: Paylaşılabilir reklamcılık verileri birimi
AssetType: Öğenin içerdiği içerik türü (ör. metin veya resim)
AssetFieldType: Öğenin nasıl kullanıldığı (ör. bir metin öğesi türü, başlık veya açıklama öğesi alanı türü olarak kullanılabilir)
AssetSet: Bir tema etrafında toplanan veya kampanyaya göre düzenlenen öğe koleksiyonu
AssetSetType: Öğe grubu sınıfı
Öğeler, öğe kümeleri, reklam grupları, kampanyalar ve müşteriler arasındaki bağlantıları temsil eden nesneler vardır:
Öğelerle bağlantılar
CustomerAsset: Müşteri ile öğe arasındaki bağlantı
CampaignAsset: Kampanya ile öğe arasındaki bağlantı
AdGroupAsset: Reklam grubu ile öğe arasındaki bağlantı
AssetSetAsset: Öğe grubu ile öğe arasındaki bağlantı
Öğe kümeleriyle bağlantılar
CustomerAssetSet: Bir müşteri ile bir öğe grubu arasındaki bağlantı
CampaignAssetSet: Kampanya ile öğe grubu arasındaki bağlantı
AdGroupAssetSet: Reklam grubu ile öğe grubu arasındaki bağlantı
Kampanya öğeleri örneği
Nesnelerin nasıl bağlanabileceğine dair görsel bir temsil aşağıda verilmiştir. Örnekte en üstte kampanyalar yer alıyor ancak aynı hiyerarşi müşteriler ve reklam grupları için de geçerlidir.
Kampanya öğe gruplarının şeması
CampaignAssetSet oluşturmadan önce bir Campaign ve bir veya daha fazla öğe içeren bir AssetSet oluşturmanız gerekir. Kampanyanızdaki geçerli tüm reklam biçimleri için bir envanter oluşturmak üzere öğeleri bir araya getirebilir veya Google Ads'in, reklamın yayınlandığı kanala (YouTube, Gmail, Arama vb.) göre mevcut öğeleri karıştırıp eşleştirmesine izin verebilirsiniz.
Reklamlara bağlı öğe türleri
Bazı öğe türleri doğrudan reklamlara bağlanabilir.
Öğe türü
AssetFieldType
Reklam türü
Video
YOUTUBE_VIDEO
Uygulama reklamı Uygulama etkileşim reklamı Yerel reklam Duyarlı görüntülü reklam
Medya paketi
MEDIA_BUNDLE CUSTOM_LAYOUT
Uygulama reklamı Görüntülü yükleme reklamı
Resim
MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE
Uygulama reklamı Uygulama etkileşim reklamı Yerel reklam Duyarlı görüntülü reklam
Uygulama reklamı Uygulama etkileşimi reklamı Yerel reklam Duyarlı görüntülü reklam Duyarlı arama ağı reklamı Akıllı kampanya reklamı
Harekete Geçirici Mesaj
CALL_TO_ACTION
Yerel reklam Duyarlı görüntülü reklam
Müşterilere, kampanyalara ve reklam gruplarına bağlı öğe türleri
Bazı öğe türleri, bağlantı nesneleri aracılığıyla müşterilere, kampanyalara veya reklam gruplarına bağlanabilir.
Öğe türü
AssetFieldType
Bağlantı
Değiştirilebilir (Mutable)
Müşteri mesajı
BUSINESS_MESSAGE
AdGroupAsset CampaignAsset CustomerAsset
Evet
Metin
BUSINESS_NAME
CampaignAsset CustomerAsset
Hayır
Resim
AD_IMAGE
AdGroupAsset CampaignAsset
Hayır
Resim
BUSINESS_LOGO
CampaignAsset CustomerAsset
Hayır
Potansiyel müşteri formu
LEAD_FORM
CampaignAsset
Evet
Promosyon
TANITIM
AdGroupAsset CampaignAsset CustomerAsset
Evet
Açıklama metni
AÇIKLAMA METNİ
AdGroupAsset CampaignAsset CustomerAsset
Evet
Ek açıklamalı snippet
STRUCTURED_SNIPPET
AdGroupAsset CampaignAsset CustomerAsset
Evet
Site bağlantısı
SİTE BAĞLANTISI
AdGroupAsset CampaignAsset CustomerAsset
Evet
Mobil uygulama
MOBILE_APP
AdGroupAsset CampaignAsset CustomerAsset
Evet
Otel açıklama metni
HOTEL_CALLOUT
AdGroupAsset CampaignAsset CustomerAsset
Evet
Telefon
ARA
AdGroupAsset CampaignAsset CustomerAsset
Evet
Fiyat
FİYAT
AdGroupAsset CampaignAsset CustomerAsset
Evet
Yer öğeleri
Konum öğeleri, diğer öğe türlerinden farklı şekilde işlenir. Ayrıntılar için Konum
öğeleri başlıklı makaleyi inceleyin.
Otomatik olarak oluşturulmuş öğeler
Otomatik olarak oluşturulmuş öğeler değiştirilemez. AssetSource simgesi, bir öğenin kullanıcı tarafından mı oluşturulduğunu yoksa sistem tarafından mı otomatik olarak oluşturulduğunu gösterir. Site bağlantısı gibi değiştirilebilir
türler, otomatik olarak oluşturulmuş öğelere bağlanamaz.
Öğe gruplarına bağlı öğe türleri
Belirli öğe türleri, belirli öğe grubu türlerine bağlanabilir.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-09-05 UTC."],[[["\u003cp\u003eAssets are shareable data units like images and text, used to build various ad types across different platforms.\u003c/p\u003e\n"],["\u003cp\u003eAssets are organized into Asset Sets and linked to Campaigns, Ad Groups, and Customers for streamlined management.\u003c/p\u003e\n"],["\u003cp\u003eSpecific Asset Types can be directly linked to ads or linked through linkage objects for greater flexibility.\u003c/p\u003e\n"],["\u003cp\u003eSome Asset Types are automatically created by the system and cannot be modified, indicated by their AssetSource.\u003c/p\u003e\n"],["\u003cp\u003eCertain Asset Types are designed to be used with specific Asset Set Types for specialized campaign setups.\u003c/p\u003e\n"]]],[],null,["Assets are units of shareable data---such as images, videos, headlines, and\ndescriptions---that are used to construct different types of ads across\nmultiple formats, such as display, YouTube, app store, and others.\n\nObjects\n\nThe most basic objects in the API are the following:\n\n- **`Asset`:** A unit of shareable advertising data\n - **`AssetType`:** The kind of content the asset contains---for example, text or image\n - **`AssetFieldType`:** How the asset is used---for example, a text asset type can be used as a headline or a description asset field type\n- **`AssetSet`** : A collection of assets centered around a theme or organized by campaign\n - **`AssetSetType`**: The class of the asset set\n\nThere are objects that represent links among assets, asset sets, ad groups,\ncampaigns, and customers:\n\n- Linkages to assets\n\n - **`CustomerAsset`:** The link between a customer and an asset\n - **`CampaignAsset`:** The link between a campaign and an asset\n - **`AdGroupAsset`:** The link between an ad group and an asset\n - **`AssetSetAsset`:** The link between an asset set and an asset\n- Linkages to asset sets\n\n - **`CustomerAssetSet`:** The link between a customer and an asset set\n - **`CampaignAssetSet`:** The link between a campaign and an asset set\n - **`AdGroupAssetSet`:** The link between an ad group and an asset set\n\nCampaign assets example\n\nHere's a visual representation of how some of the objects can be linked. The\nexample starts with campaigns at the top, but the same hierarchy also applies to\ncustomers and ad groups.\nDiagram of campaign asset sets\n\nBefore you create a `CampaignAssetSet`, you must first create a\n[`Campaign`](/google-ads/api/docs/campaigns/create-campaigns) and an `AssetSet` containing\none or more assets. You can assemble assets to create an inventory for all\napplicable ad formats in your campaign, or let Google Ads mix and match available\nassets based on which channel the ad is being served: YouTube, Gmail, Search,\nand others.\n| **Key Point:** A `Campaign` can link to one or more `CampaignAssetSet` objects, but each `CampaignAssetSet` can be linked to only one `Campaign`.\n\nAsset types linked to ads\n\nSome asset types can be linked directly to ads.\n\n| Asset type | AssetFieldType | Ad type |\n|----------------|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|\n| Video | YOUTUBE_VIDEO | App ad App engagement ad Local ad Responsive display ad |\n| Media bundle | MEDIA_BUNDLE CUSTOM_LAYOUT | App ad Display upload Ad |\n| Image | MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE | App ad App engagement ad Local ad Responsive display ad |\n| Text | HEADLINE LONG_HEADLINE DESCRIPTION MANDATORY_AD_TEXT CALL_TO_ACTION_SELECTION BUSINESS_NAME | App ad App engagement ad Local ad Responsive display ad Responsive search ad Smart campaign ad |\n| Call to Action | CALL_TO_ACTION | Local ad Responsive display ad |\n\nAsset types linked to customers, campaigns, and ad groups\n\nSome types of assets can be linked to customers, campaigns, or ad groups through\nlinkage objects.\n| **Note:** For `BUSINESS_MESSAGE` assets:\n|\n| - Each customer can have only one active business message asset.\n| - At the campaign and ad group levels, you can assign only one active business message asset for each message provider type.\n\n| Asset type | AssetFieldType | Linkage | Mutable |\n|--------------------|--------------------|------------------------------------------|---------|\n| Business message | BUSINESS_MESSAGE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Text | BUSINESS_NAME | CampaignAsset CustomerAsset | No |\n| Image | AD_IMAGE | AdGroupAsset CampaignAsset | No |\n| Image | BUSINESS_LOGO | CampaignAsset CustomerAsset | No |\n| Lead form | LEAD_FORM | CampaignAsset | Yes |\n| Promotion | PROMOTION | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Callout | CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Structured snippet | STRUCTURED_SNIPPET | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Sitelink | SITELINK | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Mobile app | MOBILE_APP | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Hotel callout | HOTEL_CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Call | CALL | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Price | PRICE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n\nLocation assets\n\nLocation assets are handled differently from other asset types. See [Location\nassets](/google-ads/api/docs/assets/location-assets) for details.\n\nAutomatically created assets\n\nAutomatically created assets cannot be modified. The\n[`AssetSource`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource) indicates whether an\nasset was user-created or was automatically generated by the system. Mutable\ntypes like sitelink can't be linked to automatically created assets.\n\nAsset types linked to asset sets\n\nCertain asset types can be linked to specific types of asset sets.\n\n| AssetType | AssetSetType | Linkage | Mutable |\n|----------------------------|------------------------------|---------------------------------------------------|-----------------------|\n| PAGE_FEED | PAGE_FEED | CampaignAssetSet | Yes |\n| DYNAMIC_EDUCATION | DYNAMIC_EDUCATION | CampaignAssetSet | Yes |\n| DYNAMIC_CUSTOM | DYNAMIC_CUSTOM | CampaignAssetSet | Yes |\n| DYNAMIC_HOTELS_AND_RENTALS | DYNAMIC_HOTELS_AND_RENTALS | CampaignAssetSet | Yes |\n| DYNAMIC_REAL_ESTATE | DYNAMIC_REAL_ESTATE | CampaignAssetSet | Yes |\n| DYNAMIC_LOCAL | DYNAMIC_LOCAL | CampaignAssetSet | Yes |\n| DYNAMIC_FLIGHTS | DYNAMIC_FLIGHTS | CampaignAssetSet | Yes |\n| DYNAMIC_JOBS | DYNAMIC_JOBS | CampaignAssetSet | Yes |\n| DYNAMIC_TRAVEL | DYNAMIC_TRAVEL | CampaignAssetSet | Yes |\n| LOCATION | LOCATION_SYNC | CustomerAssetSet CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | GMB_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | CHAIN_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | STATIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |"]]
