- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ApplyRecommendationOperation
- CampaignBudgetParameters
- TextAdParameters
- KeywordParameters
- TargetCpaOptInParameters
- TargetRoasOptInParameters
- CalloutExtensionParameters:
- CallExtensionParameters:
- SitelinkExtensionParameters
- MoveUnusedBudgetParameters
- ResponsiveSearchAdParameters
- UseBroadMatchKeywordParameters
- ResponsiveSearchAdAssetParameters
- ResponsiveSearchAdImproveAdStrengthParameters
- RaiseTargetCpaBidTooLowParameters
- ForecastingSetTargetRoasParameters
- CalloutAssetParameters
- AdAssetApplyParameters
- ApplyScope
- CallAssetParameters
- SitelinkAssetParameters,
- RaiseTargetCpaParameters
- LowerTargetRoasParameters
- ApplyRecommendationResult
- Wypróbuj
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/v14/customers/{customerId}/recommendations:apply
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator klienta z rekomendacją. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"operations": [
{
object ( |
Pola | |
---|---|
operations[] |
To pole jest wymagane. Lista operacji, w których mają zostać zastosowane rekomendacje. Jeśli częściowyFailure=false wszystkie rekomendacje powinny być tego samego typu. Obowiązuje limit 100 operacji na żądanie. |
partialFailure |
Jeśli wartość to prawda, udane operacje będą wykonywane, a nieprawidłowe – będą zwracać błędy. Jeśli ma wartość false (fałsz), operacje są wykonywane jako transakcje tylko wtedy, gdy są prawidłowe. Wartość domyślna to false (fałsz). |
Treść odpowiedzi
Wiadomość z odpowiedzią na temat: RecommendationService.ApplyRecommendation
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "results": [ { object ( |
Pola | |
---|---|
results[] |
Wyniki operacji zastosowania rekomendacji. |
partialFailureError |
Błędy związane z nieudanymi operacjami w trybie częściowej awarii. Zwracana tylko wtedy, gdy element partialFailure = true i wszystkie błędy występują w operacjach. Jeśli jakiekolwiek błędy wystąpią 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 zastosowania rekomendacji i wszelkich parametrach, które pozwalają ją dostosować.
Zapis JSON |
---|
{ "resourceName": string, // Union field |
Pola | |
---|---|
resourceName |
Nazwa zasobu rekomendacji do zastosowania. |
Pole sumy apply_parameters . Parametry do użycia podczas stosowania rekomendacji. apply_parameters może mieć tylko jedną z tych wartości: |
|
campaignBudget |
Parametry opcjonalne używane przy stosowaniu rekomendacji dotyczących budżetu kampanii. |
textAd |
Opcjonalne parametry używane przy stosowaniu rekomendacji reklam tekstowych. |
keyword |
Parametry opcjonalne używane przy stosowaniu rekomendacji słów kluczowych. |
targetCpaOptIn |
Parametry opcjonalne do wykorzystania podczas stosowania rekomendacji dotyczących docelowego CPA. |
targetRoasOptIn |
Parametry opcjonalne używane przy stosowaniu rekomendacji zgodnej z docelowym ROAS. |
calloutExtension |
Parametry do użycia podczas stosowania rekomendacji dotyczących rozszerzeń objaśnień. |
callExtension |
Parametry do użycia podczas stosowania rekomendacji dotyczących rozszerzeń połączeń. |
sitelinkExtension |
Parametry do użycia podczas stosowania rekomendacji linków do podstron. |
moveUnusedBudget |
Parametry do użycia przy stosowaniu rekomendacji dotyczących niewykorzystanego budżetu do przeniesienia. |
responsiveSearchAd |
Parametry do użycia podczas stosowania rekomendacji elastycznych reklam w wyszukiwarce. |
useBroadMatchKeyword |
Parametry do użycia podczas stosowania rekomendacji słów kluczowych w dopasowaniu przybliżonym. |
responsiveSearchAdAsset |
Parametry do użycia podczas stosowania rekomendacji komponentów elastycznych reklam w wyszukiwarce. |
responsiveSearchAdImproveAdStrength |
Parametry do użycia podczas stosowania elastycznej reklamy w wyszukiwarce poprawiają skuteczność reklamy. |
raiseTargetCpaBidTooLow |
Parametry do użycia przy stosowaniu rekomendacji zbyt niskiej docelowej stawki CPA. Stosowanie jest asynchroniczne i może potrwać kilka minut w zależności od liczby grup reklam w odpowiedniej kampanii. |
forecastingSetTargetRoas |
Parametry do użycia podczas stosowania rekomendacji dotyczącej docelowego ROAS ustawionego na potrzeby prognozowania. |
calloutAsset |
Parametry do użycia podczas stosowania rekomendacji komponentów z objaśnieniem. |
callAsset |
Parametry do użycia podczas stosowania rekomendacji komponentów do wykonywania połączeń. |
sitelinkAsset |
Parametry do użycia podczas stosowania rekomendacji komponentów z linkami do podstron. |
raiseTargetCpa |
Parametry do użycia przy stosowaniu rekomendacji zwiększą docelowy CPA. |
lowerTargetRoas |
Parametry do użycia przy stosowaniu rekomendacji niższego docelowego ROAS. |
CampaignBudgetParameters
Parametry do użycia podczas stosowania rekomendacji budżetu kampanii.
Zapis JSON |
---|
{ "newBudgetAmountMicros": string } |
Pola | |
---|---|
newBudgetAmountMicros |
Nowa kwota budżetu do ustawienia dla zasobu docelowego budżetu. To pole jest wymagane. |
TextAdParameters
Parametry do użycia podczas stosowania rekomendacji reklam tekstowych.
Zapis JSON |
---|
{
"ad": {
object ( |
Pola | |
---|---|
ad |
Nowa reklama do dodania do zalecanej grupy reklam. W tej wiadomości należy podać wartości wszystkich wymaganych pól. To pole jest wymagane. |
KeywordParameters
Parametry do użycia podczas stosowania rekomendacji słów kluczowych.
Zapis JSON |
---|
{
"matchType": enum ( |
Pola | |
---|---|
matchType |
Typ dopasowania słowa kluczowego. To pole jest wymagane. |
adGroup |
Zasób grupy reklam, do którego ma zostać dodane słowo kluczowe. To pole jest wymagane. |
cpcBidMicros |
Opcjonalnie: stawka CPC ustawiana za słowo kluczowe. Jeśli jej nie skonfigurujesz, słowo kluczowe będzie stosować stawkę na podstawie strategii ustalania stawek używanej przez docelową grupę reklam. |
TargetCpaOptInParameters
Parametry do użycia przy stosowaniu rekomendacji dotyczącej docelowego CPA.
Zapis JSON |
---|
{ "targetCpaMicros": string, "newCampaignBudgetAmountMicros": string } |
Pola | |
---|---|
targetCpaMicros |
Średni CPA używany w strategii ustalania stawek Docelowy CPA. To pole jest wymagane. |
newCampaignBudgetAmountMicros |
Opcjonalnie: kwota budżetu do ustawienia w kampanii. |
TargetRoasOptInParameters
Parametry do użycia podczas stosowania rekomendacji zgodnej z docelowym ROAS.
Zapis JSON |
---|
{ "targetRoas": number, "newCampaignBudgetAmountMicros": string } |
Pola | |
---|---|
targetRoas |
Średni ROAS (przychód na jednostkę wydatków) 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 newCampaignBudgetAmountMicros. |
newCampaignBudgetAmountMicros |
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 ( |
Pola | |
---|---|
calloutExtensions[] |
Należy dodać rozszerzenia objaśnień. To pole jest wymagane. |
CallExtensionParameters
Parametry do użycia podczas stosowania rekomendacji dotyczących rozszerzeń połączeń.
Zapis JSON |
---|
{
"callExtensions": [
{
object ( |
Pola | |
---|---|
callExtensions[] |
Rozszerzenia połączeń zostaną dodane. To pole jest wymagane. |
SitelinkExtensionParameters
Parametry do użycia podczas stosowania rekomendacji linków do podstron.
Zapis JSON |
---|
{
"sitelinkExtensions": [
{
object ( |
Pola | |
---|---|
sitelinkExtensions[] |
Linki do podstron do dodania. To pole jest wymagane. |
MoveUnusedBudgetParameters
Parametry do użycia przy stosowaniu rekomendacji dotyczących niewykorzystanego budżetu do przeniesienia.
Zapis JSON |
---|
{ "budgetMicrosToMove": string } |
Pola | |
---|---|
budgetMicrosToMove |
Kwota budżetu, która ma zostać przeniesiona z budżetu nadmiarowego do ograniczonego. To pole jest wymagane. |
ResponsiveSearchAdParameters
Parametry do użycia podczas stosowania rekomendacji elastycznych reklam w wyszukiwarce.
Zapis JSON |
---|
{
"ad": {
object ( |
Pola | |
---|---|
ad |
To pole jest wymagane. Nowa reklama do dodania do zalecanej grupy reklam. |
UseBroadMatchKeywordParameters
Parametry do użycia podczas stosowania rekomendacji słów kluczowych w dopasowaniu przybliżonym.
Zapis JSON |
---|
{ "newBudgetAmountMicros": string } |
Pola | |
---|---|
newBudgetAmountMicros |
Nowa kwota budżetu do ustawienia dla zasobu docelowego budżetu. |
ResponsiveSearchAdAssetParameters
Parametry do użycia podczas stosowania rekomendacji komponentów elastycznych reklam w wyszukiwarce.
Zapis JSON |
---|
{
"updatedAd": {
object ( |
Pola | |
---|---|
updatedAd |
Zaktualizowano reklamę. Obecna treść reklamy zostanie zastąpiona. |
ResponsiveSearchAdImproveAdStrengthParameters
Parametry do użycia podczas stosowania elastycznej reklamy w wyszukiwarce poprawiają skuteczność reklamy.
Zapis JSON |
---|
{
"updatedAd": {
object ( |
Pola | |
---|---|
updatedAd |
Zaktualizowano reklamę. Obecna treść reklamy zostanie zastąpiona. |
RaiseTargetCpaBidTooLowParameters
Parametry do użycia przy stosowaniu rekomendacji zbyt niskiej docelowej stawki CPA. Stosowanie jest asynchroniczne i może potrwać kilka minut w zależności od liczby grup reklam w odpowiedniej kampanii.
Zapis JSON |
---|
{ "targetMultiplier": number } |
Pola | |
---|---|
targetMultiplier |
To pole jest wymagane. Liczba większa niż 1,0 wskazująca, o jaki czynnik powinien zwiększyć docelowy CPA. To pole jest wymagane. |
ForecastingSetTargetRoasParameters
Parametry do użycia przy stosowaniu rekomendacji dotyczącej docelowego ROAS zgodnie z prognozą.
Zapis JSON |
---|
{ "targetRoas": number, "campaignBudgetAmountMicros": string } |
Pola | |
---|---|
targetRoas |
Nowy docelowy ROAS (przychód na jednostkę wydatków) do ustawienia dla zasobu kampanii. Wartość należy do zakresu od 0,01 do 1000,0 włącznie. |
campaignBudgetAmountMicros |
Nowa kwota budżetu kampanii do ustawienia dla zasobu kampanii. |
CalloutAssetParameters
Parametry do użycia podczas stosowania rekomendacji dotyczących komponentów z objaśnieniem.
Zapis JSON |
---|
{
"adAssetApplyParameters": {
object ( |
Pola | |
---|---|
adAssetApplyParameters |
To pole jest wymagane. Zostanie dodane komponenty z objaśnieniem. To pole jest wymagane. |
AdAssetApplyParameters
Typowe parametry używane przy stosowaniu rekomendacji dotyczących komponentów reklamy.
Zapis JSON |
---|
{ "newAssets": [ { object ( |
Pola | |
---|---|
newAssets[] |
Zasoby, które chcesz utworzyć i dołączyć do zakresu. W tej samej rozmowie można ją połączyć z dotychczasowymi komponentami. |
existingAssets[] |
Nazwy zasobów istniejących zasobów do dołączenia do zakresu. Można go połączyć z nowymi zasobami w tej samej rozmowie. |
scope |
To pole jest wymagane. Zakres, do którego mają zostać zastosowane komponenty. Komponenty na poziomie zakresu kampanii zostaną zastosowane w kampanii powiązanej z rekomendacją. Komponenty przypisane do zakresu klienta będą mieć zastosowanie do całego konta. Komponenty w zakresie kampanii zastąpią wszystkie komponenty dołączone na poziomie klienta. |
ApplyScope
Zakres, do którego chcesz zastosować zasoby.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Zakres stosowania nie został określony. |
UNKNOWN |
Nieznany. |
CUSTOMER |
Zastosuj na poziomie klienta. |
CAMPAIGN |
Zastosuj na poziomie kampanii. |
CallAssetParameters
Parametry do użycia podczas stosowania rekomendacji dotyczących komponentów do wykonywania połączeń.
Zapis JSON |
---|
{
"adAssetApplyParameters": {
object ( |
Pola | |
---|---|
adAssetApplyParameters |
To pole jest wymagane. Komponenty do wykonywania połączeń, które zostaną dodane. To pole jest wymagane. |
SitelinkAssetParameters
Parametry do użycia podczas stosowania rekomendacji dotyczących komponentów z linkami do podstron.
Zapis JSON |
---|
{
"adAssetApplyParameters": {
object ( |
Pola | |
---|---|
adAssetApplyParameters |
To pole jest wymagane. Do dodania komponenty z linkami do podstron. To pole jest wymagane. |
RaiseTargetCpaParameters
Parametry, których należy użyć przy stosowaniu, podnoszą rekomendacje docelowego CPA.
Zapis JSON |
---|
{ "targetCpaMultiplier": number } |
Pola | |
---|---|
targetCpaMultiplier |
To pole jest wymagane. Wartość docelowa, na którą chcesz ustawić mnożnik CPA. To pole jest wymagane. |
LowerTargetRoasParameters
Parametry do użycia przy stosowaniu rekomendacji dotyczących niższego docelowego ROAS.
Zapis JSON |
---|
{ "targetRoasMultiplier": number } |
Pola | |
---|---|
targetRoasMultiplier |
To pole jest wymagane. Wartość docelowa, na którą chcesz ustawić mnożnik ROAS. To pole jest wymagane. |
ApplyRecommendationResult
Wynik zastosowania rekomendacji.
Zapis JSON |
---|
{ "resourceName": string } |
Pola | |
---|---|
resourceName |
Zwracana w przypadku zastosowania. |