Method: customers.recommendations.generate

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

רשימת השגיאות שהופעלו: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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)

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

יש תמיכה בסוגי ההמלצות הבאים ליצירת המלצות: KEYWORD,‏ MAXIMIZE_CLICKS_OPT_IN,‏ MAXIMIZE_CONVERSIONS_OPT_IN,‏ MAXIMIZE_CONVERSION_VALUE_OPT_IN,‏ SET_TARGET_CPA,‏ SET_TARGET_ROAS,‏ SITELINK_ASSET,‏ TARGET_CPA_OPT_IN,‏ TARGET_ROAS_OPT_IN
advertisingChannelType

enum (AdvertisingChannelType)

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

object (AdGroupInfo)

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

enum (ConversionTrackingStatus)

זה שינוי אופציונלי. הסטטוס הנוכחי של מעקב ההמרות. השדה הזה נדרש ל-recommendationTypes הבאים: MAXIMIZE_CLICKS_OPT_IN,‏ MAXIMIZE_CONVERSIONS_OPT_IN,‏ MAXIMIZE_CONVERSION_VALUE_OPT_IN,‏ SET_TARGET_CPA,‏ SET_TARGET_ROAS,‏ TARGET_CPA_OPT_IN,‏ TARGET_ROAS_OPT_IN
biddingInfo

object (BiddingInfo)

זה שינוי אופציונלי. מידע נוכחי על הבידינג בקמפיין. השדה הזה נדרש ל-recommendationTypes הבאים: MAXIMIZE_CLICKS_OPT_IN,‏ MAXIMIZE_CONVERSIONS_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

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

ייצוג 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)

שיטת הבידינג הנוכחית. השדה הזה נדרש ל-recommendationTypes הבאים: MAXIMIZE_CLICKS_OPT_IN,‏ MAXIMIZE_CONVERSIONS_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. פרטים אופציונליים שקשורים ל-bidding_strategy_type. הערך של bidding_strategy_target_info יכול להיות רק אחת מהאפשרויות הבאות:
targetCpaMicros

string (int64 format)

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

number

יעד ההחזר הנוכחי על הוצאות הפרסום. אפשר לאכלס את השדה הזה בקמפיינים עם שיטת בידינג מסוג 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

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

string

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