Method: customers.generateAudienceCompositionInsights

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

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

HTTP অনুরোধ

POST https://googleads.googleapis.com/v14/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 ওভারভিউ দেখুন।

অন্তর্দৃষ্টি শ্রোতা

ব্যবহারকারীদের একটি সেট, বিভিন্ন বৈশিষ্ট্য দ্বারা সংজ্ঞায়িত, যার জন্য AudienceInsightsService-এ অন্তর্দৃষ্টি অনুরোধ করা যেতে পারে।

JSON প্রতিনিধিত্ব
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
ক্ষেত্র
countryLocations[]

object ( LocationInfo )

প্রয়োজন। দর্শকদের জন্য দেশ.

subCountryLocations[]

object ( LocationInfo )

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

gender

object ( GenderInfo )

দর্শকদের জন্য লিঙ্গ। অনুপস্থিত হলে, শ্রোতা লিঙ্গ দ্বারা সীমাবদ্ধ না.

ageRanges[]

object ( AgeRangeInfo )

দর্শকদের জন্য বয়সের সীমা। অনুপস্থিত থাকলে, শ্রোতারা 18 বছরের বেশি বয়সী সমস্ত লোককে প্রতিনিধিত্ব করে যা অন্যান্য বৈশিষ্ট্যের সাথে মেলে।

parentalStatus

object ( ParentalStatusInfo )

দর্শকদের জন্য পিতামাতার মর্যাদা। অনুপস্থিত থাকলে, শ্রোতা পিতামাতার অবস্থা দ্বারা সীমাবদ্ধ নয়।

incomeRanges[]

object ( IncomeRangeInfo )

শ্রোতাদের জন্য পারিবারিক আয়ের শতকরা সীমা। অনুপস্থিত থাকলে, শ্রোতা পরিবারের আয়ের পরিসর দ্বারা সীমাবদ্ধ করে না।

dynamicLineups[]

object ( AudienceInsightsDynamicLineup )

শ্রোতাদের দ্বারা দেখা YouTube সামগ্রীর প্রতিনিধিত্বকারী গতিশীল লাইনআপ।

topicAudienceCombinations[]

object ( InsightsAudienceAttributeGroup )

শ্রোতাদের সংজ্ঞায়িতকারী সত্তা, বিভাগ এবং ব্যবহারকারীর আগ্রহের বৈশিষ্ট্যের সংমিশ্রণ। সংমিশ্রণটির একটি যৌক্তিক AND-of-ORs গঠন রয়েছে: প্রতিটি InsightsAudienceAttributeGroup-এর মধ্যে বৈশিষ্ট্যগুলি OR-এর সাথে একত্রিত হয় এবং সংমিশ্রণগুলি নিজেই AND-এর সাথে একত্রিত হয়। উদাহরণস্বরূপ, অভিব্যক্তি (এন্টিটি বা অ্যাফিনিটি) এবং (ইন-মার্কেট বা বিভাগ) দুটি InsightsAudienceAttributeGroups ব্যবহার করে প্রতিটি দুটি বৈশিষ্ট্যের সাথে গঠিত হতে পারে।

InsightsAudienceAttributeGroup

AudienceInsightsAttributes এর একটি তালিকা।

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

object ( AudienceInsightsAttribute )

প্রয়োজন। যৌক্তিক OR এর সাথে একত্রিত করার জন্য দর্শকের বৈশিষ্ট্যগুলির একটি সংগ্রহ৷ গুণাবলী সব একই মাত্রা হতে হবে না. এই প্রসঙ্গে শুধুমাত্র নলেজ গ্রাফ সত্তা, পণ্য ও পরিষেবা বিভাগ এবং অ্যাফিনিটি এবং ইন-মার্কেট শ্রোতা সমর্থিত।

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

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

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 )

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