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