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

مقاييس الأداء وسمات الإعداد لاستهدافات المنتجات. كانت استهدافات المنتجات تُستخدم من خلال حملات إعلانات قائمة المنتجات في إعلانات Google لتحديد المنتجات في حساب Google Merchant Center التي يجب أن تؤدي إلى ظهور إعلانات قائمة المنتجات (إعلانات Shopping) في عمليات البحث ذات الصلة على Google. تم استبدال استهدافات المنتجات وحملات إعلانات قائمة المنتجات بحملات Shopping في "إعلانات Google". من DS، سيظل بإمكانك طلب تقارير عن المقاييس السابقة التي تمت إحالتها إلى حملات إعلانات قائمة المنتجات قبل الترقية إلى حملات Shopping.

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

طلب مقتطف

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

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

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

columnNameالوصفالسلوكالنوعقابلة للفلترة
status حالة استهداف المنتج: Active أو Paused أو Removed. تجدر الإشارة إلى أنّ لكلّ من الحملات والمجموعات الإعلانية واستهدافات المنتجات والإعلانات حالتها الخاصة. راجِع الحالة. سمة 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 نعم
productTargetId رقم تعريف استهداف المنتج في DS. سمة ID نعم
productTargetFilter تتم فلترة المنتجات في حساب Google Merchant Center الذي يتضمن استهداف المنتج هذا. يمكنك تحديد معايير المطابقة باستخدام سمات مثل معرّفات المنتجات والعلامة التجارية وما إلى ذلك. سمة String لا
productTargetEngineId رقم تعريف استهداف المنتج في حساب محرّك البحث الخارجي. سمة ID نعم
productTargetLandingPage القيمة التي تشير إلى رابط عنوان URL النهائي الذي سينتقل إليه المستخدم بعد النقر على إعلان Shopping. اطّلِع على الصفحات المقصودة في "إعلانات Shopping". سمة String نعم
productTargetClickserverUrl عنوان URL الذي يستخدمه DS لتتبُّع النشاط. يزور المستخدِم الذي ينقر على إعلان Shopping عنوان URL لتتبُّع النقرات أولاً، ثمّ يُعاد توجيهه إلى الصفحة المقصودة النهائية. اطّلِع على الصفحات المقصودة في "إعلانات Shopping". سمة String نعم
productTargetLabels أسماء التصنيفات المعيَّنة مباشرةً لاستهداف المنتج هذا لا يتم تضمين التصنيفات المكتسَبة. سمة String list نعم
productTargetMaxCpc لإلغاء التكلفة القصوى للنقرة للمجموعة الإعلانية، وتعيين الحد الأقصى للمبلغ الذي ترغب في دفعه إذا نقر أحد الأشخاص على إعلان منتج لاستهداف المنتج المحدّد هذا. إذا كان هذا الحقل فارغًا، فسيستخدم استهداف المنتج التكلفة القصوى للنقرة للمجموعة الإعلانية. سمة Money نعم
effectiveProductTargetMaxCpc التكلفة القصوى للنقرة (التكلفة القصوى للنقرة) السارية لاستهداف المنتج هذا. وستكون هذه القيمة هي نفسها التكلفة القصوى للنقرة للمجموعة الإعلانية، أو إذا كان استهداف المنتج يتجاوز إعداد المجموعة الإعلانية، فسيتمثّل في التكلفة القصوى للنقرة لاستهداف المنتج. سمة Money نعم
productTargetMaxBid وفي حال كانت تتم إدارة استهداف المنتج هذا بواسطة استراتيجية عروض أسعار في DS، لن ترفع استراتيجية عروض الأسعار أبدًا عروض الأسعار التي تتجاوز هذا الحدّ. اطّلِع على تطبيق استراتيجية عروض أسعار على استهدافات المنتجات. سمة Money نعم
productTargetMinBid في حال كانت تتم إدارة استهداف المنتج هذا باستخدام استراتيجية عروض أسعار في 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 نعم
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 نعم