نوع التقرير: paidAndMembership

يعرض تقرير نتائج البحث المدفوعة لا يعرض التقرير النتائج إلا إذا سبق لك إعداد تقرير "نتائج البحث المدفوعة والمجانية" لحساب محرّك البحث الذي تُبلغ عنه.

لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر 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 نعم