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)
  }
}
الحقول
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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
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)

مطلوب. الإعدادات المتعلّقة بالفوترة للمعلِن

AdvertiserGeneralConfig

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

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

string

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

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

string

النتائج فقط. الاسم القياسي لقاعدة بيانات TZ للمنطقة الزمنية للمعلن. مثلاً: 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" (CM360) وخوادم الإعلانات التابعة لجهات خارجية.

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" علامة "Campaign Monitor" من 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

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