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

توفّر Google Ads API عدة طرق عرض لتحليل أماكن ظهور إعلاناتك ومستوى أدائها: managed_placement_view وgroup_placement_view وdetail_placement_view وperformance_max_placement_view. تقدّم كل طريقة عرض منظورًا مختلفًا لبيانات مواضع الإعلانات.

طريقة عرض المواضع المُدارة

• ما يعرضه: يوفّر المورد managed_placement_view بيانات الأداء مجمّعة حسب مواضع الإعلان التي تستهدفها بشكل صريح (مواضع الإعلان المُدارة). ويعكس أداء معاييرك البالغ عددها Placement.
• المكافئ في واجهة المستخدم: المحتوى > مواضع الإعلان
• أداة إنشاء الطلبات: الاستكشاف في "أداة إنشاء الطلبات"

مثال على طلب البحث

لجلب مقاييس الأداء للمواضع المختارة خلال آخر 30 يومًا:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.placement.url,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

عرض موضع الإعلان في المجموعة

• ما يعرضه: يعرض المورد group_placement_view الأماكن التي تم عرض إعلاناتك فيها فعليًا على "الشبكة الإعلانية" وYouTube، بغض النظر عمّا إذا كانت مواضع الإعلانات مستهدَفة بشكل صريح أو تم اكتشافها تلقائيًا بواسطة نظام Google. ويمكن أن يشمل ذلك المواقع الإلكترونية أو القنوات أو الفيديوهات على YouTube أو التطبيقات.
• المقابل في واجهة المستخدم: المحتوى > مواضع ظهور الإعلانات
• أداة إنشاء الطلبات: الاستكشاف في "أداة إنشاء الطلبات"

صف "الإجمالي: أخرى"

لتسريع عملية إنشاء التقارير، يستبعد الموردان 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 أقل من إجمالي المقاييس للمجموعة الإعلانية أو الحملة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة لمحة عن تقرير "مواضع ظهور الإعلانات". للاطّلاع على تفاصيل حول كيفية تأثير الحدود الدنيا والبيانات الوصفية غير المتوفّرة في المقارنات بين طرق العرض، يُرجى مراجعة الاختلافات في المقاييس بين طرق عرض مواضع الإعلان والصفوف التي تتضمّن تفاصيل غير متاحة عن مواضع الإعلان.

خيارات TargetingSetting

يتأثر سلوك وفائدة 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، تحذف طريقة العرض هذه المواضع ذات النشاط المنخفض التي لا تستوفي الحد الأدنى من النشاط (يُرجى الاطّلاع على قسم صف "الإجمالي: أخرى").

الاختلافات في المقاييس بين طرق عرض مواضع الإعلانات

يتم تقييم الحد الأدنى للنشاط بشكل مستقل على كل مستوى من مستويات التفاصيل:

• يقيّم المورد 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 فقط، لأنّ ذلك قد يؤدي إلى استبدال المقاييس في مواضع إعلان مختلفة ببيانات وصفية غير متاحة. لاستبعاد الصفوف التي تتضمّن بيانات وصفية غير متاحة في لغة طلب البحث في "إعلانات Google"، يمكنك الفلترة حسب الحقل target_url أو display_name (على سبيل المثال، WHERE detail_placement_view.target_url IS NOT NULL)، لأنّه لا يمكن فلترة الحقلَين placement وresource_name.

طريقة عرض مواضع الإعلانات في "حملات الأداء الأفضل"

• ما يعرضه: يوفّر المورد performance_max_placement_view بيانات مرّات الظهور (metrics.impressions) لمواضع الإعلانات التي تم فيها عرض "إعلانات الأداء الأفضل". في الإصدار 24 والإصدارات الأحدث، يمكنك تقسيم performance_max_placement_view حسب segments.ad_network_type (غير متاح في الإصدار 23).
• أداة إنشاء الطلبات: الاستكشاف في "أداة إنشاء الطلبات"

أيّ عرض يجب استخدامه؟

• استخدِم managed_placement_view لتقييم أداء مواضع الإعلانات التي تستهدفها وتقدّم عروض أسعار لها بشكل نشط.
• استخدِم group_placement_view لفهم النطاق الكامل لأماكن ظهور إعلاناتك، خاصةً عند استخدام إعداد "الملاحظة"، وذلك لاكتشاف فرص استهداف أو استبعاد جديدة.
• استخدِم detail_placement_view للحصول على أدق التفاصيل حول عناوين URL أو الفيديوهات المحدّدة التي ظهرت فيها إعلاناتك، والتي تُستخدم غالبًا بعد تحديد نطاق أو قناة تهمّك في group_placement_view.
• استخدِم performance_max_placement_view لفحص مرات ظهور مواضع الإعلانات في "حملات الأداء الأفضل".