التقسيم

تتوفّر الشرائح في واجهة مستخدم "إعلانات 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.ad_sub_format_type (الذي يقسّم "الإعلانات غير القابلة للتخطّي أثناء عرض الفيديو" على YouTube حسب المدة) في طلب البحث نفسه مع segments.ad_format_type.

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

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

السابق
تتبُّع موضع الإعلان وأدائه
التالي
صِفْرْ