يعرض تقرير المدفوعة، نتائج البحث المدفوعة عبارات البحث التي أدت إلى ظهور إعلاناتك على 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 |
عبارات البحث التي أدخلها مستخدمو Google. | سمة | String |
نعم |
serpType |
نوع نتيجة البحث التي نقر عليها مستخدمو Google. القيم المحتملة هي:
|
سمة | SERP type |
نعم |
paidClicks |
عدد مرات نقر أحد الأشخاص على إعلان بعد إدخال طلب البحث. | المقياس | Integer |
نعم |
organicClicks |
عدد النقرات على نتائج البحث غير المدفوعة لموقعك بعد إدخال أحد الأشخاص طلب البحث. | المقياس | Integer |
نعم |
paidAndOrganicClicks |
عدد النقرات على أحد إعلاناتك أو نتيجة بحث غير مدفوعة لموقعك بعد إدخال أحد الأشخاص طلب البحث. | المقياس | Integer |
نعم |
paidImpressions |
عدد مرات ظهور الإعلان على صفحة نتائج البحث أو على موقع ويب في شبكة Google بعد أن يدخل شخص ما طلب البحث. | المقياس | Integer |
نعم |
organicQueries |
إجمالي عدد المرات التي أدخل فيها المستخدمون طلب البحث وشاهدوا نتيجة بحث مجانية واحدة على الأقل من موقعك. | المقياس | Integer |
نعم |
paidAndOrganicQueries |
إجمالي عدد مرات إدخال المستخدمين لاستعلام البحث ومشاهدة إعلان واحد على الأقل من إعلاناتك أو نتيجة بحث مجانية واحدة على الأقل من موقعك. | المقياس | Integer |
نعم |
paidCtr |
نسبة النقر إلى الظهور للإعلان، والتي تمثل عدد المرات التي ينقر فيها الأشخاص على إعلانك بعد مشاهدته وذلك بعد إدخال طلب البحث. | المقياس | Number |
نعم |
organicCtr |
هو معدّل نقر المستخدمين على نتائج بحث غير مدفوعة ووصولهم إلى موقعك الإلكتروني عند ظهور نتائج البحث غير المدفوعة لموقعك الإلكتروني. | المقياس | Number |
نعم |
paidAndOrganicCtr |
هو معدّل نقر المستخدمين على أحد إعلاناتك أو نتيجة بحث غير مدفوعة على موقعك الإلكتروني وينتهي الأمر بالنقر على أيٍّ منهما والانتقال إلى موقعك الإلكتروني. | المقياس | Number |
نعم |
paidAvgPos |
متوسط موضع الإعلان الذي يظهر فيه الإعلان بعد إدخال أحد الأشخاص طلب البحث. | المقياس | 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 |
نعم |