REST Resource: advertisers

{
  "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)
  }
}

string

فقط خروجی نام منبع تبلیغ کننده.

string ( int64 format)

فقط خروجی شناسه منحصر به فرد تبلیغ کننده. توسط سیستم تعیین شده است.

string ( int64 format)

مورد نیاز. تغییرناپذیر. شناسه منحصربه‌فرد شریکی که تبلیغ‌کننده به آن تعلق دارد.

string

مورد نیاز. نام نمایشی تبلیغ کننده

باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود.

enum ( EntityStatus )

مورد نیاز. کنترل می‌کند که آیا سفارش‌های درج و اقلام ردیف آگهی‌دهنده می‌تواند بودجه خود را صرف کند و برای موجودی پیشنهاد دهد یا خیر.

• مقادیر پذیرفته شده عبارتند از ENTITY_STATUS_ACTIVE ، ENTITY_STATUS_PAUSED و ENTITY_STATUS_SCHEDULED_FOR_DELETION .
• اگر روی ENTITY_STATUS_SCHEDULED_FOR_DELETION تنظیم شود، تبلیغ‌کننده 30 روز از زمانی که برای اولین بار برای حذف برنامه‌ریزی شده بود، حذف می‌شود.

string ( Timestamp format)

فقط خروجی مهر زمانی آخرین به‌روزرسانی آگهی‌دهنده. توسط سیستم تعیین شده است.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( AdvertiserGeneralConfig )

مورد نیاز. تنظیمات کلی تبلیغ کننده

object ( AdvertiserAdServerConfig )

مورد نیاز. تغییرناپذیر. تنظیمات مربوط به سرور آگهی آگهی دهنده.

object ( AdvertiserCreativeConfig )

مورد نیاز. تنظیمات مربوط به خلاقانه تبلیغ‌کننده.

object ( AdvertiserDataAccessConfig )

تنظیماتی که نحوه دسترسی به داده‌های تبلیغ‌کننده را کنترل می‌کنند.

object ( IntegrationDetails )

جزئیات یکپارچه سازی تبلیغ کننده. در حال حاضر فقط integrationCode برای تبلیغ‌کننده قابل اعمال است. سایر زمینه های IntegrationDetails پشتیبانی نمی شوند و در صورت ارائه نادیده گرفته می شوند.

object ( AdvertiserTargetingConfig )

تنظیمات هدف‌یابی مربوط به ارائه آگهی آگهی‌دهنده.

boolean

اینکه آیا ادغام با Mediaocean (Prisma) فعال است یا خیر. با فعال کردن این، شما با موارد زیر موافقت می کنید:

از طرف شرکتم، به Mediaocean (Prisma) اجازه می‌دهم طرح‌های بخش بودجه را به Google ارسال کند، و به Google اجازه می‌دهم گزارش‌ها و صورت‌حساب‌های مربوطه را از DV360 به Mediaocean به منظور برنامه‌ریزی بودجه، صورت‌حساب، و تطبیق برای این تبلیغ‌کننده ارسال کند.

object ( AdvertiserBillingConfig )

تنظیمات مربوط به صورت‌حساب آگهی‌دهنده.

{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}

string

مورد نیاز. آدرس دامنه وب سایت اصلی تبلیغ کننده. سیستم این اطلاعات را برای ناشرانی که برای مرتبط کردن یک کمپین با تبلیغ‌کننده نیاز به URL وب‌سایت دارند، ارسال می‌کند.

یک URL بدون مسیر یا رشته پرس و جو ارائه کنید که با http: یا https: شروع می شود. به عنوان مثال، http://www.example.com

string

فقط خروجی نام استاندارد پایگاه داده TZ منطقه زمانی تبلیغ‌کننده. به عنوان مثال، America/New_York .

مشاهده بیشتر در: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

برای تبلیغ‌کنندگان ترکیبی CM360، منطقه زمانی مشابه حساب CM360 مرتبط است. برای تبلیغ کنندگان فقط شخص ثالث، منطقه زمانی با شریک اصلی یکسان است.

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 : راند آفریقای جنوبی

{

  // 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.
}

object ( ThirdPartyOnlyConfig )

پیکربندی برای تبلیغ‌کنندگانی که فقط از سرورهای تبلیغاتی شخص ثالث استفاده می‌کنند.

object ( CmHybridConfig )

پیکربندی برای تبلیغ‌کنندگانی که هم از Campaign Manager 360 (CM360) و هم از سرورهای تبلیغات شخص ثالث استفاده می‌کنند.

{
  "pixelOrderIdReportingEnabled": boolean
}

boolean

اینکه آیا گزارش شناسه سفارش برای پیکسل‌ها فعال است یا خیر. این مقدار را نمی توان پس از تنظیم روی true تغییر داد.

{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}

string ( int64 format)

مورد نیاز. تغییرناپذیر. شناسه حساب پیکربندی Floodlight CM360 مرتبط با تبلیغ‌کننده DV360.

string ( int64 format)

مورد نیاز. تغییرناپذیر. شناسه پیکربندی Floodlight CM360 مرتبط با تبلیغ‌کننده DV360.

string ( int64 format)

