معیارهای عملکرد و ویژگی های پیکربندی برای کلمات کلیدی.
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.
درخواست گزیده
یک بدنه درخواستی معمولی Reports.request() ارسال کنید، اما "reportType": "keyword"
را مشخص کنید.
{ ... "reportType": "keyword", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName
فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.
columnName | شرح | رفتار - اخلاق | تایپ کنید | قابل فیلتر کردن |
---|---|---|---|---|
status | وضعیت کلمه کلیدی: Active ، Paused ، یا Removed . توجه داشته باشید که کمپین ها، گروه های تبلیغاتی، کلمات کلیدی و تبلیغات هر کدام وضعیت خاص خود را دارند. وضعیت را ببینید. | صفت | Status | آره |
engineStatus | وضعیت اضافی کلمه کلیدی در حساب موتور خارجی. وضعیتهای احتمالی (بسته به نوع حساب خارجی) شامل criterion rarely served ، criterion below first page bid ، criterion low quality score ، review ، campaign paused و غیره است. | صفت | String | آره |
creationTimestamp | مهر زمانی ایجاد کلمه کلیدی، فرمت شده در ISO 8601. | صفت | Timestamp | آره |
lastModifiedTimestamp | مهر زمانی آخرین تغییر کلمه کلیدی، فرمت شده در ISO 8601. | صفت | Timestamp | آره |
agency | نام آژانس | صفت | String | آره |
agencyId | شناسه نمایندگی DS. | صفت | ID | آره |
advertiser | نام تبلیغ کننده | صفت | String | آره |
advertiserId | شناسه تبلیغ کننده DS. | صفت | ID | آره |
account | نام حساب موتور | صفت | String | آره |
accountId | شناسه حساب موتور DS. | صفت | ID | آره |
accountEngineId | شناسه حساب در حساب موتور خارجی. | صفت | String | آره |
accountType | نوع حساب موتور: Google AdWords ، Bing Ads ، Yahoo Japan Listing Ads ، Yahoo Search Marketing ، Yahoo Gemini ، Baidu ، یا Comparison Shopping . | صفت | Engine type | آره |
campaign | نام کمپین. | صفت | String | آره |
campaignId | شناسه کمپین DS. | صفت | ID | آره |
campaignStatus | وضعیت کمپین حاوی این مورد. | صفت | Status | آره |
adGroup | نام گروه تبلیغاتی | صفت | String | آره |
adGroupId | شناسه گروه تبلیغات DS. | صفت | ID | آره |
adGroupStatus | وضعیت گروه تبلیغاتی حاوی این مورد. | صفت | Status | آره |
keywordId | شناسه کلمه کلیدی DS. مقدار 0 نشان می دهد که کلمه کلیدی نسبت داده نشده است. | صفت | ID | آره |
keywordMatchType | نوع تطابق کلمه کلیدی: Broad ، Exact ، Phrase یا Content . | صفت | Match type | آره |
keywordText | متن کلمه کلیدی | صفت | String | آره |
keywordEngineId | شناسه کلمه کلیدی در حساب موتور خارجی. | صفت | ID | آره |
keywordMaxCpc | حداکثر CPC گروه تبلیغات را لغو میکند و حداکثر مبلغی را تعیین میکند که اگر فردی روی تبلیغی برای این کلمه کلیدی خاص کلیک کند، مایل به پرداخت آن هستید. اگر این قسمت خالی باشد، کلمه کلیدی از حداکثر CPC گروه تبلیغاتی استفاده می کند. | صفت | Money | آره |
effectiveKeywordMaxCpc | حداکثر CPC (حداکثر هزینه به ازای هر کلیک) که برای این کلمه کلیدی وجود دارد. این مقدار یا همان مقدار حداکثر CPC گروه تبلیغات خواهد بود یا، اگر کلمه کلیدی بر تنظیم گروه تبلیغاتی غلبه کند، حداکثر CPC خود کلمه کلیدی خواهد بود. | صفت | Money | آره |
keywordLandingPage | URL نهایی که کاربر پس از کلیک بر روی تبلیغ شما از آن بازدید می کند. به نشانیهای اینترنتی صفحه فرود و سرور کلیک مراجعه کنید. | صفت | String | آره |
keywordClickserverUrl | URL که DS برای ردیابی فعالیت استفاده می کند. کاربری که روی یک تبلیغ کلیک می کند ابتدا از URL سرور کلیک بازدید می کند و سپس به صفحه فرود نهایی هدایت می شود. به نشانیهای اینترنتی صفحه فرود و سرور کلیک مراجعه کنید. | صفت | String | آره |
isDisplayKeyword | نشان می دهد که آیا این یک کلمه کلیدی نگهدارنده مکان است که برای نمایش و گزارش قرار دادن استفاده می شود. | صفت | Boolean | آره |
keywordMaxBid | اگر این کلمه کلیدی توسط یک استراتژی پیشنهادی DS مدیریت شود، استراتژی پیشنهادی هرگز قیمتها را بالاتر از این حد نخواهد کرد. به اعمال استراتژی پیشنهاد برای کلمات کلیدی مراجعه کنید. | صفت | Money | آره |
keywordMinBid | اگر این کلمه کلیدی توسط یک استراتژی پیشنهادی DS مدیریت شود، استراتژی پیشنهاد قیمت هرگز قیمت ها را کمتر از این حد نخواهد کرد. به اعمال استراتژی پیشنهاد برای کلمات کلیدی مراجعه کنید. | صفت | Money | آره |
keywordUrlParams | پارامترهای URL اضافی به صفحه فرود اضافه شده است. به افزودن پارامترهای URL مراجعه کنید. | صفت | String | آره |
bingKeywordParam2 | Param2 یک کلمه کلیدی تبلیغات بینگ. | صفت | String | آره |
bingKeywordParam3 | Param3 یک کلمه کلیدی تبلیغات بینگ. | صفت | String | آره |
keywordLabels | نام برچسب هایی که مستقیماً به این کلمه کلیدی اختصاص داده شده است. برچسب های ارثی شامل نمی شوند. | صفت | String list | آره |
qualityScoreCurrent | فقط تبلیغات گوگل و تبلیغات بینگ. جدیدترین مقدار امتیاز کیفیت موتور (QS) برای یک کلمه کلیدی. توجه داشته باشید که این ستون همیشه آخرین QS را برای یک کلمه کلیدی بدون در نظر گرفتن محدوده زمانی گزارش گزارش می دهد. | صفت | Integer | آره |
topOfPageBidCurrent | فقط تبلیغات گوگل قیمت پیشنهادی فعلی CPC مورد نیاز برای نمایش منظم آگهی شما در موقعیت های بالای نتایج جستجو را تقریبی می کند. توجه داشته باشید که این ستون همیشه CPC مورد نیاز را بدون توجه به محدوده زمانی گزارش گزارش میکند. | صفت | Money | آره |
effectiveBidStrategyId | شناسه DS استراتژی پیشنهادی که به این نهاد اختصاص داده شده است یا توسط این نهاد به ارث رسیده است. | صفت | ID | آره |
effectiveBidStrategy | نام استراتژی پیشنهادی که به این نهاد اختصاص داده شده است، یا توسط این نهاد به ارث رسیده است. | صفت | String | آره |
bidStrategyInherited | نشان می دهد که آیا استراتژی پیشنهادی این نهاد به ارث رسیده است یا خیر. | صفت | Boolean | آره |
effectiveLabels | نام تمام برچسبهای به ارث رسیده یا مستقیماً به این کلمه کلیدی اختصاص داده شده است. | صفت | String list | آره |
dfaActions | تعداد کل اقدامات مدیر کمپین. | متریک | Integer | آره |
dfaRevenue | مجموع درآمد حاصل از معاملات مدیر کمپین. | متریک | Money | آره |
dfaTransactions | تعداد کل تراکنش های مدیریت کمپین. | متریک | Integer | آره |
dfaWeightedActions | مجموع وزنی اقدامات مدیر کمپین. | متریک | Number | آره |
dfaActionsCrossEnv | تعداد کل اقدامات مدیر کمپین بین محیطی. | متریک | Number | آره |
dfaRevenueCrossEnv | مجموع درآمد حاصل از معاملات بین محیطی مدیر کمپین. | متریک | Money | آره |
dfaTransactionsCrossEnv | تعداد کل تراکنش های بین محیطی مدیر کمپین. | متریک | Number | آره |
dfaWeightedActionsCrossEnv | مجموع وزنی اقدامات بین محیطی مدیر کمپین. | متریک | Number | آره |
avgCpc | میانگین هزینه هر کلیک | متریک | Money | آره |
avgCpm | هزینه متوسط به ازای هر هزار نمایش | متریک | Money | آره |
avgPos | موقعیت متوسط. | متریک | Number | آره |
clicks | کل کلیک ها | متریک | Integer | آره |
cost | هزینه کل پرداخت شده به حساب(های) موتور. | متریک | Money | آره |
ctr | میانگین نرخ کلیک. | متریک | Number | آره |
impr | تعداد کل برداشت ها | متریک | Integer | آره |
adWordsConversions | دادههایی که تبلیغکننده تنظیم کرده است تا در ستون Google Ads Conversions گزارش شوند. وقتی یک کنش تبدیل Google Ads ایجاد میشود، تبلیغکننده میتواند انتخاب کند که آیا این تبدیلها را در ستون گزارش تبدیل شمارش کند یا خیر . | متریک | Number | آره |
adWordsConversionValue | ارزش کل تبدیلهای Google Ads. | متریک | Number | آره |
adWordsViewThroughConversions | تعداد کل تبدیلهای تبلیغاتی Google Ads از طریق بازدید. | متریک | Integer | آره |
visits | تعداد کل بازدیدهای DS. | متریک | Integer | آره |
qualityScoreAvg | فقط تبلیغات گوگل و تبلیغات بینگ. میانگین وزنی نمایش نمره کیفیت موتور (QS) در تمام روزها و کلمات کلیدی در محدوده گزارش. | متریک | Number | آره |
topOfPageBidAvg | فقط تبلیغات گوگل میانگین پیشنهاد CPC مورد نیاز در طول بازه زمانی گزارش برای نمایش منظم تبلیغات شما در موقعیتهای بالای نتایج جستجو را تقریبی میکند. | متریک | Money | آره |
date | گزارش را بر اساس روز تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر روز. این ستون تاریخ هر سطر را برمی گرداند. | بخش | Date | آره |
monthStart | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون اولین روز ماه هر ردیف را برمی گرداند. | بخش | Date | آره |
monthEnd | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون آخرین روز ماه هر ردیف را برمی گرداند. | بخش | Date | آره |
quarterStart | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون اولین روز از یک چهارم هر ردیف را برمی گرداند. | بخش | Date | آره |
quarterEnd | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون آخرین روز از یک چهارم هر سطر را برمی گرداند. | بخش | Date | آره |
weekStart | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون اولین روز (یکشنبه) هر ردیف را برمی گرداند. | بخش | Date | آره |
weekEnd | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون آخرین روز (شنبه) هر ردیف را برمی گرداند. | بخش | Date | آره |
yearStart | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون اولین روز سال هر سطر را برمی گرداند. | بخش | Date | آره |
yearEnd | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون آخرین روز سال هر سطر را برمی گرداند. | بخش | Date | آره |
deviceSegment | گزارش را بر اساس دستگاه تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر بخش دستگاه. این ستون قطعه دستگاه هر ردیف را برمی گرداند. | بخش | Device segment | آره |
floodlightGroup | گزارش را بر اساس گروه های Floodlight تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر گروه Floodlight. این ستون نام گروه Floodlight هر ردیف را برمی گرداند. توجه داشته باشید که برخی از معیارها دارای مقادیر تقسیمبندی شده Floodlight نیستند، مانند کلیکها و بازدیدها. | بخش | String | آره |
floodlightGroupId | گزارش را بر اساس گروه های Floodlight تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر گروه Floodlight. این ستون شناسه گروه DS Floodlight هر ردیف را برمی گرداند. توجه داشته باشید که برخی از معیارها دارای مقادیر تقسیمبندی شده Floodlight نیستند، مانند کلیکها و بازدیدها. | بخش | ID | آره |
floodlightGroupTag | گزارش را بر اساس گروه های Floodlight تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر گروه Floodlight. این ستون تگ گروه Floodlight هر ردیف را برمی گرداند. توجه داشته باشید که برخی از معیارها دارای مقادیر تقسیمبندی شده Floodlight نیستند، مانند کلیکها و بازدیدها. | بخش | String | آره |
floodlightActivity | گزارش را بر اساس فعالیت های Floodlight تقسیم می کند. هر ردیف و معیارهای انبوه آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر فعالیت Floodlight. این ستون نام فعالیت Floodlight هر ردیف را برمی گرداند. توجه داشته باشید که برخی از معیارها دارای مقادیر تقسیمبندی شده Floodlight نیستند، مانند کلیکها و بازدیدها. | بخش | String | آره |
floodlightActivityId | گزارش را بر اساس فعالیت های Floodlight تقسیم می کند. هر ردیف و معیارهای انبوه آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر فعالیت Floodlight. این ستون شناسه فعالیت DS Floodlight هر ردیف را برمی گرداند. توجه داشته باشید که برخی از معیارها دارای مقادیر تقسیمبندی شده Floodlight نیستند، مانند کلیکها و بازدیدها. | بخش | ID | آره |
floodlightActivityTag | گزارش را بر اساس فعالیت های Floodlight تقسیم می کند. هر ردیف و معیارهای انبوه آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر فعالیت Floodlight. این ستون تگ فعالیت Floodlight هر ردیف را برمی گرداند. توجه داشته باشید که برخی از معیارها دارای مقادیر تقسیمبندی شده Floodlight نیستند، مانند کلیکها و بازدیدها. | بخش | String | آره |
ad | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون نام آگهی را در هر ردیف برمی گرداند. | بخش | String | آره |
adId | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون شناسه DS آگهی را در هر ردیف برمی گرداند. | بخش | ID | آره |
isUnattributedAd | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون نشان می دهد که آیا معیارهای موجود در این ردیف به یک آگهی خاص قابل انتساب نیستند. | بخش | Boolean | آره |
adHeadline | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون عنوان آگهی را در هر ردیف برمی گرداند. | بخش | String | آره |
adHeadline2 | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون عنوان 2 آگهی را در هر ردیف برمی گرداند. برای برخی از موتورها موجود نیست. | بخش | String | آره |
adHeadline3 | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون عنوان 3 آگهی را در هر ردیف برمی گرداند. برای برخی از موتورها موجود نیست. | بخش | String | آره |
adDescription1 | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون، خط توضیحات 1 آگهی را در هر ردیف برمی گرداند. | بخش | String | آره |
adDescription2 | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون شرح خط 2 تبلیغ را در هر ردیف برمی گرداند. | بخش | String | آره |
adDisplayUrl | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون نشانی وب نمایش آگهی را در هر ردیف برمی گرداند. | بخش | String | آره |
adLandingPage | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون صفحه فرود آگهی را در هر ردیف برمی گرداند. | بخش | String | آره |
adType | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون نوع تبلیغ را در هر ردیف برمی گرداند: Text یا Product . | بخش | Ad type | آره |
adPromotionLine | بخش بندی گزارش بر اساس تبلیغات؛ هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر آگهی. این ستون، خط تبلیغاتی تبلیغ محصول را در هر ردیف برمیگرداند. | بخش | String | آره |