REST Resource: firstPartyAndPartnerAudiences

المورد: FirstPartyAndPartnerAudience

يصف قائمة مستخدمين تابعة للطرف الأول أو الشريك يتم استخدامها للاستهداف. يتم إنشاء شرائح جمهور الطرف الأول من خلال استخدام بيانات العملاء. يوفّر مزوّدو البيانات الخارجيون شرائح جمهور الشركاء، ولا يمكن ترخيصها إلا للعملاء.

تمثيل JSON 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
الحقول
name

string

للعرض فقط. اسم المورد الخاص بشريحة جمهور الطرف الأول والشريك
firstPartyAndPartnerAudienceId

string (int64 format)

المعرّف. المعرّف الفريد لجمهور الطرف الأول والشريك يتم تخصيصه من قِبل النظام.
displayName

string

اختيارية: الاسم المعروض لجمهور الطرف الأول والشريك
description

string

اختيارية: الوصف الذي يقدّمه المستخدم للجمهور

ينطبق ذلك على شرائح جمهور الطرف الأول فقط.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

للعرض فقط. ما إذا كان الجمهور من الطرف الأول أو من الشركاء
audienceType

enum (AudienceType)

غير قابل للتغيير نوع الجمهور
audienceSource

enum (AudienceSource)

للعرض فقط. مصدر الجمهور
membershipDurationDays

string (int64 format)

اختيارية: المدة بالأيام التي يبقى فيها الإدخال ضمن الجمهور بعد الحدث المؤهِّل. يجب أن تكون القيمة المحدّدة أكبر من 0 وأقل من أو تساوي 540.

ينطبق ذلك على شرائح جمهور الطرف الأول فقط.

هذا الحقل مطلوب في حال استخدام إحدى القيم التالية للسمة audienceType:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

للعرض فقط. حجم الجمهور المقدّر لـ "الشبكة الإعلانية"

إذا كان الحجم أقل من 1, 000، سيتم إخفاء الرقم وعرض القيمة 0 لأسباب تتعلّق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

يتم عرضها فقط في طلب استرداد بيانات باستخدام GET.
activeDisplayAudienceSize

string (int64 format)

للعرض فقط. حجم الجمهور المقدَّر لـ "الشبكة الإعلانية" في الشهر الماضي

إذا كان الحجم أقل من 1, 000، سيتم إخفاء الرقم وعرض القيمة 0 لأسباب تتعلّق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

يتم عرضها فقط في طلب استرداد بيانات باستخدام GET.
youtubeAudienceSize

string (int64 format)

للعرض فقط. حجم الجمهور المقدّر لشبكة YouTube

إذا كان الحجم أقل من 1, 000، سيتم إخفاء الرقم وعرض القيمة 0 لأسباب تتعلّق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

ينطبق ذلك على شرائح جمهور الطرف الأول فقط.

يتم عرضها فقط في طلب استرداد بيانات باستخدام GET.
gmailAudienceSize

string (int64 format)

للعرض فقط. حجم الجمهور المقدَّر لشبكة Gmail

إذا كان الحجم أقل من 1, 000، سيتم إخفاء الرقم وعرض القيمة 0 لأسباب تتعلّق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

ينطبق ذلك على شرائح جمهور الطرف الأول فقط.

يتم عرضها فقط في طلب استرداد بيانات باستخدام GET.
displayMobileAppAudienceSize

string (int64 format)

للعرض فقط. حجم الجمهور المقدَّر للتطبيقات على الأجهزة الجوّالة في "الشبكة الإعلانية"

إذا كان الحجم أقل من 1, 000، سيتم إخفاء الرقم وعرض القيمة 0 لأسباب تتعلّق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

ينطبق ذلك على شرائح جمهور الطرف الأول فقط.

يتم عرضها فقط في طلب استرداد بيانات باستخدام GET.
displayMobileWebAudienceSize

string (int64 format)

للعرض فقط. حجم الجمهور المقدَّر على الويب على الأجهزة الجوّالة في "الشبكة الإعلانية"

إذا كان الحجم أقل من 1, 000، سيتم إخفاء الرقم وعرض القيمة 0 لأسباب تتعلّق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

