التقسيم

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

أمثلة

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

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