Thêm lượt chuyển đổi mới

Khi nào thì tôi có thể sử dụng dữ liệu được tải lên?

Nếu bạn chỉ định conversionTimestamp của hôm nay hoặc hôm qua cho một lượt chuyển đổi, thì các chỉ số cho lượt chuyển đổi đó sẽ xuất hiện trong giao diện người dùng Search Ads 360 trong vòng một giờ kể từ khi tải lên. Nếu bạn chỉ định một conversionTimestamp cũ hơn hôm qua, thì các chỉ số sẽ được cập nhật sau vài giờ.

Chuyển đổi tất cả dấu thời gian của lượt chuyển đổi thành Thời gian bắt đầu (còn gọi là thời gian Unix).

Tôi có thể tạo hoạt động Floodlight từ API không?

Nếu nhà quảng cáo chưa tạo hoạt động Floodlight để theo dõi lượt chuyển đổi ngoại tuyến, bạn có thể sử dụng API Campaign Manager để tạo hoạt động. Bạn không thể sử dụng API để chỉ định rằng một hoạt động Floodlight chủ yếu được dùng cho lượt chuyển đổi ngoại tuyến. Đây là phương pháp hay nhất khi chiến lược giá thầu sẽ sử dụng dữ liệu từ lượt chuyển đổi.

Bạn nên sau khi sử dụng API để tạo hoạt động Floodlight, người dùng Search Ads 360 đăng nhập vào Search Ads 360 và thay đổi chế độ cài đặt của hoạt động để cho biết nguồn chuyển đổi chính là hoạt động ngoại tuyến.

Các phương pháp hay nhất để thêm lượt chuyển đổi

Bạn nên áp dụng các phương pháp hay nhất sau đây để thêm lượt chuyển đổi:

1. Yêu cầu người dùng Search Ads 360 đăng nhập vào Search Ads 360 và thay đổi chế độ cài đặt cho từng hoạt động Floodlight mà bạn sử dụng để báo cáo lượt chuyển đổi ngoại tuyến. Chế độ cài đặt phải cho biết rằng nguồn chuyển đổi chính là hoạt động ngoại tuyến. Hãy xem hướng dẫn trong Trung tâm trợ giúp của Search Ads 360.

2. Tải lượt chuyển đổi lên ngay khi có. Nếu bạn đang xác định lượt chuyển đổi cho một số lượt truy cập cụ thể, hãy đợi ít nhất 6 giờ sau lượt truy cập đó rồi mới tải lượt chuyển đổi lên. Search Ads 360 có thể không nhận dạng được clickID của lượt truy cập nếu bạn tải lên sớm hơn 6 giờ sau khi có lượt truy cập. Trong một số ít trường hợp, bạn có thể phải đợi tối đa 24 giờ thì Search Ads 360 mới có thể nhận dạng được clickId.

   Đảm bảo rằng mỗi tệp tải lên đều chứa các lượt chuyển đổi gần đây nhất. Trong một yêu cầu tải lên, bạn có thể không tuân theo thứ tự thời gian cho các mục nhập. Tuy nhiên, một chiến lược giá thầu có thể không thể xem xét các lượt chuyển đổi cũ mà bạn tải lên sau này trong một yêu cầu khác.

Gửi yêu cầu chèn

Bạn có thể gửi yêu cầu Conversion.insert() để thực hiện bất kỳ thao tác nào sau đây:

• Phân bổ lượt chuyển đổi cho một lượt truy cập cụ thể
• Chỉ phân bổ lượt chuyển đổi cho một từ khoá

Các trường bắt buộc trong yêu cầu Conversion.insert() phụ thuộc vào sự kiện hoặc mục mà bạn đang phân bổ lượt chuyển đổi. Các phần sau đây liệt kê các trường bắt buộc và không bắt buộc cho từng sự kiện hoặc mục mà bạn có thể phân bổ lượt chuyển đổi.

Phân bổ lượt chuyển đổi cho một lượt truy cập cụ thể

Khi khách hàng nhấp vào một hoặc nhiều quảng cáo và chuyển đến trang web của nhà quảng cáo, Search Ads 360 sẽ coi phiên người dùng trên trang web của nhà quảng cáo là một lượt truy cập. Để phân bổ lượt chuyển đổi cho một lượt truy cập, hãy chỉ định những thông tin sau trong yêu cầu Conversion.insert():

Các trường bắt buộc

