طاولات خاصة
جدول "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 ، ستكون هذه القيمة مماثلة للمنطقة الزمنية لمعلِن Floodlight المرتبط. |
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 | هدف التكلفة لكل ألف ظهور قابل للعرض بعملة المعلِن بالمايكرو. لن تتوفّر هذه القيمة في حال ضبط سمة performance_goal على NONE . |
partner_revenue_model | PartnerRevenueModel | نموذج أرباح الشريك المستخدَم في هذا العنصر |
cost_tracking_pixels | [CostTrackingPixel] | مصفوفة من CostTrackingPixels المخصّصة لتتبُّع هذا العنصر. |
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 في DDEX المرتبط بوحدة البكسل هذه. |
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 | سيكون نوع التكلفة دائمًا هو تكلفة الألف ظهور (CPM)، ورمز العملة دائمًا هو بالدولار الأمريكي. |
advertiser_pricings | [UserListAdvertiserPricing] | سيكون نوع التكلفة دائمًا هو تكلفة الألف ظهور (CPM)، ورمز العملة دائمًا هو بالدولار الأمريكي. |
جدول "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 | اسم مجموعة التطبيقات هذه. |