نوع التقرير: productGroup

مقاييس الأداء وسمات الضبط لمجموعات المنتجات تختلف تقارير مجموعة المنتجات عن تقارير الكلمات الرئيسية في عدة جوانب؛ مزيد من المعلومات.

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