API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Package google.ads.searchads360.v0.resources

شاخص

AccessibleBiddingStrategy (پیام)
AccessibleBiddingStrategy.MaximizeConversionValue (پیام)
AccessibleBiddingStrategy.MaximizeConversions (پیام)
AccessibleBiddingStrategy.TargetCpa (پیام)
AccessibleBiddingStrategy.TargetImpressionShare (پیام)
AccessibleBiddingStrategy.TargetRoas (پیام)
AccessibleBiddingStrategy.TargetSpend (پیام)
Ad (پیام)
AdGroup (پیام)
AdGroupAd (پیام)
AdGroupAdEffectiveLabel (پیام)
AdGroupAdLabel (پیام)
AdGroupAsset (پیام)
AdGroupAssetSet (پیام)
AdGroupAudienceView (پیام)
AdGroupBidModifier (پیام)
AdGroupCriterion (پیام)
AdGroupCriterion.PositionEstimates (پیام)
AdGroupCriterion.QualityInfo (پیام)
AdGroupCriterionEffectiveLabel (پیام)
AdGroupCriterionLabel (پیام)
AdGroupEffectiveLabel (پیام)
AdGroupLabel (پیام)
AgeRangeView (پیام)
Asset (پیام)
AssetGroup (پیام)
AssetGroupAsset (پیام)
AssetGroupAssetCombinationData (پیام)
AssetGroupListingGroupFilter (پیام)
AssetGroupSignal (پیام)
AssetGroupTopCombinationView (پیام)
AssetSet (پیام)
AssetSetAsset (پیام)
Audience (پیام)
BiddingStrategy (پیام)
Campaign (پیام)
Campaign.DynamicSearchAdsSetting (پیام)
Campaign.GeoTargetTypeSetting (پیام)
Campaign.NetworkSettings (پیام)
Campaign.OptimizationGoalSetting (پیام)
Campaign.SelectiveOptimization (پیام)
Campaign.ShoppingSetting (پیام)
Campaign.TrackingSetting (پیام)
CampaignAsset (پیام)
CampaignAssetSet (پیام)
CampaignAudienceView (پیام)
CampaignBudget (پیام)
CampaignCriterion (پیام)
CampaignEffectiveLabel (پیام)
CampaignLabel (پیام)
CartDataSalesView (پیام)
Conversion (پیام)
ConversionAction (پیام)
ConversionAction.AttributionModelSettings (پیام)
ConversionAction.FloodlightSettings (پیام)
ConversionAction.ValueSettings (پیام)
ConversionCustomVariable (پیام)
ConversionCustomVariable.FloodlightConversionCustomVariableInfo (پیام)
ConversionTrackingSetting (پیام)
CustomColumn (پیام)
Customer (پیام)
CustomerAsset (پیام)
CustomerAssetSet (پیام)
CustomerClient (پیام)
CustomerManagerLink (پیام)
DoubleClickCampaignManagerSetting (پیام)
DynamicSearchAdsSearchTermView (پیام)
GenderView (پیام)
GeoTargetConstant (پیام)
KeywordView (پیام)
Label (پیام)
LanguageConstant (پیام)
ListingGroupFilterDimension (پیام)
ListingGroupFilterDimension.ProductBiddingCategory (پیام)
ListingGroupFilterDimension.ProductBrand (پیام)
ListingGroupFilterDimension.ProductChannel (پیام)
ListingGroupFilterDimension.ProductCondition (پیام)
ListingGroupFilterDimension.ProductCustomAttribute (پیام)
ListingGroupFilterDimension.ProductItemId (پیام)
ListingGroupFilterDimension.ProductType (پیام)
ListingGroupFilterDimensionPath (پیام)
LocationView (پیام)
ProductBiddingCategoryConstant (پیام)
ProductGroupView (پیام)
SearchAds360Field (پیام)
ShoppingPerformanceView (پیام)
UserList (پیام)
UserLocationView (پیام)
Visit (پیام)
WebpageView (پیام)

Accessible Bidding Strategy

نمایانگر نمایی از BiddingStrategies است که متعلق به مشتری است و با آن به اشتراک گذاشته شده است.

برخلاف BiddingStrategy، این منبع شامل استراتژی‌هایی است که متعلق به مدیران مشتری است و با این مشتری به اشتراک گذاشته می‌شود - علاوه بر استراتژی‌های متعلق به این مشتری. این منبع معیارهایی را ارائه نمی دهد و فقط زیرمجموعه محدودی از ویژگی های BiddingStrategy را نشان می دهد.

فیلدها
`resource_ name`	`string` نام منبع استراتژی مناقصه قابل دسترس. نام منابع AccessibleBiddingStrategy به شکل زیر است: `customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}`
`id`	`int64` شناسه استراتژی مناقصه.
`name`	`string` نام استراتژی مناقصه.
`type`	`BiddingStrategyType` نوع استراتژی مناقصه.
`owner_ customer_ id`	`int64` شناسه مشتری مالک استراتژی مناقصه.
`owner_ descriptive_ name`	`string` توصیفی_نام مشتری که مالک استراتژی مناقصه است.
`scheme` میدانی اتحادیه طرح مناقصه. فقط یکی را می توان تنظیم کرد. `scheme` فقط می تواند یکی از موارد زیر باشد:
`maximize_ conversion_ value`	`MaximizeConversionValue` یک استراتژی مناقصه خودکار برای کمک به به دست آوردن بیشترین ارزش تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.
`maximize_ conversions`	`MaximizeConversions` یک استراتژی مناقصه خودکار برای کمک به دریافت بیشترین تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.
`target_ cpa`	`TargetCpa` یک استراتژی مناقصه که پیشنهادهایی را برای کمک به دریافت بیشترین تبدیل ممکن در هزینه به ازای هر خرید (CPA) مورد نظر شما تنظیم می کند.
`target_ impression_ share`	`TargetImpressionShare` یک استراتژی مناقصه که به طور خودکار نسبت به درصد انتخابی از نمایش‌ها بهینه می‌شود.
`target_ roas`	`TargetRoas` یک استراتژی مناقصه که به شما کمک می کند درآمد را به حداکثر برسانید و در عین حال میانگین یک هدف خاص بازده تبلیغاتی (ROAS) را به دست آورید.
`target_ spend`	`TargetSpend` یک استراتژی پیشنهادی که قیمت‌های پیشنهادی شما را طوری تنظیم می‌کند که به بیشترین تعداد کلیک ممکن در بودجه شما کمک کند.

MaximizeConversionValue

یک استراتژی مناقصه خودکار برای کمک به به دست آوردن بیشترین ارزش تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.

فیلدها

فیلدها
`target_ roas`	`double` گزینه بازده هدف تبلیغات (ROAS). اگر تنظیم شود، استراتژی پیشنهاد قیمت درآمد را به حداکثر می‌رساند و در عین حال میانگین بازده هدف در هزینه تبلیغات را به دست می‌آورد. اگر ROAS هدف بالا باشد، استراتژی پیشنهادی ممکن است نتواند کل بودجه را خرج کند. اگر ROAS هدف تعیین نشده باشد، هدف استراتژی پیشنهادی دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود.

target_ roas

double

گزینه بازده هدف تبلیغات (ROAS). اگر تنظیم شود، استراتژی پیشنهاد قیمت درآمد را به حداکثر می‌رساند و در عین حال میانگین بازده هدف در هزینه تبلیغات را به دست می‌آورد. اگر ROAS هدف بالا باشد، استراتژی پیشنهادی ممکن است نتواند کل بودجه را خرج کند. اگر ROAS هدف تعیین نشده باشد، هدف استراتژی پیشنهادی دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود.

MaximizeConversions

یک استراتژی مناقصه خودکار برای کمک به دریافت بیشترین تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.

فیلدها

فیلدها
`target_ cpa`	`int64` گزینه هزینه هدف هر خرید (CPA). این میانگین مبلغی است که می خواهید برای هر خرید خرج کنید.
`target_ cpa_ micros`	`int64` گزینه هزینه هدف هر خرید (CPA). این میانگین مبلغی است که می خواهید برای هر خرید خرج کنید.

target_ cpa

int64

گزینه هزینه هدف هر خرید (CPA). این میانگین مبلغی است که می خواهید برای هر خرید خرج کنید.

target_ cpa_ micros

int64

گزینه هزینه هدف هر خرید (CPA). این میانگین مبلغی است که می خواهید برای هر خرید خرج کنید.

TargetCpa

یک استراتژی پیشنهاد خودکار که پیشنهادهایی را برای کمک به دریافت بیشترین تعداد تبدیل ممکن در هزینه به ازای هر خرید (CPA) هدفی که تعیین می‌کنید، تنظیم می‌کند.

فیلدها

فیلدها
`target_ cpa_ micros`	`int64` میانگین هدف CPA. این هدف باید بزرگتر یا برابر با حداقل واحد قابل پرداخت بر اساس واحد پولی حساب باشد.

target_ cpa_ micros

int64

میانگین هدف CPA. این هدف باید بزرگتر یا برابر با حداقل واحد قابل پرداخت بر اساس واحد پولی حساب باشد.

TargetImpressionShare

یک استراتژی مناقصه خودکار که قیمت ها را طوری تنظیم می کند که درصد مشخصی از تبلیغات جستجو در بالای صفحه اول (یا سایر مکان های هدفمند) نشان داده شود.

فیلدها

فیلدها
`location`	`TargetImpressionShareLocation` مکان مورد نظر در صفحه نتایج جستجو.
`location_ fraction_ micros`	`int64` بخش انتخاب شده از تبلیغات برای نمایش در مکان مورد نظر در میکرو. مثلاً 1% برابر با 10000 است.
`cpc_ bid_ ceiling_ micros`	`int64` بالاترین پیشنهاد CPC را که سیستم مناقصه خودکار مجاز است تعیین کند. این فیلد الزامی است که توسط تبلیغ‌کننده وارد شده و سقف را تعیین می‌کند و در میکروهای محلی مشخص می‌شود.

location

TargetImpressionShareLocation

مکان مورد نظر در صفحه نتایج جستجو.

location_ fraction_ micros

int64

بخش انتخاب شده از تبلیغات برای نمایش در مکان مورد نظر در میکرو. مثلاً 1% برابر با 10000 است.

cpc_ bid_ ceiling_ micros

int64

بالاترین پیشنهاد CPC را که سیستم مناقصه خودکار مجاز است تعیین کند. این فیلد الزامی است که توسط تبلیغ‌کننده وارد شده و سقف را تعیین می‌کند و در میکروهای محلی مشخص می‌شود.

TargetRoas

یک استراتژی مناقصه خودکار که به شما کمک می کند درآمد را به حداکثر برسانید و در عین حال میانگین بازده هدف مشخصی از هزینه تبلیغات (ROAS) را به دست آورید.

فیلدها

فیلدها
`target_ roas`	`double` درآمد انتخاب شده (بر اساس داده های تبدیل) به ازای هر واحد هزینه.

target_ roas

double

درآمد انتخاب شده (بر اساس داده های تبدیل) به ازای هر واحد هزینه.

TargetSpend

یک استراتژی پیشنهاد خودکار که قیمت‌های پیشنهادی شما را طوری تنظیم می‌کند که به بیشترین تعداد کلیک ممکن در بودجه شما کمک کند.

فیلدها

فیلدها
`target_spend_micros (deprecated)`	`int64` این مورد منسوخ شده است! هدف هزینه ای که بر اساس آن کلیک ها به حداکثر می رسد. پیشنهاد دهنده TargetSpend سعی خواهد کرد کمتر از این مقدار یا مقدار خرج کردن طبیعی را خرج کند. اگر مشخص نشده باشد، بودجه به عنوان هدف هزینه استفاده می شود. این فیلد منسوخ شده است و دیگر نباید استفاده شود. برای جزئیات به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید.
`cpc_ bid_ ceiling_ micros`	`int64` حداکثر حد پیشنهادی که می تواند توسط استراتژی پیشنهاد تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می شود.

target_spend_micros
 (deprecated)

int64

هدف هزینه ای که بر اساس آن کلیک ها به حداکثر می رسد. پیشنهاد دهنده TargetSpend سعی خواهد کرد کمتر از این مقدار یا مقدار خرج کردن طبیعی را خرج کند. اگر مشخص نشده باشد، بودجه به عنوان هدف هزینه استفاده می شود. این فیلد منسوخ شده است و دیگر نباید استفاده شود. برای جزئیات به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید.

cpc_ bid_ ceiling_ micros

int64

حداکثر حد پیشنهادی که می تواند توسط استراتژی پیشنهاد تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می شود.

آگهی

یک آگهی

