التقسيم

تتوفّر الشرائح في واجهة مستخدم "إعلانات Google" كقائمة منفصلة. يمكنك تنفيذ التقسيم في Google Ads API من خلال إضافة الحقل المناسب إلى طلب بحث. على سبيل المثال، لنفترض أنّك أضفت segments.device إلى طلب بحث. وينتج عن ذلك تقرير يتضمّن صفًا لكل مجموعة من الجهاز والمورد المحدّد في عبارة FROM، والقيم الإحصائية (مرات الظهور والنقرات والإحالات الناجحة وما إلى ذلك) مقسّمة بينها.

في واجهة مستخدم "إعلانات Google"، يمكن استخدام شريحة واحدة فقط في كل مرة، ولكن باستخدام واجهة برمجة التطبيقات، يمكنك تحديد شرائح متعددة في طلب البحث نفسه.

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

ستشبه النتائج التي يتم الحصول عليها عند إرسال طلب البحث هذا إلى GoogleAdsService.SearchStream سلسلة JSON التالية:

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    },
    ...
  ]
}

في هذه النتيجة النموذجية، تكون سمات العنصرَين الأول والثاني، بما في ذلك اسم المورد، متطابقة. يتم تقسيم مرّات الظهور حسب الجهاز، وبالتالي يمكن عرض عنصرَين أو أكثر للحملة نفسها.

التصنيف الضمني

يتم تقسيم كل تقرير في البداية حسب المورد المحدّد في عبارة FROM. يتم عرض الحقل resource_name الخاص بالمرجع في عبارة FROM، ويتم تقسيم المقاييس حسب هذا الحقل، حتى إذا لم يتم تضمين الحقل resource_name بشكل صريح في طلب البحث. على سبيل المثال، عند تحديد ad_group كمصدر في عبارة FROM، سيتم تلقائيًا عرض ad_group.resource_name وسيتم تقسيم المقاييس ضمنيًا حسب هذا المصدر على مستوى المجموعة الإعلانية.

بالنسبة إلى هذا الاستعلام،

SELECT metrics.impressions
FROM ad_group

ستحصل على سلسلة JSON على النحو التالي:

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

يتم دائمًا عرض الحقل resource_name الخاص بـ adGroup لأنّ ad_group محدّد كمورد في عبارة FROM.

حقول شرائح الجمهور القابلة للاختيار

لا يمكن اختيار جميع حقول الشرائح لمورد معيّن في عبارة FROM. على سبيل المثال، لنفترض أنّك ستواصل طلب البحث من المورد ad_group. لكي يكون حقل شريحة قابلاً للاختيار من المورد ad_group، يجب أن يكون هذا الحقل متوفّرًا في القائمة Segments الخاصة بـ ad_group. قائمة Segments هي الجزء الأصفر من جدول الحقول المتاحة في صفحة البيانات الوصفية الخاصة بمورد ad_group.

موارد الأقسام

عند الاختيار من بعض المراجع، قد يتوفّر لك خيار الربط الضمني بالمراجع ذات الصلة من خلال اختيار حقولها إلى جانب حقول المرجع في عبارة FROM. يمكن العثور على هذه المراجع ذات الصلة في قائمة Attributed Resources ضمن المرجع في صفحة بيانات FROM. في حالة المرجع ad_group، سيظهر لك أنّه يمكنك أيضًا اختيار حقول من المرجع campaign. سيتم تلقائيًا عرض الحقل resource_name لأي Attributed Resources يتضمّن حقلًا واحدًا على الأقل في عبارة SELECT، حتى إذا لم يتم تضمين الحقل resource_name بشكل صريح في طلب البحث.

كما هو الحال عند اختيار حقول Attributed Resource، يمكنك أيضًا اختيار حقول Segmenting Resource. إذا كان أحد المراجع يتضمّن Segmenting Resources قائمة في صفحة البيانات الوصفية الخاصة به، واختَرت حقولاً من أحد المراجع المدرَجة، سيؤدي ذلك إلى تقسيم طلب البحث بشكل أكبر حسب resource_name الذي تم عرضه في Segmenting Resource. على سبيل المثال، ستجد أنّ المورد campaign مُدرَج على أنّه Segmenting Resource للمورد campaign_budget. يؤدي اختيار أي حقل من حقول الحملة، مثل campaign.name، من المورد campaign_budget إلى عرض الحقل campaign.name، بالإضافة إلى عرض الحقل campaign.resource_name وتقسيمه.

إمكانية الاختيار بين الشرائح والمقاييس

