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

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

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 اجازه می‌دهم گزارش‌ها و صورت‌حساب‌های مربوطه را از DV360 به Mediaocean به منظور برنامه‌ریزی بودجه، صورت‌حساب، و تطبیق برای این تبلیغ‌کننده ارسال کند.

billingConfig

object ( AdvertiserBillingConfig )

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

AdvertiserGeneralConfig

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

نمایندگی JSON
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
زمینه های
domainUrl

string

ضروری. آدرس دامنه وب سایت اصلی تبلیغ کننده. سیستم این اطلاعات را برای ناشرانی که برای مرتبط کردن یک کمپین با تبلیغ‌کننده نیاز به 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

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

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 )

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

ThirdPartyOnlyConfig

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

نمایندگی JSON
{
  "pixelOrderIdReportingEnabled": boolean
}
زمینه های
pixelOrderIdReportingEnabled

boolean

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

CmHybridConfig

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

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

string ( int64 format)

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

cmFloodlightConfigId

string ( int64 format)

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

cmAdvertiserIds[]

string ( int64 format)

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

cmSyncableSiteIds[]

string ( int64 format)

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

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

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

dv360ToCmDataSharingEnabled

boolean

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

dv360ToCmCostReportingEnabled

boolean

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

cmFloodlightLinkingAuthorized

boolean

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

AdvertiserCreativeConfig

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

نمایندگی JSON
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
زمینه های
iasClientId

string ( int64 format)

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

obaComplianceDisabled

boolean

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

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

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

boolean

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

videoCreativeDataSharingAuthorized

boolean

با تنظیم این فیلد روی true ، شما از طرف شرکت خود، به Google اجازه می‌دهید از خلاقیت‌های ویدیویی مرتبط با این تبلیغ‌کننده Display & Video 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

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