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, 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, 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ể hãy dùng API Campaign Manager để tạo một tài khoản. Bạn không thể sử dụng API để chỉ định hoạt động Floodlight chủ yếu được dùng cho lượt chuyển đổi ngoại tuyến. Đây là cách tốt nhất khi nào 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 Floodlight hoạt động, một người dùng Search Ads 360 đăng nhập vào Search Ads 360 và thay đổi thành 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. Yêu cầu người dùng Search Ads 360 đăng nhập vào Search Ads 360 và thay đổi các 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 sẽ cho biết rằng nguồn chính của lượt chuyển đổi là hoạt động ngoại tuyến. Xem 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 là phân bổ lượt chuyển đổi cho các lượt truy cập cụ thể, hãy đợi ít nhất 30 phút sau lượt truy cập trước khi bạn 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 trước 30 phút kể từ khi truy cập. Trong một số ít trường hợp, có thể bạn cần phải hãy đợi đến 4 giờ trước khi Search Ads 360 nhận ra 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 thì có thể chấp nhận nếu các mục nhập không đúng thứ tự thời gian. Tuy nhiên, chiến lược giá thầu có thể không thể xem xét các lượt chuyển đổi cũ hơn mà bạn tải lên sau đó trong một yêu cầu khác.

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

   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 các lượt chuyển đổi trong 24 giờ qua nhưng chưa tải các lượt chuyển đổi đó lên chưa, dấu thời gian phải là thời điểm lượt chuyển đổi được tải lên gần đây nhất . Thao tác này cho 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 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. Điều này cho Search Ads 360 biết rằng không chuyển đổi đã xảy ra trong 24 giờ qua. Chiến lược giá thầu và các chiến lược tự động khác hệ thống sẽ bao gồm 24 giờ qua—một ngày không có chuyển đổi—như của nhật ký hiệu suất.

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 chỉ số bắt buộc và trường 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 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 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 Conversion.insert() yêu cầu:

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. Xem trong nhật ký web của nhà quảng cáo để biết mã lượt nhấp hoặc liệt kê lượt chuyển đổi 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 trong Search Ads 360 đã chịu trách nhiệm cho tạo lượt truy cập.
  Sau đó Chờ ít nhất 30 phút 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 thông báo "Không tìm thấy mã lượt nhấp" , hãy đợi 4 giờ, sau đó tải chuyển đổ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 sẽ đượ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 chuyển đổi trong yêu cầu phải chỉ định một ID 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 các 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 chuyển đổi đã xảy ra. Ví dụ: nếu chuyển đổi xảy ra vào Thứ Sáu, 05 Tháng 8 2016 11:53:22 AM Giờ mùa hè miền Đông (GMT -4:00), 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ên chuyển đổi. 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 là 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 các nhóm Floodlight khác nhau), thì bạn nên làm gì đổi tên một trong các hoạt động.

  Ngoài ra, nếu biết mã nhận dạng 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ã nhận dạng Campaign Manager khác với mã Search Ads 360 và không thể dùng mã này để phân bổ conversions.) Để xem mã Search Ads 360 của một hoạt động Floodlight, hãy tải một tệp báo cáo chuyển đổi (từ Giao diện người dùng của Search Ads 360 hoặc 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 khoảng thời gian 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 chuyển đổi, tức là ACTION hoặc TRANSACTION. Một lượt chuyển đổi ACTION không có giá trị tiền tệ, trong khi Lượt chuyển đổi TRANSACTION. Ví dụ: lượt đăng ký nhận email (ACTION) so với lượt đăng ký giao dịch mua hàng thương mại điện tử (TRANSACTION).

  Nếu bạn 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 tùy chọn (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 các lượt chuyển đổi HÀNH ĐỘNG, thì Search Ads 360 sẽ tự động chèn một giá trị của 1000.
• currencyCode: Đơn vị tiền tệ của doanh thu của một giao dịch. Theo mặc định, doanh thu là đượ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, Search Ads 360 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 bảng chữ cái ISO 4217 (3 ký tự) định dạng để chỉ định đơn vị tiền tệ.
  Chỉ áp dụng cho các chuyển đổi TRANSACTION.
• customMetric và customDimension: Tải lên dữ liệu bổ sung về một 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ề tải dữ liệu lên cho Biến Floodlight.
• deviceType: Chỉ định loại thiết bị diễn ra lượt chuyển đổi. Xem danh sách giá trị được chấp nhận cho thuộc tính 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 phải liên quan đến việc phân bổ quảng cáo – bạn có thể bỏ qua hầu hết 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ể nhận criterionId bằng cách thêm TrackerId vào URL trang đích của bạn. Để biết thông tin về cách nhận ID từ khóa, hãy xem Các mã nhận dạng 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ã 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 chuyển đổi trong yêu cầu phải chỉ định một ID 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 các 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 chuyển đổi đã xảy ra. Ví dụ: nếu chuyển đổi xảy ra vào Thứ Sáu, 05 Tháng 8 2016 11:53:22 AM Giờ mùa hè miền Đông (GMT -4:00), 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ên chuyển đổi. 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 là 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 các nhóm Floodlight khác nhau), thì bạn nên làm gì đổi tên một trong các hoạt động.

  Ngoài ra, nếu biết mã nhận dạng 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ã nhận dạng Campaign Manager khác với mã Search Ads 360 và không thể dùng mã này để phân bổ conversions.) Để xem mã Search Ads 360 của một hoạt động Floodlight, hãy tải một tệp báo cáo chuyển đổi (từ Giao diện người dùng của Search Ads 360 hoặc 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 khoảng thời gian 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 chuyển đổi, tức là ACTION hoặc TRANSACTION. Một lượt chuyển đổi ACTION không có giá trị tiền tệ, trong khi Lượt chuyển đổi TRANSACTION. Ví dụ: lượt đăng ký nhận email (ACTION) so với lượt đăng ký giao dịch mua hàng thương mại điện tử (TRANSACTION).

  Nếu bạn 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 tùy chọn (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 các lượt chuyển đổi HÀNH ĐỘNG, thì Search Ads 360 sẽ tự động chèn một giá trị của 1000.
• currencyCode: Đơn vị tiền tệ của doanh thu của một giao dịch. Theo mặc định, doanh thu là đượ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, Search Ads 360 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 bảng chữ cái ISO 4217 (3 ký tự) định dạng để chỉ định đơn vị tiền tệ.
  Chỉ áp dụng cho các chuyển đổi TRANSACTION.
• customMetric và customDimension: Tải lên dữ liệu bổ sung về một lượt chuyển đổi, chẳng hạn như quốc gia nơi bạn vận chuyển một 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ề tải dữ liệu lên cho Biến Floodlight.
• deviceType: Chỉ định loại thiết bị diễn ra lượt chuyển đổi. Xem danh sách giá trị được chấp nhận cho thuộc tính 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

Các lỗi requestValidation cho biết có vấn đề về dữ liệu trong tệp tải lượt chuyển đổi lên yêu cầu (ví dụ: lượt chuyển đổi đã được tải lên hoặc không tìm thấy clickId). Trong phần này loại lỗi, 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ể tự sử dụng mã này để 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 gặp 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 rằng có sự cố 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 hệ thố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 khắc phục sự cố để biết thông tin về cách xử lý.