เพิ่ม Conversion ใหม่

โทรหา Conversion.insert() เพื่อเพิ่ม Conversion อย่างน้อย 1 รายการ เพื่อให้ระบุแหล่งที่มาของ Conversion ได้อย่างเหมาะสม คำขอของคุณ ต้องระบุชื่อกิจกรรม Floodlight ที่ผู้ลงโฆษณาใช้รายงาน Conversion ออฟไลน์ พร้อมกับรหัสของคีย์เวิร์ด โฆษณา และการคลิกที่นำไปสู่ Conversion สำหรับ ดูข้อมูลเกี่ยวกับการรับรหัส Search Ads 360 ได้ที่รหัส Search Ads 360 และ Conversion

ดูข้อมูลเกี่ยวกับข้อจํากัดในการอัปโหลด Conversion ที่ผ่านมาได้ใน ศูนย์ช่วยเหลือของ Search Ads 360

หากคำขอ Conversion.insert() ระบุ Conversion หลายรายการ Search Ads 360 จะพยายามอัปโหลด Conversion แต่ละรายการอย่างดีที่สุดแทนที่จะ การอัปโหลดทั้งกลุ่มเป็นธุรกรรมทั้งหมดหรือไม่ต้องทำอะไรเลย หากมี Conversion บางรายการใน ไม่สามารถอัปโหลดกลุ่ม แต่รายการอื่นๆ อาจยังอัปโหลดสำเร็จ การอัปโหลด Conversion อาจล้มเหลว เพราะคำขอที่ไม่ถูกต้องหรือเครือข่ายหรือระบบล้มเหลวชั่วคราว ด้วยเหตุนี้ เราจึง ขอแนะนำให้คุณอ่านการตอบกลับสำหรับ Conversion ที่แทรกทุกรายการเพื่อ ให้ตรวจสอบว่าการอัปโหลดเสร็จสมบูรณ์

ฉันจะใช้ข้อมูลที่อัปโหลดได้เร็วเพียงใด

หากคุณระบุ conversionTimestamp ของวันนี้หรือเมื่อวานสำหรับ Conversion เมตริกสำหรับ จะปรากฏใน UI ของ Search Ads 360 ภายใน 1 ชั่วโมงหลังจากอัปโหลด หากคุณ ระบุ conversionTimestamp ที่เก่ากว่าเมื่อวานนี้ ระบบจะอัปเดตเมตริกใน หลายชั่วโมง

แปลงการประทับเวลาทั้งหมดสำหรับ Conversion เป็นเวลา Epoch (หรือที่เรียกว่าเวลา Unix)

ฉันจะสร้างกิจกรรม Floodlight จาก API ได้ไหม

หากผู้ลงโฆษณายังไม่ได้สร้างกิจกรรม Floodlight เพื่อติดตาม Conversion ออฟไลน์ คุณสามารถ ใช้ Campaign Manager API เพื่อสร้าง คุณใช้ API เพื่อระบุไม่ได้ กิจกรรม Floodlight จะใช้สำหรับ Conversion ออฟไลน์เป็นหลัก ซึ่งเหมาะสมที่สุด เมื่อมีแนวทางปฏิบัติที่ดีที่สุดที่กลยุทธ์การเสนอราคาจะใช้ข้อมูลจาก Conversion

เราขอแนะนำว่าหลังจากที่ใช้ API ในการสร้าง Floodlight กิจกรรมที่ผู้ใช้ Search Ads 360 ลงชื่อเข้าใช้ Search Ads 360 และเปลี่ยนแปลง การตั้งค่าเพื่อ ระบุว่าแหล่งที่มาหลักของ Conversion คือกิจกรรมออฟไลน์

แนวทางปฏิบัติแนะนำสำหรับการเพิ่ม Conversion

