التقسيم

يمكن تنفيذ الشرائح المتوفّرة في واجهة مستخدم "إعلانات 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 وستحدّد المقاييس شرائح ضمنية استنادًا إليه على مستوى ad_group.

لذلك بالنسبة إلى هذا الطلب،

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 في المرجع ضمن صفحة metadata لعبارة FROM. في ما يتعلّق بمصدر ad_group، سترى أنّه يمكنك أيضًا اختيار حقول من مصدر campaign. سيتم تلقائيًا عرض حقل resource_name لأي Attributed Resources يحتوي على حقل واحد على الأقل في عبارة SELECT، حتى إذا لم يتم تضمين حقل resource_name صراحةً في طلب البحث.

على غرار اختيار حقول Attributed Resource، يمكنك أيضًا اختيار حقول Segmenting Resource. إذا كان أحد الموارد يحتوي على قائمة Segmenting Resources في صفحة البيانات الوصفية، سيؤدي اختيار حقول من أحد هذه الموارد المُدرَجة إلى تقسيم طلب البحث بشكل أكبر حسب قيمة Segmenting Resource التي تم عرضها في حقل resource_name. على سبيل المثال، ستلاحظ أنّ المورد 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).

أمثلة

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign

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) في التاريخ نفسه (‎15-06-2024). وبالتالي، يمكننا أن نستنتج أنّ واجهة برمجة التطبيقات تعمل على النحو المطلوب ولم تعرض عناصر مكرّرة في هذه الحالة.