Method: customers.recommendations.apply

Verilen önerileri karşılık gelen uygulama parametreleriyle uygular.

Atılan hataların listesi: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError

HTTP isteği

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

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Öneriyi içeren müşterinin kimliği.

İstek içeriği

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

JSON gösterimi 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
Alanlar
operations[]

object (ApplyRecommendationOperation)

Zorunlu. Önerilerin uygulanacağı işlemlerin listesi. kısmiFailure=false tüm öneriler aynı türde olmalıdır. İstek başına 100 işlem sınırı vardır.
partialFailure

boolean

Doğru değerine ayarlanırsa başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. Yanlış değerine ayarlanırsa işlemler, yalnızca hepsinin geçerli olması durumunda işlem olarak gerçekleştirilir. Varsayılan değer, false (yanlış) değeridir.

Yanıt gövdesi

RecommendationService.ApplyRecommendation için yanıt mesajı.

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

JSON gösterimi 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Alanlar
results[]

object (ApplyRecommendationResult)

Önerileri uygulamak için yapılan işlemlerin sonuçları.
partialFailureError

object (Status)

Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve tüm hatalar işlemler içinde ortaya çıktığında döndürülür. İşlemler dışında herhangi bir hata oluşursa (örneğin, kimlik doğrulama hataları) RPC düzeyinde hatayı döndürürüz.

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.

ApplyRecommendationOperation

Bir öneriyi uygulama işlemi ve öneriyi özelleştirmek için kullanılan parametreler hakkında bilgiler.

JSON gösterimi 
{
  "resourceName": string,

  // Union field apply_parameters can be only one of the following:
  "campaignBudget": {
    object (CampaignBudgetParameters)
  },
  "textAd": {
    object (TextAdParameters)
  },
  "keyword": {
    object (KeywordParameters)
  },
  "targetCpaOptIn": {
    object (TargetCpaOptInParameters)
  },
  "targetRoasOptIn": {
    object (TargetRoasOptInParameters)
  },
  "calloutExtension": {
    object (CalloutExtensionParameters)
  },
  "callExtension": {
    object (CallExtensionParameters)
  },
  "sitelinkExtension": {
    object (SitelinkExtensionParameters)
  },
  "moveUnusedBudget": {
    object (MoveUnusedBudgetParameters)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdParameters)
  },
  "useBroadMatchKeyword": {
    object (UseBroadMatchKeywordParameters)
  },
  "responsiveSearchAdAsset": {
    object (ResponsiveSearchAdAssetParameters)
  },
  "responsiveSearchAdImproveAdStrength": {
    object (ResponsiveSearchAdImproveAdStrengthParameters)
  },
  "raiseTargetCpaBidTooLow": {
    object (RaiseTargetCpaBidTooLowParameters)
  },
  "forecastingSetTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "calloutAsset": {
    object (CalloutAssetParameters)
  },
  "callAsset": {
    object (CallAssetParameters)
  },
  "sitelinkAsset": {
    object (SitelinkAssetParameters)
  },
  "raiseTargetCpa": {
    object (RaiseTargetCpaParameters)
  },
  "lowerTargetRoas": {
    object (LowerTargetRoasParameters)
  },
  "forecastingSetTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetCpa": {
    object (ForecastingSetTargetCpaParameters)
  },
  "setTargetRoas": {
    object (ForecastingSetTargetRoasParameters)
  },
  "leadFormAsset": {
    object (LeadFormAssetParameters)
  }
  // End of list of possible types for union field apply_parameters.
}
Alanlar
resourceName

string

Uygulanacak önerinin kaynak adı.
Birleştirme alanı apply_parameters. Öneri uygulanırken kullanılacak parametreler. apply_parameters şunlardan yalnızca biri olabilir:
campaignBudget

object (CampaignBudgetParameters)

Kampanya bütçe önerisini uygularken kullanılacak isteğe bağlı parametreler.
textAd

object (TextAdParameters)

Metin reklam önerisi uygulanırken kullanılacak isteğe bağlı parametreler.
keyword

object (KeywordParameters)

Anahtar kelime önerisi uygulanırken kullanılacak isteğe bağlı parametreler.
targetCpaOptIn

