แก้ไข Conversion ที่มีอยู่

โทรหา Conversion.update() เพื่อทำการเปลี่ยนแปลงประเภทต่อไปนี้กับ Conversion ที่มีอยู่อย่างน้อย 1 รายการ

• แก้ไขรายได้ รหัสสกุลเงิน หรือจำนวน
• แก้ไข advertiser-provided รหัสคำสั่งซื้อและรหัสที่กำหนดเอง ตัวแปร Floodlight
• นํา Conversion ออกโดยเปลี่ยน conversion.state จาก ACTIVE เป็น REMOVED

Search Ads 360 ไม่รองรับการเปลี่ยนแปลงรายการต่อไปนี้

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

แต่คุณทําเครื่องหมาย Conversion ที่มีอยู่เป็น นำออกแล้ว และอัปโหลด Conversion ใหม่ได้ทุกเมื่อ ที่มีวันที่ ประเภท รหัสการระบุแหล่งที่มา หรือกิจกรรม Floodlight ที่อัปเดต (อย่าลืมระบุ conversionId ใหม่ด้วย)

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

ส่งคำขออัปเดต

ช่องส่วนใหญ่ที่คุณระบุใน Conversion.update() จะใช้เพื่อ ระบุ Conversion ที่ต้องการอัปเดต คุณจะใช้รายการใดรายการหนึ่งต่อไปนี้ เทคนิคในการระบุ Conversion ที่มีอยู่:

• ระบุclickIdของ Conversion
  • Conversion ทั้งหมดที่แก้ไขต้องอยู่ภายใน 60 วันนับจากวันที่สร้างรหัสคลิก
• ระบุ criterionId (รหัสคีย์เวิร์ด) ของ Conversion

ทั้ง 2 เทคนิคกำหนดให้คุณระบุ conversionId, conversionTimestamp, และธุรกรรม type

นอกจากนี้ หาก Conversion เดิมระบุ revenueMicros และ currencyCode หรือ quantityMillis คำขออัปเดตจะต้องระบุข้อมูลนี้ไว้แม้ว่าคุณจะ ไม่เปลี่ยนแปลง

ระบุ Conversion ตามรหัสคลิก

หาก Conversion ระบุรหัสคลิกไว้แต่เดิม คุณสามารถส่ง Conversion.update() ได้ คำขอที่ระบุฟิลด์ต่อไปนี้

• clickId
• conversionId
• conversionTimestamp
• type
• state (ต้องระบุในกรณีที่คุณต้องการเปลี่ยนสถานะเป็น REMOVED เท่านั้น หรือใช้งานอยู่)
• quantityMillis (เฉพาะเมื่อระบุไว้ใน Conversion เดิมเท่านั้น)
• revenueMicros (เฉพาะเมื่อระบุไว้ใน Conversion เดิมเท่านั้น)
• currencyCode (เฉพาะเมื่อระบุไว้ใน Conversion เดิมเท่านั้น)

ตัวอย่าง

ต่อไปนี้เป็นตัวอย่างของ Conversion ที่มีอยู่ 2 รายการ

{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA",
    "conversionId" : "test_20130906_10",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "100000000", // 100 million revenueMicros is equivalent to $100 of revenue
    "currencyCode": "USD"
  },
  {
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
   "conversionId": "test_1383337059137",
   "conversionTimestamp": "1378710000000",
   "segmentationType" : "FLOODLIGHT",
   "segmentationName" : "Test",
   "type": "ACTION",
   "quantityMillis": "1000"
  }]
}     

คำขอต่อไปนี้อัปเดต Conversion รายการใดรายการหนึ่งจากตัวอย่างก่อนหน้า และนํา อีกส่วนหนึ่ง:

JSON

โปรดทราบว่าคำขอ Conversion.update() จะใช้ PUT เมธอด HTTP

