Method: customers.recommendations.generate

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

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

ต้องระบุ รายการ GuideType ที่มีสิทธิ์ที่จะสร้าง หากเกณฑ์ที่อัปโหลดไม่เพียงพอที่จะให้คำแนะนำ หรือแคมเปญอยู่ในสถานะที่แนะนำแล้ว ระบบจะไม่แสดงคำแนะนำสำหรับประเภทนั้น โดยทั่วไป ระบบจะแสดงคําแนะนําหากอัปโหลดช่องที่ต้องกรอกทั้งหมดสําหรับ 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)

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

ไม่บังคับ ข้อมูลการเสนอราคาปัจจุบันของแคมเปญ ช่องนี้จำเป็นสำหรับคำแนะนำต่อไปนี้ 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)

ไม่บังคับ ข้อมูลเริ่มต้นสำหรับคีย์เวิร์ด ต้องกรอกข้อมูลในช่องนี้สำหรับ recommendationsType ต่อไปนี้: KEYWORD

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ RecommendationService.GenerateRecommendations

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "recommendations": [
    {
      object (Recommendation)
    }
  ]
}
ช่อง
recommendations[]

object (Recommendation)

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

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

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

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

number

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

AdGroupInfo

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

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

object (KeywordInfo)

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

enum (AdGroupType)

ไม่บังคับ ประเภทกลุ่มโฆษณาของกลุ่มโฆษณา ต้องกรอกข้อมูลในช่องนี้สำหรับ recommendationsType ต่อไปนี้หากมีการตั้งค่า adGroupInfo ไว้: KEYWORD

SeedInfo

รายการเริ่มต้นของคีย์เวิร์ดและ URL ที่เจาะจงสำหรับสร้างคีย์เวิร์ด

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

string

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

string

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