เราขอแนะนำแนวทางปฏิบัติแนะนำต่อไปนี้ในการเพิ่ม Conversion

  1. ขอให้ผู้ใช้ Search Ads 360 ลงชื่อเข้าใช้ Search Ads 360 และเปลี่ยนการตั้งค่า สำหรับแต่ละกิจกรรม Floodlight ที่คุณใช้เพื่อรายงาน Conversion ออฟไลน์ การตั้งค่าควร บ่งชี้ว่าแหล่งที่มาหลักของ Conversion คือกิจกรรมออฟไลน์ โปรดดู ศูนย์ช่วยเหลือของ Search Ads 360 สำหรับคำแนะนำ

  2. อัปโหลด Conversion ทันทีที่พร้อมใช้งาน หากคุณ ระบุแหล่งที่มาของ Conversion จากการเข้าชมที่เฉพาะเจาะจง โปรดรออย่างน้อย 30 นาทีหลังจาก การเข้าชมก่อนที่จะอัปโหลด Conversion Search Ads 360 อาจไม่รู้จักรหัสคลิกของการเข้าชมหาก ที่คุณอัปโหลดหลังการเข้าชม 30 นาที ในบางกรณีซึ่งพบได้ไม่บ่อยนัก คุณอาจต้อง โปรดรอประมาณ 4 ชั่วโมงก่อนที่ Search Ads 360 จะจดจำ clickId ได้

    ตรวจสอบว่าการอัปโหลดแต่ละรายการมี Conversion ล่าสุด ภายใน คำขออัปโหลด สามารถทำได้หากรายการไม่เป็นไปตามลำดับเวลา แต่กลยุทธ์การเสนอราคาอาจ ไม่สามารถพิจารณา Conversion เก่าๆ ที่คุณอัปโหลดภายหลังในคำขออื่น

  3. หากคุณรอนานกว่า 24 ชั่วโมงก่อนที่จะอัปโหลด Conversion สำหรับกิจกรรม Floodlight ส่ง การประทับเวลาความพร้อมจำหน่ายสินค้า [availability]

    การประทับเวลาความพร้อมจำหน่ายสินค้าควรเป็นอย่างใดอย่างหนึ่งต่อไปนี้

    • หากคุณได้บันทึก Conversion ในช่วง 24 ชั่วโมงที่ผ่านมา แต่ยังไม่ได้อัปโหลด แต่การประทับเวลาควรเป็น เวลาที่ Conversion ที่อัปโหลดครั้งล่าสุด เกิดขึ้น การดำเนินการนี้จะแจ้งให้ Search Ads 360 ทราบว่าอาจมี Conversion เกิดขึ้น ในช่วง 24 ชั่วโมงที่ผ่านมา แต่คุณยังไม่ได้ระบุข้อมูล กลยุทธ์การเสนอราคาและ ระบบอัตโนมัติอื่นๆ จะพิจารณาประวัติประสิทธิภาพจนถึงช่วงที่ผ่านมา Conversion ที่คุณอัปโหลด
    • หากไม่มี Conversion เกิดขึ้นในช่วง 24 ชั่วโมงที่ผ่านมา การประทับเวลาควรเป็น เวลาและวันที่ปัจจุบัน ซึ่งจะแจ้งให้ Search Ads 360 ทราบว่า Conversion ที่เกิดขึ้นในช่วง 24 ชั่วโมงที่ผ่านมา กลยุทธ์การเสนอราคาและการเสนอราคาอัตโนมัติอื่นๆ จะรวมช่วงเวลา 24 ชั่วโมงที่ผ่านมา ซึ่งเป็นหนึ่งวันที่ไม่มี Conversion ในฐานะ ส่วนหนึ่งของประวัติประสิทธิภาพ

ส่งคำขอแทรก

คุณส่งคำขอ Conversion.insert() เพื่อดำเนินการต่อไปนี้ได้

  • ระบุแหล่งที่มาของ Conversion เป็นการเข้าชมที่เฉพาะเจาะจง
  • ระบุแหล่งที่มาของ Conversion จากคีย์เวิร์ดเท่านั้น

ฟิลด์ที่จำเป็นในคำขอ Conversion.insert() จะขึ้นอยู่กับ เหตุการณ์หรือรายการที่คุณกำหนดแหล่งที่มาของ Conversion นั้น ส่วนต่อไปนี้แสดงรายการ และช่องที่ไม่บังคับสำหรับแต่ละเหตุการณ์ หรือรายการแต่ละรายการที่คุณระบุแหล่งที่มาของ Conversion ได้

ระบุแหล่งที่มาของ Conversion เป็นการเข้าชมที่เฉพาะเจาะจง

เมื่อลูกค้าคลิกโฆษณา 1 รายการขึ้นไปและไปที่เว็บไซต์ของผู้ลงโฆษณา Search Ads 360 จะถือว่าเซสชันของผู้ใช้ในเว็บไซต์ของผู้ลงโฆษณาเป็นการเข้าชม หากต้องการระบุแหล่งที่มาของ Conversion เป็นการเข้าชม ให้ระบุข้อมูลต่อไปนี้ใน Conversion.insert() คำขอ:

