مقاييس الأداء للاستهدافات على مستوى المجموعة الإعلانية، والتي تشمل استهدافات المواقع الجغرافية واستهدافات الإعلانات الديناميكية واستهدافات قوائم تجديد النشاط التسويقي واستهدافات العمر/الجنس والاستهدافات غير المصنّفة لا تتوفّر بعض الاستهدافات إلّا في أنواع معيّنة من حسابات المحرّكات.
لا يمكن عرض هذا التقرير إلّا من خلال طلب غير متزامن (أي من خلال الأسلوب Reports.request()).
طلب مقتطف
أرسِل محتوى طلب عاديًا
Reports.request()
، ولكن حدِّد "reportType": "adGroupTarget".
{
...
"reportType": "adGroupTarget",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
لكل عمود تريد عرضه أو فلترته في التقرير،
حدِّد columnName المدرَج في الجدول أدناه.
يمكنك أيضًا اختياريًا تحديد
headerText،
startDate،
وendDate.
يُرجى العِلم أنّه لا يمكن فلترة بعض الأعمدة، راجِع "العناصر التي يمكن فلترتها" في الجدول أدناه.
columnName | الوصف | السلوك | النوع | قابل للفلترة |
|---|---|---|---|---|
status |
حالة استهداف المجموعة الإعلانية: Active أو Paused أو Removed. |
سمة | Status |
نعم |
creationTimestamp |
الطابع الزمني لإنشاء استهداف المجموعة الإعلانية، بتنسيق ISO 8601 | سمة | Timestamp |
نعم |
lastModifiedTimestamp |
الطابع الزمني لآخر تعديل على استهداف المجموعة الإعلانية، بتنسيق ISO 8601 | سمة | Timestamp |
نعم |
agency |
اسم الوكالة | سمة | String |
نعم |
agencyId |
رقم تعريف الوكالة في DS | سمة | ID |
نعم |
advertiser |
اسم المعلِن | سمة | String |
نعم |
advertiserId |
رقم تعريف المعلِن في "مساحة العرض والفيديو 360" | سمة | ID |
نعم |
account |
اسم حساب محرّك البحث | سمة | String |
نعم |
accountId |
رقم تعريف حساب محرّك "إعلانات شبكة البحث" | سمة | 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 |
رقم تعريف حملة "إعلانات شبكة البحث". | سمة | ID |
نعم |
campaignStatus |
حالة الحملة التي تحتوي على هذا العنصر. | سمة | Status |
نعم |
adGroup |
اسم المجموعة الإعلانية. | سمة | String |
نعم |
adGroupId |
رقم تعريف المجموعة الإعلانية في "شبكة البحث" | سمة | ID |
نعم |
adGroupStatus |
حالة المجموعة الإعلانية التي تحتوي على هذا العنصر. | سمة | Status |
نعم |
engineRemarketingList |
اسم قائمة تجديد النشاط التسويقي المرتبطة بالاستهداف. | سمة | String |
نعم |
engineRemarketingListBidModifier |
تعديل عرض السعر المرتبط بالهدف | سمة | Number |
نعم |
dynamicSearchAdsTargetConditions |
المعايير التي يستخدِمها استهداف الإعلان الديناميكي لاختيار الصفحات ضمن نطاق الموقع الإلكتروني. | سمة | String |
لا |
dynamicSearchAdsTargetCpcBid |
إعداد التكلفة القصوى للنقرة لاستهداف الإعلان الديناميكي. | سمة | Money |
نعم |
dynamicSearchAdsTargetLandingPageUrl |
نموذج عنوان URL لاستهداف الإعلان الديناميكي. | سمة | String |
نعم |
dynamicSearchAdsTargetCoverage |
النسبة المئوية للصفحات على موقع المعلِن الإلكتروني التي يتطابق معها استهداف الإعلان الديناميكي. | سمة | Number |
نعم |
locationTargetName |
اسم الموقع الجغرافي المستهدَف. | سمة | String |
نعم |
locationTargetBidModifier |
تعديل عرض الأسعار المرتبط بالموقع الجغرافي المستهدَف | سمة | Number |
نعم |
ageTargetAgeRange |
الفئة العمرية المستهدَفة | سمة | Age range |
نعم |
ageTargetBidModifier |
تعديل عرض السعر المرتبط بالعمر المستهدَف. | سمة | Number |
نعم |
genderTargetGenderType |
نوع الجنس المستهدَف: ذكر، أنثى، غير معروف | سمة | Gender type |
نعم |
genderTargetBidModifier |
تعديل عرض الأسعار المرتبط بالاستهداف حسب الجنس | سمة | Number |
نعم |
unclassifiedTargetName |
اسم الهدف غير المصنّف | سمة | String |
نعم |
unclassifiedTargetType |
نوع الاستهداف غير المصنَّف: Dynamic search. |
سمة | Unclassified target type |
نعم |
adGroupTargetId |
رقم تعريف DS الذي تم إنشاؤه لاستهداف مجموعة إعلانية. | سمة | ID |
نعم |
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. يعرض هذا العمود رقم تعريف مجموعة DS Floodlight لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في 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 |
نعم |