Method: customers.recommendations.generate

יוצרות המלצות על סמך סוגי ההמלצות המבוקשים.

רשימת שגיאות שקרו: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:generate

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

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

פרמטרים
customerId

string

חובה. מזהה הלקוח שיוצר את ההמלצות.

גוף הבקשה

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

ייצוג JSON 
{
  "recommendationTypes": [
    enum (RecommendationType)
  ],
  "advertisingChannelType": enum (AdvertisingChannelType),
  "adGroupInfo": [
    {
      object (AdGroupInfo)
    }
  ],
  "campaignSitelinkCount": integer,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "biddingInfo": {
    object (BiddingInfo)
  },
  "seedInfo": {
    object (SeedInfo)
  }
}
שדות
recommendationTypes[]

enum (RecommendationType)

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

המערכת תומכת בסוגי ההמלצות הבאים ליצירת המלצות: KEYWORD, MAXIMIZE_CPC_OPT_IN, MAXIMIZE_ מסך אופטימזציה
advertisingChannelType

enum (AdvertisingChannelType)

חובה. סוג ערוץ הפרסום של הקמפיין. ניתן ליצור המלצות בסוגי ה-AdvertisingChannelType הבאים: PERFORMANCE_MAX ו-SEARCH
adGroupInfo[]

object (AdGroupInfo)

אפשרות. הפרטים הנוכחיים של קבוצת המודעות. תומך במידע מקבוצת מודעות אחת. השדה הזה הוא אופציונלי עבור ההמלצות הבאות: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

אפשרות. הסטטוס הנוכחי של מעקב ההמרות. השדה הזה נדרש לסוגי ההמלצות הבאים: MAXIMIZE_CPC_OPT_IN, MAXIMIZE_אז_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

אפשרות. פרטי הבידינג הנוכחיים של הקמפיין. השדה הזה נדרש לסוגי ההמלצות הבאים: MAXIMIZE_CPC_OPT_IN, MAXIMIZE_אז_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
seedInfo

object (SeedInfo)

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

גוף התשובה

הודעת תשובה לגבי RecommendationService.GenerateRecommendations.

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

ייצוג JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
שדות
recommendations[]

object (Recommendation)

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

היקפי הרשאות

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

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

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

BiddingInfo

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

ייצוג JSON 
{
  "biddingStrategyType": enum (BiddingStrategyType),

  // Union field bidding_strategy_target_info can be only one of the following:
  "targetCpaMicros": string,
  "targetRoas": number
  // End of list of possible types for union field bidding_strategy_target_info.
}
שדות
biddingStrategyType

enum (BiddingStrategyType)

שיטת הבידינג הנוכחית. השדה הזה נדרש לסוגי ההמלצות הבאים: MAXIMIZE_CPC_OPT_IN, MAXIMIZE_אז_OPT_IN, MAXIMIZE_CONVERSION_VALUE_OPT_IN, SET_TARGET_CPA, SET_TARGET_ROAS, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN
שדה איחוד bidding_strategy_target_info. פרטים אופציונליים שקשורים ל-Bid_strategy_type. bidding_strategy_target_info יכול להיות רק אחד מהבאים:
targetCpaMicros

string (int64 format)

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

number

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

AdGroupInfo

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

ייצוג JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
שדות
keywords[]

object (KeywordInfo)

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

enum (AdGroupType)

אפשרות. סוג קבוצת המודעות של קבוצת המודעות. השדה הזה נדרש עבור סוגי ההמלצות הבאים אם קבוצת adGroupInfo מוגדרת: KEYWORD

SeedInfo

מקור מילת מפתח וכתובת URL ספציפית שממנה יוצרים מילות מפתח.

ייצוג JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
שדות
keywordSeeds[]

string

אפשרות. מילות מפתח או ביטויים שבעזרתם אפשר ליצור רעיונות. לדוגמה: מכוניות או "סוכנות רכב בסביבה".
urlSeed

string

כתובת URL ספציפית שממנה רוצים ליצור רעיונות, לדוגמה: www.example.com/cars.