ฟิลด์ที่จำเป็น

  • clickId: รหัสคลิกที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ของการเข้าชม ดูใน บันทึกการใช้เว็บของผู้ลงโฆษณาสำหรับรหัสคลิกหรือแสดงรายการ Conversion และใช้ รหัสคลิกจาก Conversion อื่น Search Ads 360 จะระบุแหล่งที่มาของ Conversion คีย์เวิร์ด โฆษณา และออบเจ็กต์อื่นๆ ของ Search Ads 360 ที่ทำให้เกิด ที่ทำให้เกิดการเข้าชม
    รออย่างน้อย 30 นาทีหลังจาก Search Ads 360 จะสร้างรหัสคลิกเพื่ออัปโหลด Conversion หากคุณได้รับ "ไม่พบรหัสคลิก" ให้รอ 4 ชั่วโมงแล้วจึงอัปโหลด Conversion อีกครั้ง ควรอัปโหลด Conversion ทั้งหมดภายใน 90 วันนับจากวันที่ รหัสคลิกที่สร้างขึ้น มิฉะนั้น Search Ads 360 API อาจไม่รู้จักการเข้าชมนั้น
  • conversionId: สำหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะระบุรหัสนี้ ผู้ลงโฆษณาสามารถ ระบุรหัสที่มีความหมายต่อพวกเขา Conversion แต่ละรายการในคำขอต้องระบุรหัสที่ไม่ซ้ำกัน และชุดค่าผสมของรหัสและการประทับเวลาต้องไม่ซ้ำกับ Conversion ทั้งหมดภายในผู้ลงโฆษณา สำหรับ Conversion ออนไลน์ Search Ads 360 จะคัดลอก dsConversionId หรือ floodlightOrderId ลงในพร็อพเพอร์ตี้นี้โดยขึ้นอยู่กับคำสั่ง Floodlight ของผู้ลงโฆษณา
  • conversionTimestamp: ระบุวันที่และเวลาที่ เกิด Conversion ตัวอย่างเช่น หาก Conversion เกิดขึ้นในวันศุกร์ที่ 5 ส.ค. 2016 เวลา 11:53:22 น. เวลาออมแสงตะวันออก (GMT -4:00) ระบุการประทับเวลาเป็นมิลลิวินาที Epoch: 1470412402000
  • segmentationType: ระบุประเภทของระบบ Conversion ที่จะอัปโหลด เป็น Conversion ขณะนี้ระบบรองรับเฉพาะ Conversion ของ Floodlight เท่านั้น ดังนั้นฟิลด์นี้ จำเป็นต้องระบุ FLOODLIGHT เสมอ
  • segmentationName: ชื่อกิจกรรม Floodlight ของผู้ลงโฆษณา ที่ใช้รายงาน Conversion

    หากผู้ลงโฆษณาของคุณมีกิจกรรมที่มีชื่อเดียวกัน (ซึ่งสามารถเกิดขึ้นได้หากกิจกรรม เป็นของกลุ่ม Floodlight ที่ต่างกัน) การดำเนินการที่แนะนำคือ เปลี่ยนชื่อกิจกรรมใดกิจกรรมหนึ่ง

    หรือหากคุณทราบว่ารหัส Search Ads 360 กำหนดให้กับกิจกรรม Floodlight แล้ว คุณสามารถระบุรหัสใน segmentationId แทนการระบุชื่อใน ฟิลด์ segmentationName (Campaign Manager จะกำหนดรหัสให้กับกิจกรรม Floodlight แต่รหัส Campaign Manager แตกต่างจากรหัส Search Ads 360 และไม่สามารถใช้เพื่อระบุแหล่งที่มา conversions.) หากต้องการดูรหัส Search Ads 360 สําหรับกิจกรรม Floodlight ให้ดาวน์โหลด รายงาน Conversion (จาก UI ของ Search Ads 360 หรือการรายงาน API) หากมีการระบุแหล่งที่มาของ Conversion อย่างน้อย 1 รายการเป็นกิจกรรม Floodlight ระหว่าง คุณจะเห็นรหัส Search Ads 360 ในรายงาน

  • type: ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION ไม่มีมูลค่าทางการเงิน ขณะที่ เป็น Conversion ที่เป็นธุรกรรม ตัวอย่างเช่น การลงชื่อสมัครรับอีเมล (ACTION) เทียบกับ การซื้อผ่านอีคอมเมิร์ซ (TRANSACTION)

    หากคุณระบุ TRANSACTION คุณต้องระบุฟิลด์ต่อไปนี้ด้วย

    • revenueMicros: มูลค่าทางการเงินของ Conversion

