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/v14/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

İstek gövdesi, aşağıdaki yapıyla birlikte 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. Ayarlanmazsa sonraki Pazar gününden bir sonraki Cumartesi gününe kadar olan bir 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 kampanyası tahmini yapmak için kullanılan 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 ziyaret edin.
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)

Yeni kampanyadaki tahmin edilecek 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 sayı olarak ifade edildiği için% 2'lik beklenen dönüşüm oranı 0, 02 olarak girilmelidir. Boş bırakılırsa tahmini 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çütId 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
bidding_strategy alanı. Teklif verme stratejileri. bidding_strategy şunlardan yalnızca biri olabilir:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

Öngörme için manuel TBM teklifi verme stratejisini 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 teklif verme stratejisi için kampanyadaki reklam gruplarına uygulanacak mikrosaniye cinsinden bir 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 değer uygulanır. Bu alan çok düşük bir değere ayarlanırsa minimum değer gösterilirse 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österilirse hata oluşur.
maxCpcBidCeilingMicros

string (int64 format)

Maks. TBM tekliflerinin mikro cinsinden tavanı.

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 bir 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ü belirtmeniz gerekir.
maxCpcBidMicros

string (int64 format)

Öngörülen trafik oluşturulurken reklam grubu için kullanılacak maks. TBM'dir. Bu değer, teklif stratejisinde ayarlanan maks. TBM değerini geçersiz kılar. Bu alanı yalnızca TBM değerlerini maksimum 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ü bulunmalıdır.
maxCpcBidMicros

string (int64 format)

Tahmin simülasyonunda reklam grubu düzeyindeki maks. TBM teklifini geçersiz kılan, mikro cinsinden bir 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 olduğunda kullanılabilir.
averageCpcMicros

string (int64 format)

Ortalama TBM. Yalnızca tıklama sayısı > 0 olduğunda 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)

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