- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- BiddingInfo
- AdGroupInfo
- SeedInfo
- آن را امتحان کنید!
بر اساس نوع توصیه های درخواستی، توصیه هایی ایجاد می کند.
فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RecommendationError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendations:generate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه توصیههای مشتری. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "recommendationTypes": [ enum ( |
زمینه های | |
---|---|
recommendationTypes[] | ضروری. فهرست توصیههای واجد شرایط برای ایجاد. اگر معیارهای آپلود شده برای ارائه یک توصیه کافی نباشد، یا کمپین از قبل در وضعیت توصیه شده باشد، هیچ توصیه ای برای آن نوع بازگردانده نخواهد شد. به طور کلی، اگر تمام فیلدهای مورد نیاز برای آن توصیه نوع آپلود شود، یک توصیه برگردانده می شود، اما مواردی وجود دارد که هنوز کافی نیست. انواع توصیههای زیر برای تولید توصیهها پشتیبانی میشوند: KEYWORD، MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_CPA، SET_TARGET_CLICKS_OPT_IN، TARGET_INT, TARGET_LINKET, TARGET_LINKET, TARGET_LINKET, TARGET_LINKET, TARGET_INT, TARGET_LINKET, TARGET_IN, TARGET, ROAS_OPT_IN |
advertisingChannelType | ضروری. نوع کانال تبلیغاتی کمپین انواع تبلیغات زیر برای تولید توصیه پشتیبانی می شود: PERFORMANCE_MAX و SEARCH |
adGroupInfo[] | اختیاری. اطلاعات گروه تبلیغات فعلی از اطلاعات یک AdGroup پشتیبانی می کند. این فیلد برای انواع توصیه های زیر اختیاری است: KEYWORD |
campaignSitelinkCount | اختیاری. تعداد لینک های سایت در کمپین. این فیلد برای انواع توصیه های زیر ضروری است: SITELINK_ASSET |
conversionTrackingStatus | اختیاری. وضعیت ردیابی تبدیل فعلی این فیلد برای انواع توصیههای زیر ضروری است: MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_ROAS، TARGET_INOPT_ROAS، TARGET_INOPT_IN، TARGET_INOPT_AR، |
biddingInfo | اختیاری. اطلاعات مناقصه فعلی کمپین. این فیلد برای انواع توصیههای زیر ضروری است: MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_ROAS، TARGET_INOPT_ROAS، TARGET_INOPT_IN، TARGET_INOPT_AR، |
seedInfo | اختیاری. اطلاعات بذر برای کلمات کلیدی. این فیلد برای انواع توصیه های زیر ضروری است: KEYWORD |
بدن پاسخگو
پیام پاسخ برای RecommendationService.GenerateRecommendations
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"recommendations": [
{
object ( |
زمینه های | |
---|---|
recommendations[] | فهرست توصیههای تولید شده از تصویبشده در مجموعه توصیههای درخواستی نوع. اگر دادههای کافی برای ایجاد یک توصیه برای نوع توصیههای درخواستی وجود نداشته باشد، مجموعه نتایج حاوی توصیهای برای آن نوع نخواهد بود. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
BiddingInfo
اطلاعات مناقصه فعلی کمپین. پوششی برای سیگنالهای مربوط به مناقصه فراهم میکند که به توصیهها اطلاع میدهد.
نمایندگی JSON |
---|
{ "biddingStrategyType": enum ( |
زمینه های | |
---|---|
biddingStrategyType | استراتژی مناقصه فعلی این فیلد برای انواع توصیههای زیر ضروری است: MAXIMIZE_CLICKS_OPT_IN، MAXIMIZE_CONVERSIONS_OPT_IN، MAXIMIZE_CONVERSION_VALUE_OPT_IN، SET_TARGET_CPA، SET_TARGET_ROAS، TARGET_INOPT_ROAS، TARGET_INOPT_IN، TARGET_INOPT_AR، |
فیلد اتحادیه bidding_strategy_target_info . جزئیات اختیاری مربوط به bidding_strategy_type. bidding_strategy_target_info تنها می تواند یکی از موارد زیر باشد: | |
targetCpaMicros | targetCpa فعلی در میکرو. این را می توان برای کمپین هایی با نوع استراتژی پیشنهاد قیمت TARGET_CPA یا MAXIMIZE_CONVERSIONS پر کرد. |
targetRoas | هدف فعلی این را می توان برای کمپین هایی با نوع استراتژی پیشنهاد قیمت TARGET_ROAS یا MAXIMIZE_CONVERSION_VALUE پر کرد. |
AdGroupInfo
اطلاعات گروه تبلیغات فعلی کمپین.
نمایندگی JSON |
---|
{ "keywords": [ { object ( |
زمینه های | |
---|---|
keywords[] | اختیاری. کلمات کلیدی فعلی اگر adGroupInfo تنظیم شده باشد، این فیلد برای توصیه های زیر اختیاری است: KEYWORD |
adGroupType | اختیاری. AdGroup نوع AdGroup. اگر adGroupInfo تنظیم شده باشد، این فیلد برای نوع توصیه زیر ضروری است: KEYWORD |
SeedInfo
یک بذر کلمه کلیدی و یک URL خاص برای تولید کلمات کلیدی.
نمایندگی JSON |
---|
{ "keywordSeeds": [ string ], "urlSeed": string } |
زمینه های | |
---|---|
keywordSeeds[] | اختیاری. کلمات یا عبارات کلیدی برای ایجاد ایده از، به عنوان مثال: اتومبیل یا "نمایندگی خودرو در نزدیکی من". |
urlSeed | یک آدرس اینترنتی خاص برای ایجاد ایده از آن، به عنوان مثال: www.example.com/cars. |