ช่องที่ไม่บังคับ

  • quantityMillis: จำนวนรายการใน Conversion นี้ ตัวอย่างเช่น พารามิเตอร์ จำนวนผู้ที่ลงชื่อสมัครรับจดหมายข่าวทางอีเมล หรือจำนวนสินค้าทั้งหมดที่ขาย หากคุณไม่ระบุฟิลด์นี้สำหรับ Conversion การดำเนินการ Search Ads 360 จะแทรก เป็น 1000
  • currencyCode: สกุลเงินของรายได้ของธุรกรรม โดยค่าเริ่มต้น รายได้จะเท่ากับ ถือว่าเป็นสกุลเงินของผู้ลงโฆษณา หากคุณระบุสกุลเงินอื่น Search Ads 360 จะแปลงจำนวนรายได้ที่ระบุเป็นสกุลเงินของผู้ลงโฆษณา ดูข้อมูลเพิ่มเติม
    ใช้ตัวอักษร ISO 4217 (3 อักขระ) format [รูปแบบ] เพื่อระบุสกุลเงิน
    ใช้ได้กับ Conversion ที่มีการทำธุรกรรมเท่านั้น
  • customMetric และ customDimension: อัปโหลดข้อมูลเพิ่มเติมเกี่ยวกับ เช่น ประเทศที่จัดส่งสินค้าที่ซื้อ รหัสผลิตภัณฑ์ หรือแม้กระทั่ง ระยะเวลาของการโทร ดูข้อมูลเพิ่มเติมเกี่ยวกับ อัปโหลดข้อมูลสำหรับ ตัวแปร Floodlight
  • deviceType: ระบุประเภทของอุปกรณ์ที่มี Conversion เกิดขึ้น โปรดดู รายการค่าที่ยอมรับสำหรับกรณีนี้ ด้วย

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
    "currencyCode": "USD"
  }]
}
          

Java

  /**
   * Instantiate the Doubleclicksearch service, create conversions, and upload them.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.

    // Set up a List to keep track of each conversion you create.
    List<Conversion> conversions = new Vector<Conversion>();

    // Add a conversion to the List.
    addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
        "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);

    // Upload the List and handle the response.
    uploadConversions(conversions, service);
  }


  /**
   * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
   * the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
   */
  private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
      String clickId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion().setClickId(clickId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }


  /**
   * Convert the List of conversions to a DS ConversionList, send an insert request to DS,
   * and output the response to a file.
   */
  private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
      throws IOException {

    FileOutputStream outputStream =
        new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
    final PrintStream printStream = new PrintStream(outputStream);

    try {
      // Convert the List to a ConversionList.
      ConversionList conversionList = new ConversionList().setConversion(conversions);

      // Insert an upload request and download the response to a file.
      service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
      printStream.close();
    } catch (GoogleJsonResponseException e) {
      System.err.println("Get request was rejected.");
      for (ErrorInfo error : e.getDetails().getErrors()) {
        System.err.println(error.getMessage());
      }
      System.exit(e.getStatusCode());
    }
  }
            

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a visit.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
              'conversionId': 'test_20140206_00',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

ระบุแหล่งที่มาของ Conversion จากคีย์เวิร์ดเท่านั้น

หากข้อกังวลหลักของคุณคือการระบุแหล่งที่มาของ Conversion เป็นคีย์เวิร์ด และไม่เกี่ยวข้องกับ กังวลเรื่องการระบุแหล่งที่มาของโฆษณา คุณสามารถละเว้น Search Ads 360 ส่วนใหญ่ได้ ระบุ และระบุเพียงตัวระบุคีย์เวิร์ดพร้อมด้วยช่องอื่นๆ อีก 2-3 ช่อง

