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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
ช่อง
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)

เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตผู้ลงโฆษณาครั้งล่าสุด ระบบกำหนด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
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)

ต้องระบุ การตั้งค่าที่เกี่ยวข้องกับการเรียกเก็บเงินของผู้ลงโฆษณา
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

ไม่บังคับ ผู้ลงโฆษณารายนี้มีรายการโฆษณาที่แสดงโฆษณาทางการเมืองในสหภาพยุโรปหรือไม่

หากตั้งค่าช่องนี้เป็น DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING จะเกิดสิ่งต่อไปนี้

  • รายการโฆษณาใหม่ที่สร้างภายใต้ผู้ลงโฆษณารายนี้จะได้รับกำหนด DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING หากไม่ได้ระบุไว้เป็นอย่างอื่น
  • รายการโฆษณาที่มีอยู่ภายใต้ผู้ลงโฆษณารายนี้ซึ่งไม่มีการตั้งค่าจะได้รับการอัปเดตเป็น DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING ภายใน 1 วัน

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

สําหรับผู้ลงโฆษณาแบบไฮบริด 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.
}
ช่อง
ฟิลด์ Union 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 ที่ใช้การกำหนดค่า CM360 Floodlight ร่วมกัน
cmSyncableSiteIds[]

string (int64 format)

รายการเว็บไซต์ CM360 ที่จะซิงค์ตําแหน่งโฆษณากับ DV360 เป็นครีเอทีฟโฆษณา

หากไม่มีหรือว่างเปล่าในเมธอด advertisers.create ระบบจะสร้างเว็บไซต์ CM360 โดยอัตโนมัติ

การนำเว็บไซต์ออกจากรายการนี้อาจทำให้ระบบลบครีเอทีฟโฆษณา DV360 ที่ซิงค์จาก CM360 ต้องระบุเว็บไซต์อย่างน้อย 1 รายการ
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)

รหัสสำหรับการกําหนดค่าการตรวจสอบแคมเปญที่ Integral Ad Service (IAS) จัดหาให้ ระบบ DV360 จะต่อท้ายแท็ก "Campaign Monitor" ของ IAS ที่มีรหัสนี้กับแท็กครีเอทีฟโฆษณา
obaComplianceDisabled

boolean

เลือกว่าจะปิดใช้ฟีเจอร์ "เกี่ยวกับโฆษณานี้" ของ Google หรือไม่ ซึ่งจะเพิ่มการติดป้าย (เพื่อระบุว่าเนื้อหาเป็นโฆษณา) และข้อมูลความโปร่งใส (เกี่ยวกับการโต้ตอบกับ "เกี่ยวกับโฆษณานี้") ลงในโฆษณาสำหรับการโฆษณาตามพฤติกรรมออนไลน์ (OBA) และข้อกำหนดด้านกฎระเบียบ เกี่ยวกับโฆษณานี้ช่วยให้ผู้ใช้ควบคุมโฆษณาที่เห็นได้มากขึ้น และช่วยให้คุณอธิบายได้ว่าเหตุใดผู้ใช้จึงเห็นโฆษณาของคุณ ดูข้อมูลเพิ่มเติม

หากเลือกตั้งค่าฟิลด์นี้เป็น true โปรดทราบว่าโฆษณาที่แสดงผ่าน Display & Video 360 ต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • ปฏิบัติตามข้อกำหนดการโฆษณาตามพฤติกรรมบนโลกออนไลน์ (OBA) ตามสัญญาที่คุณมีกับ Google Marketing Platform
  • ในเขตเศรษฐกิจยุโรป (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

 อัปเดตผู้ลงโฆษณาที่มีอยู่