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

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

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

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

فحص MutateAudienceResult بحثًا عن audience_id

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

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

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

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

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

الجمهور المستهدف‬‏‫

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

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

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

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

تتيح "حملات زيادة الطلب" و"حملات التطبيقات" إضافة معيار مجموعة إعلانية خاص بالجمهور باستخدام AdGroupCriterion لاستهداف شرائح الجمهور أو تقديم إشارات الجمهور. يمكنك استهداف شرائح الجمهور على مستوى المجموعة الإعلانية باستخدام معايير AudienceInfo على AdGroupCriterion.audience من خلال ضبط الحقل AudienceInfo.audience (ad_group_criterion.audience.audience) على اسم مصدر الجمهور.

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

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

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

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

إنشاء AdGroupCriterion

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

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

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

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

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

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

عند إنشاء Audience أو تعديله، تتحقّق Google Ads API من صحة الطلب وتعرض أخطاء من تعداد 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
ملخّص يحتوي الجمهور على عدد كبير جدًا من الشرائح.
الأسباب الشائعة تجاوز الحدّ الأقصى المسموح به لعدد الشرائح في شريحة جمهور
طريقة التعامل قلِّل عدد الشرائح في تعريف الجمهور.
نصائح للوقاية من الفيروس راجِع المستندات لمعرفة الحدود القصوى لعدد الشرائح لكل جمهور.