ฟิลด์ที่จำเป็น

  • criterionId: นี่คือตัวระบุคีย์เวิร์ด คุณสามารถรับ criterionId ได้โดยเพิ่ม TrackerId ลงใน URL ของหน้า Landing Page สำหรับข้อมูลเกี่ยวกับการรับรหัสคีย์เวิร์ด โปรดดู รหัส Search Ads 360 และ Conversion
  • conversionId: สำหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะระบุรหัสนี้ ผู้ลงโฆษณาสามารถ ระบุรหัสที่มีความหมายต่อพวกเขา Conversion แต่ละรายการในคำขอต้องระบุรหัสที่ไม่ซ้ำกัน และชุดค่าผสมของรหัสและการประทับเวลาต้องไม่ซ้ำกับ Conversion ทั้งหมดภายในผู้ลงโฆษณา สำหรับ Conversion ออนไลน์ Search Ads 360 จะคัดลอก dsConversionId หรือ floodlightOrderId ลงในพร็อพเพอร์ตี้นี้โดยขึ้นอยู่กับคำสั่ง Floodlight ของผู้ลงโฆษณา
  • conversionTimestamp: ระบุวันที่และเวลาที่ เกิด Conversion ตัวอย่างเช่น หาก Conversion เกิดขึ้นในวันศุกร์ที่ 5 ส.ค. 2016 เวลา 11:53:22 น. เวลาออมแสงตะวันออก (GMT -4:00) ระบุการประทับเวลาเป็นมิลลิวินาที Epoch: 1470412402000
  • segmentationType: ระบุประเภทของระบบ Conversion ที่จะอัปโหลด เป็น Conversion ขณะนี้ระบบรองรับเฉพาะ Conversion ของ Floodlight เท่านั้น ดังนั้นฟิลด์นี้ จำเป็นต้องระบุ FLOODLIGHT เสมอ
  • segmentationName: ชื่อกิจกรรม Floodlight ของผู้ลงโฆษณา ที่ใช้รายงาน Conversion

    หากผู้ลงโฆษณาของคุณมีกิจกรรมที่มีชื่อเดียวกัน (ซึ่งสามารถเกิดขึ้นได้หากกิจกรรม เป็นของกลุ่ม Floodlight ที่ต่างกัน) การดำเนินการที่แนะนำคือ เปลี่ยนชื่อกิจกรรมใดกิจกรรมหนึ่ง

    หรือหากคุณทราบว่ารหัส Search Ads 360 กำหนดให้กับกิจกรรม Floodlight แล้ว คุณสามารถระบุรหัสใน segmentationId แทนการระบุชื่อใน ฟิลด์ segmentationName (Campaign Manager จะกำหนดรหัสให้กับกิจกรรม Floodlight แต่รหัส Campaign Manager แตกต่างจากรหัส Search Ads 360 และไม่สามารถใช้เพื่อระบุแหล่งที่มา conversions.) หากต้องการดูรหัส Search Ads 360 สําหรับกิจกรรม Floodlight ให้ดาวน์โหลด รายงาน Conversion (จาก UI ของ Search Ads 360 หรือการรายงาน API) หากมีการระบุแหล่งที่มาของ Conversion อย่างน้อย 1 รายการเป็นกิจกรรม Floodlight ระหว่าง คุณจะเห็นรหัส Search Ads 360 ในรายงาน

  • type: ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION ไม่มีมูลค่าทางการเงิน ขณะที่ เป็น Conversion ที่เป็นธุรกรรม ตัวอย่างเช่น การลงชื่อสมัครรับอีเมล (ACTION) เทียบกับ การซื้อผ่านอีคอมเมิร์ซ (TRANSACTION)

    หากคุณระบุ TRANSACTION คุณต้องระบุฟิลด์ต่อไปนี้ด้วย

    • revenueMicros: มูลค่าทางการเงินของ Conversion

ช่องที่ไม่บังคับ

  • quantityMillis: จำนวนรายการใน Conversion นี้ ตัวอย่างเช่น พารามิเตอร์ จำนวนผู้ที่ลงชื่อสมัครรับจดหมายข่าวทางอีเมล หรือจำนวนสินค้าทั้งหมดที่ขาย หากคุณไม่ระบุฟิลด์นี้สำหรับ Conversion การดำเนินการ Search Ads 360 จะแทรก เป็น 1000
  • currencyCode: สกุลเงินของรายได้ของธุรกรรม โดยค่าเริ่มต้น รายได้จะเท่ากับ ถือว่าเป็นสกุลเงินของผู้ลงโฆษณา หากคุณระบุสกุลเงินอื่น Search Ads 360 จะแปลงจำนวนรายได้ที่ระบุเป็นสกุลเงินของผู้ลงโฆษณา ดูข้อมูลเพิ่มเติม
    ใช้ตัวอักษร ISO 4217 (3 อักขระ) format [รูปแบบ] เพื่อระบุสกุลเงิน
    ใช้ได้กับ Conversion ที่มีการทำธุรกรรมเท่านั้น
  • customMetric และ customDimension: อัปโหลดข้อมูลเพิ่มเติมเกี่ยวกับ เช่น ประเทศที่จัดส่งสินค้าที่ซื้อ รหัสผลิตภัณฑ์ หรือแม้กระทั่ง ระยะเวลาการโทร ดูข้อมูลเพิ่มเติมเกี่ยวกับ อัปโหลดข้อมูลสำหรับ ตัวแปร Floodlight
  • deviceType: ระบุประเภทของอุปกรณ์ที่มี Conversion เกิดขึ้น โปรดดู รายการค่าที่ยอมรับสำหรับกรณีนี้ ด้วย

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "criterionId": "43700003491981017", // Replace with your ID
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1351196386000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  }]
}

