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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of mutually exclusive fields.
}
الحقول
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)

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

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

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

string (int64 format)

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

إذا كان الحجم أقل من 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)

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

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

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

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

string (int64 format)

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

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

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

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

string (int64 format)

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

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

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

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

string

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

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

object (ContactInfoList)

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

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

object (MobileDeviceIdList)

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

ينطبق على audienceType CUSTOMER_MATCH_DEVICE_ID فقط
نهاية الحقول التي يستبعد كلّ منها الآخر

ContactInfoList

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

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

object (ContactInfo)

اختيارية: قائمة بعناصر ContactInfo تحدّد أفراد الجمهور في "مطابقة العملاء". يجب ألا يزيد عدد الأعضاء بعد تقسيم contactInfos عن 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

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

object (Consent)

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

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

إذا تم ضبط الحقلَين adUserData أو adPersonalization على CONSENT_STATUS_DENIED، سيعرض الطلب خطأ.

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 نشأت على YouTube
ADS_DATA_HUB نشأت من Ads Data Hub.

الطُرق

create

 تُنشئ هذه الطريقة كائن FirstPartyAndPartnerAudience.

editCustomerMatchMembers

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

get

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

list

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

patch

 تعديل FirstPartyAndPartnerAudience حالي