- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- AudienceCompositionSection
- AudienceCompositionAttribute
- AudienceCompositionMetrics
- AudienceCompositionAttributeCluster
- جرِّبه الآن
تعرض مجموعة من السمات التي تم تمثيلها في جمهور محل الاهتمام، بمقاييس تقارن حصة كل سمة من الجمهور بحصتها من الجمهور الأساسي.
قائمة الأخطاء التي تظهر: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "audience": { object ( |
الحقول | |
---|---|
audience |
مطلوبة. الجمهور محل الاهتمام المطلوب طلب الإحصاءات له. |
baselineAudience |
الجمهور الأساسي الذي تتم مقارنة الجمهور محل الاهتمام. |
dataMonth |
النطاق لمدة شهر واحد من البيانات السابقة لاستخدامها في الإحصاءات، بالتنسيق "yyyy-mm". في حال ترك هذه السياسة بدون ضبط، سيتم عرض الإحصاءات الخاصة بالبيانات المتعلّقة بآخر ثلاثين يومًا. |
dimensions[] |
مطلوبة. أبعاد الجمهور التي يجب عرض إحصاءات المقطوعات الموسيقية لها. |
customerInsightsGroup |
اسم العميل الذي يتم التخطيط له. وهذه قيمة من تحديد المستخدم. |
نص الاستجابة
رسالة الرد على AudienceInsightsService.GenerateAudienceCompositionInsights
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"sections": [
{
object ( |
الحقول | |
---|---|
sections[] |
محتوى تقرير الإحصاءات، منظّم في أقسام. يرتبط كل قسم بإحدى قيم "مكوّن إحصاءات الجمهور" في الطلب. قد يكون هناك أكثر من قسم واحد لكل سمة. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
AudienceCompositionSection
مجموعة من السمات ذات الصلة من النوع نفسه في تقرير إحصاءات فئات الجمهور.
تمثيل JSON |
---|
{ "dimension": enum ( |
الحقول | |
---|---|
dimension |
نوع السمات في هذا القسم. |
topAttributes[] |
الشرائح الأكثر ملاءمةً لهذا الجمهور إذا كانت السمة مثل GENDER أو AGE_RANGE أو PARENTAL_STATUS، تكون قائمة السمات هذه شاملة. |
clusteredAttributes[] |
سمات إضافية لهذا الجمهور، مجمّعة في مجموعات. لا تتم تعبئتها إلا إذا كانت السمة YOUTUBE_CHANNEL. |
AudienceCompositionAttribute
سمة جمهور مع بيانات وصفية ومقاييس.
تمثيل JSON |
---|
{ "attributeMetadata": { object ( |
الحقول | |
---|---|
attributeMetadata |
السمة مع بياناتها الوصفية |
metrics |
مشاركة مقاييس السمة وفهرستها |
AudienceCompositionMetrics
مقاييس المشاركة والمؤشر المرتبطة بسمة معيّنة في تقرير إحصاءات تكوين الجمهور.
تمثيل JSON |
---|
{ "baselineAudienceShare": number, "audienceShare": number, "index": number, "score": number } |
الحقول | |
---|---|
baselineAudienceShare |
الكسر (من 0 إلى 1 شامل) الجمهور الأساسي الذي يتطابق مع السمة. |
audienceShare |
الكسر (من 0 إلى 1 شامل) شريحة الجمهور المحدّدة التي تتطابق مع السمة. |
index |
نسبة جمهور مشاركة الجمهور إلى مشاركة الجمهور المرجعية، أو صفر إذا كانت هذه النسبة غير محدّدة أو لم تكن ذات دلالة. |
score |
هي نتيجة مدى الصلة بالموضوع تتراوح من 0 إلى 1 شاملة. |
AudienceCompositionAttributeCluster
مجموعة من السمات ذات الصلة مع البيانات الوصفية والمقاييس في تقرير إحصاءات تكوين الجمهور.
تمثيل JSON |
---|
{ "clusterDisplayName": string, "clusterMetrics": { object ( |
الحقول | |
---|---|
clusterDisplayName |
اسم مجموعة السمات هذه |
clusterMetrics |
إذا كان البُعد المرتبط بهذه المجموعة هو YOUTUBE_CHANNEL، تكون مقاييس المجموعة عبارة عن مقاييس مرتبطة بالمجموعة ككل. وبالنسبة إلى السمات الأخرى، لن يتم ضبط هذا الحقل. |
attributes[] |
السمات الفردية التي تشكل هذه المجموعة، مع البيانات الوصفية والمقاييس. |