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)

مطلوبة. قائمة بأنواع الاقتراحات المؤهَّلة التي يمكن إنشاؤها. إذا كانت المعايير المحمَّلة غير كافية لتقديم اقتراح، أو إذا كانت الحملة في الحالة المقترَحة، لن يتمّ عرض أيّ اقتراح لهذا النوع. بشكل عام، يتم عرض اقتراح إذا تم تحميل جميع الحقول المطلوبة لنوع التوصية هذا، ولكن هناك حالات لا يكون فيها ذلك كافيًا.

أنواع الاقتراحات التالية متاحة لإنشاء الاقتراحات: الكلمة الرئيسية، وMAXIMIZE_نقرة_opt_IN، وMAXIMIZE_SECONDS_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)

مطلوبة. نوع القناة الإعلانية للحملة يمكن استخدام نوعَي الإعلانات adsChannelTypes التاليَين لإنشاء الاقتراحات: PERFORMANCE_MAX وSEARCH
adGroupInfo[]

object (AdGroupInfo)

اختياريّ. معلومات المجموعة الإعلانية الحالية. تدعم المعلومات من مجموعة إعلانية واحدة هذا الحقل اختياري لأنواع التوصيات التالية: الكلمة الرئيسية
conversionTrackingStatus

enum (ConversionTrackingStatus)

اختياريّ. حالة تتبُّع الإحالات الناجحة الحالية. هذا الحقل ضروري لأنواع الاقتراحات التالية: MAXIMIZE_EXAMPLE_TAB_IN وMAXIMIZE_SECONDS_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_EXAMPLE_TAB_IN وMAXIMIZE_SECONDS_opt_IN وMAXIMIZE_CONVERSION_VALUE_opt_IN وSET_TARGET_CPA وSET_TARGET_ROAS، وTARGET_CPA_opt_IN، وTARGET_ROAS_opt_IN.
seedInfo

object (SeedInfo)

اختياريّ. المعلومات الأولية للكلمات الرئيسية. هذا الحقل ضروري لأنواع التوصيات التالية: الكلمة الرئيسية

نص الاستجابة

رسالة الرد لـ "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)

استراتيجية عروض الأسعار الحالية. هذا الحقل ضروري لأنواع الاقتراحات التالية: MAXIMIZE_EXAMPLE_TAB_IN وMAXIMIZE_SECONDS_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)

التكلفة المستهدفة الحالية للإجراء بالمايكرو. يمكن تعبئة هذه البيانات للحملات التي من نوع استراتيجية عروض الأسعار TARGET_CPA أو MAXIMIZE_Migrate.
targetRoas

number

عائد النفقات الإعلانية المستهدف الحالي. يمكن تعبئة هذه البيانات للحملات التي من نوع استراتيجية عروض الأسعار TARGET_ROAS أو MAXIMIZE_CONVERSION_VALUE.

AdGroupInfo

معلومات المجموعة الإعلانية الحالية للحملة.

تمثيل JSON 
{
  "keywords": [
    {
      object (KeywordInfo)
    }
  ],
  "adGroupType": enum (AdGroupType)
}
الحقول
keywords[]

object (KeywordInfo)

اختياريّ. الكلمات الرئيسية الحالية. هذا الحقل اختياري لنوعيات الاقتراحات التالية في حال ضبط معلومات adGroupInfo: الكلمة
adGroupType

enum (AdGroupType)

اختياريّ. نوع المجموعة الإعلانية للمجموعة الإعلانية. يُعَد هذا الحقل ضروريًا لأنواع الاقتراحات التالية في حال ضبط adGroupInfo: الكلمة الرئيسية

SeedInfo

المحتوى الأساسي للكلمة الرئيسية وعنوان URL محدّد لإنشاء كلمات رئيسية منه.

تمثيل JSON 
{
  "keywordSeeds": [
    string
  ],
  "urlSeed": string
}
الحقول
keywordSeeds[]

string

اختياريّ. الكلمات الرئيسية أو العبارات لإنشاء أفكار منها، مثل "سيارات" أو "وكالة سيارات بالقرب مني"
urlSeed

string

عنوان URL محدّد لإنشاء أفكار منه، على سبيل المثال: www.example.com/cars.