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" وخوادم الإعلانات التابعة لجهات خارجية.

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 (عند التفاعل مع "لمحة عن هذا الإعلان") إلى إعلاناتك المتعلّقة بالإعلان السلوكي على الإنترنت والمتطلبات التنظيمية. يتيح لك قسم "تفاصيل عن الإعلان" للمستخدمين التحكّم بشكل أكبر في الإعلانات التي يشاهدونها ويساعدك في توضيح سبب مشاهدة إعلانك لهم. مزيد من المعلومات

في حال اختيار ضبط هذا الحقل على 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

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