• clickId: Mã lượt nhấp có phân biệt chữ hoa chữ thường của lượt truy cập. Tìm mã lượt nhấp hoặc danh sách lượt chuyển đổi trong nhật ký web của nhà quảng cáo rồi sử dụng mã lượt nhấp từ một lượt chuyển đổi khác. Search Ads 360 sẽ phân bổ lượt chuyển đổi cho từ khoá, quảng cáo và các đối tượng khác trong Search Ads 360 chịu trách nhiệm tạo ra lượt truy cập.
  Chờ ít nhất 6 giờ sau khi Search Ads 360 tạo mã lượt nhấp để tải lượt chuyển đổi lên. Nếu bạn nhận được lỗi "Không tìm thấy mã lượt nhấp", hãy đợi 24 giờ rồi tải lại các lượt chuyển đổi lên. Bạn phải tải tất cả lượt chuyển đổi lên trong vòng 90 ngày kể từ khi mã lượt nhấp được tạo. Nếu không, API Search Ads 360 có thể không nhận ra lượt truy cập đó.
• conversionId: Đối với lượt chuyển đổi ngoại tuyến, nhà quảng cáo sẽ cung cấp mã này. Nhà quảng cáo có thể chỉ định bất kỳ mã nhận dạng nào có ý nghĩa đối với họ. Mỗi lượt chuyển đổi trong một yêu cầu phải chỉ định một mã nhận dạng duy nhất, đồng thời tổ hợp mã nhận dạng và dấu thời gian phải là duy nhất trong số tất cả lượt chuyển đổi của nhà quảng cáo. Đối với lượt chuyển đổi trực tuyến, Search Ads 360 sẽ sao chép dsConversionId hoặc floodlightOrderId vào tài sản này tuỳ thuộc vào hướng dẫn Floodlight của nhà quảng cáo.
• conversionTimestamp: Cho biết ngày và giờ xảy ra lượt chuyển đổi. Ví dụ: nếu lượt chuyển đổi diễn ra vào 11:53:22 sáng thứ Sáu, ngày 5 tháng 8 năm 2016 theo Giờ tiết kiệm ánh sáng ban ngày miền Đông (GMT – 4:00), hãy chỉ định dấu thời gian theo mili giây theo Thời gian bắt đầu của hệ thống: 1470412402000.
• segmentationType: Chỉ định loại hệ thống chuyển đổi mà bạn đang tải lượt chuyển đổi lên. Hiện tại, chúng tôi chỉ hỗ trợ lượt chuyển đổi Floodlight, vì vậy, trường này luôn bắt buộc phải chỉ định FLOODLIGHT.
• segmentationName: Tên của hoạt động Floodlight mà nhà quảng cáo đang sử dụng để báo cáo lượt chuyển đổi.

  Nếu nhà quảng cáo của bạn chứa các hoạt động có cùng tên (điều này có thể xảy ra nếu các hoạt động thuộc về các nhóm Floodlight khác nhau), bạn nên đổi tên một trong các hoạt động.

  Ngoài ra, nếu biết mã nhận dạng mà Search Ads 360 đã chỉ định cho một hoạt động Floodlight, bạn có thể chỉ định mã nhận dạng đó trong segmentationId thay vì chỉ định tên trong trường segmentationName. (Campaign Manager cũng chỉ định mã nhận dạng cho hoạt động Floodlight, nhưng mã nhận dạng Campaign Manager khác với mã nhận dạng Search Ads 360 và không thể dùng để phân bổ lượt chuyển đổi.) Để xem mã Search Ads 360 cho một hoạt động Floodlight, hãy tải báo cáo lượt chuyển đổi xuống (từ giao diện người dùng Search Ads 360 hoặc API báo cáo). Nếu ít nhất một lượt chuyển đổi đã được phân bổ cho hoạt động Floodlight trong khung thời gian của báo cáo, thì bạn sẽ thấy mã nhận dạng Search Ads 360 trong báo cáo.

• type: Loại chuyển đổi, tức là ACTION hoặc TRANSACTION. Lượt chuyển đổi ACTION không có giá trị bằng tiền, còn lượt chuyển đổi TRANSACTION thì có. Ví dụ: lượt đăng ký danh sách email (HÀNH ĐỘNG) so với lượt mua hàng thương mại điện tử (GIAO DỊCH).

  Nếu chỉ định TRANSACTION, bạn cũng cần chỉ định trường sau:

  • revenueMicros: Giá trị bằng tiền của lượt chuyển đổi.

Trường tuỳ chọn

