REST Resource: advertisers

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

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

تمثيل 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 
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
الحقول
حقل الربط ad_server_config_scheme الحقل مطلوب. يمكن أن يكون التعليق ad_server_config_scheme إحدى القيم التالية فقط:
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

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