التقسيم

تتوفّر ميزة "التقسيم" في واجهة مستخدِم "إعلانات 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 للمجموعة الإعلانية. قائمة Segments هي الجزء الأصفر من جدول الحقول المتاحة في صفحة البيانات الوصفية لمورد ad_group.

مراجع الشرائح

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

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