PUT 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 data from your site
   "conversionId": "test_20130906_10",
   "conversionTimestamp": "1378710000000",
   "type": "TRANSACTION",
   "revenueMicros": "90000000", // 90 million revenueMicros is equivalent to $90 of revenue
   "currencyCode": "USD"
  },
  {
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with data from your site
   "conversionId": "test_1383337059137",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "1000",
   "state": "REMOVED"
  }
 ]
}        

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

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

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

   ตัวอย่างเช่น
   sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --put < request.txt

Java

/**
 * Instantiate the Doubleclicksearch service, create a conversion that updates an existing conversion,
 * and upload the conversions.
 */
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>();

  // Create a conversion and add it to the conversion list.
  // Just to get a little fancy, the updateConversionFromVisit() method can be used for all
  // visit conversions, including conversions that don't specify quantity, revenue, or currency.
  // If quantityMillis wasn't specified in the original conversion, specify -1L for the
  // quantityMillis parameter. Likewise, if revenueMicros wasn't specified originally,
  // specify -1L for the revenueMicros parameter and an empty string for currency.
  conversionList = updateConversionFromVisit(
      conversionList,
      "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site
      "test_20130906_10",           // conversionId
      1378710000000L,               // timeStamp
      "TRANSACTION",                // type
      "",                           // state
      -1L,                          // quantityMillis
      90000000L,                    // revenueMicros. Equivalent to $90 of revenue
      "USD");                       // currencyCode

   // Here's a conversion that needs to be removed. Just set the state parameter to "REMOVED".
   conversionList = updateConversionFromVisit(
      conversionList,
      "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site
      "test_1383337059137",         // conversionId
      1378710000000L,               // timeStamp
      "ACTION",                     // type
      "REMOVED",                    // state
      1000L,                        // quantityMillis
      -1L,                          // revenueMicros
      "");                          // currencyCode

    // Upload the List and handle the response.
    uploadConversions(conversions, service); // See an example in Add New Conversions. 
  }

/**
 * Create a conversion and add it to a List<Conversion>.
 */
  private static List<Conversion> updateConversionFromVisit(List<Conversion> conversions,
      String clickId,
      String conversionId,
      Long timeStamp,
      String type,
      String state,
      Long quantity,
      Long revenue,
      String currency) {

    // Identifies the existing conversion.
    Conversion conversion = new Conversion()
        .setClickId(clickId)
        .setConversionId(conversionId)
        .setConversionTimestamp(BigInteger.valueOf(timeStamp))
        .setType(type);

    // Only add these fields if the value is not empty greater than -1.
    if(!state.isEmpty()) conversion.setState(state);
    if (quantity > -1L) {
      conversion.setQuantityMillis(quantity);
    }
    if (revenue > -1L) {
      conversion.setRevenueMicros(revenue);
      if (!currency.isEmpty()) {
        conversion.setCurrencyCode(currency);
      } else {
        System.err.println(String.format(
            "Can't add conversion %s. It specifies revenue but no currency.",
            conversion.getConversionId()));
        return conversions;
      }
    }

    conversions.add(conversion);
    return conversions;
  }         

Python

