- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- CampaignToForecast
- CriterionBidModifier
- CampaignBiddingStrategy
- ManualCpcBiddingStrategy
- MaximizeClicksBiddingStrategy
- MaximizeConversionsBiddingStrategy
- ForecastAdGroup
- BiddableKeyword
- KeywordForecastMetrics
- Wypróbuj
Zwraca dane (np. wyświetlenia, kliknięcia i łączny koszt) prognozy słów kluczowych w danej kampanii.
Lista zgłoszonych błędów: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError.
Żądanie HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}:generateKeywordForecastMetrics
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
Identyfikator klienta. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "forecastPeriod": { object ( |
Pola | |
---|---|
forecastPeriod |
Zakres dat prognozy. Data rozpoczęcia musi przypadać w przyszłości, a data zakończenia nie może być późniejsza niż rok od dzisiaj. Użyta strefa czasowa to strefa czasowa ustawiona na koncie Google Ads należącym do klienta. Jeśli zasada nie jest skonfigurowana, używany jest domyślny zakres dat od następnej niedzieli do następnej soboty. |
campaign |
Wymagane. Kampania użyta w prognozie. |
currencyCode |
Waluta używana do przeliczania kursu wymiany. Domyślnie używana jest waluta konta klienta. Ustaw to pole tylko wtedy, gdy waluta jest inna niż waluta konta. Listę prawidłowych kodów walut znajdziesz na stronie https://developers.google.com/google-ads/api/data/codes-formats#currency-codes. |
Treść odpowiedzi
Komunikat z odpowiedzią na temat usługi [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"campaignForecastMetrics": {
object ( |
Pola | |
---|---|
campaignForecastMetrics |
Wyniki prognozy kampanii. |
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.
CampaignToForecast
Kampania, dla której chcesz utworzyć prognozę dla kampanii opartej na słowach kluczowych.
Zapis JSON |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
Pola | |
---|---|
languageConstants[] |
Lista nazw zasobów dla języków, które mają być docelowe. Nazwa zasobu ma format „languageConstants/{kryteriumId}”. Listę kodów kryteriów języka znajdziesz na stronie https://developers.google.com/google-ads/api/data/codes-formats#languages. |
geoModifiers[] |
Lokalizacje, na które będą kierowane reklamy. Lokalizacje muszą być niepowtarzalne. |
keywordPlanNetwork |
Wymagane. Sieć używana do kierowania. |
negativeKeywords[] |
Lista wykluczających słów kluczowych, które mają być używane w kampanii podczas tworzenia prognozy. |
biddingStrategy |
Wymagane. Strategia ustalania stawek w kampanii. |
adGroups[] |
Grupy reklam w nowej kampanii, które mają zostać objęte prognozą. |
conversionRate |
Przewidywany współczynnik konwersji (liczba konwersji podzielona przez łączną liczbę kliknięć) zdefiniowany przez użytkownika. Jest to wartość dziesiętna, więc oczekiwany współczynnik konwersji równy 2% należy wpisać jako 0,02. Jeśli pozostawisz to pole puste, używany będzie szacowany współczynnik konwersji. |
CriterionBidModifier
Modyfikator stawek kryterium lokalizacji.
Zapis JSON |
---|
{ "geoTargetConstant": string, "bidModifier": number } |
Pola | |
---|---|
geoTargetConstant |
Nazwa zasobu lokalizacji geograficznej, na którą chcesz kierować reklamy. Nazwa zasobu ma format „geoTargetConstants/{kryteriumId}”. |
bidModifier |
Mnożnik powiązany z identyfikatorem kryterium. Jeśli jest ustawiona, ta wartość nie może wynosić 0. |
CampaignBiddingStrategy
Strategie ustalania stawek obsługiwane w nowych prognozach kampanii.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy bidding_strategy . Strategie ustalania stawek. bidding_strategy może mieć tylko jedną z tych wartości: |
|
manualCpcBiddingStrategy |
Do prognozowania użyj strategii samodzielnego określania stawek CPC. |
maximizeClicksBiddingStrategy |
Do prognozowania użyj strategii ustalania stawek pod kątem maksymalizacji liczby kliknięć. |
maximizeConversionsBiddingStrategy |
Do prognozowania użyj strategii ustalania stawek Maksymalizacja liczby konwersji. |
ManualCpcBiddingStrategy
Strategia samodzielnego określania stawek CPC.
Zapis JSON |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
Pola | |
---|---|
maxCpcBidMicros |
Wymagane. Stawka w mikro, która zostanie zastosowana do grup reklam w kampanii w przypadku strategii samodzielnego określania stawek CPC. |
dailyBudgetMicros |
Budżet na poziomie kampanii w mikro. Jeśli jest ustawiony, obowiązuje minimalna wartość w walucie lokalnej używanej w kampanii. Jeśli wartość w tym polu jest zbyt niska, wystąpi błąd związany z minimalną wartością. |
MaximizeClicksBiddingStrategy
Strategia ustalania stawek pod kątem maksymalizacji liczby kliknięć.
Zapis JSON |
---|
{ "dailyTargetSpendMicros": string, "maxCpcBidCeilingMicros": string } |
Pola | |
---|---|
dailyTargetSpendMicros |
Wymagane. Dzienne docelowe wydatki w mikrosekundach używane do szacowania. W przypadku waluty lokalnej używanej w kampanii obowiązuje minimalna wartość. Jeśli wartość w tym polu jest zbyt niska, wystąpi błąd związany z minimalną wartością. |
maxCpcBidCeilingMicros |
Limit maks. stawek CPC w mikro. |
MaximizeConversionsBiddingStrategy
Strategia ustalania stawek pod kątem maksymalizacji liczby konwersji.
Zapis JSON |
---|
{ "dailyTargetSpendMicros": string } |
Pola | |
---|---|
dailyTargetSpendMicros |
Wymagane. Dzienne docelowe wydatki w mikrosekundach używane do szacowania. Ta wartość musi być większa niż 0. |
ForecastAdGroup
Grupa reklam wchodząca w skład kampanii, której dotyczy prognoza.
Zapis JSON |
---|
{ "biddableKeywords": [ { object ( |
Pola | |
---|---|
biddableKeywords[] |
Wymagane. Lista słów kluczowych z możliwością określenia stawki, które mają być używane w grupie reklam podczas wykonywania prognozy. Wymaga co najmniej jednego słowa kluczowego. |
negativeKeywords[] |
Szczegóły słowa kluczowego. Należy podać zarówno tekst słowa kluczowego, jak i typ dopasowania. |
maxCpcBidMicros |
Maksymalny CPC grupy reklam używany do generowania prognozowanego ruchu. Ta wartość zastąpi maksymalną wartość CPC ustawioną w strategii ustalania stawek. Wypełnij to pole tylko w przypadku strategii ustalania stawek, które określają maks. CPC. |
BiddableKeyword
Słowo kluczowe z możliwością określenia stawki, należące do grupy reklam.
Zapis JSON |
---|
{
"keyword": {
object ( |
Pola | |
---|---|
keyword |
Wymagane. Słowo kluczowe. Musi zawierać tekst i typ dopasowania. |
maxCpcBidMicros |
Maksymalna stawka CPC w mikro na poziomie grupy reklam zastąpi maks. stawkę CPC na poziomie grupy reklam w symulacji prognozowania. Ta wartość zastąpi maksymalną wartość CPC ustawioną w strategii ustalania stawek i w grupie reklam. Wypełnij to pole tylko w przypadku strategii ustalania stawek, które obsługują wartości maks. CPC. |
KeywordForecastMetrics
Dane prognozy dla bezplanowej kampanii opartej na słowach kluczowych.
Zapis JSON |
---|
{ "impressions": number, "clickThroughRate": number, "averageCpcMicros": string, "clicks": number, "costMicros": string, "conversions": number, "conversionRate": number, "averageCpaMicros": string } |
Pola | |
---|---|
impressions |
Łączna liczba wyświetleń. |
clickThroughRate |
Średni współczynnik klikalności. Dostępne tylko wtedy, gdy wyświetlenia: > 0. |
averageCpcMicros |
Średni CPC. Dostępne tylko po kliknięciu > 0. |
clicks |
Łączna liczba kliknięć. |
costMicros |
Całkowity koszt. |
conversions |
Prognozowana liczba konwersji: kliknięcia * współczynnik konwersji. |
conversionRate |
Prognozowany współczynnik konwersji. |
averageCpaMicros |
Średni koszt pozyskania obliczany według wzoru: costMicros / konwersje. |