Java

  /**
   * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>.
   * The example in the preceding section contains the uploadConversions method,
   * which can submit the list as an insert() request.
   */
  private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCriterionId(criterionId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }        

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword only.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'criterionId': '43700004289911004', // Replace with your ID
              'conversionId': 'test_1378710000000',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

อัปโหลดข้อมูลจากรูปแบบการระบุแหล่งที่มาของบุคคลที่สาม

รูปแบบการระบุแหล่งที่มาจะกระจายเครดิตสำหรับ Conversion ทั้งหมด กิจกรรมในเส้นทาง Conversion ได้ ตัวอย่างเช่น หากผู้บริโภคคลิกโฆษณาในการค้นหาที่เสียค่าใช้จ่าย โฆษณา Display และโฆษณา Search ที่เสียค่าใช้จ่ายอีกรายการหนึ่งก่อนทำ Conversion รูปแบบการระบุแหล่งที่มาเชิงเส้นจะ ให้เครดิต Conversion 33% แก่แต่ละคลิก

แม้ว่า Search Ads 360 จะให้ รูปแบบการระบุแหล่งที่มา หากคุณใช้บริการของบุคคลที่สามหรือบริการที่คุณมี ที่พัฒนาขึ้นเพื่อกระจายเครดิตให้กับการคลิก คุณสามารถอัปโหลดข้อมูลการระบุแหล่งที่มาของบุคคลที่สามลงใน Search Ads 360 และใช้ข้อมูลในรายงานและกลยุทธ์การเสนอราคา Search Ads 360

ก่อนจะเริ่ม

ใน Campaign Manager ให้สร้างรูปแบบการระบุแหล่งที่มาที่กำหนดเอง และนำเข้ารูปแบบไปยัง Search Ads 360 ตรวจดูว่าคุณตั้งชื่อรูปแบบว่ารูปแบบการระบุแหล่งที่มาภายนอก ซึ่งจะทำให้ฟีเจอร์ของ Search Ads 360 รู้ว่ามีการใช้รูปแบบการระบุแหล่งที่มากับ ข้อมูล Conversion ที่คุณอัปโหลด เรียนรู้ เพิ่มเติม

ฟิลด์ที่จำเป็น

