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

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