التقسيم

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

موارد الشرائح

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

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

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

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