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

Gọi phương thức Conversion.insert() để thêm một hoặc nhiều lượt chuyển đổi. Để phân bổ lượt chuyển đổi một cách chính xác, yêu cầu của bạn cần chỉ định tên của một hoạt động Floodlight mà nhà quảng cáo đang sử dụng để báo cáo lượt chuyển đổi ngoại tuyến, cùng với mã nhận dạng của từ khoá, quảng cáo và có thể là lượt nhấp dẫn đến lượt chuyển đổi. Để biết thông tin về cách lấy mã nhận dạng Search Ads 360, hãy xem bài viết Mã nhận dạng Search Ads 360 và Lượt chuyển đổi.

Bạn có thể tìm thấy thông tin về các quy định hạn chế đối với việc tải lượt chuyển đổi trong quá khứ lên trong trung tâm trợ giúp của Search Ads 360.

Nếu yêu cầu Conversion.insert() của bạn chỉ định nhiều lượt chuyển đổi, thì Search Ads 360 sẽ cố gắng tải từng lượt chuyển đổi lên theo cách tốt nhất có thể thay vì tải toàn bộ lô lên dưới dạng một giao dịch tất cả hoặc không có gì. Nếu không tải được một số lượt chuyển đổi trong một lô lên, thì những lượt chuyển đổi khác vẫn có thể tải lên thành công. Không tải lên được lượt chuyển đổi do yêu cầu không hợp lệ hoặc lỗi tạm thời về mạng hoặc hệ thống. Do đó, bạn nên đọc phản hồi cho mỗi lượt chuyển đổi được chèn để đảm bảo rằng quá trình tải lên diễn ra thành công.

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 là 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 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 Campaign Manager API để tạo một hoạt động. Bạn không thể 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à một phương pháp hay 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 một hoạt động Floodlight, người dùng Search Ads 360 sẽ đăng nhập vào Search Ads 360 và thay đổi chế độ cài đặt của hoạt động đó thành cho biết nguồn chính của lượt chuyển đổi 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 dùng để báo cáo lượt chuyển đổi ngoại tuyến. Chế độ cài đặt phải cho biết nguồn chuyển đổi chính là hoạt động ngoại tuyến. Hãy xem trung tâm trợ giúp của Search Ads 360 để biết hướng dẫn.

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

    Đảm bảo rằng mỗi lượt tải lên đều chứa những lượt chuyển đổi gần đây nhất. Trong một yêu cầu tải lên duy nhất, bạn có thể tải các mục không theo thứ tự thời gian. Tuy nhiên, chiến lược giá thầu có thể không xem xét được những lượt chuyển đổi cũ mà bạn tải lên sau 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ổ một lượt chuyển đổi cho một lượt truy cập cụ thể
  • Chỉ phân bổ một 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ặt hàng mà bạn đang phân bổ lượt chuyển đổi. Các mục 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ổ một lượt chuyển đổi.

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

Khi một 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 một 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ổ một 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ủa bạn:

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 trong nhật ký web của nhà quảng cáo hoặc liệt kê lượt chuyển đổi và 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 trên 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 giá trị nhận dạng 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ã nhận dạng lượt nhấp", hãy đợi 24 giờ rồi tải lượt chuyển đổi lên lại. 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, Search Ads 360 API 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 cung cấp mã nhận dạng 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 và 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ả các lượt chuyển đổi trong phạm vi 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 chỉ thị 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 xảy ra vào Thứ Sáu, ngày 5 tháng 8 năm 2016, lúc 11:53:22 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 tính bằng mili giây kể từ 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ỉ lượt chuyển đổi Floodlight được hỗ trợ, vì vậy, bạn luôn phải chỉ định FLOODLIGHT cho trường này.
  • 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 có các hoạt động trùng tên (trường hợp này có thể xảy ra nếu các hoạt động thuộc các nhóm Floodlight khác nhau), thì 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ột 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 có í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, bạn sẽ thấy mã Search Ads 360 trong báo cáo.

  • type: Loại lượt chuyển đổi, tức là ACTION hoặc TRANSACTION. Lượt chuyển đổi HÀNH ĐỘNG không có giá trị tiền tệ, trong khi lượt chuyển đổi GIAO DỊCH thì có. Ví dụ: lượt đăng ký vào danh sách email (HÀNH ĐỘNG) so với giao dịch 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ị tiền tệ 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, thì Search Ads 360 sẽ tự động chèn giá trị 1000.
  • currencyCode: Đơn vị tiền tệ của doanh thu từ một giao dịch. Theo mặc định, doanh thu được giả định là tính 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 thêm dữ liệu về một lượt chuyển đổi, chẳng hạn như quốc gia mà mặt hàng đã mua được vận chuyển đến, mã nhận dạng sản phẩm hoặc thậm chí là thời lượng của 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 các giá trị được chấp nhận cho trường này.

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

