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

مقاييس الأداء وسمات التهيئة للكلمات الرئيسية.

لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة 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	Param2 of a Bing Ads keyword.	سمة	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 فقط. المتوسط المُرجَّح لمرات الظهور في نقاط جودة المحرك (QS) في جميع الأيام والكلمات الرئيسية في نطاق التقرير.	المقياس	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. يعرض هذا العمود رقم تعريف نشاط DS Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في 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	نعم