object (TargetCpaOptInParameters)

Hedef EBM etkinleştirme önerisi uygulanırken kullanılacak isteğe bağlı parametreler.
targetRoasOptIn

object (TargetRoasOptInParameters)

Hedef ROAS etkinleştirme önerisi uygulanırken kullanılacak isteğe bağlı parametreler.
calloutExtension

object (CalloutExtensionParameters)

Açıklama metni uzantısı önerisi uygulanırken kullanılacak parametreler.
callExtension

object (CallExtensionParameters)

Telefon uzantısı önerisi uygulanırken kullanılacak parametreler.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

Kullanılmayan bütçe taşıma önerisi uygulanırken kullanılacak parametreler.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

Duyarlı arama ağı reklamı önerisi uygularken kullanılacak parametreler.
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

Geniş eşlemeli anahtar kelime önerisini uygularken kullanılacak parametreler.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

Duyarlı arama ağı reklamı öğesi önerisi uygularken kullanılacak parametreler.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

Duyarlı arama ağı reklamı uygulanırken kullanılacak parametreler, reklam gücü önerisini iyileştirir.
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

Hedef EBM teklifini artırmanız çok düşük bir öneri olarak uygulanırken kullanılacak parametreler. Uygulama eşzamansızdır ve ilgili kampanyadaki reklam gruplarının sayısına bağlı olarak birkaç dakika sürebilir.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

Öngörme grubu hedef ROAS önerisini uygularken kullanılacak parametreler.
calloutAsset

object (CalloutAssetParameters)

Açıklama metni öğesi önerisi uygulanırken kullanılacak parametreler.
callAsset

object (CallAssetParameters)

Telefon öğesi önerisi uygulanırken kullanılacak parametreler.
raiseTargetCpa

object (RaiseTargetCpaParameters)

Hedef EBM'yi artırma önerisi uygulanırken kullanılacak parametreler.
lowerTargetRoas

object (LowerTargetRoasParameters)

Daha düşük Hedef ROAS önerisi uygulanırken kullanılacak parametreler.
forecastingSetTargetCpa

object (ForecastingSetTargetCpaParameters)

Tahmin uygulanırken kullanılacak parametreler hedef EBM önerisini ayarladı.
setTargetCpa

object (ForecastingSetTargetCpaParameters)

Ayarlanan hedef EBM önerisini uygularken kullanılacak parametreler.
setTargetRoas

object (ForecastingSetTargetRoasParameters)

Ayarlanan hedef ROAS önerisini uygularken kullanılacak parametreler.
leadFormAsset

object (LeadFormAssetParameters)

Potansiyel müşteri formu öğesi önerisi uygulanırken kullanılacak parametreler.

CampaignBudgetParameters

Kampanya bütçe önerisini uygularken kullanılacak parametreler.

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

string (int64 format)

Hedef bütçe kaynağı için belirlenecek yeni bütçe tutarı. Bu alanının doldurulması zorunludur.

TextAdParameters

Metin reklam önerisini uygularken kullanılacak parametreler.

JSON gösterimi 
{
  "ad": {
    object (Ad)
  }
}
Alanlar
ad

object (Ad)

Önerilen reklam grubuna eklenecek yeni reklam. Bu mesajda tüm gerekli alanların ayarlanması gerekir. Bu alanının doldurulması zorunludur.

KeywordParameters

Anahtar kelime önerisi uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
Alanlar
matchType

enum (KeywordMatchType)

Anahtar kelimenin eşleme türü. Bu alanının doldurulması zorunludur.
adGroup

string

Anahtar kelimenin ekleneceği reklam grubu kaynağı. Bu alanının doldurulması zorunludur.
cpcBidMicros

string (int64 format)

İsteğe bağlı, anahtar kelime için ayarlanacak TBM teklifi. Ayarlanmazsa anahtar kelime, hedef reklam grubu tarafından kullanılan teklif stratejisine dayalı teklifi kullanır.

TargetCpaOptInParameters

Hedef EBM önerisi uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
Alanlar
targetCpaMicros

string (int64 format)

