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 ที่แชร์การกำหนดค่า 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 และ ผู้ลงโฆษณาวิดีโอ 360

AdvertiserCreativeConfig

การตั้งค่าที่เกี่ยวข้องกับครีเอทีฟโฆษณาของผู้ลงโฆษณา

การแสดง JSON
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
ช่อง
iasClientId

string (int64 format)

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

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

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