Method: customers.generateKeywordForecastMetrics

מחזירה מדדים (כמו חשיפות, קליקים, עלות כוללת) של תחזית מילת מפתח בקמפיין הנתון.

רשימת שגיאות הטמעה: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

מספר הלקוח.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "forecastPeriod": {
    object (DateRange)
  },
  "campaign": {
    object (CampaignToForecast)
  },
  "currencyCode": string
}
שדות
forecastPeriod

object (DateRange)

טווח התאריכים של התחזית. תאריך ההתחלה חייב להיות בעתיד ותאריך הסיום חייב להיות בטווח של שנה מהיום. אזור הזמן שמוגדר להפניה הוא זה שמוגדר בחשבון Google Ads ששייך ללקוח. אם המדיניות לא מוגדרת, ייעשה שימוש בטווח תאריכים המוגדר כברירת מחדל מיום ראשון הבא עד ליום שבת הבא.
campaign

object (CampaignToForecast)

חובה. הקמפיין שנעשה בו שימוש בתחזית.
currencyCode

string

המטבע המשמש להמרת שערי החליפין. כברירת מחדל, נעשה שימוש במטבע של הלקוח בחשבון. יש להגדיר את השדה הזה רק אם המטבע שונה ממטבע החשבון. רשימת קודי המטבע התקינים מופיעה בכתובת https://developers.google.com/google-ads/api/data/codes-formats#currency-codes.

גוף התגובה

הודעת תגובה עבור [KeywordPlanIdeaService.GenerateKeywordForecastMetrics].

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "campaignForecastMetrics": {
    object (KeywordForecastMetrics)
  }
}
שדות
campaignForecastMetrics

object (KeywordForecastMetrics)

תוצאות התחזית של הקמפיין.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/adwords

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

CampaignToForecast

קמפיין ליצירת תחזית לקמפיין מילות מפתח.