หากต้องการใช้รูปแบบการระบุแหล่งที่มาของบุคคลที่สามกับ Conversion ให้ระบุข้อมูลต่อไปนี้ทั้งหมด คำขอ Conversion.insert() ของคุณ:

  • clickId: รหัสคลิกที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ของการเข้าชม ดูใน บันทึกการใช้เว็บของผู้ลงโฆษณาสำหรับรหัสคลิกหรือแสดงรายการ Conversion และใช้ รหัสคลิกจาก Conversion อื่น Search Ads 360 จะระบุแหล่งที่มาของ Conversion คีย์เวิร์ด โฆษณา และออบเจ็กต์อื่นๆ ของ Search Ads 360 ที่ทำให้เกิด ที่ทำให้เกิดการเข้าชม
    รออย่างน้อย 30 นาทีหลังจาก Search Ads 360 จะสร้างรหัสคลิกก่อนที่จะอัปโหลด Conversion ด้วยรหัสดังกล่าว มิฉะนั้น Search Ads 360 API อาจไม่รู้จักการเข้าชมนั้น
  • attributionModel: ตั้งค่าเป็นรูปแบบการระบุแหล่งที่มาภายนอก ดูข้อมูลเพิ่มเติม
  • countMillis: จำนวนเครดิต Conversion ที่จะเกี่ยวข้องกับคลิกนี้ ใช้ได้ในกรณีที่คำขอรวมช่อง attributionModel ด้วยเท่านั้น

    อย่าสับสนระหว่าง quantityMillis ซึ่งเป็นช่องที่ไม่บังคับซึ่งระบุ จำนวนสินค้าใน Conversion หนึ่งๆ (เช่น จำนวนสินค้าในรถเข็นช็อปปิ้ง การซื้อ)

  • conversionId: สำหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะระบุรหัสนี้ ผู้ลงโฆษณาสามารถ ระบุรหัสที่มีความหมายต่อพวกเขา Conversion แต่ละรายการในคำขอต้องระบุรหัสที่ไม่ซ้ำกัน และชุดค่าผสมของรหัสและการประทับเวลาต้องไม่ซ้ำกับ Conversion ทั้งหมดภายในผู้ลงโฆษณา สำหรับ Conversion ออนไลน์ Search Ads 360 จะคัดลอก dsConversionId หรือ floodlightOrderId ลงในพร็อพเพอร์ตี้นี้โดยขึ้นอยู่กับคำสั่ง Floodlight ของผู้ลงโฆษณา
  • conversionTimestamp: ระบุวันที่และเวลาที่ เกิด Conversion ตัวอย่างเช่น หาก Conversion เกิดขึ้นในวันศุกร์ที่ 5 ส.ค. 2016 เวลา 11:53:22 น. เวลาออมแสงตะวันออก (GMT -4:00) ระบุการประทับเวลาเป็นมิลลิวินาที Epoch: 1470412402000
  • segmentationType: ระบุประเภทของระบบ Conversion ที่จะอัปโหลด เป็น Conversion ขณะนี้ระบบรองรับเฉพาะ Conversion ของ Floodlight เท่านั้น ดังนั้นฟิลด์นี้ จำเป็นต้องระบุ FLOODLIGHT เสมอ
  • segmentationName: ชื่อกิจกรรม Floodlight ของผู้ลงโฆษณา ที่ใช้รายงาน Conversion

    หากผู้ลงโฆษณาของคุณมีกิจกรรมที่มีชื่อเดียวกัน (ซึ่งสามารถเกิดขึ้นได้หากกิจกรรม เป็นของกลุ่ม Floodlight ที่ต่างกัน) การดำเนินการที่แนะนำคือ เปลี่ยนชื่อกิจกรรมใดกิจกรรมหนึ่ง

    หรือหากคุณทราบว่ารหัส Search Ads 360 กำหนดให้กับกิจกรรม Floodlight แล้ว คุณสามารถระบุรหัสใน segmentationId แทนการระบุชื่อใน ฟิลด์ segmentationName (Campaign Manager จะกำหนดรหัสให้กับกิจกรรม Floodlight แต่รหัส Campaign Manager แตกต่างจากรหัส Search Ads 360 และไม่สามารถใช้เพื่อระบุแหล่งที่มา conversions.) หากต้องการดูรหัส Search Ads 360 สําหรับกิจกรรม Floodlight ให้ดาวน์โหลด รายงาน Conversion (จาก UI ของ Search Ads 360 หรือการรายงาน API) หากมีการระบุแหล่งที่มาของ Conversion อย่างน้อย 1 รายการเป็นกิจกรรม Floodlight ระหว่าง คุณจะเห็นรหัส Search Ads 360 ในรายงาน

  • type: ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION ไม่มีมูลค่าทางการเงิน ขณะที่ เป็น Conversion ที่เป็นธุรกรรม ตัวอย่างเช่น การลงชื่อสมัครรับอีเมล (ACTION) เทียบกับ การซื้อผ่านอีคอมเมิร์ซ (TRANSACTION)

    หากคุณระบุ TRANSACTION คุณต้องระบุฟิลด์ต่อไปนี้ด้วย

    • revenueMicros: มูลค่าทางการเงินของ Conversion

หากคุณติดตามรายได้จาก Conversion ให้ตรวจสอบว่ารูปแบบกระจายรายได้ไปยัง ของจุดสัมผัสลูกค้า ในเส้นทาง Conversion ได้ตัวอย่างเช่น หากโมเดลของคุณใช้แนวทางเชิงเส้น (กระจายรายได้ในแต่ละทัชพอยต์เท่าๆ กัน) ในเส้นทาง Conversion ที่มี การคลิกโฆษณา 3 ครั้ง แต่ละคลิกจะได้รับการระบุแหล่งที่มา 33% ของ Conversion หาก Conversion ทำรายได้ 3,000 บาท ตรวจสอบว่าโมเดล กระจายรายได้ 990 บาทให้กับแต่ละคลิก และตรวจสอบว่า revenueMicros ระบุรายได้เพียง 990 บาทสำหรับแต่ละคลิก

ช่องที่ไม่บังคับ

  • quantityMillis: จำนวนรายการใน Conversion นี้ ตัวอย่างเช่น พารามิเตอร์ จำนวนผู้ที่ลงชื่อสมัครรับจดหมายข่าวทางอีเมล หรือจำนวนสินค้าทั้งหมดที่ขาย หากคุณไม่ระบุฟิลด์นี้สำหรับ Conversion การดำเนินการ Search Ads 360 จะแทรก เป็น 1000
  • currencyCode: สกุลเงินของรายได้ของธุรกรรม โดยค่าเริ่มต้น รายได้จะเท่ากับ ถือว่าเป็นสกุลเงินของผู้ลงโฆษณา หากคุณระบุสกุลเงินอื่น Search Ads 360 จะแปลงจำนวนรายได้ที่ระบุเป็นสกุลเงินของผู้ลงโฆษณา ดูข้อมูลเพิ่มเติม
    ใช้ตัวอักษร ISO 4217 (3 อักขระ) format [รูปแบบ] เพื่อระบุสกุลเงิน
    ใช้ได้กับ Conversion ที่มีการทำธุรกรรมเท่านั้น
  • customMetric และ customDimension: อัปโหลดข้อมูลเพิ่มเติมเกี่ยวกับ เช่น ประเทศที่จัดส่งสินค้าที่ซื้อ รหัสผลิตภัณฑ์ หรือแม้กระทั่ง ระยะเวลาของการโทร ดูข้อมูลเพิ่มเติมเกี่ยวกับ อัปโหลดข้อมูลสำหรับ ตัวแปร Floodlight
  • deviceType: ระบุประเภทของอุปกรณ์ที่มี Conversion เกิดขึ้น โปรดดู รายการค่าที่ยอมรับสำหรับกรณีนี้ ด้วย