ينطبق ذلك على شرائح جمهور الطرف الأول فقط.

يتم عرضها فقط في طلب استرداد بيانات باستخدام GET.
displayDesktopAudienceSize

string (int64 format)

للعرض فقط. حجم الجمهور المقدَّر على أجهزة الكمبيوتر المكتبي في "الشبكة الإعلانية"

إذا كان الحجم أقل من 1, 000، سيتم إخفاء الرقم وعرض القيمة 0 لأسباب تتعلّق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

ينطبق ذلك على شرائح جمهور الطرف الأول فقط.

يتم عرضها فقط في طلب استرداد بيانات باستخدام GET.
appId

string

اختيارية: يتطابق appId مع نوع mobileDeviceIds الذي يتم تحميله.

ينطبق ذلك فقط على audienceType CUSTOMER_MATCH_DEVICE_ID

FirstPartyAndPartnerAudienceType

الأنواع المحتملة لمورد جمهور الطرف الأول والشريك

عمليات التعداد
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED القيمة التلقائية عندما لا يكون النوع محدّدًا أو عندما يكون غير معروف
TYPE_FIRST_PARTY شريحة الجمهور التي يتم إنشاؤها من خلال استخدام بيانات العميل
TYPE_PARTNER شريحة الجمهور التي يقدّمها مزوّدو البيانات التابعون لجهات خارجية

AudienceType

أنواع الجمهور المحتملة

عمليات التعداد
AUDIENCE_TYPE_UNSPECIFIED القيمة التلقائية عندما لا يكون النوع محدّدًا أو عندما يكون غير معروف
CUSTOMER_MATCH_CONTACT_INFO تم إنشاء شريحة الجمهور من خلال مطابقة العملاء بمعلومات الاتصال المعروفة.
CUSTOMER_MATCH_DEVICE_ID تم إنشاء شريحة الجمهور من خلال مطابقة العملاء بأرقام تعريف الأجهزة الجوّالة المعروفة.
CUSTOMER_MATCH_USER_ID تم إنشاء شريحة الجمهور من خلال مطابقة العملاء مع أرقام تعريف مستخدمين معروفة.
ACTIVITY_BASED

متوقّفة نهائيًا: تم إنشاء الجمهور استنادًا إلى نشاط الحملة.
FREQUENCY_CAP

متوقّفة نهائيًا: تم إنشاء شريحة الجمهور استنادًا إلى استبعاد عدد مرّات الظهور التي تم عرضها.
TAG_BASED تم إنشاء شريحة الجمهور استنادًا إلى المتغيّرات المخصّصة المرتبطة بوحدة البكسل.
YOUTUBE_USERS تم إنشاء شريحة الجمهور استنادًا إلى التفاعلات السابقة مع الفيديوهات أو الإعلانات على YouTube أو قناة على YouTube.
THIRD_PARTY تم ترخيص الجمهور للاستخدام من جهة خارجية.
COMMERCE شرائح الجمهور التي يقدّمها شركاء التجارة مقابل رسوم
LINEAR الجمهور المستهدف لمحتوى البرامج التلفزيونية المُجدوَلة
AGENCY جمهور تقدّمه وكالة

AudienceSource

مصادر البيانات المحتملة عن الجمهور

عمليات التعداد
AUDIENCE_SOURCE_UNSPECIFIED القيمة التلقائية عندما لا يكون مصدر بيانات عن الجمهور محدّدًا أو عندما يكون غير معروف
DISPLAY_VIDEO_360 مصدرها "مساحة العرض والفيديو 360"
CAMPAIGN_MANAGER مصدرها "مدير الحملة 360"
AD_MANAGER مصدرها "مدير إعلانات Google"
SEARCH_ADS_360 مصدرها "إعلانات شبكة البحث 360".
YOUTUBE Originated from Youtube.
ADS_DATA_HUB مصدرها Ads Data Hub

الطُرق

get

 تحصل على شريحة جمهور تابعة للطرف الأول أو لشريك.

list

 تعرض هذه الصفحة شرائح جمهور الطرف الأول والشركاء.