مقاييس الأداء وسمات الضبط لمجموعات المنتجات تختلف تقارير مجموعة المنتجات عن تقارير الكلمات الرئيسية في عدة جوانب؛ مزيد من المعلومات.
لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة Reports.request()).
طلب مقتطف
أرسِل نص طلب Reports.request() عاديًا، ولكن حدِّد "reportType": "productGroup"
.
{ ... "reportType": "productGroup", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
لكل عمود تريد عرضه أو تصفيته في التقرير، حدِّد columnName
المُدرَج في الجدول أدناه.
ويمكنك أيضًا اختياريًا تحديد
headerText
وstartDate
وendDate.
تجدر الإشارة إلى أنه لا يمكن تصفية بعض الأعمدة؛ راجع "قابل للتصفية" في الجدول أدناه.
columnName | الوصف | السلوك | النوع | قابل للفلترة |
---|---|---|---|---|
status |
حالة مجموعة المنتجات. إنها دائمًا Active . |
سمة | Status |
نعم |
engineStatus |
الحالة الإضافية لمجموعة المنتجات في حساب المحرك الخارجي. تشمل الحالات المحتملة (حسب نوع الحساب الخارجي) 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 |
نعم |
productGroupId |
رقم تعريف مجموعة المنتجات في DS وتنشئ DS أرقام التعريف هذه، والتي قد تتغير على الرغم من عدم تغيير شجرة مجموعة المنتجات الناتجة. مزيد من المعلومات | سمة | ID |
نعم |
productGroup |
المعايير التي تم استخدامها لتحديد مجموعة المنتجات، مثل AND(CATEGORY="إلكترونيات",BRAND = "example"). | سمة | String |
لا |
productGroupPartitionType |
نوع القسم لمجموعة المنتجات: Subdivided أو Excluded أو Biddable . |
سمة | Product group partition type |
نعم |
productGroupLandingPage |
الصفحة المقصودة لمجموعة المنتجات. يمكنك الاطّلاع على عناوين URL للصفحات المقصودة وخوادم النقر. | سمة | String |
نعم |
productGroupClickserverUrl |
عنوان URL الذي تستخدمه DS لتتبع النشاط. المستخدم الذي ينقر على إعلان سيزور عنوان URL لخادم النقر أولاً، ثم تتم إعادة توجيهه إلى الصفحة المقصودة النهائية. يمكنك الاطّلاع على عناوين URL للصفحات المقصودة وخوادم النقر. | سمة | String |
نعم |
productGroupMaxCpc |
لعرض التكلفة القصوى للنقرة التي تم تعيينها لمجموعة المنتجات هذه، إن وجدت. إذا لم يتم تعيين التكلفة القصوى للنقرة لمجموعة المنتجات هذه، فسيكون هذا الحقل فارغًا وتكتسب مجموعة المنتجات إعداد التكلفة القصوى للنقرة من المجموعة الإعلانية. | سمة | Money |
نعم |
effectiveProductGroupMaxCpc |
التكلفة القصوى للنقرة (CPC) سارية لمجموعة المنتجات هذه. ستكون هذه القيمة نفسها مثل التكلفة القصوى للنقرة على مستوى المجموعة الإعلانية، أو إذا كان استهداف المنتج يتجاوز إعداد المجموعة الإعلانية، فسيصبح هو التكلفة القصوى للنقرة لاستهداف المنتج. | سمة | Money |
نعم |
productGroupMaxBid |
وفي حالة إدارة مجموعة المنتجات هذه بواسطة إستراتيجية عروض أسعار DS، لن ترفع إستراتيجية عروض الأسعار مطلقًا عروض الأسعار التي تتجاوز هذا الحد. انظر تطبيق إستراتيجية عروض أسعار على مجموعة المنتجات. | سمة | Money |
نعم |
productGroupMinBid |
وفي حالة إدارة مجموعة المنتجات هذه بواسطة إستراتيجية عروض أسعار DS، لن تخفض إستراتيجية عروض الأسعار مطلقًا عروض الأسعار التي تقل عن هذا الحد. انظر تطبيق إستراتيجية عروض أسعار على مجموعة المنتجات. | سمة | 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 |
نعم |
date |
يعمل التقرير على تقسيم التقرير حسب الأيام، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف؛ صف لكل يوم. يعرض هذا العمود تاريخ كل صف. | قسم | Date |
نعم |
monthStart |
يعمل التقرير على تقسيم التقرير حسب الأشهر، ويتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل شهر. يعرض هذا العمود اليوم الأول من الشهر لكل صف. | قسم | Date |
نعم |
monthEnd |
يعمل التقرير على تقسيم التقرير حسب الأشهر، ويتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل شهر. يعرض هذا العمود آخر يوم في الشهر من كل صف. | قسم | Date |
نعم |
quarterStart |
يعمل التقرير على تقسيم التقرير بحسب الفصول؛ بل يتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل ربع سنة. يعرض هذا العمود اليوم الأول من ربع كل صف. | قسم | Date |
نعم |
quarterEnd |
يعمل التقرير على تقسيم التقرير بحسب الفصول؛ بل يتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل ربع سنة. يعرض هذا العمود اليوم الأخير من ربع كل صف. | قسم | Date |
نعم |
weekStart |
قسّم التقرير حسب الأسابيع (من الأحد إلى السبت)؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود اليوم الأول (الأحد) من كل صف. | قسم | Date |
نعم |
weekEnd |
قسّم التقرير حسب الأسابيع (من الأحد إلى السبت)؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود اليوم الأخير (السبت) من كل صف. | قسم | Date |
نعم |
yearStart |
يعمل التقرير على تقسيم التقرير حسب السنوات، ويتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف؛ صف لكل عام. يعرض هذا العمود اليوم الأول من السنة في كل صف. | قسم | Date |
نعم |
yearEnd |
يعمل التقرير على تقسيم التقرير حسب السنوات، ويتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف؛ صف لكل عام. يعرض هذا العمود آخر يوم في السنة من كل صف. | قسم | Date |
نعم |
deviceSegment |
يعمل التقرير على تقسيم التقرير حسب الجهاز، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف، بحيث يصل إلى صف واحد لكل شريحة من الأجهزة. يعرض هذا العمود شريحة الجهاز لكل صف. | قسم | Device segment |
نعم |