إنشاء شرائح الجمهور وإدارتها

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

إنشاء شرائح جمهور

يمكنك إنشاء شريحة جمهور وتعديلها باستخدام AudienceService. يجب أن يكون لكل Audience اسم فريد. تسمح شريحة الجمهور القابلة لإعادة الاستخدام هذه بدمج سمات متعدّدة للجمهور:

فحص `MutateAudienceResult` لمعرفة `audience_id`

عند إنشاء شريحة جمهور باستخدام AudienceService.MutateAudiences، تعرض كل عملية MutateAudienceResult. يمكنك فحص MutateAudienceResult للحصول على audience_id إما عن طريق تحليل المعروض resource_name أو عن طريق فحص عنصر audience القابل للتعديل عندما response_content_type يتم ضبطه على MUTABLE_RESOURCE:

# Inspect MutateAudienceResult to get audience_id
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = resource_name.split("/")[-1]
    print(f"Created audience with resource_name '{resource_name}' and audience_id '{audience_id}'.")

    # If response_content_type is MUTABLE_RESOURCE, you can access result.audience.id directly:
    if result.audience and result.audience.id:
        print(f"Audience ID from mutable resource: {result.audience.id}")

يمكنك استهداف شرائح الجمهور على مستوى المجموعة الإعلانية باستخدام AudienceInfo معايير عن طريق ضبط الـ audience حقل في الـ AdGroupCriterion على اسم مورد الجمهور.

استرداد شرائح الجمهور

كما هو الحال مع الموارد الأخرى، يمكنك استخدام GoogleAdsService.SearchStream لاسترداد سمات شرائح الجمهور.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

استهداف شرائح الجمهور

يمكن استهداف شرائح الجمهور بطرق متعدّدة حسب نوع الحملة.

إشارات مجموعة مواد العرض

تستخدِم "حملات الأداء الأفضل" an AssetGroupSignal لاستهداف شرائح الجمهور. راجِع دليل مجموعات مواد العرض للتعرّف على كيفية استهداف شرائح الجمهور باستخدام إشارات مجموعة مواد العرض.

معيار المجموعة الإعلانية

تسمح "حملات زيادة الطلب" و"حملات التطبيقات" بإضافة معيار مجموعة إعلانية للجمهور باستخدام AdGroupCriterion لاستهداف شرائح الجمهور أو تقديم إشارات الجمهور.

في ما يلي خطوات إعداد استهداف الجمهور:

تفعيل استهداف الجمهور في AdGroup

يجب تفعيل استهداف الجمهور في الـ AdGroup عن طريق ضبط use_audience_grouped على true عند إنشاء المجموعة الإعلانية.

يسمح لك ذلك بإضافة AdGroupCriterion مع شرائح الجمهور. إذا لم يتم ضبط هذه القيمة على true، سيتعذّر طلبك اللاحق لاستهداف الجمهور.

إنشاء AdGroupCriterion

أنشئ AdGroupCriterion واضبط حقل audience على اسم مورد الجمهور الذي تم إنشاؤه سابقًا في هذا الدليل.

اختياري: تفعيل استهداف الجمهور في الحملة

يمكنك اختياريًا ضبط use_audience_grouped على true عند إنشاء الحملة. باستخدام هذا الإعداد، سيظهر لك خطأ إذا حاولت إضافة معايير من شأنها استبعاد الشرائح والخصائص الديمغرافية على مستوى الحملة.

أفضل الممارسات

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

الأخطاء الشائعة

عند إنشاء Audience أو تعديله، تتحقّق واجهة برمجة تطبيقات "إعلانات Google" من الطلب وتعرض أخطاء من تعداد AudienceError إذا تعذّر التحقّق من صحة الطلب.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
ملخّص لم يتم العثور على شريحة جمهور في الطلب.
الأسباب الشائعة الإشارة إلى رقم تعريف شريحة غير موجودة أو لا يمكن الوصول إليها
طريقة التعامل تأكَّد من أنّ جميع أرقام تعريف الشرائح موجودة ويمكن الوصول إليها قبل إنشاء شريحة جمهور أو تعديلها.
نصائح للوقاية من الفيروس تحقَّق من صحة أرقام تعريف الشرائح قبل تضمينها في شريحة جمهور.
DIMENSION_INVALID
ملخّص سمة جمهور غير صالحة
الأسباب الشائعة تضمين detailed_demographic في exclusion_dimension
طريقة التعامل لا تستخدِم سوى user_list للاستبعادات في exclusion_dimension.
نصائح للوقاية من الفيروس تأكَّد من استخدام user_list فقط في exclusion_dimension عند إنشاء شريحة جمهور أو تعديلها.
DUPLICATE_AUDIENCE_SEGMENT
ملخّص تحتوي شريحة الجمهور على شرائح مكرّرة.
الأسباب الشائعة إضافة الشريحة نفسها عدة مرات إلى شريحة الجمهور نفسها
طريقة التعامل أزِل الشرائح المكرّرة من تعريف شريحة الجمهور.
نصائح للوقاية من الفيروس تأكَّد من أنّ جميع الشرائح في شريحة الجمهور فريدة.
NAME_ALREADY_IN_USE
ملخّص اسم شريحة الجمهور مستخدَم من قبل.
الأسباب الشائعة محاولة إنشاء شرائح جمهور متعدّدة بالاسم نفسه
طريقة التعامل استخدِم اسمًا فريدًا عند إنشاء شريحة جمهور.
نصائح للوقاية من الفيروس تحقَّق من أسماء شرائح الجمهور الحالية قبل إنشاء شريحة جديدة.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
ملخّص تحتوي شريحة الجمهور على عدد كبير جدًا من السمات من النوع نفسه.
الأسباب الشائعة تضمين سمات متعدّدة من النوع نفسه (على سبيل المثال، سمات عمر متعدّدة) في شريحة جمهور واحدة
طريقة التعامل تأكَّد من أنّ تعريف شريحة الجمهور لا يحتوي إلا على سمة واحدة من كل نوع.
نصائح للوقاية من الفيروس راجِع تعريف شريحة الجمهور للتأكّد من عدم تضمين أي أنواع سمات مكرّرة.
TOO_MANY_SEGMENTS
ملخّص تحتوي شريحة الجمهور على عدد كبير جدًا من الشرائح.
الأسباب الشائعة تجاوز الحدّ الأقصى المسموح به لعدد الشرائح في شريحة الجمهور
طريقة التعامل قلِّل عدد الشرائح في تعريف شريحة الجمهور.
نصائح للوقاية من الفيروس راجِع المستندات لمعرفة الحدود المفروضة على عدد الشرائح لكل شريحة جمهور.
السابق
نظرة عامة
التالي
بدء استخدام شرائح الجمهور