فیلدها
`resource_ name`	`string` نام منبع آگهی نام منابع آگهی به شکل زیر است: `customers/{customer_id}/ads/{ad_id}`
`final_ urls[]`	`string` لیست URL های نهایی ممکن پس از همه تغییر مسیرهای بین دامنه ای برای تبلیغ.
`type`	`AdType` نوع تبلیغ.
`id`	`int64` شناسه آگهی
`display_ url`	`string` نشانی اینترنتی که در توضیحات آگهی برای برخی از قالب‌های تبلیغاتی ظاهر می‌شود.
`name`	`string` نام آگهی. این فقط برای شناسایی آگهی استفاده می شود. نیازی نیست منحصر به فرد باشد و بر تبلیغ ارائه شده تأثیری ندارد. فیلد نام در حال حاضر فقط برای DisplayUploadAd، ImageAd، ShoppingComparisonListingAd و VideoAd پشتیبانی می شود.
`ad_data` فیلد اتحادیه جزئیات مربوط به نوع تبلیغ دقیقاً یک مقدار باید تنظیم شود. `ad_data` فقط می تواند یکی از موارد زیر باشد:
`text_ ad`	`SearchAds360TextAdInfo` جزئیات مربوط به تبلیغات متنی
`expanded_ text_ ad`	`SearchAds360ExpandedTextAdInfo` جزئیات مربوط به یک آگهی متنی گسترده.
`responsive_ search_ ad`	`SearchAds360ResponsiveSearchAdInfo` جزئیات مربوط به یک تبلیغ جستجوی واکنشگرا.
`product_ ad`	`SearchAds360ProductAdInfo` جزئیات مربوط به تبلیغ محصول
`expanded_ dynamic_ search_ ad`	`SearchAds360ExpandedDynamicSearchAdInfo` جزئیات مربوط به یک تبلیغ جستجوی پویا گسترده.

AdGroup

یک گروه تبلیغاتی

فیلدها
`resource_ name`	`string` نام منبع گروه تبلیغاتی نام منابع گروه تبلیغات به شکل زیر است: `customers/{customer_id}/adGroups/{ad_group_id}`
`status`	`AdGroupStatus` وضعیت گروه تبلیغاتی
`type`	`AdGroupType` نوع گروه تبلیغاتی
`ad_ rotation_ mode`	`AdGroupAdRotationMode` حالت چرخش تبلیغات گروه تبلیغاتی.
`creation_ time`	`string` مهر زمانی که این ad_group ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است.
`targeting_ setting`	`TargetingSetting` تنظیم برای هدف قرار دادن ویژگی های مرتبط.
`labels[]`	`string` نام منابع برچسب های پیوست شده به این گروه تبلیغاتی.
`effective_ labels[]`	`string` نام منابع برچسب های موثر متصل به این گروه تبلیغاتی. یک برچسب موثر برچسبی است که به ارث رسیده یا مستقیماً به این گروه تبلیغاتی اختصاص داده شده است.
`engine_ id`	`string` شناسه گروه تبلیغات در حساب موتور خارجی. این فیلد فقط برای حساب غیر Google Ads است، به عنوان مثال، Yahoo Japan، Microsoft، Baidu و غیره. برای نهاد Google Ads، به جای آن از "ad_group.id" استفاده کنید.
`start_ date`	`string` تاریخی که این گروه تبلیغاتی شروع به ارائه تبلیغات می کند. به‌طور پیش‌فرض، گروه تبلیغات اکنون شروع می‌شود یا تاریخ شروع گروه تبلیغات، هر کدام که دیرتر باشد. اگر این فیلد تنظیم شده باشد، گروه تبلیغاتی از ابتدای تاریخ مشخص شده در منطقه زمانی مشتری شروع می شود. این فیلد فقط برای حساب‌های تبلیغاتی مایکروسافت و گیت‌وی فیس‌بوک در دسترس است. قالب: YYYY-MM-DD مثال: 2019-03-14
`end_ date`	`string` تاریخ پایان ارائه تبلیغات توسط گروه تبلیغاتی. به طور پیش فرض، گروه تبلیغات در تاریخ پایان گروه تبلیغات به پایان می رسد. اگر این قسمت تنظیم شده باشد، گروه تبلیغات در پایان تاریخ مشخص شده در منطقه زمانی مشتری به پایان می رسد. این فیلد فقط برای حساب‌های تبلیغاتی مایکروسافت و گیت‌وی فیس‌بوک در دسترس است. قالب: YYYY-MM-DD مثال: 2019-03-14
`language_ code`	`string` زبان تبلیغات و کلمات کلیدی در یک گروه تبلیغاتی. این فیلد فقط برای حساب‌های تبلیغاتی مایکروسافت در دسترس است. جزئیات بیشتر: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
`last_ modified_ time`	`string` تاریخ آخرین تغییر این گروه تبلیغاتی. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.
`id`	`int64` شناسه گروه تبلیغاتی
`name`	`string` نام گروه تبلیغاتی این قسمت الزامی است و نباید هنگام ایجاد گروه های تبلیغاتی جدید خالی باشد. باید کمتر از 255 نویسه تمام عرض UTF-8 داشته باشد. نباید دارای هیچ نویسه تهی (نقطه کد 0x0)، خوراک خط NL (نقطه کد 0xA) یا نویسه برگشتی (نقطه کد 0xD) باشد.
`cpc_ bid_ micros`	`int64` حداکثر پیشنهاد CPC (هزینه به ازای هر کلیک).
`engine_ status`	`AdGroupEngineStatus` وضعیت موتور برای گروه تبلیغات.

AdGroupAd

یک تبلیغ گروه تبلیغاتی

فیلدها
`resource_ name`	`string` نام منبع آگهی نام منابع تبلیغاتی گروه تبلیغات به شکل زیر است: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}`
`status`	`AdGroupAdStatus` وضعیت آگهی.
`ad`	`Ad` آگهی
`creation_ time`	`string` مهر زمانی که این ad_group_ad ایجاد شد. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.
`labels[]`	`string` نام منابع برچسب های پیوست شده به این آگهی گروه تبلیغاتی.
`effective_ labels[]`	`string` نام منابع برچسب های موثر پیوست شده به این آگهی. یک برچسب مؤثر برچسبی است که به ارث برده شده یا مستقیماً به این آگهی اختصاص داده شده است.
`engine_ id`	`string` شناسه آگهی در حساب موتور خارجی. این فیلد فقط برای حساب Search Ads 360 است، به عنوان مثال، Yahoo Japan، Microsoft، Baidu و غیره. برای نهاد غیر جستجوی Ads 360، به جای آن از "ad_group_ad.ad.id" استفاده کنید.
`engine_ status`	`AdGroupAdEngineStatus` وضعیت اضافی آگهی در حساب موتور خارجی. وضعیت‌های احتمالی (بسته به نوع حساب خارجی) شامل فعال، واجد شرایط، در حال بررسی و غیره است.
`last_ modified_ time`	`string` زمانی که این آگهی گروه تبلیغاتی آخرین بار تغییر کرده است. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.

AdGroupAdEffectiveLabel

رابطه بین یک تبلیغ گروه تبلیغاتی و یک برچسب موثر. یک برچسب مؤثر برچسبی است که به ارث رسیده یا مستقیماً به این آگهی گروه تبلیغاتی اختصاص داده شده است.

فیلدها
`resource_ name`	`string` نام منبع برچسب مؤثر آگهی گروه آگهی. نام‌های منابع برچسب مؤثر آگهی گروه آگهی به این شکل است: `customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}`
`ad_ group_ ad`	`string` آگهی گروه تبلیغاتی که برچسب موثر به آن چسبانده شده است.
`label`	`string` برچسب موثر اختصاص داده شده به تبلیغ گروه تبلیغاتی.
`owner_ customer_ id`	`int64` شناسه مشتری که دارای برچسب موثر است.

AdGroupAdLabel

رابطه بین یک تبلیغ گروه تبلیغاتی و یک برچسب.

فیلدها
`resource_ name`	`string` نام منبع برچسب آگهی گروه تبلیغاتی. نام‌های منابع برچسب آگهی گروه آگهی به این شکل است: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`
`ad_ group_ ad`	`string` آگهی گروه تبلیغاتی که برچسب به آن چسبانده شده است.
`label`	`string` برچسبی که به تبلیغ گروه تبلیغاتی اختصاص داده شده است.
`owner_ customer_ id`	`int64` شناسه مشتری که دارای برچسب است.

AdGroupAsset

پیوندی بین یک گروه تبلیغاتی و یک دارایی.

فیلدها
`resource_ name`	`string` نام منبع دارایی گروه تبلیغات. نام منابع AdGroupAsset به شکل زیر است: `customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}`
`ad_ group`	`string` مورد نیاز. گروه تبلیغاتی که دارایی به آن مرتبط است.
`asset`	`string` مورد نیاز. دارایی که به گروه تبلیغاتی مرتبط است.
`status`	`AssetLinkStatus` وضعیت دارایی گروه تبلیغاتی

AdGroupAssetSet

AdGroupAssetSet پیوند بین یک گروه تبلیغاتی و یک مجموعه دارایی است. ایجاد AdGroupAssetSet یک مجموعه دارایی را با یک گروه تبلیغاتی پیوند می دهد.

فیلدها
`resource_ name`	`string` نام منبع مجموعه دارایی گروه تبلیغات. نام منابع مجموعه دارایی گروه تبلیغات به شکل زیر است: `customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}`
`ad_ group`	`string` گروه تبلیغاتی که این مجموعه دارایی به آن مرتبط است.
`asset_ set`	`string` مجموعه دارایی که به گروه تبلیغاتی مرتبط است.
`status`	`AssetSetLinkStatus` وضعیت مجموعه دارایی گروه تبلیغات. فقط خواندنی

AdGroupAudienceView

نمای مخاطب گروه تبلیغاتی شامل داده‌های عملکرد از علایق و فهرست‌های بازاریابی مجدد برای تبلیغات شبکه نمایش و شبکه YouTube، و فهرست‌های بازاریابی مجدد برای تبلیغات جستجو (RLSA)، جمع‌آوری‌شده در سطح مخاطب است.

فیلدها

فیلدها
`resource_ name`	`string` نام منبع نمای مخاطب گروه تبلیغات. نام منابع مشاهده مخاطبان گروه تبلیغات به شکل زیر است: `customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}`

resource_ name

string

نام منبع نمای مخاطب گروه تبلیغات. نام منابع مشاهده مخاطبان گروه تبلیغات به شکل زیر است:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

یک اصلاح کننده پیشنهاد گروه تبلیغاتی را نشان می دهد.

فیلدها
`resource_ name`	`string` نام منبع اصلاح کننده پیشنهاد گروه آگهی. نام منابع اصلاح کننده پیشنهاد قیمت گروه تبلیغات به شکل زیر است: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}`
`bid_ modifier`	`double` اصلاح کننده پیشنهاد زمانی که معیار مطابقت دارد. اصلاح کننده باید در محدوده: 0.1 - 10.0 باشد. محدوده 1.0 - 6.0 برای PreferredContent است. از 0 برای انصراف از نوع دستگاه استفاده کنید.
`criterion` میدان اتحادیه . معیار این اصلاح کننده پیشنهاد گروه آگهی. در عملیات ایجاد شروع در V5 مورد نیاز است. `criterion` فقط می تواند یکی از موارد زیر باشد:
`device`	`DeviceInfo` یک معیار دستگاه

AdGroupCriterion

یک معیار گروه تبلیغاتی گزارش ad_group_criterion فقط معیارهایی را برمی‌گرداند که به صراحت به گروه آگهی اضافه شده‌اند.

فیلدها
`resource_ name`	`string` نام منبع معیار گروه آگهی. نام منابع معیار گروه تبلیغات به شکل زیر است: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}`
`creation_ time`	`string` مهر زمانی که این معیار گروه آگهی ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است.
`status`	`AdGroupCriterionStatus` وضعیت معیار. این وضعیت موجودیت معیار گروه آگهی است که توسط مشتری تنظیم شده است. توجه: گزارش‌های UI ممکن است حاوی اطلاعات بیشتری باشد که بر واجد شرایط بودن یک معیار برای اجرا تأثیر می‌گذارد. در برخی موارد، معیاری که در API حذف شده است همچنان می‌تواند در رابط کاربری فعال نشان داده شود. به عنوان مثال، کمپین‌ها به‌طور پیش‌فرض به کاربران در تمام محدوده‌های سنی نشان داده می‌شوند، مگر اینکه حذف شوند. رابط کاربری هر محدوده سنی را به عنوان "فعال" نشان می دهد، زیرا آنها واجد شرایط دیدن تبلیغات هستند. اما AdGroupCriterion.status "حذف شده" را نشان می دهد، زیرا هیچ معیار مثبتی اضافه نشده است.
`quality_ info`	`QualityInfo` اطلاعات مربوط به کیفیت معیار.
`type`	`CriterionType` نوع معیار.
`labels[]`	`string` نام منابع برچسب های پیوست شده به این معیار گروه تبلیغاتی.
`effective_ labels[]`	`string` نام منابع برچسب های موثر پیوست شده به این معیار گروه تبلیغاتی. یک برچسب مؤثر برچسبی است که به ارث رسیده یا مستقیماً به این معیار گروه تبلیغاتی اختصاص داده شده است.
`position_ estimates`	`PositionEstimates` تخمین پیشنهادهای معیار در موقعیت های مختلف.
`final_ urls[]`	`string` لیست URL های نهایی ممکن پس از همه تغییر مسیرهای بین دامنه ای برای تبلیغ.
`engine_ id`	`string` شناسه معیار گروه آگهی در حساب موتور خارجی. این فیلد فقط برای حساب غیر Google Ads است، به عنوان مثال، Yahoo Japan، Microsoft، Baidu و غیره. برای نهاد Google Ads، به جای آن از "ad_group_criterion.criterion_id" استفاده کنید.
`last_ modified_ time`	`string` زمانی که این معیار گروه آگهی آخرین بار اصلاح شد. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.
`criterion_ id`	`int64` شناسه معیار.
`ad_ group`	`string` گروه تبلیغاتی که معیار به آن تعلق دارد.
`negative`	`bool` آیا برای هدف قرار دادن ( `false` ) یا حذف ( `true` ) معیار. این میدان تغییر ناپذیر است. برای تغییر یک معیار از مثبت به منفی، آن را حذف کنید و دوباره اضافه کنید.
`bid_ modifier`	`double` اصلاح کننده پیشنهاد زمانی که معیار مطابقت دارد. اصلاح کننده باید در محدوده: 0.1 - 10.0 باشد. بیشتر انواع معیارهای قابل هدف از اصلاح کننده ها پشتیبانی می کنند.
`cpc_ bid_ micros`	`int64` پیشنهاد CPC (هزینه به ازای هر کلیک).
`effective_ cpc_ bid_ micros`	`int64` پیشنهاد CPC موثر (هزینه به ازای هر کلیک).
`engine_ status`	`AdGroupCriterionEngineStatus` معیار وضعیت موتور برای گروه آگهی.
`final_ url_ suffix`	`string` الگوی URL برای الحاق پارامترها به URL نهایی.
`tracking_ url_ template`	`string` الگوی URL برای ساخت URL ردیابی.
`criterion` میدان اتحادیه . معیار گروه تبلیغاتی دقیقاً یکی باید تنظیم شود. `criterion` فقط می تواند یکی از موارد زیر باشد:
`keyword`	`KeywordInfo` کلمه کلیدی
`listing_ group`	`ListingGroupInfo` گروه لیست.
`age_ range`	`AgeRangeInfo` محدوده سنی.
`gender`	`GenderInfo` جنسیت.
`user_ list`	`UserListInfo` لیست کاربر.
`webpage`	`WebpageInfo` صفحه وب
`location`	`LocationInfo` مکان.

