REST Resource: advertisers

المورد: المعلِن

معلِن واحد في "مساحة العرض والفيديو 360"‏ (DV360)

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
الحقول
name

string

النتائج فقط. اسم المورِد الخاص بالمعلِن.
advertiserId

string (int64 format)

النتائج فقط. المعرّف الفريد للمُعلِن. يتمّ تخصيصه من قِبل النظام.
partnerId

string (int64 format)

الحقل مطلوب. غير قابل للتغيير المعرّف الفريد للشريك الذي ينتمي إليه المعلِن
displayName

string

الحقل مطلوب. يشير هذا الحقل إلى الاسم المعروض للمعلِن.

يجب أن يكون الترميز UTF-8 وبحجم 240 بايت كحد أقصى.
entityStatus

enum (EntityStatus)

الحقل مطلوب. يتحكّم هذا الإعداد في ما إذا كان بإمكان طلبات الإدراج والبنود الإعلانية الخاصة بالمعلِن إنفاق ميزانياتها وتقديم عروض أسعار على المستودع الإعلاني.

  • القيم المقبولة هي ENTITY_STATUS_ACTIVE وENTITY_STATUS_PAUSED وENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • إذا تم ضبطها على ENTITY_STATUS_SCHEDULED_FOR_DELETION، سيتم حذف المعلِن بعد 30 يومًا من تحديد موعد الحذف لأول مرة.
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل تم إجراؤه على المعلِن. يتمّ تخصيصه من قِبل النظام.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
generalConfig

object (AdvertiserGeneralConfig)

الحقل مطلوب. الإعدادات العامة للمعلِن
adServerConfig

object (AdvertiserAdServerConfig)

الحقل مطلوب. غير قابل للتغيير إعدادات المعلِن المرتبطة بخادم الإعلانات
creativeConfig

object (AdvertiserCreativeConfig)

الحقل مطلوب. إعدادات المعلِن ذات الصلة بتصاميم الإعلانات
dataAccessConfig

object (AdvertiserDataAccessConfig)

إعدادات تتحكّم في كيفية الوصول إلى بيانات المعلِن.
integrationDetails

object (IntegrationDetails)

تفاصيل عملية الدمج الخاصة بالمعلِن لا ينطبق على المعلن حاليًا سوى integrationCode. الحقول الأخرى الخاصة بـ IntegrationDetails غير متاحة وسيتم تجاهلها في حال توفيرها.
servingConfig

object (AdvertiserTargetingConfig)

إعدادات الاستهداف المرتبطة بعرض إعلانات المعلِن
prismaEnabled

boolean

تُستخدَم لتحديد ما إذا كان قد تم تفعيل عملية الدمج مع Mediaocean (Prisma). من خلال تفعيل هذه الميزة، أنت توافق على ما يلي:

نيابةً عن الشركة التي أعمل فيها، أفوّض Mediaocean (Prisma) بإرسال خطط شرائح الميزانية إلى Google، وأفوّض Google بإرسال التقارير والفواتير المقابلة من "مساحة العرض والفيديو 360" إلى Mediaocean لأغراض تخطيط الميزانية والفوترة والتسوية لهذا المعلِن.
billingConfig

object (AdvertiserBillingConfig)

الحقل مطلوب. إعدادات الفوترة الخاصة بالمعلِن
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

اختيارية: تُستخدَم لتحديد ما إذا كان هذا المعلِن يتضمّن عناصر حملات تعرض إعلانات سياسية عن الاتحاد الأوروبي.

في حال ضبط هذا الحقل على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING، سيحدث ما يلي:

  • سيتم تعيين DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING لأي عناصر جديدة يتم إنشاؤها ضمن هذا المعلِن، ما لم يتم تحديد خلاف ذلك.
  • سيتم تعديل أي عناصر حالية ضمن هذا المعلِن لا تتضمّن قيمة محدّدة إلى DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING في غضون يوم واحد.
defaultBusinessName

string

اختيارية: اسم المؤسسة التلقائي للمعلِن

