مقاييس الأداء وسمات الإعداد لاستهدافات المنتجات. كانت استهدافات المنتجات تُستخدم من خلال حملات إعلانات قائمة المنتجات في إعلانات 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 |
نعم |