تخمین موقعیت

تخمین پیشنهادهای معیار در موقعیت های مختلف.

فیلدها

فیلدها
`top_ of_ page_ cpc_ micros`	`int64` تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در بالای صفحه اول نتایج جستجو.

top_ of_ page_ cpc_ micros

int64

تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در بالای صفحه اول نتایج جستجو.

QualityInfo

ظرفی برای اطلاعات کیفیت معیار گروه آگهی.

فیلدها

فیلدها
`quality_ score`	`int32` نمره کیفیت. اگر Google اطلاعات کافی برای تعیین مقدار نداشته باشد، ممکن است این فیلد پر نشود.

quality_ score

int32

نمره کیفیت.

اگر Google اطلاعات کافی برای تعیین مقدار نداشته باشد، ممکن است این فیلد پر نشود.

AdGroupCriterionEffectiveLabel

رابطه بین معیار گروه تبلیغات و برچسب موثر. یک برچسب مؤثر برچسبی است که به ارث رسیده یا مستقیماً به این معیار گروه تبلیغاتی اختصاص داده شده است.

فیلدها
`resource_ name`	`string` نام منبع برچسب موثر معیار گروه آگهی. نام‌های منابع برچسب مؤثر معیار گروه آگهی به این شکل است: `customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}`
`ad_ group_ criterion`	`string` معیار گروه آگهی که برچسب مؤثر به آن چسبانده شده است.
`label`	`string` برچسب موثر اختصاص داده شده به معیار گروه آگهی.
`owner_ customer_ id`	`int64` شناسه مشتری که دارای برچسب موثر است.

AdGroupCriterionLabel

رابطه بین معیار گروه آگهی و برچسب.

فیلدها
`resource_ name`	`string` نام منبع برچسب معیار گروه آگهی. نام‌های منابع برچسب معیار گروه آگهی به این شکل است: `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}`
`ad_ group_ criterion`	`string` معیار گروه آگهی که برچسب به آن چسبانده شده است.
`label`	`string` برچسبی که به معیار گروه آگهی اختصاص داده شده است.
`owner_ customer_ id`	`int64` شناسه مشتری که دارای برچسب است.

AdGroupEffectiveLabel

رابطه بین یک گروه تبلیغاتی و یک برچسب موثر. یک برچسب موثر برچسبی است که به ارث رسیده یا مستقیماً به این گروه تبلیغاتی اختصاص داده شده است.

فیلدها
`resource_ name`	`string` نام منبع برچسب موثر گروه تبلیغاتی. نام‌های منابع برچسب مؤثر گروه آگهی به این شکل است: `customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}`
`ad_ group`	`string` گروه تبلیغاتی که برچسب موثر به آن چسبانده شده است.
`label`	`string` برچسب موثر اختصاص داده شده به گروه تبلیغاتی.
`owner_ customer_ id`	`int64` شناسه مشتری که دارای برچسب موثر است.

AdGroupLabel

رابطه بین یک گروه تبلیغاتی و یک برچسب.

