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
AdGroupAdRotationMode
AudienceSetting
- JSON gösterimi
AdGroupPrimaryStatus
AdGroupPrimaryStatusReason

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`) ], "primaryStatus": enum (`AdGroupPrimaryStatus`), "primaryStatusReasons": [ enum (`AdGroupPrimaryStatusReason`) ], "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)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "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 almıştır.
`displayCustomBidDimension`	`enum (TargetingDimension)` Reklamverenlerin, mutlak teklifler yerleştirecekleri 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 alakalı özellikler 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ürleri. Bu alan türlerine sahip öğe bağlantıları bu reklam grubu tarafından üst düzeylerden 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 düzeylerden 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.
`primaryStatus`	`enum (AdGroupPrimaryStatus)` Yalnızca çıkış. Bir reklam grubunun neden en iyi şekilde yayınlanmadığını veya neden yayınlanmadığını gösteren toplu görünüm sağlar.
`primaryStatusReasons[]`	`enum (AdGroupPrimaryStatusReason)` Yalnızca çıkış. Bir reklam grubunun neden en iyi şekilde yayınlanmadığına veya sunulmadığına ilişkin nedenleri sağlar.
`id`	`string (int64 format)` Yalnızca çıkış. Reklam grubunun kimliği.
`name`	`string` Reklam grubunun adı. Yeni reklam grupları oluşturulurken bu alan zorunludur ve boş bırakılmamalıdır. 255'ten az tam genişlikli 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şturmaya yönelik 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, birinci sayfa tanıtılan veya hedef geçiş payı değerlerinden 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ış olarak) 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ılınır. Reklam grubunun kampanya teklif stratejisi TargetRoas veya Dönüşüm Değerini Artırma (targetRoas alanı ayarlanmış olarak) 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)` Bir ürün veya hizmet için reklamı yapılan fiyatın kesirli olarak ifade edilen TBM teklifi tutarı yüzdesi. Kesir için geçerli aralık [0,1) ve burada depolanan değer 1.000.000 * [fraction]'dır.
`finalUrlSuffix`	`string` Nihai URL'ye parametre 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 (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ıt odaklı bir değerdir.
`ENABLED`	Reklam grubu etkinleştirilir.
`PAUSED`	Reklam grubu duraklatıldı.
`REMOVED`	Reklam grubu kaldırılı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ıt odaklı 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. Değer true ise bu reklam grubu, kitle hedefleme için Kitle kaynağı kullanır. Bu değer Yanlış ise bu reklam grubu bunun yerine kitle segmenti ölçütlerini kullanabilir.

useAudienceGrouped

boolean

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

AdGroupPrimaryStatus

Bir Reklam Grubunun olası durumları.

Sıralamalar
`UNSPECIFIED`	Belirtilmedi.
`UNKNOWN`	Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
`ELIGIBLE`	Reklam grubu yayınlanmaya uygun.
`PAUSED`	Reklam grubu duraklatıldı.
`REMOVED`	Reklam grubu kaldırılır.
`PENDING`	Bu reklam grubu gelecekte yayınlanabilir.
`NOT_ELIGIBLE`	Reklam grubu yayınlanmaya uygun değil.
`LIMITED`	Reklam grubunun yayınlanabilirliği sınırlı.

AdGroupPrimaryStatusReason

Reklam grubu durumunun olası nedenleri.

Sıralamalar
`UNSPECIFIED`	Belirtilmedi.
`UNKNOWN`	Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
`CAMPAIGN_REMOVED`	Kullanıcı tarafından belirtilen kampanya durumu kaldırılır. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`CAMPAIGN_PAUSED`	Kullanıcı tarafından belirtilen kampanya durumu duraklatıldı. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`CAMPAIGN_PENDING`	Bu kampanyanın başlaması için kullanıcı tarafından belirtilen zaman gelecekte. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur
`CAMPAIGN_ENDED`	Bu kampanyanın sona ermesi için kullanıcı tarafından belirtilen süre geçti. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`AD_GROUP_PAUSED`	Kullanıcı tarafından belirtilen reklam grubu durumu duraklatıldı. AdGroupPrimaryStatus.PAUSED değerine katkıda bulunur.
`AD_GROUP_REMOVED`	Kullanıcı tarafından belirtilen reklam grubu durumu kaldırılır. AdGroupPrimaryStatus.REMOVED öğesine katkıda bulunur.
`AD_GROUP_INCOMPLETE`	Bu reklam grubunun oluşturulması henüz tamamlanmadı. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`KEYWORDS_PAUSED`	Bu reklam grubunda kullanıcı tarafından belirtilen anahtar kelime durumlarının tümü duraklatıldı. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`NO_KEYWORDS`	Bu reklam grubunda uygun anahtar kelime yok. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`AD_GROUP_ADS_PAUSED`	Bu reklam grubunda kullanıcı tarafından belirtilen reklam grubu reklam durumlarının tümü duraklatıldı. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`NO_AD_GROUP_ADS`	Bu reklam grubunda uygun bir reklam grubu reklamı yok. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`HAS_ADS_DISAPPROVED`	En az bir reklamın onaylanmamasındaki politika durumu nedeni. Birden çok AdGroupPrimaryStatus katkıda bulunur.
`HAS_ADS_LIMITED_BY_POLICY`	En az bir reklamın politika nedeniyle sınırlandığı politika durumunun nedeni. Birden çok AdGroupPrimaryStatus katkıda bulunur.
`MOST_ADS_UNDER_REVIEW`	Çoğu reklamın incelenmeyi beklediği durumlarda geçerli olan politika durumu. AdGroupPrimaryStatus.PENDING'ye katkıda bulunur.
`CAMPAIGN_DRAFT`	Reklam Grubu, bir Taslak kampanyaya ait. AdGroupPrimaryStatus.NOT_ELIGIBLE'a katkıda bulunur.
`AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY`	Reklam grubu, yayındaki etkinliğin uzun süre düşük olması nedeniyle duraklatıldı. AdGroupPrimaryStatus.PAUSED değerine katkıda bulunur.