هذه هي القيمة التي تستخدمها إعلانات YouTube و"حملات زيادة الطلب" ضمن هذا المعلِن في حال عدم توفير اسم مؤسسة.
defaultLogoAssetId

string (int64 format)

اختيارية: رقم تعريف مادة عرض صورة الشعار التلقائية للمعلن

هذا هو رقم تعريف مادة العرض الذي سيتم استخدامه من قِبل "إعلانات YouTube" و"إعلانات الطلب" ضمن هذا المعلِن في حال عدم توفير مادة عرض شعار.

يجب استخدام advertisers.adAssets.upload لتحميل مادة العرض هذه باستخدام واجهة برمجة التطبيقات.

AdvertiserGeneralConfig

الإعدادات العامة للمعلن

تمثيل JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
الحقول
domainUrl

string

الحقل مطلوب. عنوان URL الخاص بالنطاق للموقع الإلكتروني الأساسي للمعلِن. سيرسل النظام هذه المعلومات إلى الناشرين الذين يحتاجون إلى عنوان URL للموقع الإلكتروني لربط حملة بمعلِن.

يُرجى تقديم عنوان URL بدون مسار أو سلسلة طلب بحث، على أن يبدأ بـ http: أو https:. على سبيل المثال، http://www.example.com
timeZone

string

النتائج فقط. اسم قاعدة بيانات المنطقة الزمنية العادي للمعلِن مثلاً: America/New_York

يمكنك الاطّلاع على مزيد من المعلومات على الرابط: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

بالنسبة إلى المعلِنين المختلطين في "مدير الحملة 360"، تكون المنطقة الزمنية هي نفسها المنطقة الزمنية لحساب "مدير الحملة 360" المرتبط. أما بالنسبة إلى المعلِنين التابعين لجهات خارجية فقط، فتكون المنطقة الزمنية هي نفسها المنطقة الزمنية للشريك الرئيسي.
currencyCode

string

الحقل مطلوب. غير قابل للتغيير تمثّل هذه السمة عملة المعلِن بتنسيق ISO 4217.

في ما يلي الرموز المقبولة والعملات التي تمثّلها:

رمز العملة : اسم العملة

  • ARS : البيزو الأرجنتيني
  • ‫AUD : دولار أسترالي
  • BRL : الريال البرازيلي
  • ‫CAD : دولار كندي
  • ‫CHF : فرنك سويسري
  • CLP : البيزو التشيلي
  • CNY : يوان صيني
  • ‫COP : البيزو الكولومبي
  • ‫CZK : كرونة تشيكية
  • DKK : كرونة دانمركية
  • EGP : جنيه مصري
  • ‫EUR : يورو
  • GBP : جنيه إسترليني
  • ‫HKD : دولار هونغ كونغ
  • ‫HUF : الفورنت الهنغاري
  • IDR : الروبية الإندونيسية
  • ILS : شيكل إسرائيلي
  • ‫INR : روبية هندية
  • ‫JPY : الين الياباني
  • KRW : وون كوريا الجنوبية
  • MXN : بيزو مكسيكي
  • ‫MYR : رينغيت ماليزي
  • ‫NGN : النيرة النيجيرية
  • ‫NOK : كرونة نرويجية
  • NZD : دولار نيوزيلندي
  • ‫PEN : السول البيروفي الجديد
  • ‫PLN : زلوتي بولندي
  • RON : اللو الروماني الجديد
  • ‫RUB : الروبل الروسي
  • SEK : كرونة سويدية
  • ‫TRY : ليرة تركية
  • ‫TWD : دولار تايواني جديد
  • ‫USD : دولار أمريكي
  • ZAR : راند جنوب أفريقي

AdvertiserAdServerConfig

إعدادات المعلِن المرتبطة بخادم الإعلانات

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
الحقول
الحقل مطلوب. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

هذا الإعداد مخصّص للمعلِنين الذين يستخدمون خوادم إعلانات خارجية فقط.
cmHybridConfig

object (CmHybridConfig)

إعدادات المعلِنين الذين يستخدمون كلاً من "مدير الحملة 360" وخوادم الإعلانات التابعة لجهات خارجية
نهاية الحقول التي يستبعد كلّ منها الآخر

