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ổ đúng cách lượt chuyển đổi, yêu cầu của bạn cần chỉ định 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 ngoại tuyến, cùng với mã 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 và lượt chuyển đổi Search Ads 360.

Bạn có thể xem thông tin về các quy định hạn chế đối với việc tải lượt chuyển đổi trước đây 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 hết sức để tải từng lượt chuyển đổi lên thay vì tải toàn bộ lô lên dưới dạng một giao dịch hoàn toàn hoặc không có gì. Nếu một số lượt chuyển đổi trong một lô không tải lên được, thì những lượt chuyển đổi khác có thể vẫn tải lên thành công. Bạn có thể không tải được lượt chuyển đổi lên do một yêu cầu không hợp lệ hoặc do lỗi hệ thống/mạng tạm thời. Do đó, bạn nên đọc phản hồi cho mọi lượt chuyển đổi được chèn để đảm bảo tải lên 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 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 Epoch (còn gọi là thời gian Unix).

Tôi có thể tạo hoạt động Floodlight qua 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 một hoạt động. Bạn không thể sử dụng API này để chỉ định rằng một hoạt động Floodlight được sử dụng chủ yếu 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.

Sau khi bạn 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 đó để cho biết rằng 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. Hãy 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 này phải cho biết rằng nguồn chính của lượt chuyển đổi là hoạt động ngoại tuyến. Hãy truy cập vào trung tâm trợ giúp của Search Ads 360 để được hướng dẫn.

  2. Tải lượt chuyển đổi lên ngay khi có dữ liệu. Nếu bạn đang phân bổ lượt chuyển đổi cho những lượt truy cập cụ thể, hãy đợi ít nhất 30 phút 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 ra mã lượt nhấp của lượt truy cập nếu bạn tải dữ liệu lên trước khi lượt truy cập đó quá 30 phút. Trong một số ít trường hợp, bạn có thể phải đợi đến 4 giờ thì Search Ads 360 mới nhận ra được clickId.

    Đảm bảo rằng mỗi video tải lên đều chứa lượt chuyển đổi gần đây nhất. Trong một yêu cầu tải lên, nếu các mục không theo thứ tự thời gian thì vẫn được chấp nhận. 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 đó trong một yêu cầu khác.

  3. Nếu bạn đợi hơn 24 giờ trước khi tải lượt chuyển đổi lên cho một hoạt động Floodlight, hãy gửi dấu thời gian có thể truy cập.

    Dấu thời gian phát sóng phải là một trong những dấu thời gian sau:

    • Nếu bạn đã ghi lại lượt chuyển đổi trong 24 giờ qua nhưng chưa tải lượt chuyển đổi đó lên, thì dấu thời gian phải là thời điểm xảy ra lượt chuyển đổi được tải lên gần đây nhất. Tính năng này giúp Search Ads 360 biết rằng lượt chuyển đổi có thể đã xảy ra trong 24 giờ qua, nhưng bạn chưa cung cấp dữ liệu. Chiến lược giá thầu và các hệ thống tự động khác sẽ chỉ xem xét hiệu suất trước đây cho đến lượt chuyển đổi gần đây nhất mà bạn tải lên.
    • Nếu không có lượt chuyển đổi nào xảy ra trong 24 giờ qua, thì dấu thời gian phải là ngày và giờ hiện tại. Tính năng này giúp Search Ads 360 biết rằng không có lượt chuyển đổi nào xảy ra trong 24 giờ qua. Các chiến lược giá thầu và các hệ thống tự động khác sẽ ghi nhận nhật ký hiệu suất trong 24 giờ qua (tức là cả ngày không có lượt chuyển đổi).

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 bạn đang phân bổ lượt chuyển đổi. Các phần sau liệt kê các trường bắt buộc và không bắt buộc cho mỗi sự kiện hoặc mặt hàng 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 một khách hàng nhấp vào một hoặc nhiều quảng cáo và truy cập vào trang web của một nhà quảng cáo, Search Ads 360 sẽ coi phiên hoạt động của 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 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 liệt kê lượt chuyển đổi trong nhật ký web của nhà quảng cáo và sử dụng mã lượt nhấp của 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 của 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 để tải lượt chuyển đổi lên. Nếu bạn gặp lỗi "Không tìm thấy mã lượt nhấp", hãy đợi 4 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, 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 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, 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 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ờ diễn ra lượt chuyển đổi. Ví dụ: nếu lượt chuyển đổi xảy ra vào 11:53:22 SA, thứ Sáu, ngày 5 tháng 8 năm 2016 theo Giờ mùa hè miền Đông (GMT -4:00), hãy chỉ định dấu thời gian theo thời gian bắt đầu của hệ thống (mili giây): 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), 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 đã gán 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ã này khác với mã trên Search Ads 360 và không thể dùng mã này để phân bổ lượt chuyển đổi.) Để xem mã Search Ads 360 của một hoạt động Floodlight, hãy tải một báo cáo lượt chuyển đổi xuống (trên 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ã Search Ads 360 trong báo cáo.

  • type: Loại chuyển đổi, nghĩa là ACTION hoặc TRANSACTION. Lượt chuyển đổi ACTION không có giá trị tiền tệ, trong khi lượt chuyển đổi TRANSACTION có giá trị tiền tệ. Ví dụ: lượt đăng ký danh sách email (ACTION) so với giao dịch mua hàng thương mại điện tử (TRANSACTION).

    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 không bắt buộc

  • quantityMillis: Số mục 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 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 doanh thu đã chỉ định sang đơn vị tiền tệ của nhà quảng cáo. Tìm hiểu thêm
    Hãy 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 các lượt chuyển đổi TRANSACTION.
  • customMetric và customDimension: Tải lên dữ liệu bổ sung về lượt chuyển đổi, chẳng hạn như quốc gia vận chuyển mặt hàng đã mua, 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 biến Floodlight tuỳ chỉnh.
  • deviceType: Chỉ định loại thiết bị diễn ra lượt chuyển đổi. 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ổ lượt chuyển đổi cho một từ khoá

Nếu bạn quan tâm chính đến việc phân bổ lượt chuyển đổi cho từ khoá (và không quan tâm đến việc phân bổ cho quảng cáo), bạn có thể bỏ qua hầu hết các giá trị nhận dạng trên 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 bài viết Mã nhận dạng và lượt chuyển đổi trong Search Ads 360.
  • conversionId: Đối với lượt chuyển đổi ngoại tuyến, nhà quảng cáo 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, 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 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ờ diễn ra lượt chuyển đổi. Ví dụ: nếu lượt chuyển đổi xảy ra vào 11:53:22 SA, thứ Sáu, ngày 5 tháng 8 năm 2016 theo Giờ mùa hè miền Đông (GMT -4:00), hãy chỉ định dấu thời gian theo thời gian bắt đầu của hệ thống (mili giây): 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), 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 đã gán 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ã này khác với mã trên Search Ads 360 và không thể dùng mã này để phân bổ lượt chuyển đổi.) Để xem mã Search Ads 360 của một hoạt động Floodlight, hãy tải một báo cáo lượt chuyển đổi xuống (trên 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ã Search Ads 360 trong báo cáo.

  • type: Loại chuyển đổi, nghĩa là ACTION hoặc TRANSACTION. Lượt chuyển đổi ACTION không có giá trị tiền tệ, trong khi lượt chuyển đổi TRANSACTION có giá trị tiền tệ. Ví dụ: lượt đăng ký danh sách email (ACTION) so với giao dịch mua hàng thương mại điện tử (TRANSACTION).

    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 không bắt buộc

  • quantityMillis: Số mục 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 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 doanh thu đã chỉ định sang đơn vị tiền tệ của nhà quảng cáo. Tìm hiểu thêm
    Hãy 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 các lượt chuyển đổi TRANSACTION.
  • customMetric và customDimension: Tải lên dữ liệu bổ sung về lượt chuyển đổi, chẳng hạn như quốc gia vận chuyển mặt hàng đã mua, 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 biến Floodlight tuỳ chỉnh.
  • deviceType: Chỉ định loại thiết bị diễn ra lượt chuyển đổi. 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ổ sẽ phân bổ giá trị đóng góp cho một lượt chuyển đổi trên toàn bộ hoạt động trong một lộ trình 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í, 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 bạn sử dụng một dịch vụ của bên thứ ba hoặc một 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, thì 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 các 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 và 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 giú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 hoặc liệt kê lượt chuyển đổi trong nhật ký web của nhà quảng cáo và sử dụng mã lượt nhấp của 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 của 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 mã lượt nhấp rồi mới tải lượt chuyển đổi có mã này lên. Nếu không, API Search Ads 360 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 sẽ được phân bổ 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 mã 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 một lượt mua hàng trong 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ã 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 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ờ diễn ra lượt chuyển đổi. Ví dụ: nếu lượt chuyển đổi xảy ra vào 11:53:22 SA, thứ Sáu, ngày 5 tháng 8 năm 2016 theo Giờ mùa hè miền Đông (GMT -4:00), hãy chỉ định dấu thời gian theo thời gian bắt đầu của hệ thống (mili giây): 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), 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 đã gán 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ã này khác với mã trên Search Ads 360 và không thể dùng mã này để phân bổ lượt chuyển đổi.) Để xem mã Search Ads 360 của một hoạt động Floodlight, hãy tải một báo cáo lượt chuyển đổi xuống (trên 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ã Search Ads 360 trong báo cáo.

  • type: Loại chuyển đổi, nghĩa là ACTION hoặc TRANSACTION. Lượt chuyển đổi ACTION không có giá trị tiền tệ, trong khi lượt chuyển đổi TRANSACTION có giá trị tiền tệ. Ví dụ: lượt đăng ký danh sách email (ACTION) so với giao dịch mua hàng thương mại điện tử (TRANSACTION).

    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.

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

Trường không bắt buộc

  • quantityMillis: Số mục 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 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 doanh thu đã chỉ định sang đơn vị tiền tệ của nhà quảng cáo. Tìm hiểu thêm
    Hãy 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 các lượt chuyển đổi TRANSACTION.
  • customMetric và customDimension: Tải lên dữ liệu bổ sung về lượt chuyển đổi, chẳng hạn như quốc gia vận chuyển mặt hàng đã mua, 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 biến Floodlight tuỳ chỉnh.
  • deviceType: Chỉ định loại thiết bị diễn ra lượt chuyển đổi. 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ý phản hồi của Search Ads 360

Phản hồi của Search Ads 360 chỉ cho biết thành công nếu tất cả các lượt chuyển đổi trong yêu cầ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, thì phản hồi sẽ bao gồm bản trình bày nội bộ đầy đủ của Search Ads 360 cho từng 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 mỗi lượt tải lượt chuyển đổi không thành công lên. Phản hồi không chứa thông báo về những lượt chuyển đổi đã được tải lên thành công.

Dưới đây là phản hồi mẫu cho một yêu cầu không hoàn toàn thành công:

{
 "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 late StageRequestError.

lỗi requestValidation

Các 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 báo details (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ã 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ề khi 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 late dựng dựngError) đều cho biết rằng có một 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 gặp 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.