Chỉ phân bổ một 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 các 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 số 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ể nhận được 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 bài viết Mã Search Ads 360 và lượt chuyển đổi.
  • conversionId: Đối với lượt chuyển đổi ngoại tuyến, nhà quảng cáo cung cấp mã nhận dạng 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 và 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ả các lượt chuyển đổi trong phạm vi 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 chỉ thị 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 xảy ra vào Thứ Sáu, ngày 5 tháng 8 năm 2016, lúc 11:53:22 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 tính bằng mili giây kể từ 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ỉ lượt chuyển đổi Floodlight được hỗ trợ, vì vậy, bạn luôn phải chỉ định FLOODLIGHT cho trường này.
  • 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 có các hoạt động trùng tên (trường hợp này có thể xảy ra nếu các hoạt động thuộc các nhóm Floodlight khác nhau), thì 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ột 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 có í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, bạn sẽ thấy mã Search Ads 360 trong báo cáo.

  • type: Loại lượt chuyển đổi, tức là ACTION hoặc TRANSACTION. Lượt chuyển đổi HÀNH ĐỘNG không có giá trị tiền tệ, trong khi lượt chuyển đổi GIAO DỊCH thì có. Ví dụ: lượt đăng ký vào danh sách email (HÀNH ĐỘNG) so với giao dịch 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ị tiền tệ 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, thì Search Ads 360 sẽ tự động chèn giá trị 1000.
  • currencyCode: Đơn vị tiền tệ của doanh thu từ một giao dịch. Theo mặc định, doanh thu được giả định là tính 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 thêm dữ liệu về một lượt chuyển đổi, chẳng hạn như quốc gia mà mặt hàng đã mua được vận chuyển đến, mã nhận dạng sản phẩm hoặc thậm chí là thời lượng của 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 các giá trị được chấp nhận cho trường này.

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

Tải dữ liệu lên từ mô hình phân bổ của bên thứ ba

Mô hình phân bổ phân bổ giá trị đóng góp cho một lượt chuyển đổi trên tất cả hoạt động trong một đường dẫn chuyển đổi. Ví dụ: nếu người tiêu dùng nhấp vào một quảng cáo tìm kiếm có trả phí, một quảng cáo hiển thị và một quảng cáo tìm kiếm có trả phí khác trước khi chuyển đổi, thì mô hình phân bổ tuyến tính sẽ phân bổ 33% giá trị đóng góp cho lượt chuyển đổi cho mỗi lượt nhấp.

Mặc dù Search Ads 360 cung cấp các mô hình phân bổ, nhưng nếu sử dụng dịch vụ của bên thứ ba hoặc dịch vụ mà bạn đã phát triển để phân bổ giá trị đóng góp cho các lượt nhấp, bạn có thể tải dữ liệu phân bổ của bên thứ ba lên Search Ads 360 và sử dụng dữ liệu đó trong báo cáo cũng như chiến lược giá thầu của Search Ads 360.

Trước khi bắt đầu

Trong Campaign Manager, hãy tạo một mô hình phân bổ tuỳ chỉnh rồi nhập mô hình đó vào Search Ads 360. Hãy nhớ đặt tên cho mô hình là Mô hình phân bổ bên ngoài. Điều này cho phép các tính năng của Search Ads 360 nhận ra rằng một mô hình phân bổ đã được áp dụng cho dữ liệu lượt chuyển đổi mà bạn tải lên. Tìm hiểu thêm

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