ตัวอย่าง

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "attributionModel": "External Attribution Model",
    "countMillis": "330",
    "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
    "currencyCode": "USD"
  }]
}
          

จัดการคำตอบของ Search Ads 360

การตอบสนองจาก Search Ads 360 บ่งชี้ความสำเร็จในกรณีที่ Conversion ทั้งหมดใน คำขอได้รับการตรวจสอบและอัปโหลดเรียบร้อยแล้ว

หากคำขอประสบความสำเร็จ

หากคำขอสำเร็จ การตอบกลับจะรวม Search Ads 360 แบบเต็มภายใน การนำเสนอของ Conversion ที่อัปโหลดแต่ละรายการ เช่น รหัสแคมเปญ รหัสกลุ่มโฆษณา และคีย์เวิร์ด (criterion) ID

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "0",
   "dsConversionId": "48719131694768384",
   "conversionId": "test_1383157331951",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368"
  },
  ...
 ]
}

หากคำขอไม่สำเร็จ

หากมี Conversion อย่างน้อย 1 รายการที่ไม่สามารถตรวจสอบความถูกต้องหรืออัปโหลดได้ การตอบกลับจะรวมข้อความสำหรับ แล้วอัปโหลด Conversion ที่ล้มเหลวแต่ละครั้ง การตอบกลับไม่มีข้อความเกี่ยวกับ Conversion ที่ อัปโหลดเรียบร้อยแล้ว

ตัวอย่างการตอบสนองต่อคำขอที่ไม่ประสบความสำเร็จอย่างสมบูรณ์มีดังนี้

{
 "error": {
    "errors": [
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
       },
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details:  [0x00000101: Click ID ..."
       }
    ]
  }
}

ข้อความแจ้งการทำงานล้มเหลวแต่ละรายการจะมีช่องสำคัญ 2 ช่อง ได้แก่ เหตุผลและข้อผิดพลาดโดยละเอียด ช่องเหตุผลอาจมี requestValidation, internalError, transactionFailed หรือ lateStageRequestError

ข้อผิดพลาด requestValidation

ข้อผิดพลาด requestValidation บ่งบอกถึงปัญหาด้านข้อมูลในการอัปโหลด Conversion (เช่น มีการอัปโหลด Conversion แล้ว หรือไม่พบ clickId) ด้วยวิธีนี้ ประเภทข้อผิดพลาด ข้อความ รายละเอียด จะมี 2 รายการดังนี้

  • รหัสเลขฐานสิบหกที่ระบุประเภทข้อผิดพลาด คุณใช้โค้ดได้ด้วยตัวเอง เพื่อระบุข้อผิดพลาดได้
  • คำอธิบายของข้อผิดพลาดในการตรวจสอบความถูกต้อง

สำหรับข้อมูลเพิ่มเติม โปรดดู รายการรหัสและ คำอธิบายที่ Search Ads 360 สามารถแสดงผลเมื่อเกิดข้อผิดพลาดในการอัปโหลด Conversion

ข้อผิดพลาดประเภทอื่นๆ

ข้อผิดพลาดประเภทอื่นๆ ทั้งหมด (internalError, transactionFailed, หรือ lateStageRequestError) บ่งชี้ว่ามีปัญหาภายในใน Search Ads 360

การตอบกลับข้อผิดพลาด

หากส่งคำขอไม่สำเร็จ ให้ลองส่งคำขอทั้งหมดอีกครั้งในภายหลัง Search Ads 360 จะรายงานข้อผิดพลาด requestValidation สำหรับ Conversion ที่ อัปโหลดแล้ว แต่จะพยายามอัปโหลด Conversion ที่เหลือ

หากคุณยังพบข้อผิดพลาดหลังจากส่งอีกครั้ง ให้ดู การแก้ปัญหา เพื่อดูข้อมูลเกี่ยวกับวิธีดําเนินการต่อ