نوع التقرير: 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	عبارات البحث التي أدخلها مستخدمو 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	نعم