ทรัพยากร 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,
      "sessionAttributesEncoded": bytes
    }
  ]
}| ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ | 
|---|---|---|---|
conversion[] | 
        list | 
        Conversion ที่ขอ | |
conversion[].adGroupId | 
        long | 
        รหัสกลุ่มโฆษณา DS | |
conversion[].adId | 
        long | 
        รหัสโฆษณา DS | |
conversion[].adUserDataConsent | 
        string | 
        แสดงความยินยอมสำหรับค่ากำหนดของบริการแพลตฟอร์มหลัก (CPS) ในการตั้งค่า ไม่มีค่าเริ่มต้น ค่าที่ยอมรับได้คือ "ให้สิทธิ์แล้ว": สถานะความยินยอมที่ต้องการคือให้สิทธิ์ อ่านค่ากำหนด CPS จากการตั้งค่า GTE ถูกปฏิเสธ: สถานะความยินยอมที่ต้องการคือปฏิเสธ รายการ CPS ว่างเปล่า
           ค่าที่ยอมรับมีดังนี้ 
  | 
        |
conversion[].advertiserId | 
        long | 
        รหัสผู้ลงโฆษณา DS | |
conversion[].agencyId | 
        long | 
        รหัสเอเจนซี DS | |
conversion[].attributionModel | 
        string | 
        พร้อมให้บริการแก่ผู้ลงโฆษณาหลังจากติดต่อฝ่ายสนับสนุนลูกค้าของ DoubleClick Search เท่านั้น | |
conversion[].campaignId | 
        long | 
        รหัสแคมเปญ DS | |
conversion[].channel | 
        string | 
        ช่องทางการขายของผลิตภัณฑ์ ค่าที่ยอมรับมีดังนี้ 
  | 
        |
conversion[].clickId | 
        string | 
        รหัสคลิก DS สําหรับ Conversion | |
conversion[].conversionId | 
        string | 
        สําหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะเป็นผู้ระบุรหัสนี้ ผู้ลงโฆษณาระบุรหัสใดก็ได้ที่สื่อความหมาย Conversion แต่ละรายการในคําขอต้องระบุรหัสที่ไม่ซ้ำกัน และการรวมรหัสและการประทับเวลาต้องไม่ซ้ำกันกับ Conversion ทั้งหมดภายในผู้ลงโฆษณา สําหรับ Conversion ออนไลน์ DS จะคัดลอก dsConversionId หรือ floodlightOrderId ไปยังพร็อพเพอร์ตี้นี้โดยขึ้นอยู่กับคําสั่ง Floodlight ของผู้ลงโฆษณา | 
        |
conversion[].conversionModifiedTimestamp | 
        unsigned long | 
        เวลาที่มีการแก้ไข Conversion ครั้งล่าสุดเป็นมิลลิวินาทีของยุค UTC | |
conversion[].conversionTimestamp | 
        unsigned long | 
        เวลาที่เกิด Conversion เป็นมิลลิวินาทีของยุค 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
           ค่าที่ยอมรับมีดังนี้ 
  | 
        |
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)
          ค่าที่ยอมรับได้ ได้แก่ 
  | 
        |
conversion[].sessionAttributesEncoded | 
        bytes | 
        แอตทริบิวต์เซสชันสําหรับเหตุการณ์ ซึ่งแสดงเป็นสตริง JSON ที่เข้ารหัส Base64 เนื้อหาควรสร้างจากคลังภาพที่ Google มีให้ | |
conversion[].state | 
        string | 
        สถานะของ Conversion ซึ่งก็คือ ACTIVE หรือ REMOVED หมายเหตุ: ระบบเลิกใช้งานสถานะ DELETED แล้ว
          ค่าที่ยอมรับมีดังนี้ 
  | 
        เขียนได้ | 
conversion[].storeId | 
        string | 
        รหัสของร้านค้าในพื้นที่ที่โฆษณาผลิตภัณฑ์ ใช้ได้เฉพาะเมื่อช่องเป็น "local" | 
        |
conversion[].type | 
        string | 
        ประเภท Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION คือการกระทำของผู้ใช้ที่ไม่มีมูลค่าที่วัดเป็นจำนวนเงินได้ ส่วน Conversion TRANSACTION คือการกระทำที่มีมูลค่าที่วัดเป็นจำนวนเงินได้ ตัวอย่างเช่น การสมัครรับอีเมล (ACTION) เทียบกับการซื้อผ่านอีคอมเมิร์ซ (TRANSACTION)
          ค่าที่ยอมรับได้มีดังนี้ 
  | 
        |
kind | 
        string | 
        ระบุว่านี่คือทรัพยากร ConversionList ค่า: สตริงคงที่ doubleclicksearch#conversionList | 
        
เมธอด
- get
 - ดึงข้อมูลรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick
 - getByCustomerId
 - ดึงข้อมูลรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search โดยใช้รหัสลูกค้า Search Ads 360 ใหม่
 - แทรก
 - แทรก Conversion ใหม่หลายรายการลงใน DoubleClick Search
 - update
 - อัปเดต Conversion หลายรายการใน DoubleClick Search
 - updateAvailability
 - อัปเดตความพร้อมใช้งานของกิจกรรม Floodlight กลุ่มหนึ่งใน DoubleClick Search