ThirdPartyOnlyConfig

إعدادات للمعلِنين الذين يستخدمون خوادم إعلانات تابعة لجهات خارجية فقط

تمثيل JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
الحقول
pixelOrderIdReportingEnabled

boolean

تحديد ما إذا كان خيار إعداد تقارير معرّف الطلب لوحدات البكسل مفعَّلاً أم لا لا يمكن تغيير هذه القيمة بعد ضبطها على true.

CmHybridConfig

إعدادات المعلِنين الذين يستخدمون كلاً من "مدير الحملة 360" وخوادم الإعلانات التابعة لجهات خارجية

تمثيل JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
الحقول
cmAccountId

string (int64 format)

الحقل مطلوب. غير قابل للتغيير رقم تعريف حساب إعدادات Floodlight في "مدير الحملة 360" المرتبط بالمعلِن في "مساحة العرض والفيديو 360"
cmFloodlightConfigId

string (int64 format)

الحقل مطلوب. غير قابل للتغيير رقم تعريف إعدادات Floodlight في "مدير الحملة 360" المرتبطة بالمعلِن على "مساحة العرض والفيديو 360"
cmAdvertiserIds[]

string (int64 format)

النتائج فقط. مجموعة أرقام تعريف المعلِنين على "مدير الحملة 360" الذين يشاركون إعدادات Floodlight في "مدير الحملة 360"
cmSyncableSiteIds[]

string (int64 format)

قائمة بالمواقع الإلكترونية على "مدير الحملة 360" التي ستتم مزامنة مواضع إعلاناتها مع "مساحة العرض والفيديو 360" كتصاميم إعلانات

في حال عدم توفّره أو كان فارغًا في طريقة advertisers.create، سينشئ النظام تلقائيًا موقعًا إلكترونيًا على "مدير الحملة 360".

قد تؤدي إزالة المواقع الإلكترونية من هذه القائمة إلى حذف تصاميم الإعلانات في "مساحة العرض والفيديو 360" التي تمت مزامنتها من "مدير الحملة 360". يجب تحديد موقع إلكتروني واحد على الأقل.
dv360ToCmDataSharingEnabled

boolean

تحديد ما إذا كان سيتم تضمين بيانات "مساحة العرض والفيديو 360" في تقارير "نقل البيانات" في "مدير الحملة 360"
dv360ToCmCostReportingEnabled

boolean

تحديد ما إذا كان سيتم إرسال تكلفة "مساحة العرض والفيديو 360" إلى "مدير الحملة 360" أم لا
cmFloodlightLinkingAuthorized

boolean

الحقل مطلوب. غير قابل للتغيير من خلال ضبط هذا الحقل على true، أنت تسمح نيابةً عن شركتك بمشاركة المعلومات من إعدادات Floodlight المحدّدة مع هذا المعلِن على "مساحة العرض والفيديو 360".

AdvertiserCreativeConfig

إعدادات مواد العرض ذات الصلة بالمعلِن

تمثيل JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
الحقول
iasClientId

string (int64 format)

معرّف لإعداد مراقبة الحملة تقدّمه شركة Integral Ad Service (IAS). سيضيف نظام "مساحة العرض والفيديو 360" علامة "مراقبة الحملة" من IAS تحتوي على هذا المعرّف إلى علامة تصميم الإعلان.
obaComplianceDisabled

boolean

ما إذا كان سيتم إيقاف ميزة "تفاصيل عن الإعلان" من Google التي تضيف شارات (لتحديد المحتوى كإعلان) ومعلومات الشفافية (حول التفاعل مع ميزة "تفاصيل عن الإعلان") إلى إعلاناتك الخاصة بالإعلان استنادًا إلى سلوك المستخدم (OBA) والمتطلبات التنظيمية أم لا تمنح ميزة "تفاصيل عن الإعلان" المستخدمين تحكّمًا أكبر في الإعلانات التي يشاهدونها، وتساعدك في توضيح سبب ظهور إعلانك لهم. مزيد من المعلومات

