- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ApplyRecommendationOperation
- CampaignBudgetParameters
- TextAdParameters
- KeywordParameters
- TargetCpaOptInParameters
- TargetRoasOptInParameters
- CalloutExtensionParameters
- CallExtensionParameters
- SitelinkExtensionParameters
- MoveUnusedBudgetParameters
- ResponsiveSearchAdParameters
- UseBroadMatchKeywordParameters
- ResponsiveSearchAdAssetParameters
- ResponsiveSearchAdImproveAdStrengthParameters
- RaiseTargetCpaBidTooLowParameters
- ForecastingSetTargetRoasParameters
- CalloutAssetParameters
- AdAssetApplyParameters
- ApplyScope
- CallAssetParameters
- SitelinkAssetParameters
- RaiseTargetCpaParameters
- LowerTargetRoasParameters
- ForecastingSetTargetCpaParameters
- ApplyRecommendationResult
- Deneyin.
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/v15/customers/{customerId}/recommendations:apply
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Öneriyi içeren müşterinin kimliği. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{
"operations": [
{
object ( |
Alanlar | |
---|---|
operations[] |
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 |
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 tümü geçerliyse ve 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 ( |
Alanlar | |
---|---|
results[] |
Önerilerin uygulanacağı işlemlerin sonuçları. |
partialFailureError |
Kısmi hata modundaki işlem hatalarıyla ilgili hatalar. Yalnızca kısmiFailure = true olduğunda ve işlemlerde tüm hatalar ortaya çıktığında döndürülür. İşlemler dışında herhangi bir hata oluşursa (örneğin, kimlik doğrulama hataları) RPC düzeyi hatası döndürülür. |
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şlemiyle ve öneriyi özelleştirmek için kullanılan parametrelerle ilgili bilgiler.
JSON gösterimi |
---|
{ "resourceName": string, // Union field |
Alanlar | |
---|---|
resourceName |
Uygulanacak önerinin kaynak adı. |
apply_parameters alanı. Öneri uygulanırken kullanılacak parametreler. apply_parameters şunlardan yalnızca biri olabilir: |
|
campaignBudget |
Kampanya bütçe önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
textAd |
Metin reklam önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
keyword |
Anahtar kelime önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
targetCpaOptIn |
Hedef EBM etkinleştirme önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
targetRoasOptIn |
Hedef ROAS etkinleştirme önerisi uygulanırken kullanılacak isteğe bağlı parametreler. |
calloutExtension |
Açıklama metni uzantısı önerisi uygulanırken kullanılacak parametreler. |
callExtension |
Telefon uzantısı önerisi uygulanırken kullanılacak parametreler. |
sitelinkExtension |
Site bağlantısı önerisi uygulanırken kullanılacak parametreler. |
moveUnusedBudget |
Kullanılmayan bütçeyi taşıma önerisi uygulanırken kullanılacak parametreler. |
responsiveSearchAd |
Duyarlı arama ağı reklamı önerisi uygulanırken kullanılacak parametreler. |
useBroadMatchKeyword |
Geniş eşlemeli anahtar kelime önerisi uygulanırken kullanılacak parametreler. |
responsiveSearchAdAsset |
Duyarlı arama ağı reklamı öğesi önerisi uygularken kullanılacak parametreler. |
responsiveSearchAdImproveAdStrength |
Duyarlı arama ağı reklamı uygulanırken kullanılacak parametreler, reklam gücü önerisini iyileştirir. |
raiseTargetCpaBidTooLow |
Hedef EBM teklifini artırma önerisi çok düşük bir öneri uygulanırken kullanılacak parametreler. Uygulama eşzamansız olarak yapılır ve ilgili kampanyadaki reklam gruplarının sayısına bağlı olarak birkaç dakika sürebilir. |
forecastingSetTargetRoas |
Öngörme bir hedef ROAS önerisini uygularken kullanılacak parametreler. |
calloutAsset |
Açıklama metni öğesi önerisi uygulanırken kullanılacak parametreler. |
callAsset |
Telefon öğesi önerisi uygulanırken kullanılacak parametreler. |
sitelinkAsset |
Site bağlantısı öğesi önerisi uygulanırken kullanılacak parametreler. |
raiseTargetCpa |
Hedef EBM'yi artırma önerisi uygulanırken kullanılacak parametreler. |
lowerTargetRoas |
Daha düşük Hedef ROAS önerisi uygulanırken kullanılacak parametreler. |
forecastingSetTargetCpa |
Öngörmeyi uygularken kullanılacak parametreler, hedef EBM önerisini ayarlar. |
setTargetCpa |
Ayarlanan hedef EBM önerisi uygulanırken kullanılacak parametreler. |
setTargetRoas |
Ayarlanan hedef ROAS önerisini uygularken kullanılacak parametreler. |
CampaignBudgetParameters
Kampanya bütçe önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "newBudgetAmountMicros": string } |
Alanlar | |
---|---|
newBudgetAmountMicros |
Hedef bütçe kaynağı için ayarlanacak yeni bütçe tutarı. Bu alanının doldurulması zorunludur. |
TextAdParameters
Metin reklam önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"ad": {
object ( |
Alanlar | |
---|---|
ad |
Önerilen reklam grubuna eklenecek yeni reklam. Tüm gerekli alanların bu iletide ayarlanması gerekir. Bu alanının doldurulması zorunludur. |
KeywordParameters
Anahtar kelime önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"matchType": enum ( |
Alanlar | |
---|---|
matchType |
Anahtar kelimenin eşleme türü. Bu alanının doldurulması zorunludur. |
adGroup |
Anahtar kelimenin ekleneceği reklam grubu kaynağı. Bu alanının doldurulması zorunludur. |
cpcBidMicros |
İsteğe bağlı, anahtar kelime için ayarlanacak TBM teklifi. Politika ayarlanmazsa anahtar kelime, hedef reklam grubu tarafından kullanılan teklif stratejisine göre teklifi kullanır. |
TargetCpaOptInParameters
Hedef EBM önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetCpaMicros": string, "newCampaignBudgetAmountMicros": string } |
Alanlar | |
---|---|
targetCpaMicros |
Hedef EBM teklif stratejisi için kullanılacak ortalama EBM. Bu alanının doldurulması zorunludur. |
newCampaignBudgetAmountMicros |
İsteğe bağlı, kampanya için ayarlanacak bütçe tutarı. |
TargetRoasOptInParameters
Hedef ROAS etkinleştirme önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetRoas": number, "newCampaignBudgetAmountMicros": string } |
Alanlar | |
---|---|
targetRoas |
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 (bu değerler dahil). newCampaignBudgetAmountMicros ayarlanmadığı sürece bu alanın doldurulması zorunludur. |
newCampaignBudgetAmountMicros |
İsteğe bağlı, kampanya için ayarlanacak bütçe tutarı. |
CalloutExtensionParameters
Açıklama metni uzantısı önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"calloutExtensions": [
{
object ( |
Alanlar | |
---|---|
calloutExtensions[] |
Açıklama metni uzantıları eklenecek. Bu alanının doldurulması zorunludur. |
CallExtensionParameters
Telefon uzantısı önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"callExtensions": [
{
object ( |
Alanlar | |
---|---|
callExtensions[] |
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 ( |
Alanlar | |
---|---|
sitelinkExtensions[] |
Eklenecek site bağlantıları. Bu alanının doldurulması zorunludur. |
MoveUnusedBudgetParameters
Kullanılmayan bütçeyi taşıma önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "budgetMicrosToMove": string } |
Alanlar | |
---|---|
budgetMicrosToMove |
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 uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"ad": {
object ( |
Alanlar | |
---|---|
ad |
Zorunlu. Önerilen reklam grubuna eklenecek yeni reklam. |
UseBroadMatchKeywordParameters
Geniş eşlemeli anahtar kelime önerisi uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{ "newBudgetAmountMicros": string } |
Alanlar | |
---|---|
newBudgetAmountMicros |
Hedef bütçe kaynağı için ayarlanacak yeni bütçe tutarı. |
ResponsiveSearchAdAssetParameters
Duyarlı arama ağı reklamı öğesi önerisi uygularken kullanılacak parametreler.
JSON gösterimi |
---|
{
"updatedAd": {
object ( |
Alanlar | |
---|---|
updatedAd |
Reklam güncellendi. Mevcut 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 ( |
Alanlar | |
---|---|
updatedAd |
Reklam güncellendi. Mevcut reklamın içeriği değiştirilecek. |
RaiseTargetCpaBidTooLowParameters
Hedef EBM teklifini artırma önerisi çok düşük bir öneri uygulanırken kullanılacak parametreler. Uygulama eşzamansız olarak yapılı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 |
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 |
Kampanya kaynağı için ayarlanacak yeni hedef ROAS (harcama birimi başına gelir). Değer 0,01 ile 1000,0 arasındadır (bu değerler dahil). |
campaignBudgetAmountMicros |
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 ( |
Alanlar | |
---|---|
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 ( |
Alanlar | |
---|---|
newAssets[] |
Oluşturulacak ve bir kapsama eklenecek öğeler. Bu öğe, aynı çağrıdaki mevcut Assets ile birleştirilebilir. |
existingAssets[] |
Bir kapsama eklenecek mevcut öğelerin kaynak adları. Bu öğe, aynı çağrıdaki yeni öğelerle birleştirilebilir. |
scope |
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 eklenmiş olan tüm öğeleri geçersiz kılar. |
ApplyScope
Öğelerin uygulanacağı kapsam.
Sıralamalar | |
---|---|
UNSPECIFIED |
Uygulama kapsamı belirtilmedi. |
UNKNOWN |
Bilinmiyor. |
CUSTOMER |
Müşteri kapsamında uygulanır. |
CAMPAIGN |
Kampanya kapsamında uygulayın. |
CallAssetParameters
Telefon öğesi önerileri uygulanırken kullanılacak parametreler.
JSON gösterimi |
---|
{
"adAssetApplyParameters": {
object ( |
Alanlar | |
---|---|
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 ( |
Alanlar | |
---|---|
adAssetApplyParameters |
Zorunlu. Eklenecek site bağlantısı öğeleri. Bu alanının doldurulması zorunludur. |
RaiseTargetCpaParameters
Hedef EBM önerilerini yükseltirken kullanılacak parametreler.
JSON gösterimi |
---|
{ "targetCpaMultiplier": number } |
Alanlar | |
---|---|
targetCpaMultiplier |
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 |
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 |
Hedef EBM teklif stratejisi için kullanılacak ortalama EBM. |
campaignBudgetAmountMicros |
Kampanya kaynağı için ayarlanacak yeni kampanya bütçesi tutarı. |
ApplyRecommendationResult
Bir öneriyi uygulamanın sonucu.
JSON gösterimi |
---|
{ "resourceName": string } |
Alanlar | |
---|---|
resourceName |
Başarılı başvuru için iade edildi. |