ייצוג JSON 
{
  "languageConstants": [
    string
  ],
  "geoModifiers": [
    {
      object (CriterionBidModifier)
    }
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "biddingStrategy": {
    object (CampaignBiddingStrategy)
  },
  "adGroups": [
    {
      object (ForecastAdGroup)
    }
  ],
  "conversionRate": number
}
שדות
languageConstants[]

string

רשימת שמות המשאבים של השפות לטירגוט. שם המשאב הוא בפורמט "languageConstants/{criterionId}". בכתובת https://developers.google.com/google-ads/api/data/codes-formats#languages מופיעה רשימת הקודים של קריטריוני השפה.
geoModifiers[]

object (CriterionBidModifier)

מיקומים לטירגוט. מיקומים חייבים להיות ייחודיים.
keywordPlanNetwork

enum (KeywordPlanNetwork)

חובה. הרשת המשמשת לטירגוט.
negativeKeywords[]

object (KeywordInfo)

הרשימה של מילות המפתח השליליות שיש להשתמש בהן בקמפיין בזמן ביצוע התחזית.
biddingStrategy

object (CampaignBiddingStrategy)

חובה. שיטת הבידינג בקמפיין.
adGroups[]

object (ForecastAdGroup)

קבוצות המודעות בקמפיין החדש לצורך יצירת תחזית.
conversionRate

number

שיעור ההמרות הצפוי (מספר ההמרות חלקי מספר הקליקים הכולל) כפי שהגדיר המשתמש. ערך זה מבוטא כערך עשרוני, לכן שיעור המרה צפוי של 2% יש להזין כ-0.02. אם השדה יישאר ריק, המערכת תשתמש בשיעור המרה משוער.

CriterionBidModifier

התאמת הצעת מחיר של קריטריון מיקום.

ייצוג JSON 
{
  "geoTargetConstant": string,
  "bidModifier": number
}
שדות
geoTargetConstant

string

שם המשאב של המיקום הגיאוגרפי שאליו יש לטרגט. שם המשאב הוא בפורמט "geoTargetConstants/{criterionId}".
bidModifier

number

המכפיל המשויך ל-criterionId. אם הוא מוגדר, הערך הזה לא יכול להיות 0.

CampaignBiddingStrategy

שיטות בידינג נתמכות לתחזיות של קמפיינים חדשים.

ייצוג JSON 
{

  // Union field bidding_strategy can be only one of the following:
  "manualCpcBiddingStrategy": {
    object (ManualCpcBiddingStrategy)
  },
  "maximizeClicksBiddingStrategy": {
    object (MaximizeClicksBiddingStrategy)
  },
  "maximizeConversionsBiddingStrategy": {
    object (MaximizeConversionsBiddingStrategy)
  }
  // End of list of possible types for union field bidding_strategy.
}
שדות
שדה איחוד bidding_strategy. שיטות בידינג. הערך של bidding_strategy יכול להיות רק אחת מהאפשרויות הבאות:
manualCpcBiddingStrategy

object (ManualCpcBiddingStrategy)

לצורך חיזוי, כדאי להשתמש בשיטת בידינג ידנית לקליק.
maximizeClicksBiddingStrategy

object (MaximizeClicksBiddingStrategy)

לשם חיזוי, כדאי להשתמש בשיטת הבידינג 'מקסימום קליקים'.
maximizeConversionsBiddingStrategy

object (MaximizeConversionsBiddingStrategy)

לצורך חיזוי, כדאי להשתמש בשיטת הבידינג 'מקסימום המרות'.

ManualCpcBiddingStrategy

שיטת בידינג ידנית לפי עלות לקליק.

ייצוג JSON 
{
  "maxCpcBidMicros": string,
  "dailyBudgetMicros": string
}
שדות
maxCpcBidMicros

string (int64 format)

חובה. הצעת מחיר ב-Micros שיש להחיל על קבוצות מודעות בקמפיין עבור שיטת בידינג ידנית לקליק.
dailyBudgetMicros

string (int64 format)

תקציב ברמת הקמפיין ב-Micros. אם הוא מוגדר, המערכת תחיל ערך מינימלי עבור המטבע המקומי שבשימוש בקמפיין. אם הערך בשדה הזה יהיה נמוך מדי, תופיע שגיאה בהצגת הערך המינימלי.

MaximizeClicksBiddingStrategy

שיטת הבידינג 'מקסימום קליקים'

ייצוג JSON 
{
  "dailyTargetSpendMicros": string,
  "maxCpcBidCeilingMicros": string
}
שדות
dailyTargetSpendMicros

string (int64 format)

חובה. יעד ההוצאות היומי במיקרו נתונים שישמש להערכה. המערכת אוכפת ערך מינימלי עבור המטבע המקומי שנעשה בו שימוש בקמפיין. אם הערך בשדה הזה יהיה נמוך מדי, תופיע שגיאה בהצגת הערך המינימלי.
maxCpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר המקסימליות לקליק ב-Micros.

MaximizeConversionsBiddingStrategy

שיטת הבידינג 'מקסימום המרות'.

ייצוג JSON 
{
  "dailyTargetSpendMicros": string
}
שדות
dailyTargetSpendMicros

string (int64 format)

חובה. יעד ההוצאות היומי במיקרו נתונים שישמש להערכה. הערך הזה חייב להיות גדול מאפס.

ForecastAdGroup

קבוצת מודעות שנכללת בקמפיין שאמורה להופיע עבורו תחזית.

ייצוג JSON 
{
  "biddableKeywords": [
    {
      object (BiddableKeyword)
    }
  ],
  "negativeKeywords": [
    {
      object (KeywordInfo)
    }
  ],
  "maxCpcBidMicros": string
}
שדות
biddableKeywords[]

object (BiddableKeyword)

חובה. רשימת מילות המפתח שניתן להגיש עליהן הצעות מחיר שישמשו בקבוצת המודעות בזמן ביצוע התחזית. נדרשת לפחות מילת מפתח אחת.
negativeKeywords[]

object (KeywordInfo)

הפרטים של מילת המפתח. עליך לציין גם את הטקסט של מילת המפתח וגם את סוג ההתאמה.
maxCpcBidMicros

string (int64 format)

העלות המקסימלית לקליק שיש להשתמש בה עבור קבוצת המודעות בעת יצירת תחזית תנועה. הערך הזה יחליף את הערך של העלות המקסימלית לקליק שהוגדרה בשיטת הבידינג. יש לציין את השדה הזה רק לשיטות בידינג עם ערכי עלות מקסימלית לקליק.

BiddableKeyword

חלק של מילת מפתח בקבוצת מודעות שניתן להגיש עליה הצעות מחיר.

ייצוג JSON 
{
  "keyword": {
    object (KeywordInfo)
  },
  "maxCpcBidMicros": string
}
שדות
keyword

object (KeywordInfo)

חובה. מילת מפתח. צריך להזין טקסט וסוג התאמה.
maxCpcBidMicros

string (int64 format)

הצעת מחיר מקסימלית לקליק ברכיבי המיקרו שעוקפת את הצעת המחיר המקסימלית לקליק ברמת קבוצת המודעות בסימולציה של התחזית. הערך הזה יחליף את הערך של העלות המקסימלית לקליק שהוגדר בשיטת הבידינג ובקבוצת המודעות. יש לציין את השדה הזה רק בשיטות בידינג שתומכות בערכים של עלות מקסימלית לקליק.

KeywordForecastMetrics

מדדי התחזית עבור קמפיין מילות מפתח ללא תוכנית.

ייצוג JSON 
{
  "impressions": number,
  "clickThroughRate": number,
  "averageCpcMicros": string,
  "clicks": number,
  "costMicros": string,
  "conversions": number,
  "conversionRate": number,
  "averageCpaMicros": string
}
שדות
impressions

number

מספר החשיפות הכולל.
clickThroughRate

number

שיעור הקליקים הממוצע. המדד הזה זמין רק אם מספר החשיפות גדול מ-0.
averageCpcMicros

string (int64 format)

העלות הממוצעת לקליק. המדד הזה זמין רק אם הקליקים > 0.
clicks

number

המספר הכולל של הקליקים.
costMicros

string (int64 format)

העלות הכוללת.
conversions

number

מספר חזוי של המרות: קליקים * שיעור המרות.
conversionRate

number

תחזית שיעור המרה.
averageCpaMicros

string (int64 format)

העלות הממוצעת להמרה מחושבת לפי costMicros / המרות.