Method: customers.generateKeywordForecastMetrics

Belirli bir kampanya için anahtar kelime tahmininin metriklerini (gösterimler, tıklamalar, toplam maliyet gibi) döndürür.

Atılan hataların listesi: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP isteği

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateKeywordForecastMetrics

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
Alanlar
forecastPeriod

object (DateRange)

Tahmin için tarih aralığı. Başlangıç tarihi gelecekte, bitiş tarihi ise bugünden itibaren 1 yıl içinde olmalıdır. Kullanılan referans saat dilimi, müşteriye ait Google Ads hesaplarından biridir. Politika ayarlanmazsa sonraki Pazar günü ile sonraki Cumartesi arasında kalan varsayılan tarih aralığı kullanılır.
campaign

object (CampaignToForecast)

Zorunlu. Tahminde kullanılan kampanya.
currencyCode

string

Döviz kuru dönüşümü için kullanılan para birimi. Varsayılan olarak, müşterinin hesap para birimi kullanılır. Bu alanı yalnızca para birimi hesabın para biriminden farklıysa ayarlayın. Geçerli para birimi kodlarının listesini https://developers.google.com/google-ads/api/data/codes-formats#currency-codes adresinde bulabilirsiniz.

Yanıt gövdesi

[KeywordPlanIdeaService.GenerateKeywordForecastMetrics] için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
Alanlar
campaignForecastMetrics

object (KeywordForecastMetrics)

Kampanya tahmininin sonuçları.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/adwords

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

CampaignToForecast

Anahtar kelime kampanya tahmini yapmak için bir kampanya.

JSON gösterimi 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
Alanlar
languageConstants[]

string

Hedeflenecek dillerin kaynak adlarının listesi. Kaynak adı "languageConstants/{ölçütKimliği}" biçimindedir. Dil ölçüt kodlarının listesi için https://developers.google.com/google-ads/api/data/codes-formats#languages adresini inceleyin.
geoModifiers[]

object (CriterionBidModifier)

Hedeflenecek konumlar. Konumlar benzersiz olmalıdır.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Zorunlu. Hedefleme için kullanılan ağ.
negativeKeywords[]

object (KeywordInfo)

Tahmin yapılırken kampanyada kullanılacak negatif anahtar kelimelerin listesi.
biddingStrategy

object (CampaignBiddingStrategy)

Zorunlu. Kampanyanın teklif stratejisi.
adGroups[]

object (ForecastAdGroup)

Tahmin edilecek yeni kampanyadaki reklam grupları.
conversionRate

number

Kullanıcı tarafından tanımlanan beklenen dönüşüm oranı (dönüşüm sayısının toplam tıklama sayısına bölümü). Bu değer ondalık bir değer olarak ifade edildiğinden, beklenen% 2 dönüşüm oranı 0,02 olarak girilmelidir. Boş bırakılırsa tahmini bir dönüşüm oranı kullanılır.

CriterionBidModifier

Konum Ölçütü teklif değiştirici.

JSON gösterimi 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
Alanlar
geoTargetConstant

string

Hedeflenecek coğrafi konumun kaynak adı. Kaynak adı "geoTargetConstants/{ölçütKimliği}" biçimindedir.
bidModifier

number

ölçüt kimliği için ilişkili çarpan. Ayarlanırsa bu değer 0 olamaz.

CampaignBiddingStrategy

Yeni kampanya tahminleri için desteklenen teklif stratejileri.

JSON gösterimi 
{

  // Union field bidding_strategy can be only one of the following:
  "manualCpcBiddingStrategy": {
    object (ManualCpcBiddingStrategy)
  },
  "maximizeClicksBiddingStrategy": {
    object (MaximizeClicksBiddingStrategy)
  },
  "maximizeConversionsBiddingStrategy": {
    object (MaximizeConversionsBiddingStrategy)
  }
  // End of list of possible types for union field bidding_strategy.
}
Alanlar
Birleştirme alanı bidding_strategy. Teklif verme stratejileri. bidding_strategy şunlardan yalnızca biri olabilir:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Öngörme için manuel TBM teklifi verme stratejisi kullanın.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

Öngörme için tıklamaları en üst düzeye çıkarma teklif stratejisini kullanın.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

