Method: customers.recommendations.apply

Stosuje podane rekomendacje z odpowiednimi parametrami stosowania.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Identyfikator klienta z rekomendacją.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "operations": [
    {
      object (ApplyRecommendationOperation)
    }
  ],
  "partialFailure": boolean
}
Pola
operations[]

object (ApplyRecommendationOperation)

Wymagane. Lista operacji, w których zostaną zastosowane rekomendacje. Jeśli partiaFailure=false ma wartość false (fałsz), wszystkie rekomendacje powinny być tego samego typu. Obowiązuje limit 100 operacji na żądanie.
partialFailure

boolean

Jeśli ma wartość true (prawda), wykonywane są udane operacje, a nieprawidłowe – zwracają błędy. W przypadku wartości false (fałsz) operacje będą realizowane jako transakcja tylko wtedy, gdy są prawidłowe. Wartość domyślna to false (fałsz).

Treść odpowiedzi

Wiadomość z odpowiedzią dla: RecommendationService.ApplyRecommendation.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "results": [
    {
      object (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Pola
results[]

object (ApplyRecommendationResult)

Wyniki działań mających na celu zastosowanie rekomendacji.
partialFailureError

object (Status)

Błędy, które odnoszą się do nieudanych operacji w trybie częściowej awarii. Zwracany tylko wtedy, gdy częściowyFailure ma wartość true (prawda) i wszystkie błędy występują w ramach operacji. Jeśli wystąpią jakieś błędy poza operacjami (na przykład błędy uwierzytelniania), zwrócimy błąd na poziomie RPC.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ApplyRecommendationOperation

Informacje o operacji stosowania rekomendacji i parametrach jej dostosowywania.

Zapis JSON 
{
  "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.
}
Pola
resourceName

string

Nazwa zasobu rekomendacji, która ma zostać zastosowana.
Pole sumy apply_parameters. Parametry, które mają być używane podczas stosowania rekomendacji. apply_parameters może mieć tylko jedną z tych wartości:
campaignBudget

object (CampaignBudgetParameters)

Parametry opcjonalne do użycia podczas stosowania rekomendacji dotyczących budżetu kampanii.
textAd

object (TextAdParameters)

Parametry opcjonalne do użycia podczas stosowania rekomendacji reklam tekstowych.
keyword

object (KeywordParameters)

Parametry opcjonalne do użycia przy stosowaniu rekomendacji słów kluczowych.
targetCpaOptIn

object (TargetCpaOptInParameters)

Parametry opcjonalne do użycia podczas stosowania rekomendacji dotyczących akceptacji docelowego CPA.
targetRoasOptIn

object (TargetRoasOptInParameters)

Parametry opcjonalne do użycia podczas stosowania rekomendacji dotyczącej akceptacji docelowego ROAS.
calloutExtension

object (CalloutExtensionParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczących rozszerzeń objaśnień.
callExtension

object (CallExtensionParameters)

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących rozszerzeń połączeń.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczących przeniesienia niewykorzystanego budżetu.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczących elastycznych reklam w wyszukiwarce.
useBroadMatchKeyword

object (UseBroadMatchKeywordParameters)

Parametry do wykorzystania podczas stosowania rekomendacji słów kluczowych w dopasowaniu przybliżonym.
responsiveSearchAdAsset

object (ResponsiveSearchAdAssetParameters)

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących komponentów elastycznych reklam w wyszukiwarce.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

Parametry do wykorzystania podczas stosowania elastycznej reklamy w wyszukiwarce poprawiają rekomendację dotyczącą skuteczności reklamy.
raiseTargetCpaBidTooLow

object (RaiseTargetCpaBidTooLowParameters)

Parametry do użycia w przypadku stosowania zbyt niskiej docelowej stawki CPA w ramach rekomendacji. Stosowanie jest asynchroniczne i może potrwać kilka minut w zależności od liczby grup reklam w powiązanej kampanii.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczących ustawionego docelowego ROAS w ramach prognozy.
calloutAsset

object (CalloutAssetParameters)

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących komponentów z objaśnieniem.
callAsset

object (CallAssetParameters)

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących komponentów do wykonywania połączeń.
raiseTargetCpa

object (RaiseTargetCpaParameters)

Parametry do wykorzystania podczas stosowania rekomendacji zwiększenia docelowego CPA.
lowerTargetRoas

object (LowerTargetRoasParameters)

Parametry do wykorzystania przy stosowaniu niższego docelowego ROAS.
forecastingSetTargetCpa

object (ForecastingSetTargetCpaParameters)

Parametry do użycia przy stosowaniu prognozowania ustaw w rekomendacji dotyczącej docelowego CPA.
setTargetCpa

object (ForecastingSetTargetCpaParameters)

Parametry do wykorzystania podczas stosowania rekomendacji dotyczącej ustawienia docelowego CPA.
setTargetRoas

object (ForecastingSetTargetRoasParameters)

Parametry do wykorzystania podczas stosowania rekomendacji związanej z ustawieniem docelowego ROAS.
leadFormAsset

object (LeadFormAssetParameters)

Parametry do wykorzystania podczas stosowania rekomendacji komponentów z formularzem kontaktowym.

CampaignBudgetParameters

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących budżetu kampanii.

Zapis JSON 
{
  "newBudgetAmountMicros": string
}
Pola
newBudgetAmountMicros

string (int64 format)

Nowa kwota budżetu do ustawienia dla zasobu budżetu docelowego. To pole jest wymagane.

TextAdParameters

Parametry do wykorzystania podczas stosowania rekomendacji reklam tekstowych.

Zapis JSON 
{
  "ad": {
    object (Ad)
  }
}
Pola
ad

object (Ad)

Nowa reklama do dodania do zalecanej grupy reklam. W tej wiadomości należy wypełnić wszystkie wymagane pola. To pole jest wymagane.

KeywordParameters

Parametry do wykorzystania przy stosowaniu rekomendacji słów kluczowych.

Zapis JSON 
{
  "matchType": enum (KeywordMatchType),
  "adGroup": string,
  "cpcBidMicros": string
}
Pola
matchType

enum (KeywordMatchType)

Typ dopasowania słowa kluczowego. To pole jest wymagane.
adGroup

string

Zasób grupy reklam, do której ma zostać dodane słowo kluczowe. To pole jest wymagane.
cpcBidMicros

string (int64 format)

Opcjonalnie stawka CPC ustawiona dla słowa kluczowego. Jeśli jej nie skonfigurujesz, słowo kluczowe będzie używać stawki na podstawie strategii ustalania stawek używanej przez docelową grupę reklam.

TargetCpaOptInParameters

Parametry do użycia podczas stosowania rekomendacji dotyczących docelowego CPA.

Zapis JSON 
{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}
Pola
targetCpaMicros

string (int64 format)

Średni CPA do użycia w strategii określania docelowych stawek CPA. To pole jest wymagane.
newCampaignBudgetAmountMicros

string (int64 format)

Opcjonalnie: kwota budżetu do ustawienia w kampanii.

TargetRoasOptInParameters

Parametry do użycia podczas stosowania rekomendacji dotyczącej akceptacji strategii Docelowy ROAS.

Zapis JSON 
{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}
Pola
targetRoas

number

Średni ROAS (przychód z jednostki wydatków), który ma być używany w strategii ustalania stawek Docelowy ROAS. Wartość należy do zakresu od 0,01 do 1000,0 włącznie. To pole jest wymagane, chyba że ustawiono parametr newCampaignBudgetAmountMicros.
newCampaignBudgetAmountMicros

string (int64 format)

Opcjonalnie: kwota budżetu do ustawienia w kampanii.

CalloutExtensionParameters

Parametry do użycia podczas stosowania rekomendacji dotyczących rozszerzeń objaśnień.

Zapis JSON 
{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}
Pola
calloutExtensions[]

object (CalloutFeedItem)

Rozszerzenia objaśnień do dodania. To pole jest wymagane.

CallExtensionParameters

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących rozszerzeń połączeń.

Zapis JSON 
{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}
Pola
callExtensions[]

object (CallFeedItem)

Rozszerzenia połączeń zostaną dodane. To pole jest wymagane.

SitelinkExtensionParameters

Parametry do wykorzystania podczas stosowania rekomendacji linków do podstron.

Zapis JSON 
{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}
Pola

MoveUnusedBudgetParameters

Parametry do użycia podczas stosowania rekomendacji dotyczących przeniesienia niewykorzystanego budżetu.

Zapis JSON 
{
  "budgetMicrosToMove": string
}
Pola
budgetMicrosToMove

string (int64 format)

Kwota budżetu, która zostanie przeniesiona z budżetu nadmiarowego do budżetu ograniczonego. To pole jest wymagane.

ResponsiveSearchAdParameters

Parametry do użycia podczas stosowania rekomendacji dotyczących elastycznych reklam w wyszukiwarce.

Zapis JSON 
{
  "ad": {
    object (Ad)
  }
}
Pola
ad

object (Ad)

Wymagane. Nowa reklama do dodania do zalecanej grupy reklam.

UseBroadMatchKeywordParameters

Parametry do wykorzystania podczas stosowania rekomendacji słów kluczowych w dopasowaniu przybliżonym.

Zapis JSON 
{
  "newBudgetAmountMicros": string
}
Pola
newBudgetAmountMicros

string (int64 format)

Nowa kwota budżetu do ustawienia dla zasobu budżetu docelowego.

ResponsiveSearchAdAssetParameters

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących komponentów elastycznych reklam w wyszukiwarce.

Zapis JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
Pola
updatedAd

object (Ad)

Zaktualizowano reklamę. Treść bieżącej reklamy zostanie zastąpiona.

ResponsiveSearchAdImproveAdStrengthParameters

Parametry do wykorzystania podczas stosowania elastycznej reklamy w wyszukiwarce poprawiają rekomendację dotyczącą skuteczności reklamy.

Zapis JSON 
{
  "updatedAd": {
    object (Ad)
  }
}
Pola
updatedAd

object (Ad)

Zaktualizowano reklamę. Treść bieżącej reklamy zostanie zastąpiona.

RaiseTargetCpaBidTooLowParameters

Parametry do użycia w przypadku stosowania zbyt niskiej docelowej stawki CPA w ramach rekomendacji. Stosowanie jest asynchroniczne i może potrwać kilka minut, w zależności od liczby grup reklam w powiązanej kampanii.

Zapis JSON 
{
  "targetMultiplier": number
}
Pola
targetMultiplier

number

Wymagane. Liczba większa niż 1,0 wskazująca współczynnik, o który należy zwiększyć docelowy CPA. To pole jest wymagane.

ForecastingSetTargetRoasParameters

Parametry do użycia podczas stosowania rekomendacji dotyczących ustawionego docelowego ROAS w ramach prognozy.

Zapis JSON 
{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}
Pola
targetRoas

number

Nowy docelowy ROAS (przychody na jednostkę wydatków) do ustawienia dla zasobu kampanii. Wartość należy do zakresu od 0,01 do 1000,0 włącznie.
campaignBudgetAmountMicros

string (int64 format)

Nowa kwota budżetu kampanii do ustawienia dla zasobu kampanii.

CalloutAssetParameters

Parametry do wykorzystania przy stosowaniu rekomendacji dotyczących komponentów z objaśnieniem.

Zapis JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Pola
adAssetApplyParameters

object (AdAssetApplyParameters)

Wymagane. Komponenty z objaśnieniem do dodania. To pole jest wymagane.

AdAssetApplyParameters

Typowe parametry stosowane przy stosowaniu rekomendacji dotyczących komponentów reklamy.

Zapis JSON 
{
  "newAssets": [
    {
      object (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
Pola
newAssets[]

object (Asset)

Zasoby do utworzenia i dołączenia do zakresu. Można ją połączyć z istniejącymi komponentami w tej samej rozmowie.
existingAssets[]

string

Nazwy zasobów istniejących zasobów, które mają zostać dołączone do zakresu. Można ją połączyć z nowymi komponentami w tej samej rozmowie.
scope

enum (ApplyScope)

Wymagane. Zakres, w którym mają zostać zastosowane zasoby. Komponenty na poziomie zakresu kampanii zostaną zastosowane w kampanii powiązanej z rekomendacją. Komponenty z zakresu na poziomie klienta będą miały zastosowanie do całego konta. Zasoby na poziomie kampanii zastąpią komponenty dołączone do zakresu klienta.

ApplyScope

Zakres, do którego mają zostać zastosowane zasoby.

Wartości w polu enum
UNSPECIFIED Zakres zastosowania nie został określony.
UNKNOWN Nieznany.
CUSTOMER Zastosuj na poziomie klienta.
CAMPAIGN Zastosuj na poziomie kampanii.

CallAssetParameters

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących komponentów do wykonywania połączeń.

Zapis JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Pola
adAssetApplyParameters

object (AdAssetApplyParameters)

Wymagane. Należy dodać komponenty do wykonywania połączeń. To pole jest wymagane.

SitelinkAssetParameters

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących komponentów z linkami do podstron.

Zapis JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}
Pola
adAssetApplyParameters

object (AdAssetApplyParameters)

Wymagane. Komponenty z linkami do podstron do dodania. To pole jest wymagane.

RaiseTargetCpaParameters

Parametry do wykorzystania podczas stosowania rekomendacji dotyczących podniesienia docelowego CPA.

Zapis JSON 
{
  "targetCpaMultiplier": number
}
Pola
targetCpaMultiplier

number

Wymagane. Wartość docelowa, na którą ma zostać ustawiony mnożnik CPA. To pole jest wymagane.

LowerTargetRoasParameters

Parametry do wykorzystania przy stosowaniu niższych rekomendacji dotyczących docelowego ROAS.

Zapis JSON 
{
  "targetRoasMultiplier": number
}
Pola
targetRoasMultiplier

number

Wymagane. Wartość docelowa, na którą ma zostać ustawiony mnożnik ROAS. To pole jest wymagane.

ForecastingSetTargetCpaParameters

Parametry do użycia podczas stosowania rekomendacji ustalonej docelowego CPA.

Zapis JSON 
{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}
Pola
targetCpaMicros

string (int64 format)

Średni CPA do użycia w strategii określania docelowych stawek CPA.
campaignBudgetAmountMicros

string (int64 format)

Nowa kwota budżetu kampanii do ustawienia dla zasobu kampanii.

LeadFormAssetParameters

Parametry do wykorzystania podczas stosowania rekomendacji komponentów z formularzem kontaktowym.

Zapis JSON 
{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  },
  "setSubmitLeadFormAssetCampaignGoal": boolean
}
Pola
adAssetApplyParameters

object (AdAssetApplyParameters)

Wymagane. Komponenty z formularzem kontaktowym, które mają zostać dodane. To pole jest wymagane.
setSubmitLeadFormAssetCampaignGoal

boolean

Jeśli ma wartość prawda, cel „Przesłanie formularza kontaktowego” zostanie ustawiony w kampanii docelowej. W rezultacie reklamy będą się wyświetlać jako reklamy z formularzem kontaktowym. Jeśli ma wartość fałsz, cel „Przesłanie formularza kontaktowego” nie zostanie ustawiony w kampanii, a reklamy będą zawierać komponenty z formularzem kontaktowym.

ApplyRecommendationResult

Wynik zastosowania rekomendacji.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwrócone w przypadku prawidłowego zastosowania.