گزارش payAndOrganic عبارات جستجویی را نشان می دهد که یا باعث نمایش تبلیغات شما در Google شده است، یا Google را برای نمایش نتایج جستجوی بدون پرداخت (ارگانیک) برای سایت شما یا هر دو تحریک می کند. این گزارش تنها در صورتی نتایج را برمیگرداند که قبلاً گزارش پرداختی و ارگانیک را برای حساب موتوری که در آن گزارش میدهید تنظیم کرده باشید.
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.
درخواست گزیده
یک بدنه درخواست عادی Reports.request() ارسال کنید، اما "reportType": "paidAndOrganic"
.
{ ... "reportType": "paidAndOrganic", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName
فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.
columnName | توضیحات | رفتار | تایپ کنید | قابل فیلتر کردن |
---|---|---|---|---|
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 | بله |
searchQuery | عبارات جستجویی که کاربران گوگل وارد کرده اند. | ویژگی | String | بله |
serpType | نوع نتیجه جستجویی که کاربران گوگل روی آن کلیک کردند. مقادیر ممکن عبارتند از:
| ویژگی | SERP type | بله |
paidClicks | تعداد دفعاتی که شخصی پس از وارد کردن SearchQuery روی تبلیغ کلیک کرده است. | متریک | Integer | بله |
organicClicks | تعداد کلیکهایی که روی نتایج جستجوی پرداخت نشده برای سایت شما پس از ورود شخصی به SearchQuery انجام میشود. | متریک | Integer | بله |
paidAndOrganicClicks | تعداد کلیکهایی که روی یکی از آگهیهای تبلیغاتی شما یا یک نتیجه جستجوی پرداخت نشده برای سایت شما پس از وارد شدن شخصی به SearchQuery انجام شده است. | متریک | Integer | بله |
paidImpressions | تعداد دفعاتی که یک تبلیغ در صفحه نتایج جستجو یا در یک وب سایت در شبکه Google ظاهر می شود پس از اینکه شخصی وارد SearchQuery شد. | متریک | Integer | بله |
organicQueries | تعداد کل دفعاتی که کاربران وارد SearchQuery شده اند و حداقل یک نتیجه جستجوی ارگانیک را از سایت شما دیده اند. | متریک | Integer | بله |
paidAndOrganicQueries | تعداد کل دفعاتی که کاربران وارد SearchQuery شده اند و حداقل یکی از تبلیغات شما یا حداقل یک نتیجه جستجوی ارگانیک را از سایت شما دیده اند. | متریک | Integer | بله |
paidCtr | نرخ کلیک برای یک تبلیغ، یعنی اغلب افرادی که تبلیغ شما را می بینند پس از وارد شدن به SearchQuery روی آن کلیک می کنند. | متریک | Number | بله |
organicCtr | نرخی که افرادی که نتایج جستجوی بدون پرداخت را برای سایت شما می بینند، در نهایت روی یک نتیجه پرداخت نشده کلیک می کنند و در سایت شما فرود می آیند. | متریک | Number | بله |
paidAndOrganicCtr | نرخی که افرادی که یکی از تبلیغات شما یا یک نتیجه جستجوی بدون پرداخت را برای سایت شما می بینند، در نهایت روی هر کدام کلیک کرده و در سایت شما فرود می آیند. | متریک | Number | بله |
paidAvgPos | میانگین موقعیتی که در آن تبلیغ پس از وارد شدن شخصی به SearchQuery نمایش داده می شود. | متریک | Number | بله |
organicAvgPos | میانگین موقعیت بالای نتایج جستجوی بدون پرداخت برای سایت شما. | متریک | Number | بله |
paidCostPerClick | میانگین هزینه هر کلیک برای یک تبلیغ. این میانگین مبلغی است که هر بار که شخصی روی تبلیغ شما کلیک می کند پرداخت می کنید. | متریک | Money | بله |
date | گزارش را بر اساس روز تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر روز. این ستون تاریخ هر سطر را برمی گرداند. | بخش | Date | بله |
monthStart | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون اولین روز ماه هر ردیف را برمی گرداند. | بخش | Date | بله |
monthEnd | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون آخرین روز ماه هر ردیف را برمی گرداند. | بخش | Date | بله |
quarterStart | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون اولین روز از یک چهارم هر ردیف را برمی گرداند. | بخش | Date | بله |
quarterEnd | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون آخرین روز از یک چهارم هر سطر را برمی گرداند. | بخش | Date | بله |
weekStart | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون اولین روز (یکشنبه) هر ردیف را برمی گرداند. | بخش | Date | بله |
weekEnd | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون آخرین روز (شنبه) هر ردیف را برمی گرداند. | بخش | Date | بله |
yearStart | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون اولین روز سال هر سطر را برمی گرداند. | بخش | Date | بله |
yearEnd | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون آخرین روز سال هر سطر را برمی گرداند. | بخش | Date | بله |
campaign | گزارش را بر اساس کمپین تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر کمپین در محدوده گزارش. این ستون نام کمپین را برمی گرداند. | بخش | String | بله |
campaignId | گزارش را بر اساس کمپین تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر کمپین در محدوده گزارش. این ستون شناسه کمپین DS را برمی گرداند. | بخش | ID | بله |
adGroup | گزارش را بر اساس گروه تبلیغاتی تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر گروه تبلیغاتی در محدوده گزارش. این ستون نام گروه تبلیغاتی را برمی گرداند. | بخش | String | بله |
adGroupId | گزارش را بر اساس گروه تبلیغاتی تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر گروه تبلیغاتی در محدوده گزارش. این ستون شناسه گروه تبلیغات DS را برمی گرداند. | بخش | ID | بله |
keywordId | گزارش را بر اساس کلمه کلیدی تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر کلمه کلیدی در محدوده گزارش. این ستون شناسه کلمه کلیدی DS را برمی گرداند. | بخش | ID | بله |
keywordMatchType | گزارش را بر اساس کلمه کلیدی تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر کلمه کلیدی در محدوده گزارش. این ستون نوع مطابقت کلمه کلیدی را برمی گرداند. | بخش | Match type | بله |
keywordText | گزارش را بر اساس کلمه کلیدی تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر کلمه کلیدی در محدوده گزارش. این ستون متن کلمه کلیدی را برمی گرداند. | بخش | String | بله |