Package google.ads.searchads360.v0.resources

شاخص

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 ممکن برای بودجه خواهد بود.

MaximizeConversions

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

فیلدها
target_cpa

int64

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

target_cpa_micros

int64

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

TargetCpa

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

فیلدها
target_cpa_micros

int64

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

TargetImpressionShare

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

فیلدها
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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

TargetRoas

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

فیلدها
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

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

یک آگهی

فیلدها
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

نام منابع برچسب های پیوست شده به این آگهی گروه تبلیغاتی.

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" است.

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}

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

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

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 مورد نیاز برای نمایش آگهی در بالای صفحه اول نتایج جستجو.

QualityInfo

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

فیلدها
quality_score

int32

نمره کیفیت.

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

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}

دارایی

دارایی بخشی از یک تبلیغ است که می تواند در چندین آگهی به اشتراک گذاشته شود. این می تواند یک تصویر (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

دارایی فراخوانی یکپارچه.

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

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

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

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

AssetSet

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

فیلدها
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 های تبلیغاتی به طور انحصاری استفاده می کند.

Geotargettypesetting

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

فیلدها
positive_geo_target_type

PositiveGeoTargetType

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

negative_geo_target_type

NegativeGeoTargetType

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

شبکه ها

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

فیلدها
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

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

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

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

فیلدها
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 مورد استفاده برای ردیابی پویا.

کمپین

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

فیلدها
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}/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

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

تبدیل

یک عمل تبدیل

فیلدها
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 متغیرهای سفارشی تبدیل FLEODLIGHT.

فیلدها
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

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

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 = به اشتراک گذاشته شده)

بازدید کنید

یک بازدید

فیلدها
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}