Method: customers.recommendations.apply

string

To pole jest wymagane. Identyfikator klienta z rekomendacją.

{
  "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.
}

string

Nazwa zasobu rekomendacji, którą chcesz zastosować.

object (CampaignBudgetParameters)

Parametry opcjonalne, których należy używać podczas stosowania rekomendacji budżetu kampanii.

object (TextAdParameters)

Parametry opcjonalne do stosowania przy stosowaniu rekomendacji reklam tekstowych.

object (KeywordParameters)

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

object (TargetCpaOptInParameters)

Parametry opcjonalne do użycia przy stosowaniu rekomendacji dotyczącej docelowego CPA.

object (TargetRoasOptInParameters)

Parametry opcjonalne do użycia przy stosowaniu rekomendacji dotyczącej docelowego ROAS.

object (CalloutExtensionParameters)

Parametry do użycia przy stosowaniu rekomendacji rozszerzeń objaśnień.

object (CallExtensionParameters)

Parametry do użycia przy stosowaniu rekomendacji rozszerzeń połączeń.

object (SitelinkExtensionParameters)

Parametry do użycia przy stosowaniu rekomendacji linku do podstrony.

object (MoveUnusedBudgetParameters)

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

object (ResponsiveSearchAdParameters)

Parametry do użycia przy stosowaniu rekomendacji elastycznych reklam w wyszukiwarce.

object (UseBroadMatchKeywordParameters)

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

object (ResponsiveSearchAdAssetParameters)

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

object (ResponsiveSearchAdImproveAdStrengthParameters)

Parametry używane podczas stosowania elastycznej reklamy w wyszukiwarce poprawiają skuteczność reklamy.

object (RaiseTargetCpaBidTooLowParameters)

Parametry do użycia w przypadku zastosowania rekomendacji dotyczącej podniesienia docelowej stawki CPA za zbyt niską wartość. Stosowanie jest asynchroniczne i może potrwać kilka minut w zależności od liczby grup reklam w danej kampanii.

object (ForecastingSetTargetRoasParameters)

Parametry do użycia przy stosowaniu rekomendacji dotyczącej docelowego ROAS ustawionego na potrzeby prognozowania.

object (CalloutAssetParameters)

Parametry do użycia przy stosowaniu rekomendacji komponentów z objaśnieniami.

object (CallAssetParameters)

Parametry do użycia przy stosowaniu rekomendacji komponentów do wykonywania połączeń.

object (SitelinkAssetParameters)

Parametry do użycia przy stosowaniu rekomendacji komponentów z linkami do podstron.

object (RaiseTargetCpaParameters)

Parametry do użycia przy stosowaniu rekomendacji dotyczącej zwiększenia docelowego CPA.

object (LowerTargetRoasParameters)

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

object (ForecastingSetTargetCpaParameters)

Parametry do użycia przy stosowaniu rekomendacji dotyczącej docelowego CPA ustawionego na potrzeby prognozy.

object (ForecastingSetTargetCpaParameters)

Parametry do użycia przy stosowaniu rekomendacji dotyczącej ustawienia docelowego CPA.

object (ForecastingSetTargetRoasParameters)

Parametry do użycia przy stosowaniu rekomendacji dotyczącej ustawienia docelowego ROAS.

object (LeadFormAssetParameters)

Parametry do użycia przy stosowaniu rekomendacji komponentów z formularzem kontaktowym.

{
  "newBudgetAmountMicros": string
}

string (int64 format)

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

{
  "ad": {
    object (Ad)
  }
}

object (Ad)

Nowa reklama, którą chcesz dodać do zalecanej grupy reklam. W tej wiadomości należy ustawić wszystkie niezbędne pola. To pole jest wymagane.

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

enum (KeywordMatchType)

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

string

Zasób grupy reklam, do którego chcesz dodać słowo kluczowe. To pole jest wymagane.

string (int64 format)