Hedef EBM teklif stratejisi için kullanılacak ortalama EBM. Bu alanının doldurulması zorunludur.
newCampaignBudgetAmountMicros

string (int64 format)

İsteğe bağlı, kampanya için belirlenecek bütçe tutarı.

TargetRoasOptInParameters

Hedef ROAS etkinleştirme önerisi uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
Alanlar
targetRoas

number

Hedef ROAS teklif stratejisi için kullanılacak ortalama ROAS (harcama birimi başına gelir). Değer 0,01 ile 1000,0 arasındadır (0,01 dahil). newCampaignBudgetAmountMicros ayarlanmadığı sürece bu zorunlu bir alandır.
newCampaignBudgetAmountMicros

string (int64 format)

İsteğe bağlı, kampanya için belirlenecek bütçe tutarı.

CalloutExtensionParameters

Açıklama metni uzantısı önerisi uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
Alanlar
calloutExtensions[]

object (CalloutFeedItem)

Ek bilgi uzantıları eklenecek. Bu alanının doldurulması zorunludur.

CallExtensionParameters

Telefon uzantısı önerisi uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
Alanlar
callExtensions[]

object (CallFeedItem)

Eklenecek telefon uzantıları. Bu alanının doldurulması zorunludur.

SitelinkExtensionParameters

Site bağlantısı önerisi uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
Alanlar

MoveUnusedBudgetParameters

Kullanılmayan bütçe taşıma önerisi uygulanırken kullanılacak parametreler.

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

string (int64 format)

Fazla bütçeden kısıtlanmış bütçeye aktarılacak bütçe tutarı. Bu alanının doldurulması zorunludur.

ResponsiveSearchAdParameters

Duyarlı arama ağı reklamı önerisi uygularken kullanılacak parametreler.

JSON gösterimi 
{
  "ad": {
    object (Ad)
  }
}
Alanlar
ad

object (Ad)

Zorunlu. Önerilen reklam grubuna eklenecek yeni reklam.

UseBroadMatchKeywordParameters

Geniş eşlemeli anahtar kelime önerisini uygularken kullanılacak parametreler.

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

string (int64 format)

Hedef bütçe kaynağı için belirlenecek yeni bütçe tutarı.

ResponsiveSearchAdAssetParameters

Duyarlı arama ağı reklamı öğesi önerisi uygularken kullanılacak parametreler.

JSON gösterimi 
{
  "updatedAd": {
    object (Ad)
  }
}
Alanlar
updatedAd

object (Ad)

Reklam güncellendi. Geçerli reklamın içeriği değiştirilecek.

ResponsiveSearchAdImproveAdStrengthParameters

Duyarlı arama ağı reklamı uygulanırken kullanılacak parametreler, reklam gücü önerisini iyileştirir.

JSON gösterimi 
{
  "updatedAd": {
    object (Ad)
  }
}
Alanlar
updatedAd

object (Ad)

Reklam güncellendi. Geçerli reklamın içeriği değiştirilecek.

RaiseTargetCpaBidTooLowParameters

Hedef EBM teklifini artırmanız çok düşük bir öneri olarak uygulanırken kullanılacak parametreler. Uygulama eşzamansızdır ve ilgili kampanyadaki reklam gruplarının sayısına bağlı olarak birkaç dakika sürebilir.

JSON gösterimi 
{
  "targetMultiplier": number
}
Alanlar
targetMultiplier

number

Zorunlu. Hedef EBM'nin artırılacağı faktörü belirten 1,0'dan büyük bir sayı. Bu alanının doldurulması zorunludur.

ForecastingSetTargetRoasParameters

Öngörme grubu hedef ROAS önerisini uygularken kullanılacak parametreler.

JSON gösterimi 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
Alanlar
targetRoas

number

Bir kampanya kaynağı için ayarlanacak yeni hedef ROAS (harcama birimi başına gelir). Değer 0,01 ile 1000,0 arasındadır (0,01 dahil).
campaignBudgetAmountMicros

string (int64 format)

Bir kampanya kaynağı için ayarlanacak yeni kampanya bütçesi tutarı.

CalloutAssetParameters

Açıklama metni öğesi önerileri uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Alanlar
adAssetApplyParameters

