Dikkat: API'nin REST arayüzüyle ilgili dokümanları görüntülüyorsunuz. Resmi istemci kitaplıklarımızın çoğu gTB kullanır. Ayrıntılar için REST Tanıtımı'nı inceleyin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

AdGroup

JSON gösterimi
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- JSON gösterimi

Bir reklam grubu.

JSON gösterimi

JSON gösterimi
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Alanlar
`resourceName`	`string` Sabit. Reklam grubunun kaynak adı. Reklam grubu kaynak adları şu biçimdedir: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` Reklam grubunun durumu.
`type`	`enum (AdGroupType)` Sabit. Reklam grubunun türü.
`adRotationMode`	`enum (AdGroupAdRotationMode)` Reklam grubunun reklam rotasyonu modu.
`urlCustomParameters[]`	`object (CustomParameter)` `trackingUrlTemplate`, `finalUrls` veya `mobile_final_urls` içinde özel parametre etiketlerini değiştirmek için kullanılan eşleme listesi.
`optimizedTargetingEnabled`	`boolean` Optimize hedefleme etkinse doğru değerini döndürür. Optimize Hedefleme, Kitle Genişletme'nin yerini alacaktır.
`displayCustomBidDimension`	`enum (TargetingDimension)` Reklamverenlerin, mutlak teklifler verebilecekleri bir hedefleme boyutu belirtmesine olanak tanır. Bu yalnızca, Arama Ağı'nı değil, yalnızca Görüntülü Reklam Ağı'nı hedefleyen kampanyalar için geçerlidir.
`targetingSetting`	`object (TargetingSetting)` Hedeflemeyle ilgili özellikler için ayar.
`audienceSetting`	`object (AudienceSetting)` Sabit. Kitleyle ilgili özellikler için ayar.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Yalnızca çıkış. Geçerli hedef EBM'nin kaynağı. Bu alan salt okunurdur.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Yalnızca çıkış. Geçerli hedef ROAS'ın kaynağı. Bu alan salt okunurdur.
`labels[]`	`string` Yalnızca çıkış. Bu reklam grubuna ekli etiketlerin kaynak adları.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` Bu reklam grubundan hariç tutulması gereken öğe alanı türleridir. Bu alan türlerine sahip öğe bağlantıları bu reklam grubu tarafından üst seviyelerden devralınmaz.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Bu reklam grubundan hariç tutulması gereken öğe grubu türleri. Bu türlere sahip öğe grubu bağlantıları, bu reklam grubu tarafından üst seviyelerden devralınmaz. Konum grubu türleri (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP ve STATIC_LOCATION_GROUP) LOCATION_SYNC'in alt türleridir. Bu nedenle, bu alan için LOCATION_SYNC ayarlanırsa, hiçbir yer grubu öğe grubunun bu reklam grubuna bağlanmasına izin verilmez ve hiçbir Yer Uzantısı (LE) ve Satış Ortağı Yer Uzantıları (ALE) bu reklam grubu altında yayınlanmaz. Şu anda yalnızca LOCATION_SYNC desteklenmektedir.
`id`	`string (int64 format)` Yalnızca çıkış. Reklam grubunun kimliği.
`name`	`string` Reklam grubunun adı. Yeni reklam grupları oluştururken bu alan zorunludur ve boş bırakılmamalıdır. 255'ten az tam genişlikli UTF-8 karakter içermelidir. Boş (kod noktası 0x0), yeni satır (kod noktası 0xA) veya satır başı karakteri (kod noktası 0xD) içermemelidir.
`baseAdGroup`	`string` Yalnızca çıkış. Taslak veya deneme reklam grupları için bu alan, bu reklam grubunun oluşturulduğu ana reklam grubunun kaynak adıdır. Bir taslak veya deneme reklam grubunda temel reklam grubu yoksa bu alan boş olur. Temel reklam grupları için bu alan, reklam grubu kaynak adına eşittir. Bu alan salt okunurdur.
`trackingUrlTemplate`	`string` İzleme URL'si oluşturmak için kullanılan URL şablonu.
`campaign`	`string` Sabit. Reklam grubunun ait olduğu kampanya.
`cpcBidMicros`	`string (int64 format)` Maksimum TBM (tıklama başına maliyet) teklifi.
`effectiveCpcBidMicros`	`string (int64 format)` Yalnızca çıkış. Teklif stratejisi manuel TBM, geliştirilmiş TBM, tanıtılan sayfa veya hedef geçiş payından biri olduğunda, değer, TBM (tıklama başına maliyet) teklif değeriyle aynı olur. Aksi takdirde, boş olur.
`cpmBidMicros`	`string (int64 format)` Maksimum BGBM (görüntülenebilir bin gösterim başına maliyet) teklifi.
`targetCpaMicros`	`string (int64 format)` Hedef EBM (edinme başına maliyet). Reklam grubunun kampanya teklif stratejisi Hedef EBM veya Dönüşümleri Artırma (hedef EBM alanı ayarlanmış şekilde) ise bu alan, kampanyanın teklif stratejisinde belirtilen hedef EBM'yi geçersiz kılar. Aksi takdirde bu değer yoksayılır.
`cpvBidMicros`	`string (int64 format)` GBM (görüntüleme başına maliyet) teklifi.
`targetCpmMicros`	`string (int64 format)` Reklamın her bin gösterimi için reklamverenin ödemek istediği, mikro cinsinden ortalama tutar.
`targetRoas`	`number` Hedef ROAS (reklam harcamalarından elde edilen gelir) geçersiz kılması. Reklam grubunun kampanya teklif stratejisi TargetRoas veya Dönüşüm Değerini Artırma (targetRoas alanı ayarlanmış halde) ise bu alan, kampanyanın teklif stratejisinde belirtilen hedef ROAS'ı geçersiz kılar. Aksi takdirde bu değer yoksayılır.
`percentCpcBidMicros`	`string (int64 format)` Belirli bir ürün veya hizmet için reklamı yapılan fiyatın oranı olarak ifade edilen TBM teklif tutarı yüzdesi. Kesir için geçerli aralık [0,1) ve burada depolanan değer 1.000.000 * [fraction] şeklindedir.
`finalUrlSuffix`	`string` Parametreleri Nihai URL'ye eklemek için URL şablonu.
`effectiveTargetCpaMicros`	`string (int64 format)` Yalnızca çıkış. Geçerli hedef EBM (edinme başına maliyet). Bu alan salt okunurdur.
`effectiveTargetRoas`	`number` Yalnızca çıkış. Geçerli hedef ROAS'tır (reklam harcamalarından elde edilen gelir). Bu alan salt okunurdur.

