مقاييس الأداء وسمات التهيئة لاستهدافات المنتجات. تم استخدام استهدافات المنتجات من قِبل حملات إعلانات قائمة المنتجات في إعلانات 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. يعرض هذا العمود رقم تعريف نشاط DS Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | ID |
نعم |
floodlightActivityTag |
يعمل التقرير على تقسيم التقرير حسب أنشطة Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل نشاط على Floodlight. يعرض هذا العمود علامة نشاط Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | String |
نعم |