REST Resource: firstAndThirdPartyAudiences

المرجع: FirstAndPartyaudience

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

تمثيل JSON 
{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
الحقول
name

string

النتائج فقط. اسم المورد للجمهور الأول والجهة الخارجية.
firstAndThirdPartyAudienceId

string (int64 format)

النتائج فقط. المعرّف الفريد لشريحة جمهور الطرف الأول والطرف الثالث تم تعيينه من قِبل النظام.
displayName

string

الاسم المعروض لجمهور الطرف الأول والطرف الثالث
description

string

الوصف المقدَّم من المستخدِم للجمهور.

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

enum (FirstAndThirdPartyAudienceType)

ما إذا كان الجمهور عبارة عن جمهور للطرف الأول أو الطرف الثالث
audienceType

enum (AudienceType)

نوع الجمهور.
audienceSource

enum (AudienceSource)

النتائج فقط. مصدر الجمهور.
membershipDurationDays

string (int64 format)

المدة بالأيام التي يظل فيها الإدخال ضمن الجمهور بعد الحدث المؤهَّل. إذا لم يكن لشريحة الجمهور تاريخ انتهاء صلاحية، اضبط قيمة هذا الحقل على 10, 000. بخلاف ذلك، يجب أن تكون القيمة المحددة أكبر من 0 وأقل من أو تساوي 540.

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

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

عاد فقط في طلب GET.
activeDisplayAudienceSize

string (int64 format)

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

إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

عاد فقط في طلب GET.
youtubeAudienceSize

string (int64 format)

النتائج فقط. حجم الجمهور المقدّر لشبكة YouTube.

إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

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

عاد فقط في طلب GET.
gmailAudienceSize

string (int64 format)

النتائج فقط. حجم الجمهور المقدّر لشبكة Gmail.

إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

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

عاد فقط في طلب GET.
displayMobileAppAudienceSize

string (int64 format)

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

إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

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

عاد فقط في طلب GET.
displayMobileWebAudienceSize

string (int64 format)

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

إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

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

عاد فقط في طلب GET.
displayDesktopAudienceSize

string (int64 format)

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

إذا كان المقاس أقل من 1000، سيتم إخفاء الرقم وسيتم عرض الرقم 0 لأسباب تتعلق بالخصوصية. وإلا، سيتم تقريب الرقم إلى رقمين معنويين.

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

عاد فقط في طلب GET.
appId

string

يتطابق appId مع نوع mobileDeviceId تم تحميلها.

ينطبق فقط على audienceType CUSTOMER_MATCH_DEVICE_ID
حقل الاتحاد members الأعضاء الأوليون لجمهور "مطابقة العملاء". يمكن أن تكون السمة "members" واحدة فقط مما يلي:
contactInfoList

object (ContactInfoList)

الإدخال فقط. قائمة بمعلومات الاتصال لتحديد أعضاء الجمهور الأولي.

ينطبق فقط على audienceType CUSTOMER_MATCH_CONTACT_INFO
mobileDeviceIdList

object (MobileDeviceIdList)

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

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

FirstAndThirdPartyAudienceType

الأنواع المحتملة من مورد الجمهور الأول والتابع لجهة خارجية.

عمليات التعداد
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED القيمة التلقائية عندما يكون النوع غير محدد أو غير معروف.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY شريحة الجمهور التي يتم إنشاؤها عن طريق استخدام بيانات العميل
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY شريحة الجمهور التي يوفّرها مزوّدو البيانات التابعون لجهات خارجية

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.
LICENSED نوع فرعي من نوع جمهور الجهات الخارجية.

AudienceSource

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

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

ContactInfoList

رسالة التفافية لقائمة من معلومات الاتصال تحدّد أعضاء جمهور "مطابقة العملاء".

تمثيل JSON 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ]
}
الحقول
contactInfos[]

object (ContactInfo)

قائمة بكائنات ContactInfo التي تحدّد أعضاء جمهور "مطابقة العملاء" يجب ألا يزيد عدد الأعضاء بعد تقسيم contactInfos عن 500,000.

ContactInfo

معلومات الاتصال التي تُحدِّد أحد أفراد جمهور "مطابقة العملاء"

تمثيل JSON 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
الحقول
hashedEmails[]

string

قائمة تتضمّن البريد الإلكتروني المجزّأ التابع لخوارزمية SHA256 للعضو. قبل التجزئة، يجب إزالة المسافات البيضاء بالكامل والتأكد من كتابة جميع أحرف السلسلة بأحرف صغيرة.
hashedPhoneNumbers[]

string

قائمة بأرقام هواتف SHA256 المجزّأة للعضو. قبل التجزئة، يجب تنسيق جميع أرقام الهواتف باستخدام تنسيق E.164 وتضمين رمز الاتصال بالبلد.
zipCodes[]

string

قائمة الرموز البريدية للعضو.

يجب أيضًا ضبطه باستخدام الحقول التالية:
hashedFirstName

string

تمت تجزئة الاسم الأول للعضو SHA256. قبل التجزئة، يجب إزالة المسافات البيضاء بالكامل والتأكد من كتابة جميع أحرف السلسلة بأحرف صغيرة.

يجب أيضًا ضبطه باستخدام الحقول التالية:
hashedLastName

string

تمت تجزئة اسم العائلة للعضو باستخدام خوارزمية SHA256. قبل التجزئة، يجب إزالة المسافات البيضاء بالكامل والتأكد من كتابة جميع أحرف السلسلة بأحرف صغيرة.

يجب أيضًا ضبطه باستخدام الحقول التالية:
countryCode

string

رمز بلد العضو

يجب أيضًا ضبطه باستخدام الحقول التالية:

MobileDeviceIdList

رسالة التفافية لقائمة من أرقام تعريف الأجهزة الجوّالة التي تُحدِّد أعضاء جمهور "مطابقة العملاء".

تمثيل JSON 
{
  "mobileDeviceIds": [
    string
  ]
}
الحقول
mobileDeviceIds[]

string

قائمة بأرقام تعريف الأجهزة الجوّالة التي تُحدِّد أعضاء جمهور "مطابقة العملاء". يجب ألا يتجاوز حجم mobileDeviceId 500,000.

الطُرق

create

 يؤدي هذا الخيار إلى إنشاء شريحة جمهور في الأولى.

editCustomerMatchMembers

 تُعدِّل قائمة الأعضاء لشريحة جمهور "مطابقة العملاء".

get

 الحصول على شريحة جمهور للطرف الأول وطرف ثالث

list

 يسرد شرائح الجمهور الأولى وشرائح الجمهور التابعة لجهة خارجية.

patch

 لتعديل جمهور حالي في FirstAndPartyUsers