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
}
ช่อง
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 เพื่อวัตถุประสงค์ในการวางแผนงบประมาณ การเรียกเก็บเงิน และการปรับยอดสำหรับผู้ลงโฆษณารายนี้

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,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
ช่อง
cmAccountId

string (int64 format)

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

string (int64 format)

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

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

boolean

จะใช้การปฏิบัติตามข้อกำหนดของการโฆษณาตามพฤติกรรมออนไลน์ (OBA) ของ DV360 หรือไม่

คำเตือน: การเปลี่ยนการตั้งค่า OBA อาจทำให้ Ad Exchange รีเซ็ตสถานะการตรวจสอบครีเอทีฟโฆษณาของคุณ ซึ่งทำให้ Ad Exchange บางแห่งไม่มีสิทธิ์แสดงจนกว่าจะได้รับอนุมัติอีกครั้ง
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

อุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ตได้รับการยกเว้นจากการกำหนดเป้าหมายการมองเห็นโฆษณาสำหรับรายการโฆษณาวิดีโอทั้งหมดของผู้ลงโฆษณารายนั้นหรือไม่

วิธีการ

audit

 ตรวจสอบผู้ลงโฆษณา

bulkEditAdvertiserAssignedTargetingOptions

 แก้ไขตัวเลือกการกำหนดเป้าหมายจำนวนมากภายใต้ผู้ลงโฆษณารายเดียว

bulkListAdvertiserAssignedTargetingOptions

 รายการตัวเลือกการกำหนดเป้าหมายที่ผู้ลงโฆษณาใช้ในการกำหนดเป้าหมายประเภทต่างๆ

create

 สร้างผู้ลงโฆษณาใหม่

delete

 ลบผู้ลงโฆษณา

get

 ได้ผู้ลงโฆษณา

list

 แสดงรายการผู้ลงโฆษณาที่ผู้ใช้ปัจจุบันเข้าถึงได้

patch

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