إذا اخترت ضبط هذا الحقل على true، يُرجى العِلم أنّ الإعلانات التي يتم عرضها من خلال "مساحة العرض والفيديو 360" يجب أن تستوفي ما يلي:

  • الالتزام ببنود الإعلان استنادًا إلى سلوك المستخدم (OBA) وفقًا لعقدك مع "منصّة Google للتسويق"
  • في المنطقة الاقتصادية الأوروبية، يجب تضمين معلومات الشفافية وآلية تتيح للمستخدمين الإبلاغ عن المحتوى غير القانوني في الإعلانات. في حال استخدام حلّ بديل لعرض شارة الإعلان وتوفير الشفافية والإبلاغ، عليك التأكّد من أنّه يتضمّن معلومات الشفافية المطلوبة وآلية الإبلاغ عن المحتوى غير القانوني، وعليك إعلام Google بأي بلاغات تصِلك بشأن محتوى غير قانوني باستخدام النموذج المناسب.
dynamicCreativeEnabled

boolean

تحدّد هذه السمة ما إذا كان المعلِن مفعّلاً للإعلانات الديناميكية.
videoCreativeDataSharingAuthorized

boolean

من خلال ضبط هذا الحقل على true، أنت تفوّض Google، نيابةً عن شركتك، باستخدام تصاميم إعلانات الفيديو المرتبطة بهذا المعلِن على "مساحة العرض والفيديو 360" لتقديم التقارير والميزات ذات الصلة بحملات المعلِن على التلفزيون.

ينطبق هذا الحقل فقط عندما يكون لدى المعلِن إعدادات خادم إعلانات CM360 hybrid.

AdvertiserDataAccessConfig

إعدادات تتحكّم في كيفية الوصول إلى البيانات ذات الصلة بالمعلِن.

تمثيل JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
الحقول
sdfConfig

object (AdvertiserSdfConfig)

إعدادات "ملفات البيانات المنظَّمة" (SDF) الخاصة بالمعلِن

في حال عدم تحديدها، يتم استخدام إعدادات SDF الخاصة بالشريك الرئيسي.

AdvertiserSdfConfig

إعدادات "ملفات البيانات المنظَّمة" (SDF) الخاصة بأحد المعلِنين

تمثيل JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
الحقول
overridePartnerSdfConfig

boolean

تحديد ما إذا كان هذا المعلِن يلغي إعدادات SDF الخاصة بالشريك الرئيسي أم لا

تلقائيًا، يكتسب المعلِن إعدادات SDF من الشريك الرئيسي. لتجاوز إعدادات الشريك، اضبط هذا الحقل على true وقدِّم الإعدادات الجديدة في sdfConfig.
sdfConfig

object (SdfConfig)

إعدادات SDF للمعلِن

AdvertiserTargetingConfig

إعدادات الاستهداف المرتبطة بعرض إعلانات أحد المعلِنين

تمثيل JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
الحقول
exemptTvFromViewabilityTargeting

boolean

تحديد ما إذا كانت أجهزة التلفزيون المتصلة معفاة من استهداف مدى إمكانية العرض لجميع البنود الإعلانية الخاصة بالفيديو ضمن حساب المعلِن

AdvertiserBillingConfig

إعدادات الفوترة الخاصة بأحد المعلِنين

تمثيل JSON 
{
  "billingProfileId": string
}
الحقول
billingProfileId

string (int64 format)

الحقل مطلوب. رقم تعريف ملف فوترة تم تعيينه للمعلن.

الطُرق

audit

 تدقيق حساب أحد المعلِنين

create

 تُستخدَم لإنشاء معلِن جديد.

delete

 تحذف هذه الطريقة معلنًا.

editAssignedTargetingOptions

 تعديل خيارات الاستهداف ضمن معلِن واحد

get

 تعرض هذه الطريقة معلومات عن أحد المعلِنين.

list

 تعرض هذه السمة قائمة بالمعلِنين الذين يمكن للمستخدم الحالي الوصول إليهم.

listAssignedTargetingOptions

 تعرض القوائم خيارات الاستهداف التي يحدّدها المعلِن على مستوى أنواع الاستهداف.

patch

 تعديل معلِن حالي