فقط خروجی مجموعه شناسه‌های تبلیغ‌کننده CM360 که پیکربندی Floodlight CM360 را به اشتراک می‌گذارند.

string ( int64 format)

فهرستی از سایت‌های CM360 که مکان‌های آنها با DV360 همگام‌سازی می‌شود.

اگر در روش advertisers.create وجود نداشته باشد یا خالی باشد، سیستم به طور خودکار یک سایت CM360 ایجاد می کند.

حذف سایت‌ها از این فهرست ممکن است باعث شود خلاقیت‌های DV360 همگام‌سازی شده از CM360 حذف شوند. حداقل یک سایت باید مشخص شود.

boolean

اینکه آیا داده‌های DV360 در گزارش‌های انتقال داده CM360 لحاظ شود یا خیر.

boolean

گزارش هزینه DV360 به CM360 یا خیر.

boolean

مورد نیاز. تغییرناپذیر. با تنظیم این فیلد روی true ، شما به نمایندگی از شرکت خود، به اشتراک گذاری اطلاعات از پیکربندی Floodlight داده شده را با این تبلیغ کننده Display & Video 360 اجازه می دهید.

{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}

string ( int64 format)

شناسه ای برای پیکربندی نظارت کمپین ارائه شده توسط سرویس تبلیغات یکپارچه (IAS). سیستم DV360 یک برچسب IAS "Campaign Monitor" حاوی این شناسه را به تگ خلاق اضافه می کند.

boolean

اینکه آیا ویژگی Google's About this Ad را غیرفعال کنید یا خیر که نشان (برای شناسایی محتوا به عنوان آگهی) و اطلاعات شفافیت (در تعامل با درباره این آگهی) را به تبلیغات شما برای تبلیغات رفتاری آنلاین (OBA) و الزامات قانونی اضافه می کند. درباره این آگهی به کاربران کنترل بیشتری بر تبلیغاتی که می‌بینند می‌دهد و به شما کمک می‌کند توضیح دهید چرا تبلیغ شما را می‌بینند. بیشتر بدانید .

اگر این فیلد را روی true تنظیم کنید، توجه داشته باشید که تبلیغات ارائه شده از طریق Display & Video 360 باید با موارد زیر مطابقت داشته باشند:

• مطابق قراردادتان با پلتفرم بازاریابی Google، با تبلیغات رفتاری آنلاین (OBA) سازگار باشید.
• در منطقه اقتصادی اروپا (EEA)، اطلاعات شفافیت و مکانیزمی برای کاربران برای گزارش محتوای غیرقانونی در تبلیغات قرار دهید. در صورت استفاده از راه حل های نشان، شفافیت و گزارش تبلیغات جایگزین، باید مطمئن شوید که حاوی اطلاعات شفافیت مورد نیاز و مکانیسم پرچم گذاری محتوای غیرقانونی است و هر گونه گزارش محتوای غیرقانونی را با استفاده از فرم مناسب به Google اطلاع می دهید.

boolean

اینکه آیا تبلیغ‌کننده برای خلاقیت‌های پویا فعال است یا خیر.

boolean

با تنظیم این فیلد روی true ، شما به نمایندگی از شرکت خود، به Google اجازه می‌دهید از خلاقیت‌های ویدیویی مرتبط با این تبلیغ‌کننده Display & Video 360 برای ارائه گزارش‌ها و ویژگی‌های مرتبط با کمپین‌های تلویزیونی تبلیغ‌کننده استفاده کند.

فقط زمانی قابل اعمال است که تبلیغ‌کننده دارای پیکربندی سرور تبلیغات CM360 hybrid باشد.

{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}

object ( AdvertiserSdfConfig )

تنظیمات فایل های داده ساخت یافته (SDF) برای تبلیغ کننده.

اگر مشخص نشده باشد، از تنظیمات SDF شریک والد استفاده می شود.

{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}

boolean

اینکه آیا این تبلیغ‌کننده پیکربندی SDF شریک اصلی خود را لغو می‌کند یا نه.

به طور پیش‌فرض، یک تبلیغ‌کننده پیکربندی SDF را از شریک اصلی به ارث می‌برد. برای لغو پیکربندی شریک، این فیلد را روی true تنظیم کنید و پیکربندی جدید را در sdfConfig ارائه دهید.

object ( SdfConfig )

پیکربندی SDF برای تبلیغ‌کننده.

• زمانی که overridePartnerSdfConfig true باشد، لازم است.
• خروجی فقط زمانی است که overridePartnerSdfConfig false باشد.

{
  "exemptTvFromViewabilityTargeting": boolean
}

boolean

اینکه آیا دستگاه‌های تلویزیون متصل از هدف‌یابی قابلیت مشاهده برای همه موارد خط ویدیویی تحت آگهی‌دهنده معاف هستند یا نه.

{
  "billingProfileId": string
}

string ( int64 format)

شناسه نمایه صورت‌حساب اختصاص داده شده به تبلیغ‌کننده.

اگر مقداری ارائه نشود، این فیلد به‌طور پیش‌فرض به شناسه نمایه صورت‌حساب پیش‌فرض شریک والد تبلیغ‌کننده خواهد بود.