الجداول الخاصة
جدول Partner
اسم الحقل | النوع | الوصف |
---|---|---|
common_data | EntityCommonData | تحتوي على البيانات الشائعة عن هذا الشريك، مثل الاسم ورقم التعريف. |
currency_code | string | رمز عملة مكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، على سبيل المثال USD للدولار الأمريكي. |
exchange_settings | [ExchangeSettings] | مصفوفة من أنواع ExchangeSettings تحتوي على معلومات مثل أرقام تعريف المقاعد لن تظهر سوى التبادلات المفعَّلة. |
default_partner_costs | PartnerCosts | تحتوي على معلومات عن التكاليف المترتبة على هذا الخطأ بالنسبة إلى هذا الشريك. |
default_partner_revenue_model | PartnerRevenueModel | تحتوي على معلومات عن نموذج الأرباح التلقائي لهذا الشريك. |
default_target_list | TargetList | يحتوي على خيارات الاستهداف التلقائية للشريك. لا يتوفّر حاليًا سوى الاستهداف الجغرافي التلقائي هنا. |
جدول Advertiser
اسم الحقل | النوع | الوصف |
---|---|---|
common_data | EntityCommonData | تحتوي على البيانات الشائعة عن هذا المعلِن، مثل الاسم ورقم التعريف. |
partner_id | Numeric Id | رقم تعريف عنصر الشريك الرئيسي يمكن الانضمام باستخدام Partner.common_data.id . |
currency_code | string | رمز عملة مكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، على سبيل المثال USD للدولار الأمريكي. |
timezone_code | string | رمز المنطقة الزمنية الأساسي، على سبيل المثال "America/Los_Angeles". إذا تم ضبط dfa_configuration على NORMAL أو HYBRID ، ستكون هذه القيمة هي نفسها المنطقة الزمنية لمعلن DoubleClick المرتبط. |
landing_page_url | string | تمثّل هذه السمة عنوان URL التلقائي للصفحة المقصودة. |
available_channel_ids | [integer] | مصفوفة من الأعداد الصحيحة التي تحتوي على القنوات المتاحة المرتبطة بهذا المعلِن. يمكن الانضمام باستخدام UniversalChannel.id . |
blacklist_channel_id | [integer] | مصفوفة من الأعداد الصحيحة التي تحتوي على قنوات القائمة السوداء لهذا المعلِن. يمكن الانضمام باستخدام UniversalChannel.id . |
dcm_configuration | Enum | 0=NONE |
dcm_network_id | Numeric Id | رقم تعريف شبكة "مدير الحملة 360" لن تتوفّر هذه القيمة في حال ضبط dcm_configuration على NONE . |
dcm_advertiser_id | Numeric Id | رقم تعريف المعلِن في "مدير الحملة 360" لن تتوفّر هذه القيمة في حال ضبط dcm_configuration على NONE . |
dcm_floodlight_group_id | Numeric Id | لن تتوفّر هذه القيمة في حال ضبط dcm_configuration على NONE . |
dcm_syncable_site_ids | [Numeric Id] | مصفوفة من أنواع Numeric Id لكل موقع إلكتروني قابل للمزامنة لهذا المعلِن. |
enable_oba_tags | boolean | يتم تفعيل علامات OBA عند ضبط القيمة على true . |
جدول Campaign
اسم الحقل | النوع | الوصف |
---|---|---|
common_data | EntityCommonData | تحتوي على البيانات الشائعة عن هذه الحملة، مثل الاسم ورقم التعريف. |
advertiser_id | Numeric Id | رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id |
budget | Budget | الميزانية المخطّطة لهذه الحملة ويشمل ذلك وقت البدء ووقت الانتهاء. |
frequency_cap | FrequencyCap | عدد مرات الظهور النشط لهذه الحملة لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور. |
default_target_list | TargetList | تحتوي على معلومات عن الاستهداف الساري لهذه الحملة. |
uses_video_creatives | boolean | عند ضبط هذه السياسة على "صحيح"، سيتم اقتراح طلبات إدراج الفيديو. |
uses_display_creatives | boolean | عند ضبط هذه السياسة على "صحيح"، سيتم اقتراح طلبات إدراج الإعلانات المعروضة. |
uses_audio_creatives | boolean | عند ضبط هذه السياسة على "صحيح"، سيتم اقتراح طلبات إدراج الصوت. |
objective | Enum |
القيم هي:1 = BRAND_AWARENESS 2 = ONLINE_ACTION 3 = OFFLINE_ACTION 4 = APP_INSTALL |
metric | Enum |
مؤشر الأداء الرئيسي. استخدم هذا الحقل لتتبع المقياس الأساسي الذي ستستخدمه لتقييم نجاح حملتك.
القيم المتاحة:1 = IMPRESSIONS 2 = VIEWABLE_IMPRESSIONS 3 = CPM 4 = CPV 5 = UNIQUES 6 = GRP 7 = TRP 8 = VCR 9 = CPA 10 = ROAS 11 = CTR 12 = CPC 13 = CVR 14 = CPI 15 = VIEWABLE_PERCENT 16 = CPIAVC 17 = OTHER |
objective_description | String | عندما يكون المقياس OTHER ، يكون هذا هو الوصف المختصر للمقياس. |
metric_amount_micros | integer | المبلغ المستهدَف للمقياس بالميكرو |
جدول InsertionOrder
اسم الحقل | النوع | الوصف |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id . |
campaign_id | Numeric Id | رقم تعريف عنصر الحملة الرئيسية. |
overall_budget | Budget | الميزانية الإجمالية لطلب الإدراج هذا ويشمل ذلك وقت البدء ووقت الانتهاء. |
scheduled_segments | [Budget] | يحتوي على أي شرائح مُجدوَلة للميزانية. قد تكون هذه المصفوفة فارغة أو غير متاحة إطلاقًا. |
frequency_cap | FrequencyCap | عدد مرّات الظهور النشط لطلب الإدراج هذا لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور. |
default_partner_costs | PartnerCosts | |
default_target_list | TargetList |
جدول LineItem
اسم الحقل | النوع | الوصف |
---|---|---|
common_data |
EntityCommonData |
|
line_item_type | Enum |
0=RTB |
insertion_order_id |
Numeric Id |
رقم تعريف عنصر طلب الإدراج الرئيسي يمكن الانضمام مع
InsertionOrder.common_data.id |
creative_ids | [Numeric Id] | مصفوفة من تصميمات الإعلانات التي تم تعيينها لهذا العنصر. يمكن الانضمام باستخدام Creative.common_data.id . |
max_cpm_advertiser_micros | integer | قيمة التكلفة القصوى لكل ألف ظهور بعملة المعلن بالمايكرو. |
performance_goal | Enum | 0=NONE (تم إيقاف التكلفة لكل ألف ظهور قابل للعرض)1=CPC |
goal_advertiser_micros | integer | هدف vCPM بعملة المعلن بالمايكرو لن تتوفّر هذه القيمة في حال ضبط performance_goal على NONE . |
partner_revenue_model | PartnerRevenueModel | نموذج أرباح الشركاء المستخدَم لهذا العنصر |
cost_tracking_pixels | [CostTrackingPixel] | مصفوفة CostTrackingPixel المخصّصة لتتبُّع هذا البند. |
Budget | Budget | الميزانية الإجمالية لهذا العنصر ويشمل ذلك وقت البدء ووقت الانتهاء. |
frequency_cap | FrequencyCap | عدد مرّات الظهور النشط لهذا العنصر لن تكون هذه القيمة متوفّرة في حال عدم ضبط عدد مرات الظهور. |
partner_costs | PartnerCosts | |
target_list | TargetList | يحتوي على معلومات عن الاستهداف الساري لهذا العنصر. |
جدول Creative
اسم الحقل | النوع | الوصف |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id . |
dcm_placement_id | Numeric Id | رقم تعريف موضع الإعلان في "مدير الحملة 360" المرتبط بتصميم الإعلان هذا. |
width_pixels | integer | عرض تصميم الإعلان بالبكسل |
height_pixels | integer | ارتفاع تصميم الإعلان بالبكسل |
approval_status | [ApprovalStatus] | مصفوفة تحتوي على عناصر ApprovalStatus تمثل حالة تصميمات الإعلانات في التبادلات التي توافق على تصميمات الإعلانات |
expanding_direction | Enum | 0=Not Expandable |
creative_type | Enum |
0=Image or HTML5 |
جدول Pixel
اسم الحقل | النوع | الوصف |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id . |
partner_id | Numeric Id | رقم تعريف عنصر الشريك الرئيسي يمكن الانضمام باستخدام Partner.common_data.id . |
dcm_floodlight_id | Numeric Id | رقم تعريف Floodlight في Floodlight المرتبط بهذا البكسل. |
allow_google_redirect | boolean | |
allow_rm_redirect | boolean | عند الضبط على true ، سيتم تفعيل ميزة الانتقال من وإلى الوسائط اليمنى في وحدة البكسل. |
remarketing_enabled | boolean | عند الضبط على true ، سيتم تفعيل وحدة البكسل هذه للاستخدام في الاستهداف. لن تتوفّر هذه القيمة إلا في حال ضبط dfa_configuration للمعلن الرئيسي على NONE . |
is_secure | boolean | عند الضبط على true ، سيستخدم هذا البكسل بروتوكول HTTPS. لن تتوفّر هذه القيمة إلا في حال ضبط dfa_configuration للمعلن الرئيسي على NONE . |
جدول Floodlight Activity
اسم الحقل | النوع | الوصف |
---|---|---|
common_data | EntityCommonData | |
advertiser_id | Numeric Id | رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id . |
partner_id | Numeric Id | رقم تعريف عنصر الشريك المسؤول للمعلن الرئيسي. يمكن الانضمام باستخدام Partner.common_data.id . |
remarketing_enabled | boolean | عند ضبط هذه السياسة على true ، سيتم تفعيل هذا النشاط للاستخدام في الاستهداف. |
ssl_required | boolean | وعند ضبطها على true ، يجب أن تكون العلامات متوافقة مع السياسات. |
جدول InventorySource
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لمصدر المستودع. |
unclassified | boolean | عند الضبط على true ، سيتم تضمين كل المستودع غير المصنّف. |
inventory_name | string | اسم مصدر المستودع كما هو موضّح في واجهة المستخدم. قد لا يكون هذا الحقل متوفرًا. في حال عدم توفّر السمة inventory_name وكانت السمة unclassified صحيحة، يشير ذلك إلى المستودع غير المصنّف للتبادل. إذا لم تكن هذه السمة متوفّرة وكانت السمة unclassified غير صحيحة، يكون مصدر المستودع هو المستودع الإعلاني على مستوى الصرف. |
exchange_id | Numeric Id | رقم تعريف التبادل الذي يتوفّر فيه مصدر المستودع هذا يمكن الانضمام باستخدام SupportedExchange.id . |
accessing_advertisers | [Numeric Id] | هناك مصفوفة من أرقام تعريف المعلنين، والتي يمكن الانضمام إليها مع Advertiser.common_data.id ، والإذن باستخدام مصدر المستودع هذا.ملاحظة: إذا كان مصدر المستودع الإعلاني متاحًا لجميع المعلِنين، لن يكون هذا الحقل متوفّرًا. |
external_id | string | رقم التعريف الخارجي الذي يتم منحه لمصدر المستودع هذا والمحدّد من خلال عملية التبادل، ويُعرف عادةً باسم الصفقة أو الرقم التعريفي للبائع. قد يكون هذا الحقل غير متوفر. |
min_cpm_micros | integer | السعر الأدنى الفعلي لمصدر المستودع هذا بعملة المايكرو. |
min_cpm_currency_code | string | تمثّل هذه السمة رمز العملة بالتنسيق ISO 4217 المكوَّن من 3 أحرف والمُستخدَم للسمة min_cpm_micros . |
جدول UserList
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لقائمة المستخدمين. |
name | string | اسم قائمة المستخدمين كما هو موضّح في واجهة المستخدم. |
data_partner_id | Numeric Id | يمكن الانضمام باستخدام DataPartner.id . تم ضبط هذا الحقل لقوائم المستخدمين التابعة لجهات خارجية فقط. |
accessing_advertisers | [Numeric Id] | مصفوفة من أرقام تعريف المعلنين، يمكن الانضمام إليها مع Advertiser.common_data.id ، والإذن باستخدام قائمة المستخدمين هذه.ملاحظة: في حال توفّر قائمة مستخدمين لجميع المعلنين، لن يكون هذا الحقل متوفّرًا. |
partner_pricing | UserListPricing | سيكون نوع التكلفة دائمًا هو التكلفة لكل ألف ظهور، وسيكون رمز العملة دائمًا بالدولار الأمريكي. |
advertiser_pricings | [UserListAdvertiserPricing] | سيكون نوع التكلفة دائمًا هو التكلفة لكل ألف ظهور، وسيكون رمز العملة دائمًا بالدولار الأمريكي. |
جدول CustomAffinity
اسم الحقل | النوع | الوصف |
---|---|---|
id |
Numeric Id |
مفتاح فريد للجمهور المخصّص ذي الاهتمامات المشتركة. |
name |
string |
اسم الجمهور المخصّص ذي الاهتمامات المشتركة كما هو موضّح في واجهة المستخدم. |
description |
string |
وصف الجمهور المخصّص ذي الاهتمامات المشتركة كما هو موضّح في واجهة المستخدم. |
advertiser_id |
Numeric Id |
رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id . |
جدول UniversalChannel
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد للقناة |
name | string | اسم القناة كما هو موضّح في واجهة المستخدم. |
site_ids |
[Numeric Id] |
مصفوفة تحتوي على أرقام تعريف UniversalSite
في هذه القناة. يمكن الانضمام باستخدام UniversalSite.id . |
accessing_advertisers | [Numeric Id] | إنّ مصفوفة من أرقام تعريف المعلنين، والتي يمكن الانضمام إليها مع Advertiser.common_data.id ، حاصلة على إذن باستخدام هذه القناة.ملاحظة: إذا كانت القناة متاحة لجميع المعلنين، لن يظهر هذا الحقل. |
is_deleted | boolean | عند الضبط على true ، لن تتمكّن أي عناصر جديدة من استهداف هذه القناة، ولكن ستستمرّ العناصر الحالية التي تستهدف هذه القناة في ذلك. |
is_brand_safe_channel | boolean | عند ضبط هذه القيمة على true ، يمكن استخدام هذه القناة لفلترة أمان العلامة التجارية. ويتوفر هذا التصنيف حاليًا true فقط لمستويات أمان العلامة التجارية الأربعة المدمجة. |
جدول NegativeKeywordList
اسم الحقل | النوع | الوصف |
---|---|---|
id |
Numeric Id |
مفتاح فريد لقائمة الكلمات الرئيسية السلبية. |
name |
string |
اسم قائمة الكلمات الرئيسية السلبية كما هو موضّح في واجهة المستخدم. |
advertiser_id |
Numeric Id |
رقم تعريف عنصر المعلِن الرئيسي يمكن الانضمام باستخدام Advertiser.common_data.id . |
الجداول العامة
جدول SupportedExchange
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد للتبادل. |
name | string | اسم التبادل، على سبيل المثال Ad Exchange . |
جدول DataPartner
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لمزوّد بيانات الجهة الخارجية |
name | string | اسم مزوِّد البيانات التابع لجهة خارجية، مثل BlueKai . |
جدول UniversalSite
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد للموقع الإلكتروني العام. |
name | string | عنوان URL للموقع الإلكتروني أو اسمه، مثل google.com أو Google Unclassified |
جدول SiteIdToPlacementId
اسم الحقل | النوع | الوصف |
---|---|---|
siteId |
Numeric Id |
التعيين من رقم تعريف الموقع العام إلى أرقام تعريف مواضع الويب. |
placementId |
Numeric Id |
عنوان URL لموضع الإعلان على الويب أو اسمه، مثل google.com أو Google Unclassified . |
جدول GeoLocation
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد للموقع الجغرافي. |
canonical_name | string | سلسلة الموقع المفصولة بفواصل ومصادرها. مثال: "سياتل، واشنطن، الولايات المتحدة". |
geo_name | string | اسم الموقع الجغرافي مثال: "سياتل". |
country_code | string | رمز البلد بصيغة ISO-3166 alpha-2 لهذا الموقع الجغرافي، على سبيل المثال US . |
region_code | string | رمز التقسيم الفرعي ISO-3166-2 لهذا الموقع الجغرافي، على سبيل المثال US-WA . قد يكون هذا الحقل غير متوفّر. |
city_name | string | اسم المدينة لهذا الموقع الجغرافي، على سبيل المثال Seattle . قد يكون هذا الحقل غير متوفّر. |
postal_code | string | الرمز البريدي لهذا الموقع الجغرافي، على سبيل المثال 98033 . قد يكون هذا الحقل غير متوفّر. |
dma_code | integer | رمز منطقة السوق المحدّدة لهذا الموقع الجغرافي، على سبيل المثال 510 . قد يكون هذا الحقل غير متوفّر. |
جدول Language
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لهذه اللغة. |
code | string | ويمكنك استخدام رمز ISO-639-1 لهذه اللغة أو أحد zh_CN للغة الصينية (المبسّطة) أو zh_TW للصينية (التقليدية) أو other للغات الأخرى. |
جدول DeviceCriteria
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لمعايير الجهاز هذه. |
is_mobile | boolean | إذا كانت القيمة هي "صحيح"، سيشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك. |
name | string | الاسم المألوف لمعايير الجهاز. |
criteria_type | Enum | 0=OPERATING_SYSTEM |
operating_system_id | Numeric Id | تحدد نظام التشغيل. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 0 . |
mobile_brand_name | string | اسم العلامة التجارية للجهاز. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 1 . |
mobile_model_name | string | اسم طراز الجهاز لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 1 . اختياريّ. |
mobile_make_model_id | Numeric Id | تحدد رقم طراز الجهاز. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 1 . اختياريّ. |
device_type | Enum | تشير هذه السمة إلى نوع الجهاز. لا تتم تعبئة هذا الحقل إلّا عندما تكون قيمة criteria_type هي 2 .
|
جدول Browser
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لهذا المتصفح. |
is_mobile | boolean | إذا كانت القيمة هي "صحيح"، سيشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك. |
name | string | الاسم المألوف للمتصفّح، على سبيل المثال Safari 5 . ولا يتضمّن سلسلة وكيل المستخدم الكاملة. |
جدول Isp
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لمزوّد خدمة الإنترنت هذا. |
is_mobile | boolean | إذا كانت القيمة هي "صحيح"، سيشمل هذا المعيار الأجهزة الجوّالة فقط. إذا كانت القيمة "false"، لا يشمل هذا الإدخال سوى الأجهزة غير الجوّالة، حتى إذا كان اسمها (مثل "غير ذلك") لا يشير إلى ذلك. |
name | string | اسم مزوّد خدمة الإنترنت هذا |
secondary_criteria_id | integer |
معرّف بديل اختياري يمكن استخدامه لتحديد الكيان. |
جدول AppCollection
اسم الحقل | النوع | الوصف |
---|---|---|
id | Numeric Id | مفتاح فريد لمجموعة التطبيقات هذه |
name | string | اسم مجموعة التطبيقات هذه |