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/v15/customers/{customerId}/recommendations:apply

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest 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)

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

boolean

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 (ApplyRecommendationResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
Pola
results[]

object (ApplyRecommendationResult)

Wyniki operacji zastosowania rekomendacji.
partialFailureError

object (Status)

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 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)
  }
  // End of list of possible types for union field apply_parameters.
}
Pola
resourceName

string

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

object (CampaignBudgetParameters)

Parametry opcjonalne używane przy stosowaniu rekomendacji dotyczących budżetu kampanii.
textAd

object (TextAdParameters)

Opcjonalne parametry używane przy stosowaniu rekomendacji reklam tekstowych.
keyword

object (KeywordParameters)

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

object (TargetCpaOptInParameters)

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

object (TargetRoasOptInParameters)

Parametry opcjonalne używane przy stosowaniu rekomendacji zgodnej z docelowym ROAS.
calloutExtension

object (CalloutExtensionParameters)

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

object (CallExtensionParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczących rozszerzeń połączeń.
moveUnusedBudget

object (MoveUnusedBudgetParameters)

Parametry do użycia przy stosowaniu rekomendacji dotyczących niewykorzystanego budżetu do przeniesienia.
responsiveSearchAd

object (ResponsiveSearchAdParameters)

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

object (UseBroadMatchKeywordParameters)

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

object (ResponsiveSearchAdAssetParameters)

Parametry do użycia podczas stosowania rekomendacji komponentów elastycznych reklam w wyszukiwarce.
responsiveSearchAdImproveAdStrength

object (ResponsiveSearchAdImproveAdStrengthParameters)

Parametry do użycia podczas stosowania elastycznej reklamy w wyszukiwarce poprawiają skuteczność reklamy.
raiseTargetCpaBidTooLow

object (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.
forecastingSetTargetRoas

object (ForecastingSetTargetRoasParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczącej docelowego ROAS ustawionego na potrzeby prognozowania.
calloutAsset

object (CalloutAssetParameters)

Parametry do użycia podczas stosowania rekomendacji komponentów z objaśnieniem.
callAsset

object (CallAssetParameters)

Parametry do użycia podczas stosowania rekomendacji komponentów do wykonywania połączeń.
raiseTargetCpa

object (RaiseTargetCpaParameters)

Parametry do użycia przy stosowaniu rekomendacji zwiększą docelowy CPA.
lowerTargetRoas

object (LowerTargetRoasParameters)

Parametry do użycia przy stosowaniu rekomendacji niższego docelowego ROAS.
forecastingSetTargetCpa

object (ForecastingSetTargetCpaParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczącej docelowego CPA ustawionego na potrzeby prognozowania.
setTargetCpa

object (ForecastingSetTargetCpaParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczącej ustawionego docelowego CPA.
setTargetRoas

object (ForecastingSetTargetRoasParameters)

Parametry do użycia podczas stosowania rekomendacji dotyczącej ustawionego docelowego ROAS.

CampaignBudgetParameters

Parametry do użycia podczas stosowania rekomendacji budżetu kampanii.

Zapis JSON 
{
  "newBudgetAmountMicros": string
}
Pola
newBudgetAmountMicros

string (int64 format)

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 (Ad)
  }
}
Pola
ad

object (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 (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órego ma zostać dodane słowo kluczowe. To pole jest wymagane.
cpcBidMicros

string (int64 format)

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

string (int64 format)

Średni CPA używany w strategii ustalania stawek Docelowy 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 zgodnej z docelowym ROAS.

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

number

Ś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

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)

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 (CallFeedItem)
    }
  ]
}
Pola
callExtensions[]

object (CallFeedItem)

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 (SitelinkFeedItem)
    }
  ]
}
Pola

MoveUnusedBudgetParameters

Parametry do użycia przy stosowaniu rekomendacji dotyczących niewykorzystanego budżetu do przeniesienia.

Zapis JSON 
{
  "budgetMicrosToMove": string
}
Pola
budgetMicrosToMove

string (int64 format)

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 (Ad)
  }
}
Pola
ad

object (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

string (int64 format)

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 (Ad)
  }
}
Pola
updatedAd

object (Ad)

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 (Ad)
  }
}
Pola
updatedAd

object (Ad)

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

number

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

number

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

string (int64 format)

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 (AdAssetApplyParameters)
  }
}
Pola
adAssetApplyParameters

object (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 (Asset)
    }
  ],
  "existingAssets": [
    string
  ],
  "scope": enum (ApplyScope)
}
Pola
newAssets[]

object (Asset)

Zasoby, które chcesz utworzyć i dołączyć do zakresu. W tej samej rozmowie można ją połączyć z dotychczasowymi komponentami.
existingAssets[]

string

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

enum (ApplyScope)

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 (AdAssetApplyParameters)
  }
}
Pola
adAssetApplyParameters

object (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 (AdAssetApplyParameters)
  }
}
Pola
adAssetApplyParameters

object (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

number

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

number

To pole jest wymagane. Wartość docelowa, na którą chcesz ustawić mnożnik ROAS. To pole jest wymagane.

ForecastingSetTargetCpaParameters

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

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

string (int64 format)

Średni CPA używany w strategii ustalania stawek Docelowy CPA.
campaignBudgetAmountMicros

string (int64 format)

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

ApplyRecommendationResult

Wynik zastosowania rekomendacji.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwracana w przypadku zastosowania.