AdGroupStatus

Bir reklam grubunun olası durumları.

Sıralamalar
`UNSPECIFIED`	Durum belirtilmedi.
`UNKNOWN`	Alınan değer bu sürümde bilinmiyor. Bu yalnızca yanıta yönelik bir değerdir.
`ENABLED`	Reklam grubu etkinleştirildi.
`PAUSED`	Reklam grubu duraklatıldı.
`REMOVED`	Reklam grubu kaldırılır.

AdGroupType

Olası reklam grubu türlerini listeleyen sıralama.

Sıralamalar
`UNSPECIFIED`	Tür belirtilmedi.
`UNKNOWN`	Alınan değer bu sürümde bilinmiyor. Bu yalnızca yanıta yönelik bir değerdir.
`SEARCH_STANDARD`	Arama Ağı kampanyaları için varsayılan reklam grubu türü.
`DISPLAY_STANDARD`	Görüntülü Reklam Ağı kampanyaları için varsayılan reklam grubu türü.
`SHOPPING_PRODUCT_ADS`	Standart ürün reklamları yayınlayan Alışveriş kampanyaları için reklam grubu türü.
`HOTEL_ADS`	Otel kampanyaları için varsayılan reklam grubu türüdür.
`SHOPPING_SMART_ADS`	Akıllı Alışveriş kampanyalarındaki reklam gruplarının türü.
`VIDEO_BUMPER`	Kısa, atlanamayan video içi reklamlar
`VIDEO_TRUE_VIEW_IN_STREAM`	TrueView (atlanabilir) yayın içi video reklamları.
`VIDEO_TRUE_VIEW_IN_DISPLAY`	Görüntülü (In-display) TrueView video reklamları.
`VIDEO_NON_SKIPPABLE_IN_STREAM`	Atlanamayan video içi reklamlar
`VIDEO_OUTSTREAM`	Yayın dışı video reklamlar.
`SEARCH_DYNAMIC_ADS`	Dinamik Arama Ağı Reklamları reklam grupları için reklam grubu türü.
`SHOPPING_COMPARISON_LISTING_ADS`	Alışveriş Karşılaştırma Girişi kampanyalarındaki reklam gruplarının türü.
`PROMOTED_HOTEL_ADS`	Tanıtılan Otel reklam grupları için reklam grubu türü.
`VIDEO_RESPONSIVE`	Video duyarlı reklam grupları.
`VIDEO_EFFICIENT_REACH`	Video açısından etkili erişim reklam grupları.
`SMART_CAMPAIGN_ADS`	Akıllı kampanyalar için reklam grubu türü.
`TRAVEL_ADS`	Seyahat kampanyaları için reklam grubu türü.

AdGroupAdRotationMode

Bir reklam grubunun olası reklam rotasyonu modları.

Sıralamalar
`UNSPECIFIED`	Reklam rotasyonu modu belirtilmedi.
`UNKNOWN`	Alınan değer bu sürümde bilinmiyor. Bu yalnızca yanıta yönelik bir değerdir.
`OPTIMIZE`	Reklam grubu reklamlarını tıklamalara veya dönüşümlere göre optimize edin.
`ROTATE_FOREVER`	Sonsuza kadar eşit sıklıkta dönüşümlü yayınla.

AudienceSetting

Kitle hedefleme ayarları.

JSON gösterimi
{ "useAudienceGrouped": boolean }

Alanlar

Alanlar
`useAudienceGrouped`	`boolean` Sabit. Doğru ise bu reklam grubu, kitle hedefleme için Kitle kaynağı kullanır. Bu değer yanlışsa bu reklam grubu bunun yerine kitle segmenti ölçütlerini kullanabilir.

useAudienceGrouped

boolean

Sabit. Doğru ise bu reklam grubu, kitle hedefleme için Kitle kaynağı kullanır. Bu değer yanlışsa bu reklam grubu bunun yerine kitle segmenti ölçütlerini kullanabilir.