REST Resource: firstAndThirdPartyAudiences

المرجع: FirstAndThirdParty Audience

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

تمثيل 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)

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

إذا كان الحجم أقل من 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 مع نوع 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)
    }
  ],
  "consent": {
    object (Consent)
  }
}
الحقول
contactInfos[]

object (ContactInfo)

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

consent

object (Consent)

الإدخال فقط. إعداد الموافقة للمستخدمين في contactInfos.

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

في حال ضبط الحقل adUserData أو adPersonalization على CONSENT_STATUS_DENIED، سيعرض الطلب خطأً.

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

رمز البلد للعضو

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

ConsentStatus

حالة الموافقة

عمليات التعداد
CONSENT_STATUS_UNSPECIFIED قيمة النوع غير محدّدة أو غير معروفة في هذا الإصدار.
CONSENT_STATUS_GRANTED تم منح الموافقة.
CONSENT_STATUS_DENIED تم رفض الموافقة.

MobileDeviceIdList

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

تمثيل JSON
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
الحقول
mobileDeviceIds[]

string

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

consent

object (Consent)

الإدخال فقط. إعداد الموافقة للمستخدمين في mobileDeviceIds.

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

في حال ضبط الحقل adUserData أو adPersonalization على CONSENT_STATUS_DENIED، سيعرض الطلب خطأً.

الطُرق

create

ينشئ FirstAndThirdPartyالجمهور.

editCustomerMatchMembers

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

get

الحصول على جمهور للطرف الأول والطرف الثالث.

list

يسرد شرائح جمهور الطرف الأول والطرف الثالث.

patch

تعمل هذه السياسة على تعديل فئة FirstAndPartyParty الحالية.