فیلدها
`resource_ name`	`string` نام منبع برچسب گروه تبلیغات. نام منابع برچسب گروه تبلیغات به شکل زیر است: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}`
`ad_ group`	`string` گروه تبلیغاتی که برچسب به آن چسبانده شده است.
`label`	`string` برچسب اختصاص داده شده به گروه تبلیغات.
`owner_ customer_ id`	`int64` شناسه مشتری که دارای برچسب است.

AgeRangeView

نمای محدوده سنی

فیلدها

فیلدها
`resource_ name`	`string` نام منبع نمای محدوده سنی. نام منابع نمای محدوده سنی به شکل زیر است: `customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}`

resource_ name

string

نام منبع نمای محدوده سنی. نام منابع نمای محدوده سنی به شکل زیر است:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

دارایی

دارایی بخشی از یک تبلیغ است که می تواند در چندین آگهی به اشتراک گذاشته شود. این می تواند یک تصویر (ImageAsset)، یک ویدیو (YoutubeVideoAsset) و غیره باشد. دارایی ها تغییر ناپذیر هستند و قابل حذف نیستند. برای جلوگیری از ارائه دارایی، دارایی را از نهادی که از آن استفاده می کند حذف کنید.

فیلدها
`resource_ name`	`string` نام منبع دارایی نام منابع دارایی به شکل زیر است: `customers/{customer_id}/assets/{asset_id}`
`type`	`AssetType` نوع دارایی
`final_ urls[]`	`string` لیستی از URL های نهایی ممکن پس از تغییر مسیرهای متقابل دامنه.
`status`	`AssetStatus` وضعیت دارایی.
`creation_ time`	`string` مهر زمانی که این دارایی ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است.
`last_ modified_ time`	`string` تاریخ آخرین تغییر این دارایی. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.
`id`	`int64` شناسه دارایی
`name`	`string` نام اختیاری دارایی
`tracking_ url_ template`	`string` قالب URL برای ساخت URL ردیابی.
`engine_ status`	`AssetEngineStatus` وضعیت موتور برای یک دارایی
`asset_data` فیلد اتحادیه. نوع خاص دارایی `asset_data` تنها می تواند یکی از موارد زیر باشد:
`youtube_ video_ asset`	`YoutubeVideoAsset` یک دارایی ویدیوی YouTube.
`image_ asset`	`ImageAsset` دارایی تصویر
`text_ asset`	`TextAsset` دارایی متن
`callout_ asset`	`UnifiedCalloutAsset` دارایی فراخوانی یکپارچه.
`sitelink_ asset`	`UnifiedSitelinkAsset` دارایی پیوند سایت یکپارچه.
`page_ feed_ asset`	`UnifiedPageFeedAsset` دارایی فید صفحه یکپارچه.
`mobile_ app_ asset`	`MobileAppAsset` دارایی اپلیکیشن موبایل
`call_ asset`	`UnifiedCallAsset` دارایی تماس یکپارچه
`call_ to_ action_ asset`	`CallToActionAsset` دارایی فراخوان برای اقدام
`location_ asset`	`UnifiedLocationAsset` دارایی مکان یکپارچه

AssetGroup

یک گروه دارایی AssetGroupAsset برای پیوند یک دارایی به گروه دارایی استفاده می شود. AssetGroupSignal برای مرتبط کردن یک سیگنال به یک گروه دارایی استفاده می شود.

فیلدها
`resource_ name`	`string` نام منبع گروه دارایی. نام منابع گروه دارایی به شکل زیر است: `customers/{customer_id}/assetGroups/{asset_group_id}`
`id`	`int64` شناسه گروه دارایی.
`campaign`	`string` کمپینی که این گروه دارایی با آن مرتبط است. دارایی که به گروه دارایی مرتبط است.
`name`	`string` مورد نیاز. نام گروه دارایی مورد نیاز. طول آن باید حداقل 1 و حداکثر طول 128 باشد. باید در یک کمپین منحصر به فرد باشد.
`final_ urls[]`	`string` لیستی از URL های نهایی پس از تغییر مسیرهای متقابل دامنه. در حداکثر عملکرد، به‌طور پیش‌فرض، url‌ها واجد شرایط گسترش هستند، مگر اینکه انصراف داده شوند.
`final_ mobile_ urls[]`	`string` لیستی از URL های نهایی تلفن همراه پس از تغییر مسیرهای متقابل دامنه. در حداکثر عملکرد، به‌طور پیش‌فرض، url‌ها واجد شرایط گسترش هستند، مگر اینکه انصراف داده شوند.
`status`	`AssetGroupStatus` وضعیت گروه دارایی
`path1`	`string` قسمت اول متنی که ممکن است به url نمایش داده شده در آگهی اضافه شده باشد.
`path2`	`string` قسمت دوم متن که ممکن است به نشانی اینترنتی نمایش داده شده در آگهی اضافه شده باشد. این فیلد فقط زمانی قابل تنظیم است که مسیر 1 تنظیم شده باشد.
`ad_ strength`	`AdStrength` قدرت تبلیغات کلی این گروه دارایی.

AssetGroupAsset

AssetGroupAsset پیوند بین یک دارایی و یک گروه دارایی است. افزودن AssetGroupAsset یک دارایی را با یک گروه دارایی پیوند می دهد.

فیلدها
`resource_ name`	`string` نام منبع دارایی گروه دارایی. نام منبع دارایی گروه دارایی به شکل زیر است: `customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}`
`asset_ group`	`string` گروه دارایی که این دارایی گروه دارایی در حال پیوند است.
`asset`	`string` دارایی که این دارایی گروه دارایی در حال پیوند است.
`field_ type`	`AssetFieldType` شرح قرارگیری دارایی در گروه دارایی. به عنوان مثال: HEADLINE، YOUTUBE_VIDEO و غیره
`status`	`AssetLinkStatus` وضعیت پیوند بین یک دارایی و گروه دارایی.

AssetGroupAssetCombinationData

داده های ترکیبی دارایی گروه دارایی

فیلدها

فیلدها
`asset_ combination_ served_ assets[]`	`AssetUsage` دارایی های خدمت شده

asset_ combination_ served_ assets[]

AssetUsage

دارایی های خدمت شده

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter نشان دهنده گره درخت فیلتر گروه فهرست در یک گروه دارایی است.

فیلدها
`resource_ name`	`string` نام منبع فیلتر گروه فهرست گروه دارایی. نام منبع فیلتر گروه فهرست گروه دارایی به شکل زیر است: `customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}`
`asset_ group`	`string` گروه دارایی که این گروه فهرست دارایی فیلتر گروهی از آن است.
`id`	`int64` شناسه ListingGroupFilter.
`type`	`ListingGroupFilterType` نوع یک گره فیلتر گروه لیست.
`vertical`	`ListingGroupFilterVertical` عمودی که درخت گره فعلی نشان می دهد. همه گره های یک درخت باید به یک عمود تعلق داشته باشند.
`case_ value`	`ListingGroupFilterDimension` مقدار ابعادی که این گروه فهرست‌بندی با آن والد خود را اصلاح می‌کند. برای گروه ریشه تعریف نشده است.
`parent_ listing_ group_ filter`	`string` نام منبع زیربخش گروه فهرست والد. تهی برای گره فیلتر گروه فهرست ریشه.
`path`	`ListingGroupFilterDimensionPath` مسیر ابعادی که این فیلتر گروه فهرست را تعریف می کند.

AssetGroupSignal

AssetGroupSignal نشان دهنده یک سیگنال در یک گروه دارایی است. وجود یک سیگنال به کمپین حداکثر عملکرد نشان می دهد که چه کسی بیشترین احتمال را دارد که تبدیل کند. Performance Max از سیگنال برای جستجوی افراد جدید با هدف مشابه یا قوی‌تر برای یافتن تبدیل‌ها در جستجو، نمایش، ویدیو و موارد دیگر استفاده می‌کند.

فیلدها
`resource_ name`	`string` نام منبع سیگنال گروه دارایی. نام منبع سیگنال گروه دارایی به شکل زیر است: `customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}`
`asset_ group`	`string` گروه دارایی که سیگنال گروه دارایی به آن تعلق دارد.
`signal` میدان اتحادیه سیگنال گروه دارایی. `signal` می تواند تنها یکی از موارد زیر باشد:
`audience`	`AudienceInfo` سیگنال مخاطبی که باید توسط کمپین حداکثر عملکرد استفاده شود.

AssetGroupTopCombinationView

دیدگاهی در مورد استفاده از ترکیب دارایی تبلیغات گروه تبلیغات.

فیلدها

فیلدها
`resource_ name`	`string` نام منبع نمای ترکیبی بالای گروه دارایی. نام منابع نمای ترکیبی برتر AssetGroup به این شکل است: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
`asset_ group_ top_ combinations[]`	`AssetGroupAssetCombinationData` ترکیب های برتر دارایی هایی که با هم خدمت می کردند.

resource_ name

string

نام منبع نمای ترکیبی بالای گروه دارایی. نام منابع نمای ترکیبی برتر AssetGroup به این شکل است: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

asset_ group_ top_ combinations[]

AssetGroupAssetCombinationData

ترکیب های برتر دارایی هایی که با هم خدمت می کردند.

AssetSet

مجموعه دارایی که مجموعه ای از دارایی ها را نشان می دهد. از AssetSetAsset برای پیوند یک دارایی به مجموعه دارایی استفاده کنید.

فیلدها

فیلدها
`id`	`int64` شناسه مجموعه دارایی.
`resource_ name`	`string` نام منبع مجموعه دارایی. نام منابع مجموعه دارایی به شکل زیر است: `customers/{customer_id}/assetSets/{asset_set_id}`

id

int64

شناسه مجموعه دارایی.

resource_ name

string

نام منبع مجموعه دارایی. نام منابع مجموعه دارایی به شکل زیر است:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset پیوند بین یک دارایی و یک مجموعه دارایی است. افزودن AssetSetAsset یک دارایی را با یک مجموعه دارایی پیوند می دهد.

فیلدها
`resource_ name`	`string` نام منبع دارایی مجموعه دارایی. نام منابع دارایی مجموعه دارایی به شکل زیر است: `customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}`
`asset_ set`	`string` مجموعه دارایی که این دارایی مجموعه دارایی به آن مرتبط است.
`asset`	`string` دارایی که این دارایی مجموعه دارایی به آن مرتبط است.
`status`	`AssetSetAssetStatus` وضعیت دارایی مجموعه دارایی. فقط خواندنی

مخاطب

مخاطب یک گزینه هدف‌گیری مؤثر است که به شما امکان می‌دهد ویژگی‌های بخش مختلف، مانند مشخصات جمعیتی دقیق و وابستگی‌ها را قطع کنید تا مخاطبانی ایجاد کنید که بخش‌هایی از بخش‌های هدف شما را نشان می‌دهند.

فیلدها
`resource_ name`	`string` نام منبع مخاطب نام مخاطبان به شکل زیر است: `customers/{customer_id}/audiences/{audience_id}`
`id`	`int64` شناسه مخاطب
`name`	`string` مورد نیاز. نام مخاطب. باید در بین همه مخاطبان منحصر به فرد باشد. طول آن باید حداقل 1 و حداکثر طول 255 باشد.
`description`	`string` توصیف این مخاطب.

استراتژی مناقصه

یک استراتژی مناقصه

فیلدها
`resource_ name`	`string` نام منبع استراتژی مناقصه. نام منابع استراتژی مناقصه به شکل زیر است: `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}`
`status`	`BiddingStrategyStatus` وضعیت استراتژی مناقصه. این فیلد فقط خواندنی است.
`type`	`BiddingStrategyType` نوع استراتژی مناقصه. با تنظیم طرح مناقصه، یک استراتژی مناقصه ایجاد کنید. این فیلد فقط خواندنی است.
`currency_ code`	`string` ارز مورد استفاده در استراتژی مناقصه (کد سه حرفی ISO 4217). برای استراتژی‌های مناقصه در مشتریان مدیر، این ارز را می‌توان روی ایجاد و پیش‌فرض ارز مشتری مدیر تنظیم کرد. برای خدمات رسانی به مشتریان، این فیلد قابل تنظیم نیست. همه استراتژی‌ها در یک مشتری خدمت‌رسان به طور ضمنی از واحد پول مشتری خدمات‌دهی‌کننده استفاده می‌کنند. در همه موارد فیلد effect_currency_code ارز استفاده شده توسط استراتژی را برمی گرداند.
`id`	`int64` شناسه استراتژی مناقصه.
`name`	`string` نام استراتژی مناقصه. همه استراتژی های مناقصه در یک حساب باید به طور مشخص نامگذاری شوند. طول این رشته باید بین 1 تا 255، شامل UTF-8 بایت، (بریده شده) باشد.
`effective_ currency_ code`	`string` ارز مورد استفاده در استراتژی مناقصه (کد سه حرفی ISO 4217). برای استراتژی‌های مناقصه در مشتریان مدیر، این واحد پولی است که تبلیغ‌کننده هنگام ایجاد استراتژی تعیین می‌کند. برای ارائه خدمات به مشتریان، این کد ارز مشتری است. معیارهای استراتژی مناقصه با این ارز گزارش شده است. این فیلد فقط خواندنی است.
`campaign_ count`	`int64` تعداد کمپین های پیوست شده به این استراتژی مناقصه. این فیلد فقط خواندنی است.
`non_ removed_ campaign_ count`	`int64` تعداد کمپین‌های حذف نشده پیوست شده به این استراتژی مناقصه. این فیلد فقط خواندنی است.
`scheme` میدانی اتحادیه طرح مناقصه. فقط یکی را می توان تنظیم کرد. `scheme` فقط می تواند یکی از موارد زیر باشد:
`enhanced_ cpc`	`EnhancedCpc` یک استراتژی قیمت‌گذاری که قیمت‌ها را برای کلیک‌هایی که به نظر می‌رسد بیشتر منجر به تبدیل می‌شوند، افزایش می‌دهد و برای کلیک‌هایی که احتمال کمتری به نظر می‌رسد، آن‌ها را کاهش می‌دهد.
`maximize_ conversion_ value`	`MaximizeConversionValue` یک استراتژی مناقصه خودکار برای کمک به به دست آوردن بیشترین ارزش تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.
`maximize_ conversions`	`MaximizeConversions` یک استراتژی مناقصه خودکار برای کمک به دریافت بیشترین تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.
`target_ cpa`	`TargetCpa` یک استراتژی مناقصه که پیشنهادهایی را برای کمک به دریافت بیشترین تبدیل ممکن در هزینه به ازای هر خرید (CPA) مورد نظر شما تنظیم می کند.
`target_ impression_ share`	`TargetImpressionShare` یک استراتژی مناقصه که به طور خودکار نسبت به درصد انتخابی از نمایش‌ها بهینه می‌شود.
`target_ outrank_ share`	`TargetOutrankShare` یک استراتژی مناقصه که قیمت ها را بر اساس بخش هدف حراج ها تنظیم می کند که در آن تبلیغ کننده باید از یک رقیب خاص بالاتر باشد. این فیلد منسوخ شده است. ایجاد یک استراتژی جدید مناقصه با این فیلد یا پیوست کردن استراتژی‌های مناقصه با این فیلد به یک کمپین شکست خواهد خورد. جهش به استراتژی هایی که قبلاً این طرح را پر کرده اند مجاز است.
`target_ roas`	`TargetRoas` یک استراتژی مناقصه که به شما کمک می کند درآمد را به حداکثر برسانید و در عین حال میانگین یک هدف خاص بازده تبلیغاتی (ROAS) را به دست آورید.
`target_ spend`	`TargetSpend` یک استراتژی پیشنهادی که قیمت‌های پیشنهادی شما را طوری تنظیم می‌کند که به بیشترین تعداد کلیک ممکن در بودجه شما کمک کند.

کمپین

یک کمپین.

فیلدها
`resource_ name`	`string` نام منبع کمپین نام منابع کمپین به شکل زیر است: `customers/{customer_id}/campaigns/{campaign_id}`
`status`	`CampaignStatus` وضعیت کمپین هنگامی که یک کمپین جدید اضافه می شود، وضعیت به طور پیش فرض فعال است.
`serving_ status`	`CampaignServingStatus` وضعیت ارائه تبلیغات کمپین.
`bidding_ strategy_ system_ status`	`BiddingStrategySystemStatus` وضعیت سیستم استراتژی مناقصه کمپین.
`ad_ serving_ optimization_ status`	`AdServingOptimizationStatus` وضعیت بهینه سازی سرویس تبلیغات کمپین.
`advertising_ channel_ type`	`AdvertisingChannelType` هدف اصلی سرویس برای تبلیغات در کمپین. گزینه های هدف را می توان در `network_settings` اصلاح کرد. این قسمت الزامی است و هنگام ایجاد کمپین های جدید نباید خالی باشد. فقط هنگام ایجاد کمپین قابل تنظیم است. پس از ایجاد کمپین، فیلد را نمی توان تغییر داد.
`advertising_ channel_ sub_ type`	`AdvertisingChannelSubType` اصلاح اختیاری در `advertising_channel_type` . باید یک نوع فرعی معتبر از نوع کانال اصلی باشد. فقط هنگام ایجاد کمپین قابل تنظیم است. پس از ایجاد کمپین، فیلد را نمی توان تغییر داد.
`url_ custom_ parameters[]`	`CustomParameter` فهرست نگاشت‌هایی که برای جایگزینی برچسب‌های پارامتر سفارشی در `tracking_url_template` ، `final_urls` ، یا `mobile_final_urls` استفاده می‌شوند.
`real_ time_ bidding_ setting`	`RealTimeBiddingSetting` تنظیمات برای مناقصه بلادرنگ، ویژگی فقط برای کمپین هایی که شبکه Ad Exchange را هدف قرار می دهند.
`network_ settings`	`NetworkSettings` تنظیمات شبکه برای کمپین
`dynamic_ search_ ads_ setting`	`DynamicSearchAdsSetting` تنظیم برای کنترل تبلیغات جستجوی پویا (DSA).
`shopping_ setting`	`ShoppingSetting` تنظیم برای کنترل کمپین های خرید.
`geo_ target_ type_ setting`	`GeoTargetTypeSetting` تنظیم برای هدف‌یابی جغرافیایی تبلیغات.
`effective_ labels[]`	`string` نام منابع برچسب های موثر پیوست شده به این کمپین. یک برچسب موثر برچسبی است که به ارث رسیده یا مستقیماً به این کمپین اختصاص داده شده است.
`labels[]`	`string` نام منابع برچسب های پیوست شده به این کمپین.
`bidding_ strategy_ type`	`BiddingStrategyType` نوع استراتژی مناقصه. یک استراتژی مناقصه را می توان با تنظیم طرح پیشنهادی برای ایجاد یک استراتژی مناقصه استاندارد یا فیلد `bidding_strategy` برای ایجاد یک استراتژی مناقصه نمونه کارها ایجاد کرد. این فیلد فقط خواندنی است.
`accessible_ bidding_ strategy`	`string` نام منبع AccessibleBiddingStrategy، یک نمای فقط خواندنی از ویژگی‌های نامحدود استراتژی مناقصه پورتفولیوی پیوست شده که توسط 'bidding_strategy' شناسایی شده است. خالی، اگر کمپین از استراتژی نمونه کارها استفاده نمی کند. ویژگی های استراتژی نامحدود برای همه مشتریانی که استراتژی با آنها به اشتراک گذاشته شده است در دسترس است و از منبع AccessibleBiddingStrategy خوانده می شود. در مقابل، ویژگی‌های محدود شده فقط برای مشتری مالک استراتژی و مدیران آن در دسترس است. ویژگی های محدود شده را فقط می توان از منبع BiddingStrategy خواند.
`frequency_ caps[]`	`FrequencyCapEntry` فهرستی که تعداد دفعات دیدن تبلیغات این کمپین را هر کاربر محدود می کند.
`selective_ optimization`	`SelectiveOptimization` تنظیمات بهینه‌سازی انتخابی برای این کمپین، که شامل مجموعه‌ای از اقدامات تبدیلی برای بهینه‌سازی این کمپین است. این ویژگی فقط برای کمپین های برنامه ای اعمال می شود که از MULTI_CHANNEL به عنوان AdvertisingChannelType و APP_CAMPAIGN یا APP_CAMPAIGN_FOR_ENGAGEMENT به عنوان AdvertisingChannelSubType استفاده می کنند.
`optimization_ goal_ setting`	`OptimizationGoalSetting` تنظیم هدف بهینه سازی برای این کمپین که شامل مجموعه ای از انواع اهداف بهینه سازی است.
`tracking_ setting`	`TrackingSetting` تنظیمات در سطح کمپین برای ردیابی اطلاعات.
`engine_ id`	`string` شناسه کمپین در حساب موتور خارجی. این فیلد فقط برای حساب غیر Google Ads است، به عنوان مثال، Yahoo Japan، Microsoft، Baidu و غیره. برای نهاد Google Ads، به جای آن از "campaign.id" استفاده کنید.
`excluded_ parent_ asset_ field_ types[]`	`AssetFieldType` انواع فیلد دارایی که باید از این کمپین حذف شوند. پیوندهای دارایی با این نوع فیلدها توسط این کمپین از سطح بالا به ارث نمی رسد.
`create_ time`	`string` مهر زمانی که این کمپین ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است. create_time در نسخه 1 منسوخ خواهد شد. به جای آن از create_time استفاده کنید.
`creation_ time`	`string` مهر زمانی که این کمپین ایجاد شد. مُهر زمانی در منطقه زمانی مشتری و در قالب «سالم-MM-dd HH:mm:ss» است.
`last_ modified_ time`	`string` تاریخ آخرین تغییر این کمپین. زمان تاریخ در منطقه زمانی مشتری و در قالب "سالم-MM-dd HH:mm:ss.ssssss" است.
`id`	`int64` شناسه کمپین
`name`	`string` نام کمپین. این قسمت الزامی است و هنگام ایجاد کمپین های جدید نباید خالی باشد. نباید دارای هیچ نویسه تهی (نقطه کد 0x0)، خوراک خط NL (نقطه کد 0xA) یا نویسه برگشتی (نقطه کد 0xD) باشد.
`tracking_ url_ template`	`string` الگوی URL برای ساخت URL ردیابی.
`campaign_ budget`	`string` نام منبع بودجه کمپین کمپین.
`start_ date`	`string` تاریخ شروع کمپین در ارائه خدمات به منطقه زمانی مشتری در قالب YYYY-MM-DD.
`end_ date`	`string` آخرین روز از کمپین خدمات رسانی به منطقه زمانی مشتری در قالب YYYY-MM-DD. در ایجاد، پیش‌فرض 2037-12-30 است، به این معنی که کمپین به‌طور نامحدود اجرا می‌شود. برای تنظیم یک کمپین موجود برای اجرای نامحدود، این فیلد را روی 2037-12-30 تنظیم کنید.
`final_ url_ suffix`	`string` پسوند برای افزودن پارامترهای پرس و جو به صفحات فرود که با ردیابی موازی ارائه می شوند استفاده می شود.
`url_ expansion_ opt_ out`	`bool` نشان دهنده انصراف از گسترش URL به URL های هدفمندتر است. در صورت انصراف (درست)، فقط نشانی‌های وب نهایی در گروه دارایی یا نشانی‌های وب مشخص‌شده در مرکز تجاری Google تبلیغ‌کننده یا فیدهای داده‌های کسب‌وکار مورد هدف قرار می‌گیرند. در صورت انتخاب (نادرست)، کل دامنه هدف قرار خواهد گرفت. این فیلد را فقط می توان برای کمپین های Performance Max تنظیم کرد، جایی که مقدار پیش فرض نادرست است.
`campaign_bidding_strategy` میدانی اتحادیه . استراتژی مناقصه برای کمپین. باید نمونه کارها (ایجاد شده از طریق سرویس BiddingStrategy) یا استاندارد باشد که در کمپین تعبیه شده است. `campaign_bidding_strategy` تنها می تواند یکی از موارد زیر باشد:
`bidding_ strategy`	`string` نام منبع استراتژی مناقصه نمونه کارها که توسط کمپین استفاده می شود.
`manual_ cpa`	`ManualCpa` استراتژی مناقصه دستی استاندارد CPA. استراتژی مناقصه دستی که به تبلیغ کننده اجازه می دهد قیمت پیشنهادی را برای هر اقدام مشخص شده توسط تبلیغ کننده تنظیم کند. فقط برای کمپین های خدمات محلی پشتیبانی می شود.
`manual_ cpc`	`ManualCpc` استراتژی مناقصه CPC دستی استاندارد. مناقصه مبتنی بر کلیک دستی که در آن کاربر به ازای هر کلیک پرداخت می کند.
`manual_ cpm`	`ManualCpm` استراتژی مناقصه CPM دستی استاندارد. مناقصه مبتنی بر نمایش دستی که در آن کاربر به ازای هر هزار بار نمایش پرداخت می کند.
`maximize_ conversions`	`MaximizeConversions` استراتژی پیشنهادی استاندارد حداکثر کردن تبدیل ها که به طور خودکار تعداد تبدیل ها را در حین خرج کردن بودجه شما به حداکثر می رساند.
`maximize_ conversion_ value`	`MaximizeConversionValue` استراتژی پیشنهادی استاندارد حداکثر کردن ارزش تبدیل که به طور خودکار پیشنهادهایی را برای به حداکثر رساندن درآمد در حین خرج کردن بودجه تنظیم می کند.
`target_ cpa`	`TargetCpa` استراتژی پیشنهادی CPA هدف استاندارد که به طور خودکار پیشنهاداتی را برای کمک به دستیابی به هر چه بیشتر تبدیل ها در هزینه هدف در هر کسب و کار (CPA) که تعیین کرده اید ، تعیین می کند.
`target_ impression_ share`	`TargetImpressionShare` تصور هدف استراتژی مناقصه به اشتراک گذاری. یک استراتژی پیشنهادی خودکار که برای دستیابی به درصد منتخب از برداشت ها ، پیشنهاداتی را تعیین می کند.
`target_ roas`	`TargetRoas` استراتژی پیشنهادی ROAS هدف استاندارد که به طور خودکار درآمد را به حداکثر می رساند در حالی که میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) است.
`target_ spend`	`TargetSpend` هدف استاندارد هزینه پیشنهادی را که به طور خودکار پیشنهادات شما را تعیین می کند تا به شما کمک کند تا حد ممکن در بودجه شما به دست بیاورید.
`percent_ cpc`	`PercentCpc` استراتژی پیشنهادی CPC درصد استاندارد که در آن پیشنهادات بخشی از قیمت تبلیغ شده برای برخی از خدمات خوب یا خدمات است.
`target_ cpm`	`TargetCpm` یک استراتژی مناقصه که به طور خودکار هزینه در هر هزار برداشت را بهینه می کند.

DynamicsearchAdsSting

تنظیم برای کنترل تبلیغات جستجوی پویا (DSA).

فیلدها

فیلدها
`domain_ name`	`string` مورد نیاز. نام دامنه اینترنت که این تنظیمات نشان می دهد ، به عنوان مثال "Google.com" یا "www.google.com".
`language_ code`	`string` مورد نیاز. کد زبان که زبان دامنه را مشخص می کند ، به عنوان مثال ، "en".
`use_ supplied_ urls_ only`	`bool` این که آیا این کمپین از URL های تبلیغاتی به طور انحصاری استفاده می کند.

domain_ name

string

مورد نیاز. نام دامنه اینترنت که این تنظیمات نشان می دهد ، به عنوان مثال "Google.com" یا "www.google.com".

language_ code

string

مورد نیاز. کد زبان که زبان دامنه را مشخص می کند ، به عنوان مثال ، "en".

use_ supplied_ urls_ only

bool

این که آیا این کمپین از URL های تبلیغاتی به طور انحصاری استفاده می کند.

Geotargettypesetting

مجموعه ای از تنظیمات مربوط به Geotargeting ADS را نشان می دهد.

فیلدها

فیلدها
`positive_ geo_ target_ type`	`PositiveGeoTargetType` تنظیمات مورد استفاده برای ژئوتارجت مثبت در این کمپین خاص.
`negative_ geo_ target_ type`	`NegativeGeoTargetType` تنظیمات مورد استفاده برای ژئوتارجت منفی در این کمپین خاص.

positive_ geo_ target_ type

PositiveGeoTargetType

تنظیمات مورد استفاده برای ژئوتارجت مثبت در این کمپین خاص.

negative_ geo_ target_ type

NegativeGeoTargetType

تنظیمات مورد استفاده برای ژئوتارجت منفی در این کمپین خاص.

تنظیمات شبکه

تنظیمات شبکه برای کمپین.

فیلدها
`target_ google_ search`	`bool` آیا تبلیغات با نتایج جستجوی Google.com ارائه می شود.
`target_ search_ network`	`bool` این که آیا تبلیغات در سایت های شریک در شبکه جستجوی Google ارائه می شود ( `true` `target_google_search` نیز نیاز دارد).
`target_ content_ network`	`bool` آیا تبلیغات در محل های مشخص شده در شبکه Google Display ارائه می شود. مکان ها با استفاده از معیار قرارگیری مشخص می شوند.
`target_ partner_ search_ network`	`bool` آیا تبلیغات در شبکه Google Partner ارائه می شود. این فقط برای برخی از حساب های Google Partner در دسترس است.

بهینه سازی

تنظیم هدف بهینه سازی برای این کمپین ، که شامل مجموعه ای از انواع هدف بهینه سازی است.

فیلدها

فیلدها
`optimization_ goal_ types[]`	`OptimizationGoalType` لیست انواع هدف بهینه سازی.

optimization_ goal_ types[]

OptimizationGoalType

لیست انواع هدف بهینه سازی.

انتخاب انتخابی

تنظیم بهینه سازی انتخابی برای این کمپین ، که شامل مجموعه ای از اقدامات تبدیل برای بهینه سازی این کمپین به سمت آن است. این ویژگی فقط در مورد کمپین های برنامه ای که از Multi_Channel به عنوان AdvertisingChanneltype و APP_CAMPAIDE یا APP_CAMPAIGN_FOR_ENGEMIGENCE به عنوان ADRAPISINGCHANNELSUBTYPE استفاده می کنند ، صدق می کند.

فیلدها

فیلدها
`conversion_ actions[]`	`string` مجموعه انتخاب شده نام منابع برای اقدامات تبدیل برای بهینه سازی این کمپین.

conversion_ actions[]

string

مجموعه انتخاب شده نام منابع برای اقدامات تبدیل برای بهینه سازی این کمپین.

خریدهای

تنظیمات تبلیغات برای خرید. جهان محصولاتی را که توسط این کمپین تبلیغ می شود ، و چگونگی تعامل این کمپین با سایر کمپین های خرید تعریف می کند.

فیلدها
`feed_ label`	`string` برچسب FEED از محصولات در این کمپین گنجانده شده است. فقط می توان یکی از Feed_Label یا Sales_Country را تنظیم کرد. اگر به جای sales_country استفاده شود ، قسمت feed_label کدهای کشور را با همان قالب می پذیرد: "xx". در غیر این صورت می تواند هر رشته ای باشد که برای برچسب فید در مرکز بازرگان Google استفاده می شود.
`use_ vehicle_ inventory`	`bool` آیا موجودی لیست خودرو را هدف قرار دهید.
`merchant_ id`	`int64` شناسه حساب مرکز بازرگان. این قسمت برای ایجاد عملیات لازم است. این زمینه برای کمپین های خرید تغییر ناپذیر است.
`sales_ country`	`string` کشور فروش محصولات در این کمپین گنجانده شده است.
`campaign_ priority`	`int32` اولویت کمپین. کمپین هایی با اولویت های عددی بالاتر بر کسانی که اولویت های کمتری دارند ، برتری دارند. این زمینه برای کمپین های خرید با مقادیر بین 0 تا 2 مورد نیاز است. این قسمت برای کمپین های خرید هوشمند اختیاری است ، اما در صورت تنظیم باید برابر با 3 باشد.
`enable_ local`	`bool` آیا محصولات محلی را شامل می شود.

پیگیری

تنظیمات سطح کمپین برای ردیابی اطلاعات.

فیلدها

فیلدها
`tracking_ url`	`string` URL مورد استفاده برای ردیابی پویا.

tracking_ url

string

URL مورد استفاده برای ردیابی پویا.

کمپین

پیوند بین یک کمپین و دارایی.

فیلدها
`resource_ name`	`string` نام منابع دارایی کمپین. نام منابع کمپین دارای فرم است: `customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}`
`status`	`AssetLinkStatus` وضعیت دارایی مبارزات انتخاباتی.
`campaign`	`string` کمپینی که دارایی به آن پیوند داده شده است.
`asset`	`string` دارایی که به کمپین مرتبط است.

کمپین

Compuntarsetset پیوند بین یک کمپین و یک مجموعه دارایی است. اضافه کردن یک کمپین ، دارایی مجموعه ای را با یک کمپین پیوند می دهد.

فیلدها
`resource_ name`	`string` نام منابع مجموعه دارایی کمپین. دارایی مجموعه منابع دارایی فرم دارد: `customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}`
`campaign`	`string` کمپینی که این مجموعه دارایی به آن مرتبط است.
`asset_ set`	`string` مجموعه دارایی که به کمپین مرتبط است.
`status`	`AssetSetLinkStatus` وضعیت دارایی کمپین دارایی را تعیین کرده است. فقط خواندنی

CampaiceAudienceView

دیدگاه مخاطبان مبارزات انتخاباتی. شامل داده های عملکردی از علایق و لیست های بازاریابی برای نمایش شبکه و تبلیغات شبکه YouTube و لیست های بازاریابی برای تبلیغات جستجو (RLSA) ، که توسط کمپین و معیار مخاطبان جمع شده است. این دیدگاه فقط شامل مخاطبان متصل در سطح کمپین است.

فیلدها

فیلدها
`resource_ name`	`string` نام منابع دیدگاه مخاطبان کمپین. مخاطبان کمپین مشاهده نام منابع این شکل را دارند: `customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}`

resource_ name

string

نام منابع دیدگاه مخاطبان کمپین. مخاطبان کمپین مشاهده نام منابع این شکل را دارند:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

کمپین

بودجه کمپین

فیلدها
`resource_ name`	`string` نام منابع بودجه کمپین. نام منابع بودجه کمپین فرم دارد: `customers/{customer_id}/campaignBudgets/{campaign_budget_id}`
`delivery_ method`	`BudgetDeliveryMethod` روش تحویل که میزان بودجه کمپین را در آن تعیین می کند. اگر در یک عملیات ایجاد شده نامشخص باشد ، به طور پیش فرض استاندارد است.
`period`	`BudgetPeriod` دوره ای که برای صرف بودجه. پیش فرض روزانه اگر مشخص نشده باشد.
`amount_ micros`	`int64` میزان بودجه ، در ارز محلی برای حساب. مبلغ در MICROS مشخص شده است ، جایی که یک میلیون معادل یک واحد ارز است. هزینه ماهانه در 30.4 برابر این مبلغ بسته می شود.

معیار کمپین

یک معیار مبارزات انتخاباتی.

فیلدها
`resource_ name`	`string` نام منابع معیار کمپین. نام منابع معیار کمپین فرم دارد: `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}`
`display_ name`	`string` نام نمایشگر معیار. این زمینه برای جهش نادیده گرفته می شود.
`type`	`CriterionType` نوع معیار.
`status`	`CampaignCriterionStatus` وضعیت معیار.
`last_ modified_ time`	`string` DateTime هنگامی که آخرین معیار کمپین اصلاح شد. DateTime در منطقه زمانی مشتری و در قالب "Yyyy-MM-DD HH: MM: SSSSSSSS" است.
`criterion_ id`	`int64` شناسه معیار. این زمینه در هنگام جهش نادیده گرفته می شود.
`bid_ modifier`	`float` اصلاح کننده برای پیشنهادات هنگام مطابقت با معیار. اصلاح کننده باید در محدوده باشد: 0.1 - 10.0. انواع معیارهای هدفمند از اصلاح کننده ها پشتیبانی می کنند. برای امتناع از نوع دستگاه از 0 استفاده کنید.
`negative`	`bool` آیا معیار را هدف قرار دهید ( `false` ) یا ( `true` ) را حذف کنید.
`criterion` میدان اتحادیه. معیار مبارزات انتخاباتی. دقیقاً باید تنظیم شود. `criterion` می تواند تنها یکی از موارد زیر باشد:
`keyword`	`KeywordInfo` کلمه کلیدی
`location`	`LocationInfo` مکان.
`device`	`DeviceInfo` دستگاه
`age_ range`	`AgeRangeInfo` دامنه سنی
`gender`	`GenderInfo` جنسیت.
`user_ list`	`UserListInfo` لیست کاربر
`language`	`LanguageInfo` زبان.
`webpage`	`WebpageInfo` صفحه وب.
`location_ group`	`LocationGroupInfo` گروه محل

کمپین

نشان دهنده رابطه بین یک کمپین و یک برچسب مؤثر است. یک برچسب مؤثر یک برچسب به ارث رسیده یا مستقیماً به این کمپین اختصاص داده شده است.

فیلدها
`resource_ name`	`string` نام منبع نام منابع کمپینفکتولاوبل فرم: `customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}`
`campaign`	`string` کمپینی که برچسب مؤثر به آن وصل شده است.
`label`	`string` برچسب مؤثر به کمپین اختصاص داده شده است.
`owner_ customer_ id`	`int64` شناسه مشتری که دارای برچسب موثر است.

کمپین

نشان دهنده رابطه بین یک کمپین و یک برچسب است.

فیلدها
`resource_ name`	`string` نام منبع نام منابع برچسب کمپین فرم دارد: `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}`
`campaign`	`string` کمپینی که برچسب به آن وصل شده است.
`label`	`string` برچسب اختصاص داده شده به کمپین.
`owner_ customer_ id`	`int64` شناسه مشتری که صاحب برچسب است.

cartdatasalesview

نمای فروش داده های سبد خرید.

فیلدها

resource_ name

string

نام منبع نمای فروش داده های سبد خرید. نمایش داده های سبد خرید نام منابع دارای فرم هستند: customers/{customer_id}/cartDataSalesView

تبدیل

فیلدها
`resource_ name`	`string` نام منابع تبدیل. نام منابع تبدیل فرم دارد: `customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}`
`id`	`int64` شناسه تبدیل
`criterion_ id`	`int64` تبلیغات جستجو 360 شناسه معیار. مقدار 0 نشان می دهد که معیار غیرقابل توزیع است.
`merchant_ id`	`int64` شناسه حساب موجودی ADS 360 حاوی محصولی که روی آن کلیک شده است. ADS ADS 360 هنگام پیوند یک حساب موجودی در تبلیغات 360 ، این شناسه را تولید می کند.
`ad_ id`	`int64` شناسه تبلیغاتی مقدار 0 نشان می دهد که AD غیر توزیع شده است.
`click_ id`	`string` یک رشته منحصر به فرد ، برای بازدیدی که تبدیل به آن نسبت داده می شود ، که به عنوان پارامتر URL Click ID به صفحه فرود منتقل می شود.
`visit_ id`	`int64` تبلیغات جستجو 360 از شناسه بازدیدی که تبدیل به آن نسبت داده شده است.
`advertiser_ conversion_ id`	`string` برای تبدیل های آفلاین ، این شناسه ارائه شده توسط تبلیغ کنندگان است. اگر یک تبلیغ کننده چنین شناسه ای را مشخص نکند ، ADS 360 یک مورد را تولید می کند. برای تبدیل آنلاین ، این برابر با ستون ID یا ستون Floodlight_Order_ID بسته به دستورالعمل های چراغ تبلیغ کننده تبلیغ کننده است.
`product_ id`	`string` شناسه محصول روی آن کلیک کرد.
`product_ channel`	`ProductChannel` کانال فروش محصولی که روی آن کلیک شده است: آنلاین یا محلی.
`product_ language_ code`	`string` این زبان (ISO-639-1) که برای فید مرکز بازرگان حاوی داده های مربوط به محصول تعیین شده است.
`product_ store_ id`	`string` فروشگاه موجود در آگهی موجودی محلی که روی آن کلیک شده است. این باید با شناسه های فروشگاه مورد استفاده در خوراک محصولات محلی شما مطابقت داشته باشد.
`product_ country_ code`	`string` کشور (ISO-3166-FORMAT) برای فید موجودی که شامل محصول کلیک شده است ، ثبت شده است.
`attribution_ type`	`AttributionType` آنچه تبدیل به آن نسبت داده می شود: بازدید یا کلمه کلیدی+AD.
`conversion_ date_ time`	`string` جدول زمانی رویداد تبدیل.
`conversion_ last_ modified_ date_ time`	`string` زمان آخرین باری که تبدیل تغییر یافت.
`conversion_ visit_ date_ time`	`string` جدول زمانی بازدیدی که تبدیل به آن نسبت داده می شود.
`conversion_ quantity`	`int64` مقدار موارد ثبت شده توسط تبدیل ، همانطور که توسط پارامتر URL QTY تعیین می شود. تبلیغ کننده مسئول جمع آوری پویا پارامتر (مانند تعداد کالاهای فروخته شده در تبدیل) است ، در غیر این صورت پیش فرض 1 است.
`conversion_ revenue_ micros`	`int64` درآمد تعدیل شده در MICROS برای رویداد تبدیل. این همیشه به ارز حساب سرویس خواهد بود.
`floodlight_ original_ revenue`	`int64` درآمد اصلی و بدون تغییر مرتبط با رویداد FLEODLIGHT (به ارز گزارش فعلی) ، قبل از اصلاحات دستورالعمل ارزی Floodlight.
`floodlight_ order_ id`	`string` شناسه سفارش Floodlight ارائه شده توسط تبلیغ کننده برای تبدیل.
`status`	`ConversionStatus` وضعیت تبدیل ، یا فعال یا حذف شده ..
`asset_ id`	`int64` شناسه دارایی که در طول رویداد تبدیل با آن تعامل داشت.
`asset_ field_ type`	`AssetFieldType` نوع میدان دارایی رویداد تبدیل.

ConversionAction

یک عمل تبدیل

فیلدها
`resource_ name`	`string` نام منبع عمل تبدیل. نام منابع اکشن تبدیل فرم دارد: `customers/{customer_id}/conversionActions/{conversion_action_id}`
`creation_ time`	`string` Timestamp of Actional Lightlight ، که در ISO 8601 فرمت شده است.
`status`	`ConversionActionStatus` وضعیت این اقدام تبدیل برای رویداد تبدیل.
`type`	`ConversionActionType` نوع این عمل تبدیل.
`category`	`ConversionActionCategory` دسته تبدیل ها برای این اقدام تبدیل گزارش شده است.
`value_ settings`	`ValueSettings` تنظیمات مربوط به ارزش وقایع تبدیل مرتبط با این اقدام تبدیل.
`attribution_ model_ settings`	`AttributionModelSettings` تنظیمات مربوط به مدل انتساب این اقدام تبدیل.
`floodlight_ settings`	`FloodlightSettings` تنظیمات چراغهای روشن برای انواع تبدیل چراغ.
`id`	`int64` شناسه عمل تبدیل.
`name`	`string` نام عمل تبدیل. این قسمت مورد نیاز است و هنگام ایجاد اقدامات تبدیل جدید نباید خالی باشد.
`primary_ for_ goal`	`bool` اگر یک بیت اولیه Action Action یک عمل تبدیل نادرست باشد ، اقدام به تبدیل برای همه کمپین ها بدون در نظر گرفتن هدف تبدیل مشتری یا هدف تبدیل کمپین ، غیر قابل قبول است. با این حال ، اهداف تبدیل سفارشی به Primary_for_goal احترام نمی گذارند ، بنابراین اگر یک کمپین دارای یک هدف تبدیل سفارشی باشد که با یک عمل تبدیل کاذب primary_for_goal پیکربندی شده است ، این عمل تبدیل هنوز قابل پیشنهاد است. به طور پیش فرض ، Primary_for_goal در صورت عدم تنظیم صحیح خواهد بود. در V9 ، Primary_for_goal فقط می تواند پس از ایجاد از طریق یک عمل "به روزرسانی" به صورت نادرست تنظیم شود زیرا به عنوان اختیاری اعلام نمی شود.
`owner_ customer`	`string` اگر این یک اقدام تبدیل تعریف شده توسط سیستم باشد ، نام منابع مشتری مالک اقدام تبدیل یا تهی است.
`include_ in_ client_ account_ conversions_ metric`	`bool` این که آیا این اقدام تبدیل باید در متریک "client_account_conversions" گنجانده شود.
`include_ in_ conversions_ metric`	`bool` این که آیا این اقدام تبدیل باید در متریک "تبدیل" گنجانده شود.
`click_ through_ lookback_ window_ days`	`int64` حداکثر تعداد روزهایی که ممکن است بین تعامل (به عنوان مثال ، یک کلیک) و یک رویداد تبدیل از بین برود.
`app_ id`	`string` شناسه برنامه برای یک اقدام تبدیل برنامه.

attributionmodelsettings

تنظیمات مربوط به مدل انتساب این اقدام تبدیل.

فیلدها

attribution_ model

AttributionModel

نوع مدل انتساب این عمل تبدیل.

data_ driven_ model_ status

DataDrivenModelStatus

وضعیت مدل انتساب داده محور برای عمل تبدیل.

چراغهای روشن

تنظیمات مربوط به یک عمل تبدیل چراغ.

فیلدها

activity_ group_ tag

string

رشته برای شناسایی یک گروه فعالیت نوری هنگام گزارش تبدیل استفاده می شود.

activity_ tag

string

رشته برای شناسایی یک فعالیت چراغ در هنگام گزارش تبدیل استفاده می شود.

activity_ id

int64

شناسه فعالیت FLEODLIGHT در مدیر کمپین DoubleClick (DCM).

ارزش ها

تنظیمات مربوط به ارزش وقایع تبدیل مرتبط با این اقدام تبدیل.

فیلدها

default_ value

double

مقدار استفاده در هنگام وقایع تبدیل برای این اقدام تبدیل با مقدار نامعتبر ، مجاز یا گمشده ارسال می شود ، یا وقتی این اقدام تبدیل پیکربندی شده است تا همیشه از مقدار پیش فرض استفاده کند.

default_ currency_ code

string

کد ارزی برای استفاده در هنگام وقایع تبدیل برای این اقدام تبدیل با یک کد ارز نامعتبر یا گمشده ارسال می شود ، یا وقتی این اقدام تبدیل پیکربندی شده است تا همیشه از مقدار پیش فرض استفاده کند.

always_ use_ default_ value

bool

کنترل می کند که آیا مقدار پیش فرض و کد ارز پیش فرض به جای مقدار و کد ارز مشخص شده در رویدادهای تبدیل برای این اقدام تبدیل استفاده می شود.

تبدیل پذیر

یک متغیر سفارشی تبدیل. به "در مورد معیارهای و ابعاد Floodlight Custom Light در تبلیغات جدید 360" در https://support.google.com/sa360/answer/13567857 مراجعه کنید.

فیلدها
`resource_ name`	`string` نام منبع متغیر تبدیل تبدیل. تبدیل نام منابع متغیر سفارشی فرم: `customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}`
`id`	`int64` شناسه متغیر سفارشی تبدیل.
`name`	`string` مورد نیاز. نام متغیر سفارشی تبدیل. نام باید منحصر به فرد باشد. حداکثر طول نام 100 نویسه است. قبل و بعد از آن نباید فضای اضافی وجود داشته باشد.
`tag`	`string` مورد نیاز. برچسب متغیر سفارشی تبدیل. برچسب باید منحصر به فرد باشد و از یک شخصیت "U" تشکیل شود که مستقیماً با یک عدد کمتر از Ormequal تا 100 دنبال می شود. به عنوان مثال: "U4".
`status`	`ConversionCustomVariableStatus` وضعیت متغیر سفارشی تبدیل برای تعهدی رویداد تبدیل.
`owner_ customer`	`string` نام منبع مشتری که صاحب متغیر تبدیل سفارشی است.
`family`	`ConversionCustomVariableFamily` خانواده متغیر سفارشی تبدیل.
`cardinality`	`ConversionCustomVariableCardinality` کاردینال بودن متغیر سفارشی تبدیل.
`floodlight_ conversion_ custom_ variable_ info`	`FloodlightConversionCustomVariableInfo` زمینه هایی برای تبلیغات جستجو 360 متغیرهای سفارشی تبدیل FLEODLIGHT.
`custom_ column_ ids[]`	`int64` شناسه ستون های سفارشی که از این متغیر سفارشی تبدیل استفاده می کنند.

چراغ برق

اطلاعات مربوط به تبلیغات جستجو 360 متغیرهای سفارشی تبدیل آتش سوزی.

فیلدها

floodlight_ variable_ type

FloodlightVariableType

نوع متغیر Floodlight تعریف شده در تبلیغات 360.

floodlight_ variable_ data_ type

FloodlightVariableDataType

نوع داده متغیر Floodlight تعریف شده در تبلیغات 360.

ConversionTrackingingting

مجموعه ای از تنظیمات در سطح مشتری مربوط به ردیابی تبدیل 360 ADS 360.

فیلدها
`accepted_ customer_ data_ terms`	`bool` آیا مشتری شرایط داده مشتری را پذیرفته است. در صورت استفاده از ردیابی تبدیل حساب متقابل ، این مقدار از مدیر به ارث می رسد. این فیلد فقط خواندنی است. برای اطلاعات بیشتر ، به https://support.google.com/adspolicy/answer/7475709 مراجعه کنید.
`conversion_ tracking_ status`	`ConversionTrackingStatus` وضعیت ردیابی تبدیل. این نشان می دهد که آیا مشتری از ردیابی تبدیل استفاده می کند ، و چه کسی صاحب ردیابی تبدیل این مشتری است. اگر این مشتری از ردیابی تبدیل حساب متقابل استفاده کند ، مقدار برگشتی بر اساس `login-customer-id` درخواست متفاوت خواهد بود.
`enhanced_ conversions_ for_ leads_ enabled`	`bool` این که آیا مشتری برای تبدیل های پیشرفته برای سرب انتخاب شده است. در صورت استفاده از ردیابی تبدیل حساب متقابل ، این مقدار از مدیر به ارث می رسد. این فیلد فقط خواندنی است.
`google_ ads_ conversion_ customer`	`string` نام منابع مشتری که در آن تبدیل ها ایجاد و مدیریت می شوند. این فیلد فقط خواندنی است.
`conversion_ tracking_ id`	`int64` شناسه ردیابی تبدیل برای این حساب استفاده شده است. این شناسه نشان نمی دهد که آیا مشتری از ردیابی تبدیل استفاده می کند (Conversion_Tracking_status). این فیلد فقط خواندنی است.
`google_ ads_ cross_ account_ conversion_ tracking_ id`	`int64` شناسه ردیابی تبدیل مدیر مشتری. این زمانی تنظیم می شود که مشتری تصمیم به ردیابی تبدیل می کند ، و این امر بر Conversion_Tracking_ID غلبه می کند. این قسمت فقط از طریق UI Google ADS قابل مدیریت است. این فیلد فقط خواندنی است.
`cross_ account_ conversion_ tracking_ id`	`int64` شناسه ردیابی تبدیل مدیر مشتری. این زمانی تنظیم می شود که مشتری تصمیم به ردیابی تبدیل به حساب متقاطع می گیرد و باعث غلبه بر Conversion_Tracking_ID می شود.

کولون

یک ستون سفارشی به ستون جستجو 360 ستون سفارشی در https://support.google.com/sa360/answer/9633916 مراجعه کنید

فیلدها
`resource_ name`	`string` نام منبع ستون سفارشی. نام منابع ستون سفارشی فرم دارد: `customers/{customer_id}/customColumns/{custom_column_id}`
`id`	`int64` شناسه ستون سفارشی.
`name`	`string` نام تعریف شده توسط کاربر ستون سفارشی.
`description`	`string` توضیحات تعریف شده توسط کاربر از ستون سفارشی.
`value_ type`	`CustomColumnValueType` نوع مقدار نتیجه ستون سفارشی.
`references_ attributes`	`bool` درست است وقتی ستون سفارشی به یک یا چند ویژگی اشاره دارد.
`references_ metrics`	`bool` درست است وقتی ستون سفارشی به یک یا چند معیار مراجعه می کند.
`queryable`	`bool` درست هنگامی که ستون سفارشی در دسترس است تا در پرس و جو از SearchADS360Service.Search و SearchADS360Service.SearchStream استفاده شود.
`referenced_ system_ columns[]`	`string` لیست ستون های سیستم ارجاع شده این ستون سفارشی. به عنوان مثال ، یک ستون سفارشی "جمع برداشت ها و کلیک ها" به ستون های سیستم "metrics.clicks" ، "metrics.impressions" ارجاع داده است.
`render_ type`	`CustomColumnRenderType` چگونه باید مقدار نتیجه ستون سفارشی تفسیر شود.

مشتری

فیلدها
`resource_ name`	`string` نام منابع مشتری. نام منابع مشتری فرم دارد: `customers/{customer_id}`
`conversion_ tracking_ setting`	`ConversionTrackingSetting` تنظیم ردیابی تبدیل برای مشتری.
`account_ type`	`AccountType` نوع حساب موتور ، به عنوان مثال ، تبلیغات Google ، تبلیغات مایکروسافت ، یاهو ژاپن ، بایدو ، فیس بوک ، مسیر موتور و غیره.
`double_ click_ campaign_ manager_ setting`	`DoubleClickCampaignManagerSetting` تنظیم مدیر کمپین DoubleClick (DCM) برای مشتری مدیر.
`account_ status`	`AccountStatus` وضعیت حساب ، به عنوان مثال ، فعال ، مکث ، حذف و غیره.
`last_ modified_ time`	`string` DateTime هنگام آخرین تغییر این مشتری. DateTime در منطقه زمانی مشتری و در قالب "Yyyy-MM-DD HH: MM: SSSSSSSS" است.
`engine_ id`	`string` شناسه حساب در حساب موتور خارجی.
`status`	`CustomerStatus` وضعیت مشتری.
`creation_ time`	`string` زمانی که این مشتری ایجاد شد. Timestamp در منطقه زمانی مشتری و در قالب "YYYYY-MM-DD HH: MM: SS" است.
`id`	`int64` شناسه مشتری.
`descriptive_ name`	`string` نام توصیفی اختیاری و غیر منحصر به فرد مشتری.
`currency_ code`	`string` ارز که در آن حساب کار می کند. زیر مجموعه ای از کدهای ارز از استاندارد ISO 4217 پشتیبانی می شود.
`time_ zone`	`string` شناسه منطقه محلی مشتری.
`tracking_ url_ template`	`string` الگوی URL برای ساخت URL ردیابی از پارامترها.
`final_ url_ suffix`	`string` الگوی URL برای پیوستن به پارامترها به URL نهایی.
`auto_ tagging_ enabled`	`bool` آیا برچسب زدن خودکار برای مشتری فعال است.
`manager`	`bool` آیا مشتری مدیر است.

مشتری

پیوند بین مشتری و دارایی.

فیلدها

resource_ name

string

نام منابع دارایی مشتری. نام منابع CustomerAsseSt فرم دارد:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

مورد نیاز. دارایی که به مشتری مرتبط است.

status

AssetLinkStatus

وضعیت دارایی مشتری.

مشتری مشتری

CustomerAssetSet پیوند بین مشتری و مجموعه دارایی است. اضافه کردن یک مشتری مشتری یک دارایی را با مشتری پیوند می دهد.

فیلدها
`resource_ name`	`string` نام منابع مجموعه دارایی مشتری. دارایی مجموعه منابع دارایی فرم دارد: `customers/{customer_id}/customerAssetSets/{asset_set_id}`
`asset_ set`	`string` مجموعه دارایی که به مشتری مرتبط است.
`customer`	`string` مشتری که این مجموعه دارایی به آن پیوند دارد.
`status`	`AssetSetLinkStatus` وضعیت دارایی دارایی مشتری. فقط خواندنی

مشتری مشتری

پیوندی بین مشتری داده شده و مشتری مشتری. مشتری های مشتری فقط برای مشتریان مدیر وجود دارند. کلیه مشتریان مشتری مستقیم و غیرمستقیم و همچنین خود مدیر گنجانده شده است.

فیلدها
`resource_ name`	`string` نام منبع مشتری مشتری. نام منابع مشتری مشتری دارای فرم است: `customers/{customer_id}/customerClients/{client_customer_id}`
`applied_ labels[]`	`string` نام منابع برچسب های متعلق به مشتری درخواست کننده که برای مشتری مشتری اعمال می شود. نام منابع برچسب فرم دارد: `customers/{customer_id}/labels/{label_id}`
`status`	`CustomerStatus` وضعیت مشتری مشتری. فقط بخوانید.
`client_ customer`	`string` نام منبع مشتری مشتری که به مشتری داده شده مرتبط است. فقط بخوانید.
`hidden`	`bool` مشخص می کند که آیا این یک حساب پنهان است یا خیر. فقط بخوانید.
`level`	`int64` فاصله بین مشتری و مشتری. برای پیوند خود ، مقدار سطح 0 خواهد بود. فقط بخوانید.
`time_ zone`	`string` مخزن داده های محلی محلی (CLDR) بازنمایی رشته از منطقه زمانی مشتری ، به عنوان مثال ، America/LOS_ANGELES. فقط بخوانید.
`test_ account`	`bool` مشخص می کند که آیا مشتری یک حساب آزمایشی است یا خیر. فقط بخوانید.
`manager`	`bool` آیا مشتری مدیر است یا خیر. فقط بخوانید.
`descriptive_ name`	`string` نام توصیفی برای مشتری. فقط بخوانید.
`currency_ code`	`string` کد ارز (به عنوان مثال ، "USD" ، "EUR") برای مشتری. فقط بخوانید.
`id`	`int64` شناسه مشتری مشتری. فقط بخوانید.

لینک

نمایانگر رابطه لینک مشتری و مدیر است.

فیلدها
`resource_ name`	`string` نام منبع نام منابع CustomerManagerLink فرم دارد: `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}`
`status`	`ManagerLinkStatus` وضعیت پیوند بین مشتری و مدیر.
`manager_ customer`	`string` مشتری مدیر به مشتری مرتبط است.
`manager_ link_ id`	`int64` شناسه لینک مشتری-مدیر. این فیلد فقط خواندنی است.
`start_ time`	`string` زمان سنجی که CustomerManagerLink ایجاد شد. Timestamp در منطقه زمانی مشتری و در قالب "YYYYY-MM-DD HH: MM: SS" است.

DoubleClickCampaignManagerSting

تنظیم مدیر کمپین DoubleClick (DCM) برای مشتری مدیر.

فیلدها

advertiser_ id

int64

شناسه تبلیغ کننده مدیر کمپین در ارتباط با این مشتری.

network_ id

int64

شناسه شبکه مدیر کمپین مرتبط با این مشتری.

time_ zone

string

منطقه زمانی شبکه مدیر کمپین در ارتباط با این مشتری در قالب پایگاه داده منطقه زمانی IANA ، مانند America/New_york.

DynamicsearchAdsSearchTermView

نمای جستجوی تبلیغات پویا جستجو.

فیلدها

resource_ name

string

نام منابع نمای جستجوی آگهی های جستجوی پویا. آگهی های جستجوی پویا جستجوی اصطلاح مشاهده نام منابع دارای فرم هستند:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_ page

string

URL صفحه فرود پویا انتخاب شده از این تصور.

این فیلد فقط خواندنی است.

ژاندرویز

یک نمای جنسیتی منبع Gender_View به جای اینکه معیارهایی اضافه شود ، وضعیت خدمت موثر را منعکس می کند. یک گروه تبلیغاتی بدون معیارهای جنسیتی به طور پیش فرض به همه جنس ها نشان می دهد ، بنابراین همه جنس ها با آمار در Gender_View ظاهر می شوند.

فیلدها

resource_ name

string

نام منابع نمای جنسیت. نام منابع مشاهده جنسیت فرم دارد:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

ژئوتارجت

یک هدف جغرافیایی ثابت.

فیلدها
`resource_ name`	`string` نام منبع GEO Target ثابت. GEO Target Lames منابع ثابت فرم دارد: `geoTargetConstants/{geo_target_constant_id}`
`status`	`GeoTargetConstantStatus` وضعیت ثابت GEO.
`id`	`int64` شناسه هدف GEO ثابت است.
`name`	`string` GEO نام انگلیسی ثابت.
`country_ code`	`string` کد کشور ISO-3166-1 alpha-2 که با هدف همراه است.
`target_ type`	`string` نوع هدف ثابت GEO.
`canonical_ name`	`string` نام انگلیسی کاملاً واجد شرایط ، متشکل از نام هدف و پدر و مادر و کشور آن.
`parent_ geo_ target`	`string` نام منابع والدین GEO ثابت ثابت است. GEO Target Lames منابع ثابت فرم دارد: `geoTargetConstants/{parent_geo_target_constant_id}`

کلمه کلیدی

نمای کلمه کلیدی

فیلدها

resource_ name

string

نام منبع نمای کلمه کلیدی. نام منابع مشاهده کلمه کلیدی فرم دارد:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

برچسب بزنید

یک برچسب

فیلدها
`resource_ name`	`string` نام منبع نام منابع برچسب فرم دارد: `customers/{customer_id}/labels/{label_id}`
`status`	`LabelStatus` وضعیت برچسب. فقط بخوانید.
`text_ label`	`TextLabel` نوعی از برچسب نمایش متن در پس زمینه رنگی.
`id`	`int64` شناسه برچسب. فقط بخوانید.
`name`	`string` نام برچسب. این قسمت مورد نیاز است و هنگام ایجاد برچسب جدید نباید خالی باشد. طول این رشته باید بین 1 تا 80 باشد ، فراگیر.

وابسته به زبان

یک زبان

فیلدها
`resource_ name`	`string` نام منبع زبان ثابت. نام منابع ثابت زبان فرم دارد: `languageConstants/{criterion_id}`
`id`	`int64` شناسه زبان ثابت است.
`code`	`string` کد زبان ، به عنوان مثال ، "en_us" ، "en_au" ، "es" ، "fr" و غیره.
`name`	`string` نام کامل زبان به زبان انگلیسی ، به عنوان مثال ، "انگلیسی (ما)" ، "اسپانیایی" و غیره.
`targetable`	`bool` آیا زبان هدفمند است.

لیست groupfilterdimension

ابعاد لیست برای فیلتر گروه لیست دارایی.

فیلدها
`dimension` میدان اتحادیه. بعد یکی از انواع زیر همیشه موجود است. `dimension` فقط می تواند یکی از موارد زیر باشد:
`product_ bidding_ category`	`ProductBiddingCategory` دسته مناقصه از یک پیشنهاد محصول.
`product_ brand`	`ProductBrand` مارک یک پیشنهاد محصول.
`product_ channel`	`ProductChannel` محل پیشنهاد محصول.
`product_ condition`	`ProductCondition` شرط پیشنهاد محصول.
`product_ custom_ attribute`	`ProductCustomAttribute` ویژگی سفارشی یک پیشنهاد محصول.
`product_ item_ id`	`ProductItemId` شناسه مورد از یک پیشنهاد محصول.
`product_ type`	`ProductType` نوع پیشنهاد محصول.

نماد محصول

یکی از عناصر یک دسته مناقصه در سطح معینی. مقولات سطح بالا در سطح 1 ، فرزندان آنها در سطح 2 و غیره قرار دارند. ما در حال حاضر تا 5 سطح پشتیبانی می کنیم. کاربر باید یک نوع ابعاد را مشخص کند که سطح دسته را نشان می دهد. همه موارد زیر مجموعه یکسان باید از نوع ابعاد یکسان (سطح دسته) برخوردار باشند.

فیلدها

level

ListingGroupFilterBiddingCategoryLevel

سطح دسته در طبقه بندی را نشان می دهد.

id

int64

شناسه دسته مناقصه محصول.

این شناسه معادل شناسه Google_Product_Category است که در این مقاله شرح داده شده است: https://support.google.com/merchants/answer/6324436

محصول

مارک محصول.

فیلدها

value

string

ارزش رشته برند محصول.

کانال

محل پیشنهاد محصول.

فیلدها

channel

ListingGroupFilterProductChannel

ارزش محل.

شرط محصول

شرط پیشنهاد محصول.

فیلدها

condition

ListingGroupFilterProductCondition

ارزش شرط.

محصول

ویژگی سفارشی یک پیشنهاد محصول.

فیلدها

index

ListingGroupFilterCustomAttributeIndex

شاخص ویژگی سفارشی را نشان می دهد.

value

string

ارزش رشته ویژگی سفارشی محصول.

تولید کننده

شناسه مورد از یک پیشنهاد محصول.

فیلدها

value

string

ارزش شناسه.

نوع محصول

نوع پیشنهاد محصول.

فیلدها

level

ListingGroupFilterProductTypeLevel

سطح نوع.

value

string

مقدار نوع.

لیست groupfilterdimensionpath

مسیر تعریف ابعاد تعریف یک فیلتر گروهی لیست.

فیلدها

dimensions[]

ListingGroupFilterDimension

مسیر کامل ابعاد از طریق سلسله مراتب فیلتر گروه لیست (به استثنای گره ریشه) به این فیلتر گروه لیست.

مکان یابی

نمای مکان خلاصه عملکرد کمپین ها توسط یک معیار موقعیت مکانی است.

فیلدها

resource_ name

string

نام منبع نمای مکان. نام منابع مشاهده مکان دارای فرم است:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

محصول

دسته مناقصه محصول.

فیلدها
`resource_ name`	`string` نام منابع دسته مناقصه محصول. نام منابع بخش مناقصه محصول فرم دارد: `productBiddingCategoryConstants/{country_code}~{level}~{id}`
`level`	`ProductBiddingCategoryLevel` سطح دسته مناقصه محصول.
`status`	`ProductBiddingCategoryStatus` وضعیت دسته مناقصه محصول.
`id`	`int64` شناسه دسته مناقصه محصول. این شناسه معادل شناسه Google_Product_Category است که در این مقاله شرح داده شده است: https://support.google.com/merchants/answer/6324436 .
`country_ code`	`string` کد کشور دو حرف بالا از گروه مناقصه محصول.
`product_ bidding_ category_ constant_ parent`	`string` نام منابع دسته مناقصه محصول والدین.
`language_ code`	`string` کد زبان دسته مناقصه محصول.
`localized_ name`	`string` ارزش نمایش دسته مناقصه محصول را مطابق با زبان_کد بومی سازی می کند.

ProductGroupView

نمای گروه محصول

فیلدها

resource_ name

string

نام منابع نمای گروه محصول. نام منابع نمایش گروه محصولات دارای فرم است:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

Searchads360field

یک زمینه یا منبع (Artifact) که توسط SearchADS360Service استفاده می شود.

فیلدها
`resource_ name`	`string` نام منبع آثار باستانی. نام منابع مصنوعی فرم دارد: `SearchAds360Fields/{name}`
`category`	`SearchAds360FieldCategory` دسته آثار باستانی.
`selectable_ with[]`	`string` نام کلیه منابع ، بخش ها و معیارهایی که با مصنوعات توصیف شده قابل انتخاب هستند.
`attribute_ resources[]`	`string` نام کلیه منابعی که با مصنوعات توصیف شده قابل انتخاب هستند. زمینه های این منابع معیارهای تقسیم نمی کنند که در نمایش داده های جستجو گنجانده شود. این زمینه فقط برای آثار باستانی تنظیم شده است که دسته آنها منبع است.
`metrics[]`	`string` در این قسمت نام تمام معیارهایی که با مصنوعات توصیف شده در هنگام استفاده در بند FROM قابل انتخاب هستند ، لیست می کند. این فقط برای آثار باستانی تنظیم شده است که دسته آنها منبع است.
`segments[]`	`string` در این قسمت نام همه آثار باستانی ، اعم از یک بخش یا منبع دیگر ، آن معیارهای بخش در هنگام نمایش داده های جستجو و هنگامی که از مصنوعات توصیف شده در بند FROM استفاده می شود ، ذکر شده است. این فقط برای آثار باستانی تنظیم شده است که دسته آنها منبع است.
`enum_ values[]`	`string` ارزش های مصنوعات می توانند فرض کنند که آیا این یک زمینه از نوع enum است. این قسمت فقط برای مصنوعات بخش دسته یا ویژگی تنظیم شده است.
`data_ type`	`SearchAds360FieldDataType` این زمینه اپراتورهایی را که می توان با مصنوعات در محل بندها استفاده کرد ، تعیین می کند.
`name`	`string` نام مصنوعات.
`selectable`	`bool` این که آیا مصنوعات می تواند در یک بند انتخابی در نمایش داده های جستجو استفاده شود.
`filterable`	`bool` آیا می توان از مصنوعات در یک بند جایی که در نمایش داده های جستجو استفاده می شود ، استفاده کرد.
`sortable`	`bool` این که آیا مصنوعات می تواند در یک بند به ترتیب در نمایش داده های جستجو استفاده شود.
`type_ url`	`string` URL Proto توصیف نوع داده Artifact.
`is_ repeated`	`bool` آیا مصنوعات میدانی تکرار می شود.

ShoppingPerformanceView

نمای عملکرد خرید. آمار تبلیغاتی خرید را در چندین سطح ابعاد محصول جمع می کند. مقادیر ابعاد محصول از مرکز بازرگان مانند برند ، دسته ، ویژگی های سفارشی ، شرایط محصول و نوع محصول ، وضعیت هر بعد را از تاریخ و زمان ثبت رویداد مربوطه منعکس می کند.

فیلدها

resource_ name

string

نام منابع نمای عملکرد خرید. عملکرد خرید نام منابع دارای فرم است: customers/{customer_id}/shoppingPerformanceView

لیست کاربر

یک لیست کاربر این لیستی از کاربرانی است که مشتری ممکن است هدف قرار دهد.

فیلدها
`resource_ name`	`string` نام منبع لیست کاربر. نام منابع لیست کاربر فرم دارد: `customers/{customer_id}/userLists/{user_list_id}`
`type`	`UserListType` نوع این لیست. این فیلد فقط خواندنی است.
`id`	`int64` شناسه لیست کاربر.
`name`	`string` نام این لیست کاربر. بسته به Access_Reason ، نام لیست کاربر ممکن است منحصر به فرد نباشد (برای مثال ، اگر Access_Reason = به اشتراک گذاشته شده)

userLocationView

نمای مکان کاربر

نمای مکان کاربر شامل کلیه معیارهای جمع شده در سطح کشور ، یک ردیف در هر کشور است. این معیارها را در محل فیزیکی واقعی کاربر توسط موقعیت مکانی هدفمند یا هدفمند گزارش می کند. در صورت استفاده از قسمتهای دیگر بخش ، ممکن است بیش از یک ردیف در هر کشور بدست آورید.

فیلدها

resource_ name

string

نام منبع نمای مکان کاربر. نام منابع مشاهده UserLocation فرم:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

country_ criterion_ id

int64

شناسه معیار برای کشور.

targeting_ location

bool

نشان می دهد که آیا مکان مورد هدف قرار گرفته است یا نه.

بازدید کنید

یک بازدید

فیلدها
`resource_ name`	`string` نام منبع بازدید. بازدید از نام منابع فرم: `customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}`
`id`	`int64` شناسه بازدید
`criterion_ id`	`int64` آگهی های جستجو 360 شناسه کلمه کلیدی. مقدار 0 نشان می دهد که کلمه کلیدی غیرقابل توزیع است.
`merchant_ id`	`int64` شناسه حساب موجودی ADS 360 حاوی محصولی که روی آن کلیک شده است. ADS ADS 360 هنگام پیوند یک حساب موجودی در تبلیغات 360 ، این شناسه را تولید می کند.
`ad_ id`	`int64` شناسه تبلیغاتی مقدار 0 نشان می دهد که AD غیر توزیع شده است.
`click_ id`	`string` یک رشته منحصر به فرد برای هر بازدید که به عنوان پارامتر URL Click ID به صفحه فرود منتقل می شود.
`visit_ date_ time`	`string` جدول زمانی رویداد بازدید. Timestamp در منطقه زمانی مشتری و در قالب "YYYYY-MM-DD HH: MM: SS" است.
`product_ id`	`string` شناسه محصول روی آن کلیک کرد.
`product_ channel`	`ProductChannel` کانال فروش محصولی که روی آن کلیک شده است: آنلاین یا محلی.
`product_ language_ code`	`string` این زبان (ISO-639-1) که برای فید مرکز بازرگان حاوی داده های مربوط به محصول تعیین شده است.
`product_ store_ id`	`string` فروشگاه موجود در آگهی موجودی محلی که روی آن کلیک شده است. این باید با شناسه های فروشگاه مورد استفاده در خوراک محصولات محلی شما مطابقت داشته باشد.
`product_ country_ code`	`string` کشور (فرمت ISO-3166) برای فید موجودی که شامل محصول کلیک شده است ، ثبت شده است.
`asset_ id`	`int64` شناسه دارایی که در طول رویداد بازدید با آن تعامل داشت.
`asset_ field_ type`	`AssetFieldType` نوع میدان دارایی رویداد بازدید.

صفحه وب

نمای صفحه وب.

فیلدها

resource_ name

string

نام منبع نمای صفحه وب. نام منابع مشاهده صفحه دارای فرم است:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}