گزارش 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 | آره |