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