REST Resource: advertisers

منبع: تبلیغ کننده

یک تبلیغ کننده در Display & Video 360 (DV360).

نمایندگی 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

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

advertiser Id

string ( int64 format)

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

partner Id

string ( int64 format)

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

display Name

string

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

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

entity Status

enum ( EntityStatus )

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

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

string ( Timestamp format)

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

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

general Config

object ( AdvertiserGeneralConfig )

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

ad Server Config

object ( AdvertiserAdServerConfig )

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

creative Config

object ( AdvertiserCreativeConfig )

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

data Access Config

object ( AdvertiserDataAccessConfig )

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

integration Details

object ( IntegrationDetails )

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

serving Config

object ( AdvertiserTargetingConfig )

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

prisma Enabled

boolean

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

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

billing Config

object ( AdvertiserBillingConfig )

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

AdvertiserGeneralConfig

تنظیمات کلی یک تبلیغ کننده

نمایندگی JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
فیلدها
domain Url

string

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

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

time Zone

string

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

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

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

currency Code

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 فقط می تواند یکی از موارد زیر باشد:
third Party Only Config

object ( ThirdPartyOnlyConfig )

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

cm Hybrid Config

object ( CmHybridConfig )

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

ThirdPartyOnlyConfig

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

نمایندگی JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
فیلدها
pixel Order Id Reporting Enabled

boolean

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

CmHybridConfig

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

نمایندگی JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
فیلدها
cm Account Id

string ( int64 format)

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

cm Floodlight Config Id

string ( int64 format)

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

cm Advertiser Ids[]

string ( int64 format)

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

cm Syncable Site Ids[]

string ( int64 format)

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

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

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

dv360 To Cm Data Sharing Enabled

boolean

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

dv360 To Cm Cost Reporting Enabled

boolean

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

cm Floodlight Linking Authorized

boolean

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

AdvertiserCreativeConfig

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

نمایندگی JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
فیلدها
ias Client Id

string ( int64 format)

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

oba Compliance Disabled

boolean

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

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

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

boolean

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

video Creative Data Sharing Authorized

boolean

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

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

AdvertiserDataAccessConfig

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

نمایندگی JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
فیلدها
sdf Config

object ( AdvertiserSdfConfig )

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

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

AdvertiserSdfConfig

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

نمایندگی JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
فیلدها
override Partner Sdf Config

boolean

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

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

sdf Config

object ( SdfConfig )

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

AdvertiserTargetingConfig

تنظیمات هدفمند مربوط به ارائه تبلیغات یک تبلیغ‌کننده.

نمایندگی JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
فیلدها
exempt Tv From Viewability Targeting

boolean

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

AdvertiserBillingConfig

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

نمایندگی JSON 
{
  "billingProfileId": string
}
فیلدها
billing Profile Id

string ( int64 format)

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

روش ها

audit

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

create

 یک تبلیغ کننده جدید ایجاد می کند.

delete

 یک تبلیغ کننده را حذف می کند.

edit Assigned Targeting Options

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

get

 یک تبلیغ کننده می گیرد.

list

 تبلیغ‌کنندگانی را فهرست می‌کند که برای کاربر فعلی قابل دسترسی هستند.

list Assigned Targeting Options

 گزینه های هدف گذاری اختصاص داده شده به یک تبلیغ کننده را در بین انواع هدف فهرست می کند.

patch

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