نوع گزارش: کلمه کلیدی

معیارهای عملکرد و ویژگی های پیکربندی برای کلمات کلیدی.

این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد 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	بله