object (AdAssetApplyParameters)

Zorunlu. Eklenecek açıklama metni öğeleri. Bu alanının doldurulması zorunludur.

AdAssetApplyParameters

Reklam öğesi önerileri uygulanırken kullanılan genel parametreler.

JSON gösterimi 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
Alanlar
newAssets[]

object (Asset)

Oluşturulacak ve bir kapsama eklenecek öğeler. Bu öğe, aynı çağrıdaki mevcutÖğeler ile birleştirilebilir.
existingAssets[]

string

Bir kapsama eklenecek mevcut öğelerin kaynak adları. Bu öğe, aynı çağrıdaki yeni öğelerle birleştirilebilir.
scope

enum (ApplyScope)

Zorunlu. Öğelerin uygulanacağı kapsam. Kampanya kapsamı düzeyindeki öğeler, öneriyle ilişkili kampanyaya uygulanır. Müşteri kapsamındaki öğeler hesabın tamamı için geçerli olur. Kampanya kapsamındaki öğeler, müşteri kapsamında eklenenleri geçersiz kılar.

ApplyScope

Öğelerin uygulanacağı kapsam.

Sıralamalar
UNSPECIFIED Uygulama kapsamı belirtilmedi.
UNKNOWN Bilinmiyor.
CUSTOMER Müşteri kapsamında uygulayın.
CAMPAIGN Kampanya kapsamında uygulayın.

CallAssetParameters

Telefon öğesi önerileri uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Alanlar
adAssetApplyParameters

object (AdAssetApplyParameters)

Zorunlu. Eklenecek telefon öğeleri. Bu alanının doldurulması zorunludur.

SitelinkAssetParameters

Site bağlantısı öğesi önerileri uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Alanlar
adAssetApplyParameters

object (AdAssetApplyParameters)

Zorunlu. Eklenecek site bağlantısı öğeleri. Bu alanının doldurulması zorunludur.

RaiseTargetCpaParameters

Hedef EBM önerilerini uygularken kullanılacak parametreler.

JSON gösterimi 
{
  "targetCpaMultiplier": number
}
Alanlar
targetCpaMultiplier

number

Zorunlu. EBM çarpanının ayarlanacağı hedef. Bu alanının doldurulması zorunludur.

LowerTargetRoasParameters

Daha düşük Hedef ROAS önerileri uygulanırken kullanılacak parametreler.

JSON gösterimi 
{
  "targetRoasMultiplier": number
}
Alanlar
targetRoasMultiplier

number

Zorunlu. ROAS çarpanının ayarlanacağı hedef. Bu alanının doldurulması zorunludur.

ForecastingSetTargetCpaParameters

Belirli bir hedef EBM önerisini uygularken kullanılacak parametreler.

JSON gösterimi 
{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}
Alanlar
targetCpaMicros

string (int64 format)

Hedef EBM teklif stratejisi için kullanılacak ortalama EBM.
campaignBudgetAmountMicros

string (int64 format)

Bir kampanya kaynağı için ayarlanacak yeni kampanya bütçesi tutarı.

LeadFormAssetParameters

Potansiyel müşteri formu öğesi önerisini uygularken kullanılacak parametreler.

JSON gösterimi 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  },
  "setSubmitLeadFormAssetCampaignGoal": boolean
}
Alanlar
adAssetApplyParameters

object (AdAssetApplyParameters)

Zorunlu. Eklenecek potansiyel müşteri formu öğeleri. Bu alanının doldurulması zorunludur.
setSubmitLeadFormAssetCampaignGoal

boolean

Doğru değerine ayarlanırsa hedef kampanyada "Potansiyel Müşteri Formu Gönderme" hedefi ayarlanır. Bu nedenle, reklamlar potansiyel müşteri formu reklam öğesi reklamları olarak gösterilir. Yanlış değerine ayarlanırsa kampanyada "Potansiyel Müşteri Formu Gönderme" hedefi ayarlanmaz ve reklamlar potansiyel müşteri formu öğeleri içerir.

ApplyRecommendationResult

Bir öneriyi uygulamanın sonucu.

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

string

Başarılı başvurular için iade edildi.