Method: customers.generateKeywordForecastMetrics

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

רשימת שגיאות שהתקבלו: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v16/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)

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

string (int64 format)

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

MaximizeClicksBiddingStrategy

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

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

string (int64 format)

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

string (int64 format)

תקרת הצעות המחיר המקסימליות לקליק במיליוניות השנייה.

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)

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

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 / המרות.