• quantityMillis: Số lượng mặt hàng trong lượt chuyển đổi này. Ví dụ: số người đã đăng ký nhận bản tin qua email hoặc tổng số lượng mặt hàng đã bán. Nếu bạn không chỉ định trường này cho lượt chuyển đổi HÀNH ĐỘNG, Search Ads 360 sẽ tự động chèn giá trị 1000.
• currencyCode: Đơn vị tiền tệ của doanh thu của một giao dịch. Theo mặc định, doanh thu được giả định là bằng đơn vị tiền tệ của nhà quảng cáo. Nếu bạn chỉ định một đơn vị tiền tệ khác, thì Search Ads 360 sẽ quy đổi số tiền doanh thu đã chỉ định sang đơn vị tiền tệ của nhà quảng cáo. Tìm hiểu thêm
  Sử dụng định dạng bảng chữ cái ISO 4217 (3 ký tự) để chỉ định đơn vị tiền tệ.
  Chỉ áp dụng cho lượt chuyển đổi GIAO DỊCH.
• customMetric và customDimension: Tải dữ liệu bổ sung về một lượt chuyển đổi lên, chẳng hạn như quốc gia nơi mặt hàng đã mua được vận chuyển đến, mã sản phẩm hoặc thậm chí là thời lượng của một cuộc gọi điện thoại. Tìm hiểu thêm về cách tải dữ liệu lên cho các biến Floodlight tuỳ chỉnh.
• deviceType: Chỉ định loại thiết bị diễn ra lượt chuyển đổi. Hãy xem danh sách giá trị được chấp nhận cho trường này.

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"
  }]
}
          

  /**
   * 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());
    }
  }
            

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())

Chỉ phân bổ lượt chuyển đổi cho một từ khoá

Nếu mối quan tâm chính của bạn là phân bổ lượt chuyển đổi cho từ khoá và bạn không quan tâm đến việc phân bổ cho quảng cáo, thì bạn có thể bỏ qua hầu hết giá trị nhận dạng Search Ads 360 và chỉ chỉ định giá trị nhận dạng của từ khoá cùng với một vài trường khác:

Các trường bắt buộc

• criterionId: Đây là giá trị nhận dạng từ khoá. Bạn có thể lấy criterionId bằng cách thêm macro TrackerId vào URL trang đích. Để biết thông tin về cách lấy mã từ khoá, hãy xem phần Mã và lượt chuyển đổi trên Search Ads 360.
• conversionId: Đối với lượt chuyển đổi ngoại tuyến, nhà quảng cáo sẽ cung cấp mã này. Nhà quảng cáo có thể chỉ định bất kỳ mã nhận dạng nào có ý nghĩa đối với họ. Mỗi lượt chuyển đổi trong một yêu cầu phải chỉ định một mã nhận dạng duy nhất, đồng thời tổ hợp mã nhận dạng và dấu thời gian phải là duy nhất trong số tất cả lượt chuyển đổi của nhà quảng cáo. Đối với lượt chuyển đổi trực tuyến, Search Ads 360 sẽ sao chép dsConversionId hoặc floodlightOrderId vào tài sản này tuỳ thuộc vào hướng dẫn Floodlight của nhà quảng cáo.
• conversionTimestamp: Cho biết ngày và giờ xảy ra lượt chuyển đổi. Ví dụ: nếu lượt chuyển đổi diễn ra vào 11:53:22 sáng thứ Sáu, ngày 5 tháng 8 năm 2016 theo Giờ tiết kiệm ánh sáng ban ngày miền Đông (GMT – 4:00), hãy chỉ định dấu thời gian theo mili giây theo Thời gian bắt đầu của hệ thống: 1470412402000.
• segmentationType: Chỉ định loại hệ thống chuyển đổi mà bạn đang tải lượt chuyển đổi lên. Hiện tại, chúng tôi chỉ hỗ trợ lượt chuyển đổi Floodlight, vì vậy, trường này luôn bắt buộc phải chỉ định FLOODLIGHT.
• segmentationName: Tên của hoạt động Floodlight mà nhà quảng cáo đang sử dụng để báo cáo lượt chuyển đổi.

  Nếu nhà quảng cáo của bạn chứa các hoạt động có cùng tên (điều này có thể xảy ra nếu các hoạt động thuộc về các nhóm Floodlight khác nhau), bạn nên đổi tên một trong các hoạt động.

  Ngoài ra, nếu biết mã nhận dạng mà Search Ads 360 đã chỉ định cho một hoạt động Floodlight, bạn có thể chỉ định mã nhận dạng đó trong segmentationId thay vì chỉ định tên trong trường segmentationName. (Campaign Manager cũng chỉ định mã nhận dạng cho hoạt động Floodlight, nhưng mã nhận dạng Campaign Manager khác với mã nhận dạng Search Ads 360 và không thể dùng để phân bổ lượt chuyển đổi.) Để xem mã Search Ads 360 cho một hoạt động Floodlight, hãy tải báo cáo lượt chuyển đổi xuống (từ giao diện người dùng Search Ads 360 hoặc API báo cáo). Nếu ít nhất một lượt chuyển đổi đã được phân bổ cho hoạt động Floodlight trong khung thời gian của báo cáo, thì bạn sẽ thấy mã nhận dạng Search Ads 360 trong báo cáo.

• type: Loại chuyển đổi, tức là ACTION hoặc TRANSACTION. Lượt chuyển đổi ACTION không có giá trị bằng tiền, còn lượt chuyển đổi TRANSACTION thì có. Ví dụ: lượt đăng ký danh sách email (HÀNH ĐỘNG) so với lượt mua hàng thương mại điện tử (GIAO DỊCH).

  Nếu chỉ định TRANSACTION, bạn cũng cần chỉ định trường sau:

  • revenueMicros: Giá trị bằng tiền của lượt chuyển đổi.

Trường tuỳ chọn

• quantityMillis: Số lượng mặt hàng trong lượt chuyển đổi này. Ví dụ: số người đã đăng ký nhận bản tin qua email hoặc tổng số lượng mặt hàng đã bán. Nếu bạn không chỉ định trường này cho lượt chuyển đổi HÀNH ĐỘNG, Search Ads 360 sẽ tự động chèn giá trị 1000.
• currencyCode: Đơn vị tiền tệ của doanh thu của một giao dịch. Theo mặc định, doanh thu được giả định là bằng đơn vị tiền tệ của nhà quảng cáo. Nếu bạn chỉ định một đơn vị tiền tệ khác, thì Search Ads 360 sẽ quy đổi số tiền doanh thu đã chỉ định sang đơn vị tiền tệ của nhà quảng cáo. Tìm hiểu thêm
  Sử dụng định dạng bảng chữ cái ISO 4217 (3 ký tự) để chỉ định đơn vị tiền tệ.
  Chỉ áp dụng cho lượt chuyển đổi GIAO DỊCH.
• customMetric và customDimension: Tải dữ liệu bổ sung về một lượt chuyển đổi lên, chẳng hạn như quốc gia nơi mặt hàng đã mua được vận chuyển đến, mã sản phẩm hoặc thậm chí là thời lượng của một cuộc gọi điện thoại. Tìm hiểu thêm về cách tải dữ liệu lên cho các biến Floodlight tuỳ chỉnh.
• deviceType: Chỉ định loại thiết bị diễn ra lượt chuyển đổi. Hãy xem danh sách giá trị được chấp nhận cho trường này.

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"
  }]
}

  /**
   * 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;
  }        

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())

Ví dụ:

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"
  }]
}
          

lỗi requestValidation

Lỗi requestValidation cho biết các vấn đề về dữ liệu trong yêu cầu tải lượt chuyển đổi lên (ví dụ: lượt chuyển đổi đã được tải lên hoặc không tìm thấy clickId). Trong loại lỗi này, thông báo chi tiết chứa hai mục:

• Mã thập lục phân xác định loại lỗi. Bạn có thể sử dụng mã này trong tập lệnh của riêng mình để xác định lỗi.
• Nội dung mô tả lỗi xác thực.

Để biết thêm thông tin, hãy xem danh sách mã và nội dung mô tả mà Search Ads 360 có thể trả về cho các lỗi tải lượt chuyển đổi lên.

Các loại lỗi khác

Tất cả các loại lỗi khác (internalError, transactionFailed hoặc lateStageRequestError) cho biết có vấn đề nội bộ trong Search Ads 360.

Phản hồi lỗi

Nếu yêu cầu không thành công, hãy thử gửi lại toàn bộ lệnh gọi yêu cầu sau. Search Ads 360 sẽ báo cáo lỗi requestValidation cho mọi lượt chuyển đổi đã tải lên, nhưng sẽ cố gắng tải các lượt chuyển đổi còn lại lên.

Nếu bạn vẫn thấy lỗi sau khi gửi lại, hãy xem phần khắc phục sự cố để biết thông tin về cách tiếp tục.