المورد: DataSegment
تحدّد هذه السمة معرّفًا لشريحة من المساحات الإعلانية المتاحة التي يمكن أن يستهدفها منسّقو الإعلانات أو منسّقو وسائط الإعلان في واجهة مستخدم الصفقات أو حزم المزادات. يتم تنظيم المساحات الإعلانية من قِبل منظِّمين على منصات خارجية. -- Next ID: 9 --
| تمثيل JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "state": enum ( |
| الحقول | |
|---|---|
name |
غير قابل للتغيير المعرّف. المعرّف الفريد لشريحة البيانات يتوافق رقم تعريف الحساب مع رقم تعريف الحساب الذي أنشأ الشريحة. التنسيق: |
createTime |
النتائج فقط. وقت إنشاء شريحة البيانات يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
updateTime |
النتائج فقط. وقت آخر تعديل لشريحة البيانات يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
state |
النتائج فقط. حالة شريحة البيانات |
| سيتم تحصيل الرسوم عندما تستخدم حسابات أخرى شريحة البيانات هذه. على سبيل المثال، عندما تضيف حسابات أخرى شريحة البيانات هذه إلى صفقة أو حزمة مزاد. لا يمكن تغيير نوع الرسوم لشريحة البيانات بعد ضبطه. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد: | |
cpmFee |
اختيارية: رسوم ثابتة يتم تحصيلها لكل ألف ظهور بعد ضبط رمز العملة، لا يمكن تغييره. |
millipercentOfMediaFee |
اختيارية: سيتم تحصيل الرسوم كنسبة مئوية من تكلفة الظهور، ويتم تمثيلها بالنسبة المئوية من الألف. على سبيل المثال، يتم تمثيل %1 على النحو التالي: 1000. |
| نهاية الحقول التي يستبعد كلّ منها الآخر | |
userListId |
اختيارية: غير قابل للتغيير رقم تعريف قائمة المستخدمين التي تتضمّنها شريحة البيانات هذه يمكن لمشرفي البيانات الذين لديهم حساب مرتبط على "شريك البيانات" إنشاء شريحة بيانات تتضمّن قائمة مستخدمين يملكها حساب "شريك البيانات" المرتبط. يمكن تحميل قوائم المستخدمين وإدارتها باستخدام Data Manager API. يتيح لك ربط قائمة مستخدمين بشريحة بيانات تحديد شريحة من المساحة الإعلانية المتاحة استنادًا إلى شريحة جمهور تنشئها. |
ولاية
النتائج فقط. استخدِم طريقة التفعيل والإيقاف لتغيير الحالة.
| عمليات التعداد | |
|---|---|
STATE_UNSPECIFIED |
القيمة التلقائية |
ACTIVE |
شريحة البيانات نشطة. |
INACTIVE |
شريحة البيانات غير نشطة. |
SUSPENDED |
تم تعليق شريحة البيانات ولا يمكن تفعيلها. |
الطُرق |
|
|---|---|
|
لتفعيل شريحة بيانات |
|
تنشئ هذه الطريقة شريحة بيانات يملكها المنسّق المُدرَج. |
|
لإيقاف شريحة بيانات |
|
يتم الحصول على شريحة بيانات من خلال اسمها. |
|
يمكنك إدراج شرائح البيانات التي يملكها أحد المشرفين. |
|
تعديل شريحة بيانات |