Conversion

ทรัพยากร Conversion มีวิธีการที่อนุญาตให้ผู้ใช้สร้าง แก้ไข และดึง Conversion ของ Floodlight หลายรายการพร้อมกัน

ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้

การนำเสนอแหล่งข้อมูล

รายการ Conversion

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
conversion[] list Conversion ที่ขอ
conversion[].adGroupId long รหัสกลุ่มโฆษณา DS
conversion[].adId long รหัสโฆษณา DS
conversion[].adUserDataConsent string แสดงความยินยอมสำหรับค่ากำหนดบริการแพลตฟอร์มหลัก (CPS) ในการตั้งค่า ไม่มีค่าเริ่มต้น ค่าที่ยอมรับได้คือ GRANTED: สถานะความยินยอมที่ต้องการคือให้สิทธิ์ อ่านค่ากำหนด CPS จากการตั้งค่า GTE DENIED: สถานะความยินยอมที่ต้องการคือปฏิเสธ รายการ CPS ว่างเปล่า
conversion[].advertiserId long รหัสผู้ลงโฆษณา DS
conversion[].agencyId long รหัสเอเจนซี DS
conversion[].attributionModel string พร้อมให้บริการแก่ผู้ลงโฆษณาหลังจากติดต่อฝ่ายสนับสนุนลูกค้าของ DoubleClick Search แล้วเท่านั้น
conversion[].campaignId long รหัสแคมเปญ DS
conversion[].channel string ช่องทางการขายสำหรับผลิตภัณฑ์ ค่าที่ยอมรับได้ มีดังนี้
  • "local": กิจการที่มีหน้าร้านจริง
  • "online": ร้านค้าออนไลน์
conversion[].clickId string รหัสคลิก DS สำหรับ Conversion
conversion[].conversionId string สําหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะระบุรหัสนี้ ผู้ลงโฆษณาสามารถระบุรหัสที่มีความหมายต่อตนได้ Conversion แต่ละรายการในคำขอต้องระบุรหัสที่ไม่ซ้ำกัน และชุดค่าผสมของรหัสและการประทับเวลาจะต้องไม่ซ้ำกันกับ Conversion ทั้งหมดภายในผู้ลงโฆษณา
สำหรับ Conversion ออนไลน์ DS จะคัดลอก dsConversionId หรือ floodlightOrderId มายังพร็อพเพอร์ตี้นี้ตามคำสั่ง Floodlight ของผู้ลงโฆษณา
conversion[].conversionModifiedTimestamp unsigned long เวลาที่แก้ไข Conversion ครั้งล่าสุด เป็น Epoch millis UTC
conversion[].conversionTimestamp unsigned long เวลาที่เกิด Conversion ในหน่วย Epoch millis UTC
conversion[].countMillis long พร้อมให้บริการแก่ผู้ลงโฆษณาหลังจากติดต่อฝ่ายสนับสนุนลูกค้าของ DoubleClick Search แล้วเท่านั้น
conversion[].criterionId long รหัสเกณฑ์ (คีย์เวิร์ด) ของ DS
conversion[].currencyCode string รหัสสกุลเงินสำหรับรายได้ของ Conversion ควรอยู่ในรูปแบบตัวอักษร ISO 4217 (อักขระ 3 ตัว) เขียนได้
conversion[].customDimension[] list มิติข้อมูลที่กำหนดเองสำหรับ Conversion ซึ่งใช้กรองข้อมูลในรายงานได้
conversion[].customDimension[].name string ชื่อมิติข้อมูลที่กำหนดเอง
conversion[].customDimension[].value string ค่ามิติข้อมูลที่กำหนดเอง
conversion[].customMetric[] list เมตริกที่กำหนดเองสำหรับ Conversion
conversion[].customMetric[].name string ชื่อเมตริกที่กำหนดเอง
conversion[].customMetric[].value double ค่าตัวเลขของเมตริกที่กำหนดเอง
conversion[].customerId string รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ ต้องเป็นบัญชีลูกค้า เมื่อตั้งค่าช่องนี้แล้ว ควรตั้งค่าช่องรหัสอื่นๆ ทั้งหมดเป็นรหัส Search Ads 360 เวอร์ชันใหม่
conversion[].deviceType string ประเภทอุปกรณ์ที่เกิด Conversion

