- نمایندگی JSON
- AdGroupCriterionStatus
- QualityInfo
- CriterionSystemServingStatus
- AdGroupCriterionApprovalStatus
- تخمین موقعیت
- ListingGroupInfo
- ListingGroupType
- ListingDimensionPath
- AppPaymentModelInfo
- AppPaymentModelType
- CustomIntentInfo
یک معیار گروه تبلیغاتی گزارش adGroupCriterion فقط معیارهایی را برمیگرداند که به صراحت به گروه آگهی اضافه شدهاند.
نمایندگی JSON |
---|
{ "resourceName": string, "displayName": string, "status": enum ( |
زمینه های | |
---|---|
resourceName | تغییرناپذیر. نام منبع معیار گروه آگهی. نام منابع معیار گروه تبلیغات به شکل زیر است: |
displayName | فقط خروجی نام نمایشی معیار. این فیلد برای جهش نادیده گرفته می شود. |
status | وضعیت معیار. این وضعیت موجودیت معیار گروه آگهی است که توسط مشتری تنظیم شده است. توجه: گزارشهای UI ممکن است حاوی اطلاعات بیشتری باشد که بر واجد شرایط بودن یک معیار برای اجرا تأثیر میگذارد. در برخی موارد، معیاری که در API حذف شده است همچنان میتواند در رابط کاربری فعال نشان داده شود. به عنوان مثال، کمپینها بهطور پیشفرض به کاربران در تمام محدودههای سنی نشان داده میشوند، مگر اینکه حذف شوند. رابط کاربری هر محدوده سنی را به عنوان "فعال" نشان می دهد، زیرا آنها واجد شرایط دیدن تبلیغات هستند. اما AdGroupCriterion.status "حذف شده" را نشان می دهد، زیرا هیچ معیار مثبتی اضافه نشده است. |
qualityInfo | فقط خروجی اطلاعات مربوط به کیفیت معیار. |
type | فقط خروجی نوع معیار. |
systemServingStatus | فقط خروجی وضعیت خدمت معیار. |
approvalStatus | فقط خروجی وضعیت تایید معیار. |
disapprovalReasons[] | فقط خروجی فهرست دلایل عدم تایید معیار. دلایل مختلف برای رد کردن یک معیار را میتوانید در اینجا پیدا کنید: https://support.google.com/adspolicy/answer/6008942 این فیلد فقط خواندنی است. |
labels[] | فقط خروجی نام منابع برچسب های پیوست شده به این معیار گروه تبلیغاتی. |
effectiveCpcBidSource | فقط خروجی منبع پیشنهاد CPC موثر. |
effectiveCpmBidSource | فقط خروجی منبع پیشنهاد CPM موثر. |
effectiveCpvBidSource | فقط خروجی منبع پیشنهاد CPV موثر. |
effectivePercentCpcBidSource | فقط خروجی منبع پیشنهاد درصد CPC موثر. |
positionEstimates | فقط خروجی تخمین پیشنهادهای معیار در موقعیت های مختلف. |
finalUrls[] | لیست URL های نهایی ممکن پس از همه تغییر مسیرهای بین دامنه ای برای تبلیغ. |
finalMobileUrls[] | فهرست آدرسهای اینترنتی نهایی تلفن همراه پس از همه تغییر مسیرهای بین دامنهای. |
urlCustomParameters[] | فهرست نگاشتهایی که برای جایگزینی برچسبهای پارامتر سفارشی در |
criterionId | فقط خروجی شناسه معیار. این فیلد برای جهش نادیده گرفته می شود. |
adGroup | تغییرناپذیر. گروه تبلیغاتی که معیار به آن تعلق دارد. |
negative | تغییرناپذیر. آیا برای هدف قرار دادن ( این میدان تغییر ناپذیر است. برای تغییر یک معیار از مثبت به منفی، آن را حذف کنید و دوباره اضافه کنید. |
bidModifier | اصلاح کننده پیشنهاد زمانی که معیار مطابقت دارد. اصلاح کننده باید در محدوده: 0.1 - 10.0 باشد. بیشتر انواع معیارهای قابل هدف از اصلاح کننده ها پشتیبانی می کنند. |
cpcBidMicros | پیشنهاد CPC (هزینه به ازای هر کلیک). |
cpmBidMicros | پیشنهاد CPM (هزینه به ازای هر هزار نمایش قابل مشاهده). |
cpvBidMicros | پیشنهاد CPV (هزینه به ازای هر بازدید). |
percentCpcBidMicros | مبلغ پیشنهادی CPC، که به عنوان کسری از قیمت اعلام شده برای برخی کالاها یا خدمات بیان می شود. محدوده معتبر برای کسری [0،1) است و مقدار ذخیره شده در اینجا 1,000,000 * [کسری] است. |
effectiveCpcBidMicros | فقط خروجی پیشنهاد CPC موثر (هزینه به ازای هر کلیک). |
effectiveCpmBidMicros | فقط خروجی پیشنهاد CPM موثر (هزینه به ازای هر هزار نمایش قابل مشاهده). |
effectiveCpvBidMicros | فقط خروجی پیشنهاد CPV موثر (هزینه به ازای هر بازدید). |
effectivePercentCpcBidMicros | فقط خروجی مبلغ پیشنهادی درصد CPC موثر. |
finalUrlSuffix | الگوی URL برای الحاق پارامترها به URL نهایی. |
trackingUrlTemplate | الگوی URL برای ساخت URL ردیابی. |
دقیقاً یکی باید تنظیم شود. | |
keyword | تغییرناپذیر. کلمه کلیدی. |
placement | تغییرناپذیر. تعیین سطح. |
mobileAppCategory | تغییرناپذیر. دسته برنامه موبایل |
mobileApplication | تغییرناپذیر. اپلیکیشن موبایل. |
listingGroup | تغییرناپذیر. گروه لیست. |
ageRange | تغییرناپذیر. رده سنی. |
gender | تغییرناپذیر. جنسیت. |
incomeRange | تغییرناپذیر. محدوده درآمد |
parentalStatus | تغییرناپذیر. وضعیت والدین. |
userList | تغییرناپذیر. فهرست کاربران. |
youtubeVideo | تغییرناپذیر. ویدیوی یوتیوب. |
youtubeChannel | تغییرناپذیر. کانال یوتیوب. |
topic | تغییرناپذیر. موضوع. |
userInterest | تغییرناپذیر. علاقه کاربر |
webpage | تغییرناپذیر. صفحه وب |
appPaymentModel | تغییرناپذیر. مدل پرداخت اپلیکیشن |
customAffinity | تغییرناپذیر. وابستگی سفارشی. |
customIntent | تغییرناپذیر. هدف سفارشی. |
customAudience | تغییرناپذیر. مخاطب سفارشی |
combinedAudience | تغییرناپذیر. مخاطب ترکیبی |
audience | تغییرناپذیر. حضار. |
location | تغییرناپذیر. محل. |
language | تغییرناپذیر. زبان. |
AdGroupCriterionStatus
وضعیت های ممکن یک AdGroupCriterion.
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
ENABLED | معیار گروه آگهی فعال است. |
PAUSED | معیار گروه آگهی متوقف شده است. |
REMOVED | معیار گروه آگهی حذف شده است. |
QualityInfo
ظرفی برای اطلاعات کیفیت معیار گروه آگهی.
نمایندگی JSON |
---|
{ "creativeQualityScore": enum ( |
زمینه های | |
---|---|
creativeQualityScore | فقط خروجی عملکرد تبلیغ در مقایسه با سایر تبلیغ کنندگان. |
postClickQualityScore | فقط خروجی امتیاز کیفیت صفحه فرود. |
searchPredictedCtr | فقط خروجی نرخ کلیک در مقایسه با سایر تبلیغ کنندگان. |
qualityScore | فقط خروجی نمره کیفیت. اگر Google اطلاعات کافی برای تعیین مقدار نداشته باشد، ممکن است این فیلد پر نشود. |
CriterionSystemServingStatus
وضعیت های سرویس دهی سیستم معیار را برمی شمارد.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | مقدار در این نسخه ناشناخته است. |
ELIGIBLE | واجد شرایط |
RARELY_SERVED | حجم کم جستجو |
AdGroupCriterionApprovalStatus
وضعیت های تأیید AdGroupCriterion را برمی شمارد.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | مقدار در این نسخه ناشناخته است. |
APPROVED | تایید شده. |
DISAPPROVED | تایید نشد. |
PENDING_REVIEW | بررسی در انتظار. |
UNDER_REVIEW | در دست بررسی. |
تخمین موقعیت
تخمین پیشنهادهای معیار در موقعیت های مختلف.
نمایندگی JSON |
---|
{ "firstPageCpcMicros": string, "firstPositionCpcMicros": string, "topOfPageCpcMicros": string, "estimatedAddClicksAtFirstPositionCpc": string, "estimatedAddCostAtFirstPositionCpc": string } |
زمینه های | |
---|---|
firstPageCpcMicros | فقط خروجی تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در صفحه اول نتایج جستجو. |
firstPositionCpcMicros | فقط خروجی تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در موقعیت اول، در بالای صفحه اول نتایج جستجو. |
topOfPageCpcMicros | فقط خروجی تخمین پیشنهاد CPC مورد نیاز برای نمایش آگهی در بالای صفحه اول نتایج جستجو. |
estimatedAddClicksAtFirstPositionCpc | فقط خروجی تخمین بزنید که با تغییر پیشنهاد کلمه کلیدی خود به مقدار در firstPositionCpcMicros، چند کلیک در هفته ممکن است داشته باشید. |
estimatedAddCostAtFirstPositionCpc | فقط خروجی زمانی که پیشنهاد کلمه کلیدی خود را به مقدار در firstPositionCpcMicros تغییر میدهید، هزینههای شما در هفته چگونه ممکن است تغییر کند. |
ListingGroupInfo
یک معیار گروه فهرست بندی
نمایندگی JSON |
---|
{ "type": enum ( |
زمینه های | |
---|---|
type | نوع گروه لیست |
caseValue | مقدار ابعادی که این گروه فهرستبندی با آن والد خود را اصلاح میکند. برای گروه ریشه تعریف نشده است. |
parentAdGroupCriterion | نام منبع معیار گروه آگهی که زیربخش گروه فهرست والد است. تهی برای گروه ریشه. |
path | مسیر ابعادی که این گروه فهرست را تعریف می کند. |
ListingGroupType
نوع گروه فهرست.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
SUBDIVISION | تقسیم بندی محصولات در امتداد برخی از ابعاد فهرست بندی. این گره ها با ارائه خدمات برای ورودی های فهرست بندی مورد استفاده قرار نمی گیرند، بلکه صرفاً برای تعریف ساختار درخت هستند. |
UNIT | فهرست کردن واحد گروه که یک پیشنهاد را تعریف می کند. |
ListingDimensionPath
مسیر ابعادی که یک گروه فهرست را تعریف می کند.
نمایندگی JSON |
---|
{
"dimensions": [
{
object ( |
زمینه های | |
---|---|
dimensions[] | مسیر کامل ابعاد از طریق سلسله مراتب گروه لیست، از ریشه (به استثنای خود ریشه) تا این گروه فهرست. |
AppPaymentModelInfo
معیار مدل پرداخت اپلیکیشن
نمایندگی JSON |
---|
{
"type": enum ( |
زمینه های | |
---|---|
type | نوع مدل پرداخت اپلیکیشن |
AppPaymentModelType
Enum مدلهای پرداخت احتمالی برنامه را توصیف میکند.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
PAID | نشان دهنده برنامه های پولی است. |
CustomIntentInfo
یک معیار قصد سفارشی معیاری از این نوع فقط قابل هدف است.
نمایندگی JSON |
---|
{ "customIntent": string } |
زمینه های | |
---|---|
customIntent | نام منبع CustomInterest. |