قد لا يكون حقل شريحة معيّن متوافقًا مع بعض حقول الشرائح الأخرى أو مع بعض حقول المقاييس. لتحديد حقول الشرائح المتوافقة مع بعضها البعض، راجِع قائمة selectable_with بالشرائح في عبارة SELECT.

في حالة مورد ad_group، تتوفّر أكثر من 50 شريحة يمكنك اختيارها. ومع ذلك، فإنّ قائمة selectable_with الخاصة بـ segments.hotel_check_in_date هي مجموعة أصغر بكثير من الشرائح المتوافقة. وهذا يعني أنّه في حال إضافة الحقل segments.hotel_check_in_date إلى العبارة SELECT، سيتم حصر الشرائح المتبقية المتاحة للاختيار في تقاطع هاتين القائمتين.

عند إضافة شرائح معيّنة، قد تنخفض المقاييس في صف الملخّص. عند إضافة segments.keyword.info.match_type إلى طلب بحث يتضمّن FROM ad_group_ad، يطلب هذا القسم من طلب البحث الحصول فقط على صفوف البيانات التي تتضمّن كلمات رئيسية، وإزالة أي صف غير مرتبط بكلمة رئيسية. في هذه الحالة، ستكون المقاييس أقل لأنّها تستبعد أي مقاييس غير مرتبطة بالكلمات الرئيسية.

قواعد الشرائح في عبارة WHERE

عندما يكون جزء في عبارة WHERE، يجب أن يكون أيضًا في عبارة SELECT. يُستثنى من هذه القاعدة شرائح التاريخ التالية، والتي يُشار إليها باسم شرائح التاريخ الأساسية:

  • segments.date
  • segments.week
  • segments.month
  • segments.quarter
  • segments.year

قواعد حقول شريحة الجمهور الأساسية المستندة إلى البيانات

تعمل الأقسام segments.date وsegments.week وsegments.month وsegments.quarter وsegments.year على النحو التالي:

  • يمكن فلترة هذه الشرائح في عبارة WHERE بدون ظهورها في عبارة SELECT.

  • إذا كانت أيّ من هذه الشرائح في عبارة SELECT، يجب تحديد نطاق زمني محدود يتألف من شرائح التاريخ الأساسية في عبارة WHERE. ليس مطلوبًا أن تكون أجزاء التاريخ هي نفسها المحدّدة في SELECT.

أمثلة

غير صالح: بما أنّ segments.date مضمّن في عبارة SELECT، عليك تحديد نطاق تاريخ محدود في عبارة WHERE لـ segments.date أو segments.week أو segments.month أو segments.quarter أو segments.year. 
SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
صالح: يعرض هذا الاستعلام أسماء الحملات والنقرات التي تمّت خلال النطاق الزمني. يُرجى العِلم أنّ segments.date ليس مطلوبًا أن يظهر في عبارة SELECT. 
SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
صالح: يعرض هذا الاستعلام أسماء الحملات والنقرات مقسّمة حسب التاريخ لجميع الأيام في النطاق الزمني. 
SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
صالح: يعرض هذا الاستعلام أسماء الحملات والنقرات مقسّمة حسب الشهر لجميع الأيام ضمن النطاق الزمني. 
SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
صالح: يعرض هذا الاستعلام أسماء الحملات والنقرات مقسّمة حسب الربع ثم حسب الشهر لجميع الأشهر في النطاق الزمني للسنة. 
SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year > 2019
  AND segments.year < 2024

search_term_view

يتم أيضًا تقسيم المرجع search_term_view ضمنيًا حسب المجموعة الإعلانية، وليس فقط عبارة البحث، كما يتضح من بنية اسم المرجع، الذي يتضمّن أيضًا المجموعة الإعلانية. لذلك، ستحصل على بعض الصفوف التي تبدو مكرّرة مع عبارات البحث نفسها التي تظهر في نتائجك، ولكن هذه الصفوف تنتمي إلى مجموعة إعلانية مختلفة.

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2024-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2024-06-15"
      }
    }
  ]
}

على الرغم من أنّ العنصرَين المعروضَين في هذا المثال يبدوان متطابقَين، إلا أنّ أسماء الموارد مختلفة في الواقع، لا سيما في جزء "المجموعة الإعلانية". وهذا يعني أنّ عبارة البحث "صور Google" تُنسَب إلى المجموعتَين الإعلانيتَين (رقم التعريف 2222222222 و33333333333) في التاريخ نفسه (2024-06-15). وبالتالي، يمكننا الاستنتاج أنّ واجهة برمجة التطبيقات عملت على النحو المطلوب ولم تعرض عناصر مكرّرة في هذه الحالة.

السابق
مقاييس المعايير
التالي
صِفْرْ