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" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่างเช่น "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 ของเว็บไซต์เพื่อเชื่อมโยงแคมเปญกับผู้ลงโฆษณา

ระบุ 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)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสบัญชีของการกำหนดค่า CM360 Floodlight ที่ลิงก์กับผู้ลงโฆษณา DV360
cmFloodlightConfigId

string (int64 format)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสการกำหนดค่า CM360 Floodlight ที่ลิงก์กับผู้ลงโฆษณา 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)

การตั้งค่าไฟล์ Structured Data (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

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