Öngörme için dönüşümleri artırma teklif stratejisini kullanın.

ManualCpcBiddingStrategy

Manuel TBM Teklifi Verme Stratejisi.

JSON gösterimi 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
Alanlar
maxCpcBidMicros

string (int64 format)

Zorunlu. Manuel TBM teklifi verme stratejisi için kampanyadaki reklam gruplarına uygulanacak mikrosaniye cinsinden teklif.
dailyBudgetMicros

string (int64 format)

Kampanya düzeyindeki bütçe (mikro ölçekte) Ayarlanırsa kampanyada kullanılan yerel para birimi için minimum bir değer uygulanır. Bu alan çok düşük bir değere ayarlanırsa minimum değer gösterilirken bir hata oluşur.

MaximizeClicksBiddingStrategy

Tıklamaları En Üst Düzeye Çıkar Teklif Stratejisi.

JSON gösterimi 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
Alanlar
dailyTargetSpendMicros

string (int64 format)

Zorunlu. Tahmin için kullanılacak, mikro cinsinden günlük hedef harcama. Kampanyada kullanılan yerel para birimi için minimum değer uygulanır. Bu alan çok düşük bir değere ayarlanırsa minimum değer gösterilirken bir hata oluşur.
maxCpcBidCeilingMicros

string (int64 format)

Mikro cinsinden maks. TBM teklifleri üst sınırı.

MaximizeConversionsBiddingStrategy

Dönüşümleri Artırma Teklif Stratejisi.

JSON gösterimi 
{
  "dailyTargetSpendMicros": string
}
Alanlar
dailyTargetSpendMicros

string (int64 format)

Zorunlu. Tahmin için kullanılacak, mikro cinsinden günlük hedef harcama. Bu değer sıfırdan büyük olmalıdır.

ForecastAdGroup

Tahmin yapılacak kampanyanın parçası olan bir reklam grubu.

JSON gösterimi 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
Alanlar
biddableKeywords[]

object (BiddableKeyword)

Zorunlu. Tahmin yapılırken reklam grubunda kullanılacak teklif verilebilir anahtar kelimelerin listesi. En az bir anahtar kelime gerektirir.
negativeKeywords[]

object (KeywordInfo)

Anahtar kelimenin ayrıntıları. Hem anahtar kelime metnini hem de eşleme türünü belirtmelisiniz.
maxCpcBidMicros

string (int64 format)

Öngörülen trafik oluşturulurken reklam grubu için kullanılacak maks. TBM. Bu değer, teklif stratejisinde ayarlanan maks. TBM değerini geçersiz kılar. Bu alanı yalnızca TBM değerlerini en üst düzeye çıkaran teklif stratejileri için belirtin.

BiddableKeyword

Bir reklam grubunun teklif verilebilir anahtar kelime parçası.

JSON gösterimi 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
Alanlar
keyword

object (KeywordInfo)

Zorunlu. Anahtar kelime. Metin ve eşleme türü olmalıdır.
maxCpcBidMicros

string (int64 format)

Tahmin simülasyonunda reklam grubu düzeyindeki maks. TBM teklifini geçersiz kılan, mikro cinsinden maks. TBM teklifi. Bu değer, teklif stratejisinde ve reklam grubunda ayarlanan maks. TBM değerini geçersiz kılar. Bu alanı yalnızca maks. TBM değerlerini destekleyen teklif stratejileri için belirtin.

KeywordForecastMetrics

Plansız anahtar kelime kampanyası için tahmin metrikleri.

JSON gösterimi 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
Alanlar
impressions

number

Toplam gösterim sayısı.
clickThroughRate

number

Ortalama tıklama oranı. Yalnızca gösterim sayısı 0'dan büyükse kullanılabilir.
averageCpcMicros

string (int64 format)

Ortalama TBM. Yalnızca tıklama sayısı 0'dan büyükse kullanılabilir.
clicks

number

Toplam tıklama sayısı.
costMicros

string (int64 format)

Toplam maliyet.
conversions

number

Öngörülen dönüşüm sayısı: tıklama sayısı * conversionRate.
conversionRate

number

Öngörülen dönüşüm oranı.
averageCpaMicros

string (int64 format)

costMicros / dönüşüm sayısı olarak hesaplanan ortalama edinme başına maliyet.