Method: customers.generateAudienceCompositionInsights

এমন বৈশিষ্ট্যগুলির একটি সংগ্রহ দেখায় যা আগ্রহের শ্রোতাদের মধ্যে প্রতিনিধিত্ব করা হয়, এমন মেট্রিক্সের সাথে যা দর্শকদের প্রতিটি বৈশিষ্ট্যের ভাগের সাথে একটি বেসলাইন দর্শকের ভাগের তুলনা করে।

নিক্ষিপ্ত ত্রুটির তালিকা: শ্রোতা অন্তর্দৃষ্টি ত্রুটি প্রমাণীকরণ ত্রুটি অনুমোদন ত্রুটি ক্ষেত্র ত্রুটি হেডার ত্রুটি অভ্যন্তরীণ ত্রুটি কোটা ত্রুটি রেঞ্জ ত্রুটি অনুরোধ ত্রুটি

HTTP অনুরোধ

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAudienceCompositionInsights

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
customerId

string

প্রয়োজন। গ্রাহকের আইডি।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
ক্ষেত্র
audience

object ( InsightsAudience )

প্রয়োজন। আগ্রহের শ্রোতা যার জন্য অন্তর্দৃষ্টি অনুরোধ করা হচ্ছে.

baselineAudience

object ( InsightsAudience )

বেসলাইন দর্শক যার সাথে আগ্রহের দর্শকদের তুলনা করা হচ্ছে।

dataMonth

string

"yyyy-mm" বিন্যাসে অন্তর্দৃষ্টির জন্য ব্যবহার করার জন্য ঐতিহাসিক ডেটার এক মাসের পরিসর। যদি সেট না থাকে, তাহলে শেষ ত্রিশ দিনের ডেটার জন্য অন্তর্দৃষ্টি ফেরত দেওয়া হবে৷

dimensions[]

enum ( AudienceInsightsDimension )

প্রয়োজন। শ্রোতার মাত্রা যার জন্য রচনার অন্তর্দৃষ্টি ফেরত দেওয়া উচিত৷

customerInsightsGroup

string

গ্রাহকের নাম যার জন্য পরিকল্পনা করা হচ্ছে। এটি একটি ব্যবহারকারী-সংজ্ঞায়িত মান।

প্রতিক্রিয়া শরীর

AudienceInsightsService.GenerateAudienceCompositionInsights এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
ক্ষেত্র
sections[]

object ( AudienceCompositionSection )

অন্তর্দৃষ্টি প্রতিবেদনের বিষয়বস্তু, বিভাগগুলিতে সংগঠিত। প্রতিটি বিভাগ অনুরোধে AudienceInsightsDimension মানগুলির একটির সাথে যুক্ত। প্রতি মাত্রায় একাধিক বিভাগ থাকতে পারে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/adwords

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

শ্রোতা রচনা বিভাগ

শ্রোতা রচনার অন্তর্দৃষ্টি প্রতিবেদনে একই ধরণের সম্পর্কিত বৈশিষ্ট্যগুলির একটি সংগ্রহ৷

JSON প্রতিনিধিত্ব
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
ক্ষেত্র
dimension

enum ( AudienceInsightsDimension )

এই বিভাগে বৈশিষ্ট্যের ধরন।

topAttributes[]

object ( AudienceCompositionAttribute )

এই দর্শকদের জন্য সবচেয়ে প্রাসঙ্গিক বিভাগ. যদি মাত্রা GENDER, AGE_RANGE বা PARENTAL_STATUS হয়, তাহলে গুণাবলীর এই তালিকাটি সম্পূর্ণ।

clusteredAttributes[]

object ( AudienceCompositionAttributeCluster )

এই শ্রোতাদের জন্য অতিরিক্ত গুণাবলী, ক্লাস্টারে গোষ্ঠীবদ্ধ। মাত্রা YOUTUBE_CHANNEL হলেই কেবল জনবহুল।

AudienceCompositionAttribute

মেটাডেটা এবং মেট্রিক্স সহ একটি শ্রোতা বৈশিষ্ট্য।

JSON প্রতিনিধিত্ব
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
ক্ষেত্র
attributeMetadata

object ( AudienceInsightsAttributeMetadata )

এর মেটাডেটা সহ বৈশিষ্ট্য।

metrics

object ( AudienceCompositionMetrics )

বৈশিষ্ট্যের জন্য শেয়ার এবং সূচক মেট্রিক্স।

অডিয়েন্স কম্পোজিশনমেট্রিক্স

একটি অডিয়েন্স কম্পোজিশন ইনসাইট রিপোর্টে একটি অ্যাট্রিবিউটের সাথে যুক্ত শেয়ার এবং ইনডেক্স মেট্রিক্স।

JSON প্রতিনিধিত্ব
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
ক্ষেত্র
baselineAudienceShare

number

বেসলাইন দর্শকের ভগ্নাংশ (0 থেকে 1 সহ) যা বৈশিষ্ট্যের সাথে মেলে।

audienceShare

number

বৈশিষ্ট্যের সাথে মেলে এমন নির্দিষ্ট দর্শকের ভগ্নাংশ (0 থেকে 1 সহ)।

index

number

বেসলাইন অডিয়েন্সশেয়ার থেকে শ্রোতাভাগের অনুপাত, অথবা যদি এই অনুপাতটি অনির্ধারিত হয় বা অর্থবহ না হয় তাহলে শূন্য৷

score

number

0 থেকে 1 সমেত একটি প্রাসঙ্গিক স্কোর।

AudienceCompositionAttributeCluster

শ্রোতা রচনার অন্তর্দৃষ্টি প্রতিবেদনে মেটাডেটা এবং মেট্রিক্স সহ সম্পর্কিত বৈশিষ্ট্যগুলির একটি সংগ্রহ৷

JSON প্রতিনিধিত্ব
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
ক্ষেত্র
clusterDisplayName

string

গুণাবলী এই ক্লাস্টার নাম

clusterMetrics

object ( AudienceCompositionMetrics )

যদি এই ক্লাস্টারের সাথে যুক্ত ডাইমেনশনটি YOUTUBE_CHANNEL হয়, তাহলে ক্লাস্টারমেট্রিক্স হল সামগ্রিকভাবে ক্লাস্টারের সাথে যুক্ত মেট্রিক্স। অন্যান্য মাত্রার জন্য, এই ক্ষেত্রটি আনসেট করা আছে।

attributes[]

object ( AudienceCompositionAttribute )

মেটাডেটা এবং মেট্রিক্স সহ এই ক্লাস্টারটি তৈরি করে এমন পৃথক বৈশিষ্ট্য।