เพิ่ม 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 อาจล้มเหลว เนื่องจากคำขอไม่ถูกต้อง หรือเครือข่ายหรือระบบล้มเหลวชั่วคราว ดังนั้น เราขอแนะนำให้คุณอ่านคำตอบสำหรับ 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

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

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

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

    หากคุณระบุ TRANSACTION คุณจะต้องระบุช่องต่อไปนี้ด้วย

    • revenueMicros: มูลค่าที่เป็นตัวเงินของ Conversion

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

  • quantityMillis: จำนวนสินค้าใน Conversion นี้ เช่น จำนวนผู้ที่ลงชื่อสมัครรับจดหมายข่าวทางอีเมลหรือจำนวนสินค้าทั้งหมดที่ขายไป หากไม่ได้ระบุฟิลด์นี้สำหรับ Conversion ACTION 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"
  }]
}

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 และใช้เพื่อระบุแหล่งที่มาของ 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 ที่เป็น TRANSACTION มีมูลค่าทางการเงิน ตัวอย่างเช่น การลงชื่อสมัครใช้รายชื่ออีเมล (การกระทำ) เทียบกับการซื้ออีคอมเมิร์ซ (ธุรกรรม)

    หากคุณระบุ TRANSACTION คุณจะต้องระบุช่องต่อไปนี้ด้วย

    • revenueMicros: มูลค่าที่เป็นตัวเงินของ Conversion

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

  • quantityMillis: จำนวนสินค้าใน Conversion นี้ เช่น จำนวนผู้ที่ลงชื่อสมัครรับจดหมายข่าวทางอีเมลหรือจำนวนสินค้าทั้งหมดที่ขายไป หากไม่ได้ระบุฟิลด์นี้สำหรับ Conversion ACTION 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"
  }]
}

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 ที่เป็น TRANSACTION มีมูลค่าทางการเงิน ตัวอย่างเช่น การลงชื่อสมัครใช้รายชื่ออีเมล (การกระทำ) เทียบกับการซื้ออีคอมเมิร์ซ (ธุรกรรม)

    หากคุณระบุ TRANSACTION คุณจะต้องระบุช่องต่อไปนี้ด้วย

    • revenueMicros: มูลค่าที่เป็นตัวเงินของ Conversion

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

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

  • quantityMillis: จำนวนสินค้าใน Conversion นี้ เช่น จำนวนผู้ที่ลงชื่อสมัครรับจดหมายข่าวทางอีเมลหรือจำนวนสินค้าทั้งหมดที่ขายไป หากไม่ได้ระบุฟิลด์นี้สำหรับ Conversion ACTION 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

การตอบกลับจาก 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 ที่เหลือ

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