def update_conversion(service):
  """Change the revenue for one existing conversion and remove another.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().update(
      body=
      {
          'conversion' : [{
              'clickId' : 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site
              'conversionId' : 'test_20130906_13',
              'conversionTimestamp' : '1378710000000',
              'segmentationType' : 'FLOODLIGHT',
              'segmentationName' : 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '90000000', // 90 million revenueMicros is equivalent to $90 of revenue
              'currencyCode': 'USD'
            },
            {
             'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site
             'conversionId': 'test_1383337059137_01',
             'conversionTimestamp': '1378710000000',
             'segmentationType' : 'FLOODLIGHT',
             'segmentationName' : 'Test',
             'type': 'ACTION',
             'quantityMillis': '1000',
             'state': 'REMOVED'
            }]
      }
  )

  pprint.pprint(request.execute())

ระบุ Conversion ตามรหัสคีย์เวิร์ด

หากคุณไม่มีสิทธิ์เข้าถึงรหัสคลิก หรือหากเดิม Conversion มีการระบุแหล่งที่มาเป็น คุณสามารถส่งคำขอ Conversion.update() ซึ่ง ระบุฟิลด์ต่อไปนี้

• criterionId (รหัสคีย์เวิร์ด)
• conversionId
• conversionTimestamp
• type
• state (ต้องระบุในกรณีที่คุณต้องการเปลี่ยนสถานะเป็น REMOVED เท่านั้น หรือใช้งานอยู่)
• quantityMillis (เฉพาะเมื่อระบุไว้ใน Conversion เดิมเท่านั้น)
• revenueMicros (เฉพาะเมื่อระบุไว้ใน Conversion เดิมเท่านั้น)
• currencyCode (เฉพาะเมื่อระบุไว้ใน Conversion เดิมเท่านั้น)

คุณเลือกที่จะระบุรหัสอื่นๆ ได้ด้วย เช่น รหัสโฆษณาของ Conversion, รหัสแคมเปญ เป็นต้น แต่ไม่จำเป็น Search Ads 360 ต้องใช้เฉพาะรหัสในรายการด้านบนเพื่อ ระบุ Conversion ที่มีอยู่

ตัวอย่าง

ต่อไปนี้เป็นตัวอย่างของ Conversion ที่มีอยู่

{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "44700000155906860",
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "1000",
   "segmentationType": "FLOODLIGHT",
   "segmentationName": "Test"
  }]
}     

คำขอต่อไปนี้อัปเดตการประทับเวลาของ Conversion

JSON

โปรดทราบว่าคำขอ Conversion.update() จะใช้ PUT เมธอด HTTP

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

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

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

   ตัวอย่างเช่น
   sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/conversion --put < request.txt

PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "criterionId": "43700004289911004", // Replace with your ID
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "3000"
  }
 ]
}        

Java

    // Send conversion data to updateConversion, which creates a conversion and adds it
    // to the conversion list.
    conversionList =  updateConversionFromKeyword(conversionList,
        43700004289911004L,   // criterionId. Replace with your ID
        "test_1383157519886", // conversionId
        1378710000000L,       // timeStamp
        "ACTION",             // type
        "",                   // state
        3000L,                // quantityMillis
        -1L,                  // revenueMicros
        "");                  // currencyCode

  private static List<Conversion> updateConversionFromKeyword(List<Conversion> conversions,
       Long criterionId,
       String conversionId,
       Long timeStamp,
       String type,
       String state,
       Long quantity,
       Long revenue,
       String currency
    ) {

   Conversion conversion = new Conversion()
   .setCriterionId(criterionId)
   .setConversionId(conversionId)
   .setConversionTimestamp(BigInteger.valueOf(timeStamp))
   .setType(type);

   // Only add these fields if the value is not empty greater than -1.
   if(!state.isEmpty()) conversion.setState(state);
   if (quantity > -1L) {
     conversion.setQuantityMillis(quantity);
   }
   if (revenue > -1L) {
     conversion.setRevenueMicros(revenue);
     if (!currency.isEmpty()) {
       conversion.setCurrencyCode(currency);
     } else {
       System.err.println(String.format(
           "Can't add conversion %s. It specifies revenue but no currency.",
           conversion.getConversionId()));
       return conversions;
     }
   }

   conversions.add(conversion);
   return conversions;
   }                 

Python

def update_conversion(service):
  """Change the timestamp of a conversion. Use only the keyword id (criterionId)
  to identify the conversion.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().update(
      body=
      {
          'conversion': [{
              'criterionId': '43700004289911004', // Replace with your ID
              'conversionId': 'test_1383157519886',
              'conversionTimestamp': '1378760000000',
              'type': 'ACTION',
              'quantityMillis': '1000'
            }]
      }
  )

  pprint.pprint(request.execute())

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

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

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

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