تتبُّع موضع الإعلان وأدائه

توفّر 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 لفحص مرات ظهور مواضع الإعلانات في "حملات الأداء الأفضل".