توفّر Google Ads API عدة طرق عرض لتحليل أماكن ظهور إعلاناتك ومستوى أدائها:
managed_placement_view وgroup_placement_view وdetail_placement_view وperformance_max_placement_view. تقدّم كل طريقة عرض منظورًا مختلفًا
لبيانات مواضع الإعلانات. للحصول على طلبات بحث جاهزة للتنفيذ بلغة طلب البحث في "إعلانات Google" (GAQL) وcurl والتي تكرّر شاشات مواضع الإعلانات في واجهة مستخدم "إعلانات Google"، يُرجى الاطّلاع على دليل طلبات البحث.
طريقة عرض المواضع المُدارة
- البيانات المعروضة: يوفّر المورد
managed_placement_viewبيانات الأداء مجمّعة حسب معايير مواضع الإعلان الإيجابية التي تستهدفها في مجموعاتك الإعلانية. تتضمّن طريقة العرض هذه جميع أنواع المعايير الخمسة التي تتم إدارتها ضمن المحتوى > مواضع الإعلان في واجهة مستخدم "إعلانات Google": المواقع الإلكترونية وقنوات YouTube وفيديوهات YouTube والتطبيقات على الأجهزة الجوّالة وفئات التطبيقات على الأجهزة الجوّالة. - المكافئ في واجهة المستخدم: المحتوى > مواضع الإعلان
- أداة إنشاء الطلبات: الاستكشاف في "أداة إنشاء الطلبات"
أنواع معايير المواضع المستهدفة للإعلانات
يملأ كل صف في مورد managed_placement_view حقل AdGroupCriterion الذي يتطابق مع قيمة ad_group_criterion.type ويترك حقول مواضع الإعلان الأخرى بدون ضبط:
| نوع موضع واجهة المستخدم | قيمة ad_group_criterion.type |
حقول تفاصيل المعيار | ملاحظات |
|---|---|---|---|
| المواقع الإلكترونية | PLACEMENT |
ad_group_criterion.placement.url |
عنوان URL للموقع الإلكتروني أو النطاق المستهدَف |
| قنوات على YouTube | YOUTUBE_CHANNEL |
ad_group_criterion.youtube_channel.channel_id |
معرّف القناة على YouTube يعرض الحقل ad_group_criterion.display_name اسم القناة. |
| الفيديوهات على YouTube | YOUTUBE_VIDEO |
ad_group_criterion.youtube_video.video_id |
معرّف الفيديو على YouTube يعرض الحقل ad_group_criterion.display_name عنوان الفيديو. |
| التطبيقات | MOBILE_APPLICATION |
ad_group_criterion.mobile_application.app_id، ad_group_criterion.mobile_application.name |
معرّف التطبيق بتنسيق {platform}-{platform_native_id} (1- لنظام التشغيل iOS و2- لنظام التشغيل Android) واسم التطبيق |
| فئات التطبيقات | MOBILE_APP_CATEGORY |
ad_group_criterion.mobile_app_category.mobile_app_category_constant |
اسم المورد بتنسيق mobileAppCategoryConstants/{mobile_app_category_id} يُرجى الاطّلاع على أسماء فئات التطبيقات للأجهزة الجوّالة والتسلسل الهرمي. |
مثال على طلب البحث
لجلب مقاييس الأداء في جميع أنواع المواضع المستهدفة للإعلانات على مدار آخر
30 يومًا، اختَر الحقل ad_group_criterion.type إلى جانب الحقول الخاصة بالنوع:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.display_name,
ad_group_criterion.placement.url,
ad_group_criterion.youtube_channel.channel_id,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.mobile_application.app_id,
ad_group_criterion.mobile_application.name,
ad_group_criterion.mobile_app_category.mobile_app_category_constant,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
أسماء فئات تطبيقات الأجهزة الجوّالة والتسلسل الهرمي لها
في واجهة مستخدم "إعلانات Google"، تعرض فئات تطبيقات الأجهزة الجوّالة المستهدَفة مسار متجر التطبيقات بالكامل، مثل فئات التطبيقات > Apple App Store > التعليم. عند إرسال طلبات بحث إلى Google Ads API، يُرجى مراعاة السلوكيات التالية:
- ثوابت فئات التطبيقات على الأجهزة الجوّالة التي يمكن تحديد مصدرها:
مورد
mobile_app_category_constantليس موردًا يمكن تحديد مصدره لموردmanaged_placement_view. اختَر حقلad_group_criterion.mobile_app_category.mobile_app_category_constantبدلاً من ذلك (على سبيل المثال،mobileAppCategoryConstants/60503)، أو أرسِل طلب بحث إلى موردad_group_criterionعندما لا تحتاج إلى مقاييس. - الأسماء المعروضة للفئات الفرعية فقط: يعرض كل من الحقلَين
ad_group_criterion.display_nameوmobile_app_category_constant.nameاسم الفئة الفرعية فقط، مثل"Education"أو"Games". ولا يتضمّن أيّ من الحقلَين مسار متجر التطبيقات الرئيسي. - حلّ مشكلة مسار متجر التطبيقات: يشارك Google Play وApple App Store أسماء الفئات الفرعية في أرقام تعريف معايير مختلفة. على سبيل المثال، معرّفات المعايير
60005(/All Apps/Google Play/Education) و60060(/All Apps/Google Play/Family/Education) و60503(/All Apps/Apple App Store/Education) تعرض جميعها"Education"في الحقلَينnameوdisplay_name. استخرِج اللاحقة{mobile_app_category_id}من اسم المورد وابحث عن مسار التسلسل الهرمي الكامل في جدول فئات التطبيقات على الأجهزة الجوّالة أو ملف CSV.
عرض موضع الإعلان في المجموعة
- ما يعرضه: يعرض المورد
group_placement_viewالأماكن التي تم عرض إعلاناتك فيها فعليًا على "الشبكة الإعلانية" وYouTube، بغض النظر عمّا إذا كانت مواضع الإعلانات مستهدَفة بشكل صريح أو تم اكتشافها تلقائيًا بواسطة نظام Google. ويمكن أن يشمل ذلك المواقع الإلكترونية أو القنوات أو الفيديوهات على YouTube أو التطبيقات. - المقابل في واجهة المستخدم: المحتوى > مواضع ظهور الإعلانات
- أداة إنشاء الطلبات: الاستكشاف في "أداة إنشاء الطلبات"
مثال على طلب البحث
يسترجع طلب البحث التالي مقاييس الأداء للنطاقات والتطبيقات على الأجهزة الجوّالة وقنوات YouTube التي ظهرت فيها الإعلانات خلال آخر 30 يومًا:
SELECT
campaign.id,
ad_group.id,
group_placement_view.display_name,
group_placement_view.target_url,
group_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS
صف "الإجمالي: أخرى"
لتسريع عملية إنشاء التقارير، يستبعد الموردان
group_placement_view وdetail_placement_view
مواضع الإعلان الفردية التي لا تستوفي الحدّ الأدنى المطلوب للنشاط من حيث
مرّات الظهور أو التفاعلات.
- في واجهة مستخدم "إعلانات Google": تجمع واجهة المستخدم مواضع الإعلانات التي لا تستوفي هذا الحدّ الأدنى للنشاط في صف ملخّص يحمل التصنيف الإجمالي: غير ذلك.
- في Google Ads API: تحذف واجهة برمجة التطبيقات مواضع الإعلانات التي لا تستوفي الحد الأدنى للنشاط من نتائج التقارير ولا تعرض صفًا ملخّصًا حيث يحتوي الحقل
group_placement_view.placementأوdetail_placement_view.placementعلى القيمة"Other".
نتيجةً لذلك، قد يكون مجموع صفوف مواضع الإعلان الفردية في موردَي
group_placement_view وdetail_placement_view
أقل من إجمالي المقاييس للمجموعة الإعلانية أو الحملة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة لمحة عن تقرير "مواضع ظهور الإعلانات". للاطّلاع على تفاصيل حول كيفية تأثير الحدود الدنيا والبيانات الوصفية غير المتوفّرة في المقارنات بين طرق العرض، يُرجى مراجعة الاختلافات في المقاييس بين طرق عرض مواضع الإعلان والصفوف التي تتضمّن تفاصيل غير متاحة عن مواضع الإعلان.
إعدادات استهداف مواضع الإعلان
يتأثر سلوك وفائدة
group_placement_view بـ
TargetingSetting لسمة PLACEMENT
على مستوى المجموعة الإعلانية. يحتوي هذا الإعداد على قائمة من
target_restrictions، ولكل منها حقل منطقي bid_only
يحدّد ما إذا كانت إعلاناتك تظهر فقط في المواضع المستهدفة للإعلانات أو في
مواضع أخرى أيضًا. يُرجى الاطّلاع على لمحة عن إعدادَي "الاستهداف" و "الملاحظة".
bid_only = false: تتوافق هذه القيمة مع الاستهداف في واجهة مستخدم "إعلانات Google" للمواضع. إذا تم ضبط مجموعتك الإعلانية على "الاستهداف"، ستظهر إعلاناتك فقط في مواضع الإعلان التي أضفتها صراحةً كمعايير. يمكنك اختيار تطبيق تعديلات عروض الأسعار على مواضع الإعلانات هذه. في هذا السيناريو، يعكسgroup_placement_viewإلى حد كبيرmanaged_placement_view، ولكنه لا يزال يخضع للحد الأدنى من حدود النشاط.bid_only = true: تتوافق هذه القيمة مع الملاحظة في واجهة مستخدم "إعلانات Google" للمواضع. إذا تم ضبط مجموعتك الإعلانية على "الملاحظة"، يمكن عرض إعلاناتك في أي موضع مؤهَّل على "الشبكة الإعلانية" وYouTube. يمكنك أيضًا تطبيق تعديلات عروض الأسعار على أي مواضع إعلان استهدفتها. في هذه الحالة، يكونgroup_placement_viewمهمًا لاكتشاف مواضع إعلان جديدة تظهر فيها إعلاناتك، والتي يمكنك اختيار إضافتها كمواضع مختارة أو استبعادات.
عرض موضع التفاصيل
- البيانات المعروضة: يوفّر المورد
detail_placement_viewتقسيمًا أكثر تفصيلاً لمواضع الإعلانات، ما يقدّم تفاصيل تتجاوز مستوى النطاق أو القناة. على سبيل المثال، يمكن أن يعرض عناوين URL محدّدة أو معرّفات فيديوهات على YouTube ظهرت فيها إعلاناتك. - ما يعادل واجهة المستخدم: يعادل اختيار صفوف في المحتوى > مواضع ظهور الإعلانات، ثم النقر على عرض التفاصيل.
- أداة إنشاء الطلبات: الاستكشاف في "أداة إنشاء الطلبات"
- ملاحظات مهمة: على غرار المورد
group_placement_view، تحذف طريقة العرض هذه المواضع ذات النشاط المنخفض التي لا تستوفي الحد الأدنى من النشاط (يُرجى الاطّلاع على قسم صف "الإجمالي: أخرى").
مثال على طلب البحث
للحدّ من حجم النتائج، يجلب طلب البحث التالي مقاييس مواضع الإعلانات على مستوى عنوان URL ومستوى الفيديو خلال فترة زمنية تبلغ 7 أيام. بالنسبة إلى الحسابات الكبيرة، يمكنك فلترة النتائج بشكل أكبر حسب
حقل campaign.id أو ad_group.id:
SELECT
campaign.id,
ad_group.id,
detail_placement_view.display_name,
detail_placement_view.target_url,
detail_placement_view.group_placement_target_url,
detail_placement_view.placement_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS
لاستبعاد الصفوف التي لا تتوفّر فيها البيانات الوصفية لمواضع الإعلانات، أضِف AND
detail_placement_view.target_url IS NOT NULL (يُرجى الاطّلاع على الصفوف التي لا تتوفّر فيها تفاصيل مواضع الإعلانات). عندما لا تحتاج إلى حقول resource_name التي تم عرضها، أضِف عبارة PARAMETERS
omit_unselected_resource_names = true.
الاختلافات في المقاييس بين طرق عرض مواضع الإعلانات
يتم تقييم الحد الأدنى للنشاط بشكل مستقل على كل مستوى من مستويات التفاصيل:
- يقيّم المورد
group_placement_viewالحدّ الأدنى على مستوى النطاق المجمّع أو التطبيق المتوافق مع الأجهزة الجوّالة أو القناة على YouTube. - يقيّم المورد
detail_placement_viewالحدّ الأدنى بشكل منفصل لكل عنوان URL لصفحة فردية أو فيديو على YouTube.
يستبعد المورد detail_placement_view عناوين URL للصفحات الفردية أو فيديوهات على YouTube التي لا تستوفي الحد الأدنى. نتيجةً لذلك، يمكن أن يؤدي جمع صفوف detail_placement_view لنطاق أو قناة على YouTube (تمت فلترتها حسب حقل detail_placement_view.group_placement_target_url) إلى عرض عدد مرات ظهور أقل من صف group_placement_view المقابل.
الصفوف التي تتضمّن تفاصيل مواضع إعلانات غير متاحة
يمكن أن يعرض طلب البحث عن مورد group_placement_view أو detail_placement_view صفوفًا متعددة في المجموعة الإعلانية نفسها مع حقول placement وdisplay_name وtarget_url غير محدّدة وقيمة resource_name متطابقة (على سبيل المثال، تنتهي بـ ~MTRf).
يحدث هذا السلوك للأسباب التالية:
- تجميع مواضع الإعلان الداخلية: يجمِّع كلا العرضَين مقاييس الأداء حسب معرّف موضع إعلان داخلي فريد بدلاً من حقول السلسلة
resource_nameأوplacement. - البيانات الوصفية غير المتاحة لمواضع الإعلانات: في واجهة مستخدم "إعلانات Google"، تظهر مواضع الإعلانات التي لا تتضمّن بيانات وصفية في جداول البحث الخلفية على أنّها غير معروفة أو القناة لم تعُد متاحة أو الفيديو لم يعُد متاحًا. في واجهة برمجة التطبيقات، لا يزال كل معرّف موضع إعلان مميّز يعرض صفًا للمقاييس، مع عدم ضبط الحقول
placementوdisplay_nameوtarget_url. - أسماء الموارد المركّبة: اللاحقة
{base64_placement}في الحقلresource_nameهي ترميز Base64 من{type_id}_{placement}، حيث{type_id}هو معرّف داخلي لنوع موضع الإعلان وليس رقم التعدادPlacementType. عندما يكون الحقلplacement_typeهوWEBSITE(المعرّف الداخلي14) ويكون الحقلplacementغير محدّد، يتم ترميز السلسلة"14_"إلىMTRf(وبالمثل، يتم ترميزMOBILE_APPLICATION"55_"إلىNTVf، ويتم ترميزYOUTUBE_VIDEO"89_"إلىODlf، ويتم ترميزYOUTUBE_CHANNEL"90_"إلىOTBf). وبالتالي، فإنّ مواضع الإعلانات المتعدّدة من النوع نفسه والتي تتضمّن بيانات وصفية غير متاحة في المجموعة الإعلانية نفسها تشارك قيمةresource_nameنفسها أثناء تسجيل صفوف مقاييس منفصلة.
عند معالجة نتائج group_placement_view أو
detail_placement_view في رمز العميل،
لا تزل تكرار الصفوف حسب الحقل resource_name فقط، لأنّ ذلك
قد يؤدي إلى استبدال المقاييس في مواضع إعلان مختلفة ببيانات وصفية غير متاحة.
لاستبعاد الصفوف التي تتضمّن بيانات وصفية غير متاحة في GAQL، يمكنك الفلترة حسب الحقل target_url أو display_name، لأنّه لا يمكن فلترة الحقلَين placement وresource_name. على سبيل المثال، استخدِم WHERE group_placement_view.target_url IS
NOT NULL أو WHERE detail_placement_view.target_url IS NOT NULL.
طريقة عرض مواضع الإعلانات في "حملات الأداء الأفضل"
- ما يعرضه: يوفّر المورد
performance_max_placement_viewبيانات مرّات الظهور (metrics.impressions) لمواضع الإعلانات التي تم فيها عرض "إعلانات الأداء الأفضل". في الإصدار 24 والإصدارات الأحدث، يمكنك تقسيمperformance_max_placement_viewحسبsegments.ad_network_type(غير متاح في الإصدار 23). - ما يعادل واجهة المستخدم: الإحصاءات والتقارير > محرِّر التقارير > موضع الإعلان في "حملات الأداء الأفضل"
- أداة إنشاء الطلبات: الاستكشاف في "أداة إنشاء الطلبات"
مثال على طلب البحث
يسترجع طلب البحث التالي مرّات ظهور مواضع الإعلانات مقسّمة حسب نوع شبكة الإعلانات لـ "حملات الأداء الأفضل" خلال آخر 30 يومًا:
SELECT
campaign.id,
performance_max_placement_view.display_name,
performance_max_placement_view.target_url,
performance_max_placement_view.placement_type,
segments.ad_network_type,
metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS
اختيار طريقة عرض موضع الإعلان
- استخدِم
managed_placement_viewلتقييم أداء مواضع الإعلانات التي تستهدفها وتقدّم عروض أسعار لها بشكل نشط. - استخدِم
group_placement_viewلفهم النطاق الكامل لأماكن ظهور إعلاناتك، خاصةً عند استخدام إعداد "الملاحظة"، وذلك لاكتشاف فرص استهداف أو استبعاد جديدة. - استخدِم
detail_placement_viewللحصول على أدق التفاصيل حول عناوين URL أو الفيديوهات المحدّدة التي ظهرت فيها إعلاناتك، والتي تُستخدم غالبًا بعد تحديد نطاق أو قناة تهمّك فيgroup_placement_view. - استخدِم
performance_max_placement_viewلفحص مرات ظهور مواضع الإعلانات في "حملات الأداء الأفضل".