التقسيم

تتوفّر الشرائح في واجهة مستخدم "إعلانات 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، سيتم حصر الشرائح المتبقية المتاحة للاختيار في التقاطع بين هاتين القائمتين.

الفلترة الضمنية من خلال اختيار الشرائح

عند اختيار حقول شرائح معيّنة في طلب البحث، قد تعمل Google Ads API على فلترة النتائج ضمنيًا لتضمين الصفوف التي تنطبق فيها شريحة الجمهور هذه والتي تتضمّن قيمة فقط.

تأثير segments.keyword.*

يحدث مثال شائع ومهم لهذا السلوك عند اختيار أي حقل ضمن segments.keyword (مثل segments.keyword.info.text وsegments.keyword.ad_group_criterion).

  • استبعاد الزيارات غير المستندة إلى كلمات رئيسية: إذا أدرجت أي segments.keyword.*حقل في عبارة SELECT، سيؤدي ذلك إلى حصر النتائج في الصفوف المرتبطة مباشرةً بمعيار مجموعة إعلانية لكلمة رئيسية على "شبكة البحث".

  • أنواع الحملات المتأثّرة: نتيجةً لذلك، يتم استبعاد البيانات من أنواع الحملات أو المجموعات الإعلانية التي لا تعتمد على الكلمات الرئيسية على "شبكة البحث" من النتائج. ويشمل ذلك على سبيل المثال لا الحصر:

    • الإعلانات الديناميكية على شبكة البحث: لأنّ استهدافات الإعلانات الديناميكية على شبكة البحث تستند إلى محتوى الموقع الإلكتروني وليس إلى الكلمات الرئيسية.
    • حملات Shopping: تستخدِم مجموعات المنتجات بدلاً من الكلمات الرئيسية.
    • "حملات الأداء الأفضل": على الرغم من أنّ "حملات الأداء الأفضل" قد تعرض إعلاناتها على شبكة البحث، لا يتم عادةً تقسيم تقاريرها حسب معايير الكلمات الرئيسية نفسها.

  • الشبكة الإعلانية: تشير حقول segments.keyword.* إلى الكلمات الرئيسية المستخدَمة على شبكة البحث. ولا يتم تقسيمها حسب الكلمات الرئيسية على "الشبكة الإعلانية" أو طرق الاستهداف الأخرى على الشبكة الإعلانية.

أفضل الممارسات: إذا كان تحليلك يتطلّب تضمين بيانات الأداء من الإعلانات الديناميكية على شبكة البحث أو Shopping أو مصادر أخرى غير مستندة إلى الكلمات الرئيسية على شبكة البحث، لا تُدرِج حقولاً من segments.keyword.* في طلب البحث. حلِّل البيانات على مستوى جميع أنواع الحملات أولاً، ولا تطبِّق تقسيم الكلمات الرئيسية إلا عند التركيز على أداء الكلمات الرئيسية على شبكة البحث.

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

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