- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- CampaignToForecast
- CriterionBidModifier
- CampaignBiddingStrategy
- ManualCpcBiddingStrategy
- MaximizeClicksBiddingStrategy
- MaximizeConversionsBiddingStrategy
- ForecastAdGroup
- BiddableKeyword
- KeywordForecastMetrics
- Wypróbuj
Zwraca dane (takie jak wyświetlenia, kliknięcia i łączny koszt) prognozy słów kluczowych dla danej kampanii.
Lista zgłoszonych błędów: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError.
Żądanie HTTP
POST https://googleads.googleapis.com/v16/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 – w ciągu roku od dzisiaj. Użyta referencyjna strefa czasowa to strefa czasowa konta Google Ads należącego do klienta. Jeśli nie zostanie ustawiony, używany będzie domyślny zakres dat od następnej niedzieli do następnej soboty. |
campaign |
To pole jest 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
Odpowiedź na pytanie dotyczące [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 omówieniu protokołu OAuth 2.0.
CampaignToForecast
Kampania, która ma wygenerować prognozę dla kampanii opartej na słowach kluczowych.
Zapis JSON |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
Pola | |
---|---|
languageConstants[] |
Lista nazw zasobów języków, na które mają być kierowane reklamy. 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 mają być kierowane reklamy. Lokalizacje muszą być niepowtarzalne. |
keywordPlanNetwork |
To pole jest 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 |
To pole jest wymagane. Strategia ustalania stawek w kampanii. |
adGroups[] |
Grupy reklam w nowej kampanii, które mają być objęte prognozą. |
conversionRate |
Oczekiwany współczynnik konwersji (liczba konwersji podzielona przez liczbę wszystkich kliknięć) określoną przez użytkownika. Wartość jest wyrażona ułamkiem dziesiętnym, więc oczekiwany współczynnik konwersji równy 2% należy wpisać jako 0,02. Jeśli pozostawisz to pole puste, zostanie zastosowany szacunkowy 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/{criterionId}”. |
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 na potrzeby nowych prognoz kampanii.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy bidding_strategy . Strategie ustalania stawek. bidding_strategy może być tylko jedną z tych wartości: |
|
manualCpcBiddingStrategy |
Używaj strategii samodzielnego ustalania stawek CPC do prognozowania. |
maximizeClicksBiddingStrategy |
Użyj strategii ustalania stawek pod kątem maksymalizacji liczby kliknięć do prognozowania. |
maximizeConversionsBiddingStrategy |
Użyj strategii ustalania stawek pod kątem maksymalizacji liczby konwersji do prognozowania. |
ManualCpcBiddingStrategy
Strategia samodzielnego ustawiania stawek CPC.
Zapis JSON |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
Pola | |
---|---|
maxCpcBidMicros |
To pole jest wymagane. Stawka (w mikro) stosowana do grup reklam w kampanii w przypadku strategii samodzielnego określania stawek CPC. |
dailyBudgetMicros |
Budżet na poziomie kampanii w mikro. Jeśli jest ustawione, dla waluty lokalnej w kampanii wymuszana będzie wartość minimalna. Jeśli wartość w tym polu będzie ustawiona zbyt nisko, pojawi się 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 |
To pole jest wymagane. Dzienne docelowe wydatki w mikro do użycia do oszacowania. W lokalnej walucie używanej w kampanii obowiązuje wartość minimalna. Jeśli wartość w tym polu będzie ustawiona zbyt nisko, pojawi się błąd związany z minimalną wartością. |
maxCpcBidCeilingMicros |
Pułap maks. stawek CPC w mikro. |
MaximizeConversionsBiddingStrategy
Strategia ustalania stawek Maksymalizacja liczby konwersji.
Zapis JSON |
---|
{ "dailyTargetSpendMicros": string } |
Pola | |
---|---|
dailyTargetSpendMicros |
To pole jest wymagane. Dzienne docelowe wydatki w mikro do użycia do oszacowania. Ta wartość musi być większa od zera. |
ForecastAdGroup
Grupa reklam będąca częścią kampanii, której dotyczy prognoza.
Zapis JSON |
---|
{ "biddableKeywords": [ { object ( |
Pola | |
---|---|
biddableKeywords[] |
To pole jest wymagane. Lista słów kluczowych z możliwością określenia stawki, których chcesz użyć w grupie reklam podczas wykonywania prognozy. Wymaga co najmniej jednego słowa kluczowego. |
negativeKeywords[] |
Szczegóły słowa kluczowego. Musisz podać zarówno tekst, jak i typ dopasowania słowa kluczowego. |
maxCpcBidMicros |
Maksymalny CPC używany przez grupę reklam podczas generowania prognozowanego ruchu. Ta wartość zastąpi wartość maksymalnego CPC ustawioną w strategii ustalania stawek. Stosuj to pole tylko w przypadku strategii ustalania stawek, które maksymalizują wartość CPC. |
BiddableKeyword
Część grupy reklam zawierająca słowo kluczowe z możliwością określenia stawki.
Zapis JSON |
---|
{
"keyword": {
object ( |
Pola | |
---|---|
keyword |
To pole jest wymagane. Słowo kluczowe. Wymagany jest tekst i typ dopasowania. |
maxCpcBidMicros |
Maksymalna stawka CPC w mikro, która zastępuje maks. stawkę CPC na poziomie grupy reklam w symulacji prognozy. Ta wartość zastąpi wartość maksymalnego CPC ustawioną w strategii ustalania stawek i w grupie reklam. Stosuj to pole tylko w przypadku strategii ustalania stawek, które obsługują wartości maks. CPC. |
KeywordForecastMetrics
Dane prognozy dla bezplanowanej 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 liczba wyświetleń przekracza 0. |
averageCpcMicros |
Średni CPC. Wartość dostępna tylko wtedy, gdy liczba kliknięć przekracza 0. |
clicks |
Łączna liczba kliknięć. |
costMicros |
Łączny koszt. |
conversions |
Prognozowana liczba konwersji: kliknięcia * współczynnik konwersji. |
conversionRate |
Prognozowany współczynnik konwersji. |
averageCpaMicros |
Średni koszt pozyskania obliczony jako koszt mikro konwersji / liczba konwersji. |