Search Ads 360 Reporting API เวอร์ชันเก่ากำลังจะหยุดให้บริการ และจะหยุดให้บริการในวันที่ 30 มิถุนายน 2024 โปรดทราบว่า Search Ads 360 Conversion API จะไม่ได้รับผลกระทบและจะยังคงรองรับต่อไป การพัฒนาการรายงานใหม่ทั้งหมดควรใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

ตั้งแต่เดือนเมษายน 2024 ระบบจะแสดงข้อผิดพลาดของเวอร์ชัน API ที่ไม่รองรับเมื่อขอรายงาน ดูรายละเอียดที่นี่

และเราขอแนะนำอย่างยิ่งให้คุณย้ายข้อมูลการใช้งาน Search Ads 360 ที่มีอยู่ไปยัง API ใหม่ ดูข้อมูลเพิ่มเติมได้ที่เริ่มต้นใช้งานและคู่มือการย้ายข้อมูลของ Search Ads 360 Reporting API เวอร์ชันใหม่

หน้านี้ได้รับการแปลโดย Cloud Translation API

เพิ่ม Conversion ใหม่

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

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

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

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

หากระบุ conversionTimestamp ของวันนี้หรือเมื่อวานสำหรับ Conversion เมตริกสำหรับ 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

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

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

การประทับเวลาความพร้อมจำหน่ายสินค้าควรเป็นอย่างใดอย่างหนึ่งต่อไปนี้
- หากคุณบันทึก Conversion ในช่วง 24 ชั่วโมงที่ผ่านมาแต่ยังไม่ได้อัปโหลด Conversion การประทับเวลาควรเป็นเวลาที่เกิด 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 และจะใช้เพื่อระบุแหล่งที่มาของ Conversion ไม่ได้) หากต้องการดูรหัส Search Ads 360 สําหรับกิจกรรม Floodlight ให้ดาวน์โหลดรายงาน Conversion (จาก UI ของ Search Ads 360 หรือ Reporting 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 ตัว) เพื่อระบุสกุลเงิน
ใช้ได้กับ Conversion ที่มีธุรกรรมเท่านั้น
customMetric และ customDimension: อัปโหลดข้อมูลเพิ่มเติมเกี่ยวกับ Conversion เช่น ประเทศที่จัดส่งสินค้าที่ซื้อ รหัสผลิตภัณฑ์ หรือแม้กระทั่งระยะเวลาในการโทรศัพท์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปโหลดข้อมูลสำหรับตัวแปร 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"
  }]
}

ใช้สคริปต์ยูทิลิตีของ Search Ads 360 เพื่อส่งคำขอนี้

หากต้องการส่งคำขอ POST ที่เป็นข้อมูลดิบ JSON คุณใช้สคริปต์ sa360Api.py ได้ดังนี้

คัดลอกออบเจ็กต์ JSON ตัวอย่าง (ทุกอย่างที่อยู่ระหว่างและรวมถึงวงเล็บปีกกา 2 อัน) ลงในไฟล์ข้อความใหม่ที่ชื่อ request.txt
เปลี่ยนรหัสเอเจนซีที่อยู่ในโค้ด JSON เป็นรหัสเอเจนซีของคุณเอง
นำความคิดเห็นออก เช่น // The date column segments the report by individual days.
รวมข้อมูลเข้าสู่ระบบ OAuth 2.0 เป็นสตริงเดียวที่คั่นด้วยคอมมาดังนี้
client-ID,client-secret,refresh-token
(ซึ่งเป็นสตริงเดียวกับที่ sa360Api.py แสดงเมื่อคุณเรียกใช้ sa360Api.py --login ตามที่อธิบายไว้ในตั้งค่าการให้สิทธิ์)
เรียกใช้ sa360Api.py ดังนี้
sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
ในคำสั่งด้านบน ให้ใช้ CREDENTIALS แทนสตริงที่คุณประกอบขึ้นในขั้นตอนก่อนหน้า
แทนที่ชื่อของเมธอด POST ในช่องด้านล่างสำหรับ API-method
ตัวอย่างเช่น
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --post < request.txt

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 ดูข้อมูลการรับรหัสคีย์เวิร์ดได้ที่รหัสและ Conversion ของ Search Ads 360
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 และจะใช้เพื่อระบุแหล่งที่มาของ Conversion ไม่ได้) หากต้องการดูรหัส Search Ads 360 สําหรับกิจกรรม Floodlight ให้ดาวน์โหลดรายงาน Conversion (จาก UI ของ Search Ads 360 หรือ Reporting 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 ตัว) เพื่อระบุสกุลเงิน
ใช้ได้กับ Conversion ที่มีธุรกรรมเท่านั้น
customMetric และ customDimension: อัปโหลดข้อมูลเพิ่มเติมเกี่ยวกับ Conversion เช่น ประเทศที่จัดส่งสินค้าที่ซื้อ รหัสผลิตภัณฑ์ หรือแม้กระทั่งระยะเวลาในการโทรศัพท์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปโหลดข้อมูลสำหรับตัวแปร 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"
  }]
}