ค่าที่ยอมรับได้ มีดังนี้
  • "DESKTOP"
  • "HIGH_END_MOBILE"
  • "OTHER_DEVICE"
  • "TABLET"
conversion[].dsConversionId long รหัสที่ DoubleClick Search สร้างขึ้นสำหรับ Conversion แต่ละรายการ
conversion[].engineAccountId long รหัสบัญชีเครื่องมือค้นหา DS
conversion[].floodlightOrderId string รหัสคำสั่งซื้อของ Floodlight ที่ผู้ลงโฆษณาระบุสำหรับ Conversion
conversion[].inventoryAccountId long รหัสที่ DS สร้างและใช้เพื่อระบุบัญชีสินค้าคงคลังที่มีผลิตภัณฑ์โดยไม่ซ้ำกัน
conversion[].productCountry string ประเทศที่ลงทะเบียนฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 3166 เพื่อระบุประเทศ
conversion[].productGroupId long รหัสกลุ่มผลิตภัณฑ์ DS
conversion[].productId string รหัสผลิตภัณฑ์ (SKU)
conversion[].productLanguage string ภาษาที่ลงทะเบียนสำหรับฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 639 เพื่อระบุภาษา
conversion[].quantityMillis long ปริมาณของ Conversion นี้ หน่วยเป็นมิลลิวินาที เขียนได้
conversion[].revenueMicros long จำนวนรายได้ของ Conversion TRANSACTION นี้ เป็นไมโคร (ค่าคูณด้วย 1000000 ไม่มีทศนิยม) เช่น หากต้องการระบุค่ารายได้เป็น "10" ป้อน "10000000" (10 ล้าน) ในคำขอ เขียนได้
conversion[].segmentationId long ตัวระบุการแบ่งกลุ่มที่เป็นตัวเลข (เช่น รหัสกิจกรรม DoubleClick Search Floodlight)
conversion[].segmentationName string ตัวระบุการแบ่งกลุ่มลูกค้าที่ใช้งานง่าย (เช่น ชื่อกิจกรรม DoubleClick Search Floodlight)
conversion[].segmentationType string ประเภทการแบ่งกลุ่มของ Conversion นี้ (เช่น FLOODLIGHT)

ค่าที่ยอมรับได้ มีดังนี้
  • "FLOODLIGHT"
conversion[].state string สถานะของ Conversion ซึ่งก็คือ ACTIVE หรือ REMOVED หมายเหตุ: สถานะ "DELETED" เลิกใช้งานแล้ว

ค่าที่ยอมรับได้ มีดังนี้
  • "ACTIVE"
  • "DELETED":  (เลิกใช้งานแล้ว)
  • "REMOVED"
เขียนได้
conversion[].storeId string รหัสของร้านค้าในพื้นที่ที่โฆษณาผลิตภัณฑ์ ใช้ได้เฉพาะเมื่อช่องเป็น "local"
conversion[].type string ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION เป็นการกระทำของผู้ใช้ที่ไม่มีมูลค่าที่วัดจำนวนเงินได้ ส่วน Conversion TRANSACTION เป็นการกระทำที่มีมูลค่าวัดปริมาณได้ เช่น การลงชื่อสมัครใช้รายชื่ออีเมล (ACTION) เทียบกับการซื้อผ่านอีคอมเมิร์ซ (TRANSACTION)

ค่าที่ยอมรับได้ มีดังนี้
  • "ACTION"
  • "TRANSACTION"
kind string ระบุว่าข้อมูลนี้เป็นทรัพยากร ConversionList ค่า: สตริงคงที่ doubleclicksearch#conversionList

เมธอด

รับ
ดึงรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search
getByCustomerId
ดึงรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search โดยใช้รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่
แทรก
แทรกกลุ่ม Conversion ใหม่ลงใน DoubleClick Search
อัปเดต
อัปเดตกลุ่ม Conversion ใน DoubleClick Search
updateAvailability
อัปเดตความพร้อมใช้งานของกลุ่มกิจกรรม Floodlight ใน DoubleClick Search