Để áp dụng mô hình phân bổ của bên thứ ba cho một lượt chuyển đổi, hãy chỉ định tất cả các thông tin sau trong yêu cầu Conversion.insert() của bạn:

  • 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 trong nhật ký web của nhà quảng cáo hoặc liệt kê lượt chuyển đổi và 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 trên Search Ads 360 chịu trách nhiệm tạo ra lượt truy cập.
    Chờ ít nhất 30 phút sau khi Search Ads 360 tạo giá trị nhận dạng lượt nhấp trước khi tải lượt chuyển đổi lên bằng giá trị nhận dạng đó. Nếu không, Search Ads 360 API có thể không nhận ra lượt truy cập.
  • attributionModel: Đặt thành Mô hình phân bổ bên ngoài. Tìm hiểu thêm
  • countMillis: Số tiền giá trị đóng góp cho lượt chuyển đổi cần phân phối cho lượt nhấp này. Chỉ áp dụng nếu yêu cầu cũng bao gồm trường attributionModel.

    Đừng nhầm lẫn tham số này với quantityMillis, một trường không bắt buộc chỉ định số lượng mặt hàng trong một lượt chuyển đổi (chẳng hạn như số lượng mặt hàng trong giao dịch mua giỏ hàng).

  • conversionId: Đối với lượt chuyển đổi ngoại tuyến, nhà quảng cáo cung cấp mã nhận dạng 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 và 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ả các lượt chuyển đổi trong phạm vi 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 chỉ thị 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 xảy ra vào Thứ Sáu, ngày 5 tháng 8 năm 2016, lúc 11:53:22 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 tính bằng mili giây kể từ 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ỉ lượt chuyển đổi Floodlight được hỗ trợ, vì vậy, bạn luôn phải chỉ định FLOODLIGHT cho trường này.
  • 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 có các hoạt động trùng tên (trường hợp này có thể xảy ra nếu các hoạt động thuộc các nhóm Floodlight khác nhau), thì 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ột 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 có í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, bạn sẽ thấy mã Search Ads 360 trong báo cáo.

  • type: Loại lượt chuyển đổi, tức là ACTION hoặc TRANSACTION. Lượt chuyển đổi HÀNH ĐỘNG không có giá trị tiền tệ, trong khi lượt chuyển đổi GIAO DỊCH thì có. Ví dụ: lượt đăng ký vào danh sách email (HÀNH ĐỘNG) so với giao dịch 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ị tiền tệ của lượt chuyển đổi.

Nếu bạn theo dõi doanh thu từ lượt chuyển đổi, hãy đảm bảo rằng mô hình của bạn phân bổ doanh thu cho từng điểm tiếp xúc trong một lộ trình chuyển đổi. Ví dụ: nếu mô hình của bạn sử dụng phương pháp tuyến tính (phân phối doanh thu đồng đều trên mỗi điểm tiếp xúc), trong một lộ trình chuyển đổi bao gồm 3 lượt nhấp vào quảng cáo, mỗi lượt nhấp sẽ được phân bổ 33% lượt chuyển đổi. Nếu lượt chuyển đổi mang lại doanh thu 1.000.000 VND, hãy đảm bảo mô hình của bạn phân bổ 330.000 VND doanh thu cho mỗi lượt nhấp và đảm bảo revenueMicros chỉ định 330.000 VND doanh thu cho mỗi lượt nhấp.

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, thì Search Ads 360 sẽ tự động chèn giá trị 1000.
  • currencyCode: Đơn vị tiền tệ của doanh thu từ một giao dịch. Theo mặc định, doanh thu được giả định là tính 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 thêm dữ liệu về một lượt chuyển đổi, chẳng hạn như quốc gia mà mặt hàng đã mua được vận chuyển đến, mã nhận dạng sản phẩm hoặc thậm chí là thời lượng của 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 các giá trị được chấp nhận cho trường này.

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

Xử lý các phản hồi của Search Ads 360

Phản hồi từ Search Ads 360 chỉ cho biết thành công nếu tất cả lượt chuyển đổi trong yêu cầu đều được xác thực và tải lên thành công.

Nếu yêu cầu thành công

Nếu yêu cầu thành công, phản hồi sẽ bao gồm toàn bộ thông tin nội bộ của Search Ads 360 cho mỗi lượt chuyển đổi được tải lên, chẳng hạn như mã chiến dịch, mã nhóm quảng cáo và mã từ khoá (tiêu chí).

{
 "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"
  },
  ...
 ]
}

Nếu yêu cầu không thành công

Nếu một hoặc nhiều lượt chuyển đổi không xác thực hoặc tải lên được, thì phản hồi sẽ bao gồm thông báo cho từng lượt chuyển đổi không tải lên được. Phản hồi không chứa thông báo về những lượt chuyển đổi đã tải lên thành công.

Sau đây là ví dụ về phản hồi cho một yêu cầu không thành công hoàn toàn:

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

Mỗi thông báo lỗi chứa hai trường quan trọng: lý do và thông báo lỗi chi tiết. Trường lý do có thể chứa requestValidation, internalError, transactionFailed hoặc lateStageRequestError.

requestValidation errors

Lỗi requestValidation cho biết 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 tin chi tiết về thông báo chứa 2 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ả về 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 đã được 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ến hành.