نوع التقرير: كلمة رئيسية

مقاييس الأداء وسمات الإعداد للكلمات الرئيسية

لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر Reports.request()).

طلب مقتطف

إرسال رسالة عادية Reports.request() نص الطلب، ولكن يجب تحديد "reportType": "keyword".

{
...
  "reportType": "keyword",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

لكلّ عمود تريد عرضه أو فلترته في التقرير حدِّد columnName المدرَجة في الجدول أدناه. يمكنك أيضًا تحديد headerText، startDate, وendDate. وتجدر الإشارة إلى أنّه لا يمكن فلترة بعض الأعمدة. راجِع القسم "قابل للفلترة" في الجدول أدناه.

columnName	الوصف	السلوك	النوع	قابلة للفلترة
status	حالة الكلمة الرئيسية: Active أو Paused أو Removed. يُرجى العلم بأنّ لكل حملة والمجموعات الإعلانية والكلمات الرئيسية والإعلانات حالتها الخاصة. راجِع الحالة.	سمة	Status	نعم
engineStatus	حالة إضافية للكلمة الرئيسية في حساب محرك البحث الخارجي. تشمل الحالات المحتملة (استنادًا إلى نوع الحساب الخارجي) criterion rarely served وcriterion below first page bid وcriterion low quality score وreview وcampaign paused وما إلى ذلك.	سمة	String	نعم
creationTimestamp	طابع زمني لإنشاء الكلمة الرئيسية، ويكون منسَّقًا وفقًا لمعيار ISO 8601	سمة	Timestamp	نعم
lastModifiedTimestamp	طابع زمني لأحدث تعديل للكلمة الرئيسية، ويكون منسَّقًا وفقًا لمعيار ISO 8601	سمة	Timestamp	نعم
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	نعم
campaign	اسم الحملة.	سمة	String	نعم
campaignId	رقم تعريف الحملة في DS.	سمة	ID	نعم
campaignStatus	حالة الحملة التي تحتوي على هذا العنصر.	سمة	Status	نعم
adGroup	اسم المجموعة الإعلانية.	سمة	String	نعم
adGroupId	رقم تعريف المجموعة الإعلانية في DS.	سمة	ID	نعم
adGroupStatus	حالة المجموعة الإعلانية التي تحتوي على هذا العنصر.	سمة	Status	نعم
keywordId	رقم تعريف الكلمة الرئيسية في DS. تشير القيمة 0 إلى أنّ الكلمة الرئيسية لم يتم تحديد مصدرها.	سمة	ID	نعم
keywordMatchType	نوع مطابقة الكلمة الرئيسية: Broad أو Exact أو Phrase أو Content.	سمة	Match type	نعم
keywordText	نص الكلمة الرئيسية.	سمة	String	نعم
keywordEngineId	رقم تعريف الكلمة الرئيسية في حساب محرك البحث الخارجي.	سمة	ID	نعم
keywordMaxCpc	لإلغاء التكلفة القصوى للنقرة للمجموعة الإعلانية، وتعيين الحد الأقصى للمبلغ الذي ترغب في دفعه إذا نقر أحد الأشخاص على إعلان لهذه الكلمة الرئيسية المحدّدة. إذا كان هذا الحقل فارغًا، ستستخدم الكلمة الرئيسية التكلفة القصوى للنقرة للمجموعة الإعلانية.	سمة	Money	نعم
effectiveKeywordMaxCpc	التكلفة القصوى للنقرة (التكلفة القصوى للنقرة) السارية على هذه الكلمة الرئيسية. وستكون هذه القيمة هي نفسها التكلفة القصوى للنقرة للمجموعة الإعلانية، أو إذا كانت الكلمة الرئيسية تلغي إعداد المجموعة الإعلانية، ستتوفّر له قيمة التكلفة القصوى للنقرة المتعلقة بالكلمة الرئيسية.	سمة	Money	نعم
keywordLandingPage	رابط عنوان URL النهائي الذي سينتقل إليه المستخدم بعد النقر على إعلانك. اطّلِع على عناوين URL الخاصة بالصفحات المقصودة وخادم النقرات.	سمة	String	نعم
keywordClickserverUrl	عنوان URL الذي يستخدمه DS لتتبُّع النشاط. سيزور المستخدِم الذي ينقر على إعلان عنوان URL لخادم النقرات أولاً، ثمّ سيُعاد توجيهه إلى الصفحة المقصودة النهائية. اطّلِع على عناوين URL الخاصة بالصفحات المقصودة وخادم النقرات.	سمة	String	نعم
isDisplayKeyword	تحدّد هذه السمة ما إذا كانت كلمة رئيسية نائبة تُستخدَم لإعداد التقارير على الشبكة الإعلانية ومواضع الإعلانات.	سمة	Boolean	نعم
keywordMaxBid	إذا كانت هذه الكلمة الرئيسية مُدارة بواسطة استراتيجية عروض أسعار في DS، لن ترفع استراتيجية عروض الأسعار أبدًا عروض الأسعار فوق هذا الحدّ. اطّلِع على تطبيق استراتيجية عروض أسعار على الكلمات الرئيسية.	سمة	Money	نعم
keywordMinBid	في حال كانت هذه الكلمة الرئيسية مُدارة بواسطة استراتيجية عروض أسعار في DS، لن تعمل استراتيجية عروض الأسعار على خفض عروض الأسعار إلى ما دون هذا الحدّ مطلقًا. اطّلِع على تطبيق استراتيجية عروض أسعار على الكلمات الرئيسية.	سمة	Money	نعم
keywordUrlParams	تمت إضافة مَعلمات عناوين URL إضافية إلى الصفحة المقصودة. راجِع إضافة مَعلمات عناوين URL.	سمة	String	نعم
bingKeywordParam2	المَعلمة 2 لكلمة رئيسية تخصّ "إعلانات Bing".	سمة	String	نعم
bingKeywordParam3	المَعلمة 3 لكلمة رئيسية تخصّ "إعلانات Bing".	سمة	String	نعم
keywordLabels	أسماء التصنيفات المعيَّنة مباشرةً لهذه الكلمة الرئيسية لا يتم تضمين التصنيفات المكتسَبة.	سمة	String list	نعم
qualityScoreCurrent	"إعلانات Google" و"إعلانات Bing" فقط. أحدث قيمة لنقاط الجودة (QS) للمحرك لكلمة رئيسية. تجدر الإشارة إلى أن هذا العمود يعرض دائمًا أحدث نقاط الجودة لكلمة رئيسية بصرف النظر عن النطاق الزمني للتقرير.	سمة	Integer	نعم
topOfPageBidCurrent	"إعلانات Google" فقط. تقريب عرض سعر النقرة الحالي اللازم لظهور إعلانك بانتظام في المواضع العليا أعلى نتائج البحث. تجدر الإشارة إلى أنّ هذا العمود يعرض دائمًا تكلفة النقرة المطلوبة حاليًا بصرف النظر عن النطاق الزمني للتقرير.	سمة	Money	نعم
effectiveBidStrategyId	رقم تعريف DS لاستراتيجية عروض الأسعار التي تم تعيينها لهذا الكيان أو المكتسبة من هذا الكيان.	سمة	ID	نعم
effectiveBidStrategy	اسم استراتيجية عروض الأسعار التي حدّدتها لهذا الكيان أو مكتسَبة من قِبل هذا الكيان	سمة	String	نعم
bidStrategyInherited	تشير إلى ما إذا كانت استراتيجية عروض أسعار هذا الكيان مكتسَبة.	سمة	Boolean	نعم
effectiveLabels	أسماء جميع التصنيفات المكتسَبة أو التي تم تخصيصها مباشرةً لهذه الكلمة الرئيسية.	سمة	String list	نعم
dfaActions	إجمالي عدد إجراءات "مدير الحملة".	المقياس	Integer	نعم
dfaRevenue	الأرباح المجمّعة الناتجة عن معاملات "مدير الحملة"	المقياس	Money	نعم
dfaTransactions	إجمالي عدد معاملات "مدير الحملة".	المقياس	Integer	نعم
dfaWeightedActions	المجموع المعدَّل لإجراءات "مدير الحملة".	المقياس	Number	نعم
dfaActionsCrossEnv	إجمالي عدد إجراءات "مدير الحملة" على جميع البيئات.	المقياس	Number	نعم
dfaRevenueCrossEnv	الأرباح المجمّعة الناتجة عن معاملات "مدير الحملة" على مستوى جميع البيئات	المقياس	Money	نعم
dfaTransactionsCrossEnv	إجمالي عدد معاملات "مدير الحملة" على جميع البيئات.	المقياس	Number	نعم
dfaWeightedActionsCrossEnv	المجموع المعدَّل لإجراءات "مدير الحملة" على جميع البيئات.	المقياس	Number	نعم
avgCpc	متوسط تكلفة النقرة.	المقياس	Money	نعم
avgCpm	متوسّط التكلفة لكل ألف ظهور	المقياس	Money	نعم
avgPos	متوسط موضع الإعلان	المقياس	Number	نعم
clicks	النقرات المجمّعة.	المقياس	Integer	نعم
cost	التكلفة المجمّعة المدفوعة لحسابات محرّك البحث	المقياس	Money	نعم
ctr	متوسط نسبة النقر إلى الظهور	المقياس	Number	نعم
impr	إجمالي عدد مرات الظهور.	المقياس	Integer	نعم
adWordsConversions	البيانات التي أعدّها المعلِن لتسجيلها في عمود "الإحالات الناجحة" في "إعلانات Google" عند إنشاء إجراء إحالة ناجحة في "إعلانات Google"، يمكن للمعلِن اختيار ما إذا كان يريد احتساب هذه الإحالات الناجحة في عمود "تقارير الإحالات الناجحة".	المقياس	Number	نعم
adWordsConversionValue	القيمة المجمّعة للإحالات الناجحة في "إعلانات Google"	المقياس	Number	نعم
adWordsViewThroughConversions	إجمالي عدد الإحالات الناجحة بعد رؤية الإعلان فقط في "إعلانات Google".	المقياس	Integer	نعم
visits	إجمالي عدد زيارات DS.	المقياس	Integer	نعم
qualityScoreAvg	"إعلانات Google" و"إعلانات Bing" فقط. متوسّط نقاط الجودة حسب عدد مرّات الظهور لمحرّك البحث على مدار جميع الأيام والكلمات الرئيسية في نطاق التقرير.	المقياس	Number	نعم
topOfPageBidAvg	"إعلانات Google" فقط. تقريب متوسط عرض سعر النقرة المطلوب خلال النطاق الزمني للتقرير لكي تظهر إعلاناتك بانتظام في المواضع العليا أعلى نتائج البحث.	المقياس	Money	نعم
date	لتقسيم التقرير حسب الأيام؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل يوم. يعرض هذا العمود تاريخ كل صف.	قسم	Date	نعم
monthStart	تقسيم التقرير حسب الأشهر؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل شهر. يعرض هذا العمود اليوم الأول من الشهر لكل صف.	قسم	Date	نعم
monthEnd	تقسيم التقرير حسب الأشهر؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل شهر. يعرض هذا العمود آخر يوم من الشهر لكل صف.	قسم	Date	نعم
quarterStart	لتقسيم التقرير إلى أرباع؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل ربع سنة. يعرض هذا العمود اليوم الأول من ربع كل صف.	قسم	Date	نعم
quarterEnd	لتقسيم التقرير إلى أرباع؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل ربع سنة. يعرض هذا العمود اليوم الأخير من ربع كل صف.	قسم	Date	نعم
weekStart	يقسّم التقرير حسب الأسابيع (من الأحد إلى السبت) يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود اليوم الأول (الأحد) من كل صف.	قسم	Date	نعم
weekEnd	يقسّم التقرير حسب الأسابيع (من الأحد إلى السبت) يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود آخر يوم (السبت) من كل صف.	قسم	Date	نعم
yearStart	يقسّم التقرير حسب السنوات؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل عام. يعرض هذا العمود اليوم الأول من السنة لكل صف.	قسم	Date	نعم
yearEnd	يقسّم التقرير حسب السنوات؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل عام. يعرض هذا العمود آخر يوم من السنة لكل صف.	قسم	Date	نعم
deviceSegment	لتقسيم التقرير حسب الجهاز يتم تقسيم كل صف ومقاييسه المجمَّعة إلى صفوف متعددة، على أن يصل صف واحد لكل شريحة جهاز. يعرض هذا العمود مقطع الجهاز لكل صف.	قسم	Device segment	نعم
floodlightGroup	تقسيم التقرير حسب مجموعات Floodlight يتمّ تقسيم كلّ صف ومقاييسه المجمَّعة إلى صفوف متعدّدة، على أن يصل عددها إلى صف واحد لكلّ مجموعة في Floodlight. يعرض هذا العمود اسم مجموعة Floodlight لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات.	قسم	String	نعم
floodlightGroupId	تقسيم التقرير حسب مجموعات Floodlight يتمّ تقسيم كلّ صف ومقاييسه المجمَّعة إلى صفوف متعدّدة، على أن يصل عددها إلى صف واحد لكلّ مجموعة في Floodlight. يعرض هذا العمود رقم تعريف مجموعة Floodlight في DS لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات.	قسم	ID	نعم
floodlightGroupTag	تقسيم التقرير حسب مجموعات Floodlight يتمّ تقسيم كلّ صف ومقاييسه المجمَّعة إلى صفوف متعدّدة، على أن يصل عددها إلى صف واحد لكلّ مجموعة في Floodlight. يعرض هذا العمود علامة مجموعة Floodlight لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات.	قسم	String	نعم
floodlightActivity	تقسيم التقرير حسب أنشطة Floodlight يتمّ تقسيم كلّ صف ومقاييسه المجمَّعة إلى صفوف متعدّدة، على أن يكون صفّ واحد لكلّ نشاط Floodlight. يعرض هذا العمود اسم نشاط Floodlight لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات.	قسم	String	نعم
floodlightActivityId	تقسيم التقرير حسب أنشطة Floodlight يتمّ تقسيم كلّ صف ومقاييسه المجمَّعة إلى صفوف متعدّدة، على أن يكون صفّ واحد لكلّ نشاط Floodlight. يعرض هذا العمود رقم تعريف نشاط Floodlight في DS لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات.	قسم	ID	نعم
floodlightActivityTag	تقسيم التقرير حسب أنشطة Floodlight يتمّ تقسيم كلّ صف ومقاييسه المجمَّعة إلى صفوف متعدّدة، على أن يكون صفّ واحد لكلّ نشاط Floodlight. يعرض هذا العمود علامة نشاط Floodlight لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات.	قسم	String	نعم
ad	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمَّعة إلى صفوف متعددة، على أن يصل صف واحد لكل إعلان. يعرض هذا العمود اسم الإعلان في كل صف.	قسم	String	نعم
adId	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود رقم تعريف DS للإعلان في كل صف.	قسم	ID	نعم
isUnattributedAd	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يشير هذا العمود إلى ما إذا كانت المقاييس في هذا الصف لا يمكن نسبها إلى إعلان معيّن.	قسم	Boolean	نعم
adHeadline	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود عنوان الإعلان في كل صف.	قسم	String	نعم
adHeadline2	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود العنوان 2 للإعلان في كل صف. هذه الميزة غير متوفّرة لبعض المحرّكات.	قسم	String	نعم
adHeadline3	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود العنوان 3 للإعلان في كل صف. هذه الميزة غير متوفّرة لبعض المحرّكات.	قسم	String	نعم
adDescription1	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود سطر الوصف 1 للإعلان في كل صف.	قسم	String	نعم
adDescription2	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود سطر الوصف 2 للإعلان في كل صف.	قسم	String	نعم
adDisplayUrl	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود عنوان URL المعروض للإعلان في كل صف.	قسم	String	نعم
adLandingPage	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمَّعة إلى صفوف متعددة، على أن يصل صف واحد لكل إعلان. يعرض هذا العمود الصفحة المقصودة للإعلان في كل صف.	قسم	String	نعم
adType	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود نوع الإعلان في كل صف: Text أو Product.	قسم	Ad type	نعم
adPromotionLine	لتقسيم التقرير حسب الإعلانات يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، على أن يصل عددها إلى صف واحد لكل إعلان. يعرض هذا العمود سطر العرض الترويجي لإعلان المنتج في كل صف.	قسم	String	نعم