Opcjonalnie określa stawkę CPC za słowo kluczowe. Jeśli jej nie skonfigurujesz, słowo kluczowe będzie używać stawki na podstawie strategii ustalania stawek używanej przez docelową grupę reklam.

{
  "targetCpaMicros": string,
  "newCampaignBudgetAmountMicros": string
}

string (int64 format)

Średni CPA używany w strategii ustalania stawek Docelowy CPA. To pole jest wymagane.

string (int64 format)

Opcjonalnie kwota budżetu ustawiona na kampanię.

{
  "targetRoas": number,
  "newCampaignBudgetAmountMicros": string
}

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 parametr newCampaignBudgetAmountMicros.

string (int64 format)

Opcjonalnie kwota budżetu ustawiona na kampanię.

{
  "calloutExtensions": [
    {
      object (CalloutFeedItem)
    }
  ]
}

object (CalloutFeedItem)

Dodamy rozszerzenia objaśnień. To pole jest wymagane.

{
  "callExtensions": [
    {
      object (CallFeedItem)
    }
  ]
}

object (CallFeedItem)

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

{
  "sitelinkExtensions": [
    {
      object (SitelinkFeedItem)
    }
  ]
}

object (SitelinkFeedItem)

Linki do podstron do dodania. To pole jest wymagane.

{
  "budgetMicrosToMove": string
}

string (int64 format)

Kwota budżetu, która ma zostać zmieniona z nadmiarowego na ograniczony. To pole jest wymagane.

{
  "ad": {
    object (Ad)
  }
}

object (Ad)

To pole jest wymagane. Nowa reklama, którą chcesz dodać do zalecanej grupy reklam.

{
  "newBudgetAmountMicros": string
}

string (int64 format)

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

{
  "updatedAd": {
    object (Ad)
  }
}

object (Ad)

Zaktualizowano reklamę. Obecna treść reklamy zostanie zastąpiona.

{
  "updatedAd": {
    object (Ad)
  }
}

object (Ad)

Zaktualizowano reklamę. Obecna treść reklamy zostanie zastąpiona.

{
  "targetMultiplier": number
}

number

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

{
  "targetRoas": number,
  "campaignBudgetAmountMicros": string
}

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.

string (int64 format)

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

{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}

object (AdAssetApplyParameters)

To pole jest wymagane. Zostanie dodane komponenty z objaśnieniem. To pole jest wymagane.

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

object (Asset)

Zasoby do utworzenia i dołączenia do zakresu. W jednym wywołaniu można połączyć go z dotychczasowymi zasobami.

string

Nazwy zasobów istniejących zasobów, które mają zostać dołączone do zakresu. Można go połączyć z nowymi zasobami w tej samej wywołaniu.

enum (ApplyScope)

To pole jest wymagane. Zakres, do którego mają zostać zastosowane komponenty. Komponenty na poziomie kampanii zostaną zastosowane w kampanii powiązanej z rekomendacją. Komponenty należące do zakresu klienta będą mieć zastosowanie do całego konta. Komponenty na poziomie kampanii zastąpią wszystkie zasoby dołączone na poziomie klienta.

{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}

object (AdAssetApplyParameters)

To pole jest wymagane. Komponenty do wykonywania połączeń, które zostaną dodane. To pole jest wymagane.

{
  "adAssetApplyParameters": {
    object (AdAssetApplyParameters)
  }
}

object (AdAssetApplyParameters)

To pole jest wymagane. Zostanie dodane komponenty z linkami do podstron. To pole jest wymagane.

{
  "targetCpaMultiplier": number
}

number

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

{
  "targetRoasMultiplier": number
}

number

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

{
  "targetCpaMicros": string,
  "campaignBudgetAmountMicros": string
}

string (int64 format)

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

string (int64 format)

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

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

object (AdAssetApplyParameters)

To pole jest wymagane. Komponenty z formularzem kontaktowym do dodania. To pole jest wymagane.

boolean

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

{
  "resourceName": string
}

string

Zwrócony w przypadku zastosowania.