REST Resource: advertisers

المرجع: المعلِن

معلن واحد في الشبكة الإعلانية الفيديو 360 (مساحة العرض والفيديو 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" "أداة مراقبة الحملات" 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

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