ใช้สคริปต์ยูทิลิตีของ Search Ads 360 เพื่อส่งคำขอนี้

หากต้องการส่งคำขอ POST ที่เป็นข้อมูลดิบ JSON คุณใช้สคริปต์ sa360Api.py ได้ดังนี้

คัดลอกออบเจ็กต์ JSON ตัวอย่าง (ทุกอย่างที่อยู่ระหว่างและรวมถึงวงเล็บปีกกา 2 อัน) ลงในไฟล์ข้อความใหม่ที่ชื่อ request.txt
เปลี่ยนรหัสเอเจนซีที่อยู่ในโค้ด JSON เป็นรหัสเอเจนซีของคุณเอง
นำความคิดเห็นออก เช่น // The date column segments the report by individual days.
รวมข้อมูลเข้าสู่ระบบ OAuth 2.0 เป็นสตริงเดียวที่คั่นด้วยคอมมาดังนี้
client-ID,client-secret,refresh-token
(ซึ่งเป็นสตริงเดียวกับที่ sa360Api.py แสดงเมื่อคุณเรียกใช้ sa360Api.py --login ตามที่อธิบายไว้ในตั้งค่าการให้สิทธิ์)
เรียกใช้ sa360Api.py ดังนี้
sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
ในคำสั่งด้านบน ให้ใช้ CREDENTIALS แทนสตริงที่คุณประกอบขึ้นในขั้นตอนก่อนหน้า
แทนที่ชื่อของเมธอด POST ในช่องด้านล่างสำหรับ API-method
ตัวอย่างเช่น
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --post < request.txt

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 ตัวอย่างเช่น หากผู้บริโภคคลิกโฆษณา Search ที่เสียค่าใช้จ่าย โฆษณา 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 และจะใช้เพื่อระบุแหล่งที่มาของ Conversion ไม่ได้) หากต้องการดูรหัส Search Ads 360 สําหรับกิจกรรม Floodlight ให้ดาวน์โหลดรายงาน Conversion (จาก UI ของ Search Ads 360 หรือ Reporting API) หากมี Conversion อย่างน้อย 1 รายการที่มาจากกิจกรรม Floodlight ในกรอบเวลาของรายงาน คุณจะเห็นรหัส Search Ads 360 ในรายงาน
type: ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ที่เป็น "ACTION" ไม่มีมูลค่าทางการเงิน ในขณะที่ Conversion ของ "ธุรกรรม" มี ตัวอย่างเช่น การลงชื่อสมัครใช้รายชื่ออีเมล (ACTION) เทียบกับการซื้อผ่านอีคอมเมิร์ซ (TRANSACTION)
หากระบุ TRANSACTION คุณต้องระบุช่องต่อไปนี้ด้วย
- revenueMicros: มูลค่าทางการเงินของ Conversion

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

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

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

หากต้องการส่งคำขอ POST ที่เป็นข้อมูลดิบ JSON คุณใช้สคริปต์ sa360Api.py ได้ดังนี้

คัดลอกออบเจ็กต์ JSON ตัวอย่าง (ทุกอย่างที่อยู่ระหว่างและรวมถึงวงเล็บปีกกา 2 อัน) ลงในไฟล์ข้อความใหม่ที่ชื่อ request.txt
เปลี่ยนรหัสเอเจนซีที่อยู่ในโค้ด JSON เป็นรหัสเอเจนซีของคุณเอง
นำความคิดเห็นออก เช่น // The date column segments the report by individual days.
รวมข้อมูลเข้าสู่ระบบ OAuth 2.0 เป็นสตริงเดียวที่คั่นด้วยคอมมาดังนี้
client-ID,client-secret,refresh-token
(ซึ่งเป็นสตริงเดียวกับที่ sa360Api.py แสดงเมื่อคุณเรียกใช้ sa360Api.py --login ตามที่อธิบายไว้ในตั้งค่าการให้สิทธิ์)
เรียกใช้ sa360Api.py ดังนี้
sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
ในคำสั่งด้านบน ให้ใช้ CREDENTIALS แทนสตริงที่คุณประกอบขึ้นในขั้นตอนก่อนหน้า
แทนที่ชื่อของเมธอด POST ในช่องด้านล่างสำหรับ API-method
ตัวอย่างเช่น
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --post < request.txt

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

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

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

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

{
 "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 ที่เหลือ

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