Method: customers.recommendations.generate

สร้างคำแนะนำตาม recommendationsTypes ที่ขอ

รายการข้อผิดพลาดที่พบ: 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)

ต้องระบุ รายการ recommendationsTypes ที่มีสิทธิ์ที่จะสร้าง หากเกณฑ์ที่อัปโหลดไม่เพียงพอที่จะให้คำแนะนำ หรือแคมเปญอยู่ในสถานะที่แนะนำอยู่แล้ว ระบบจะไม่แสดงคำแนะนำสำหรับประเภทนั้น โดยทั่วไป ระบบจะแสดงคำแนะนำหากมีการอัปโหลดช่องที่ต้องกรอกทั้งหมดสำหรับRecommendationType นั้น แต่ก็ยังมีบางกรณีที่ยังไม่เพียงพอ

รองรับคำแนะนำประเภทต่อไปนี้สำหรับการสร้างคำแนะนำ: KEYWORD, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_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)

ต้องระบุ ประเภทช่องทางโฆษณาของแคมเปญ ระบบรองรับ AdvertisingChannelType ต่อไปนี้สําหรับการสร้างคําแนะนํา: PERFORMANCE_MAX และ SEARCH
adGroupInfo[]

object (AdGroupInfo)

ไม่บังคับ ข้อมูลกลุ่มโฆษณาปัจจุบัน รองรับข้อมูลจากกลุ่มโฆษณาเดียว ช่องนี้ไม่บังคับสำหรับ recommendationsTypes ต่อไปนี้: KEYWORD
conversionTrackingStatus

enum (ConversionTrackingStatus)

ไม่บังคับ สถานะเครื่องมือวัด Conversion ปัจจุบัน ฟิลด์นี้จำเป็นสำหรับคำแนะนำประเภทต่อไปนี้: MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_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_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_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)

รายการคำแนะนำที่สร้างขึ้นจากชุดคำแนะนำที่ส่งในชุดคำแนะนำที่ขอ หากมีข้อมูลไม่เพียงพอที่จะสร้างคำแนะนำสำหรับRecommendationTypes ที่ขอ ชุดผลลัพธ์จะไม่มีคำแนะนำสำหรับประเภทดังกล่าว

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต 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_CLICKS_OPT_IN, MAXIMIZE_CONVERSION_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)

targetCpa ปัจจุบันในไมโคร ค่านี้สามารถเป็นข้อมูลสำหรับแคมเปญที่มีประเภทกลยุทธ์การเสนอราคาเป็น TARGET_CPA หรือ MAXIMIZE_CONVERSION
targetRoas

number

targetRoas ปัจจุบัน ค่านี้สามารถป้อนข้อมูลสำหรับแคมเปญที่มีประเภทกลยุทธ์การเสนอราคา TARGET_ROAS หรือ MAXIMIZE_CONVERSION_VALUE

AdGroupInfo

ข้อมูลกลุ่มโฆษณาปัจจุบันของแคมเปญ

การแสดง JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
ช่อง
keywords[]

object (KeywordInfo)

ไม่บังคับ คีย์เวิร์ดปัจจุบัน ช่องนี้ไม่บังคับสำหรับ recommendedTypes ต่อไปนี้ หากตั้งค่า adGroupInfo ไว้: KEYWORD
adGroupType

enum (AdGroupType)

ไม่บังคับ ประเภทกลุ่มโฆษณาของกลุ่มโฆษณา ฟิลด์นี้จำเป็นสำหรับการให้คำแนะนำประเภทที่กำหนดต่อไปนี้หากมีการตั้งค่า adGroupInfo ไว้: KEYWORD

SeedInfo

คีย์เวิร์ดตั้งต้นและ URL เฉพาะที่จะใช้สร้างคีย์เวิร์ด

การแสดง JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
ช่อง
keywordSeeds[]

string

ไม่บังคับ คีย์เวิร์ดหรือข้อความที่จะใช้สร้างแนวคิด เช่น รถยนต์หรือ "ตัวแทนจำหน่ายรถยนต์ใกล้ฉัน"
urlSeed

string

URL ที่เฉพาะเจาะจงสำหรับสร้างแนวคิด เช่น www.example.com/cars