新增轉換

如要新增一或多項轉換,請呼叫 Conversion.insert() 方法。為了正確歸因轉換,您的要求必須指明廣告客戶用於回報離線轉換的 Floodlight 活動名稱,以及關鍵字、廣告和帶來轉換的點擊 ID。想瞭解如何取得 Search Ads 360 ID,請參閱 Search Ads 360 ID 與轉換一文。

如要瞭解上傳歷來轉換資料的相關限制,請前往 Search Ads 360 說明中心

如果您的 Conversion.insert() 要求指定多次轉換,Search Ads 360 會盡可能上傳每個轉換資料,而不是將整個批次上傳為無限制交易。如果批次中的部分轉換資料無法上傳,其他轉換可能還是能成功上傳。轉換上傳作業可能會因為要求無效,或是網路或系統暫時故障而失敗。因此,建議您針對每項插入的轉換閱讀回應,以確保上傳成功。

資料上傳後要多久才能使用?

如果您為轉換指定的 conversionTimestamp 為今天或昨天,則在上傳後的 1 小時內,Search Ads 360 UI 中就會顯示轉換指標。如果您指定的 conversionTimestamp 早於昨天,指標會在幾小時內更新。

將所有轉換時間戳記轉換為 Epoch 時間 (也稱為 Unix 時間)。

可以透過 API 建立 Floodlight 活動嗎?

如果廣告客戶尚未建立用於追蹤離線轉換的 Floodlight 活動,您可以 使用 Campaign Manager API 建立活動。但無法透過 API 指定 Floodlight 活動主要用於離線轉換。當出價策略使用轉換資料時,建議您採取這種做法。

建議您在使用 API 建立 Floodlight 活動之後,讓 Search Ads 360 使用者登入 Search Ads 360,將活動的 設定變更為表示主要來源是離線活動

新增轉換的最佳做法

建議您採用以下最佳做法新增轉換:

  1. 要求 Search Ads 360 使用者登入 Search Ads 360,然後針對用於回報離線轉換的每個 Floodlight 活動變更相關設定。這類設定應能指出主要轉換來源為離線活動。操作說明請參閱 Search Ads 360 說明中心

  2. 盡快上傳可用的轉換資料。如果要 將轉換歸給特定造訪,請在該次造訪發生後等待至少 30 分鐘,然後再上傳轉換。如果您在造訪後的 30 分鐘內上傳完畢,Search Ads 360 可能會無法辨識該次造訪的 clickID。在極少數情況下,Search Ads 360 最多需要 4 小時才能辨識 clickId。

    確認每次上傳要求均包含最新的轉換資料。如果單次上傳要求中的資料沒有按照時間順序排列,並不會造成任何問題。不過,如果您後來在其他要求中上傳更早的資料,出價策略可能就無法處理。

  3. 如果您超過 24 小時才上傳 Floodlight 活動的轉換資料,請傳送可用性時間戳記

    可用性時間戳記應為下列其中一個值:

    • 如果您在過去 24 小時內記錄了轉換但尚未上傳,時間戳記應為上次上傳轉換發生的時間。這樣 Search Ads 360 就會知道過去 24 小時內可能有轉換,但您尚未提供相關資料。出價策略和其他自動化系統只考量到您最近一次上傳的轉換為止的成效記錄。
    • 如果過去 24 小時內沒有發生任何轉換,時間戳記應為目前的時間和日期。這樣 Search Ads 360 就會判斷過去 24 小時內沒有發生任何轉換。出價策略和其他自動化系統會將過去 24 小時 (無轉換的一天) 納入成效記錄中。

傳送插入要求

您可以傳送 Conversion.insert() 要求,執行下列任一操作:

  • 將轉換歸因於特定造訪
  • 只將轉換歸因於關鍵字

Conversion.insert() 要求中的必填欄位取決於您轉換歸因的事件或項目。以下各節針對能夠將轉換歸因至的每個事件或項目,列出必填和選填欄位。

將轉換歸因於特定造訪

當客戶點擊一或多則廣告進入廣告客戶的網站時,Search Ads 360 會將廣告客戶網站上的使用者工作階段視為一次造訪。如要將轉換歸因於某次造訪,請在 Conversion.insert() 要求中指定以下項目:

必填欄位

  • clickId:造訪會區分大小寫的點擊 ID。在廣告客戶的網頁記錄中查看點擊 ID 或列出轉換,然後使用其他轉換的點擊 ID。Search Ads 360 會將轉換歸因於負責產生造訪的關鍵字、廣告和其他 Search Ads 360 物件。
    Search Ads 360 產生點擊 ID 後,請等待至少 30 分鐘再上傳轉換資料。 如果您收到「找不到點擊 ID」錯誤訊息,請等待 4 小時後再重新上傳轉換。轉換必須在點擊 ID 產生後的 90 天內上傳。 否則 Search Ads 360 API 可能無法識別該次造訪。
  • conversionId:如果是離線轉換,廣告客戶請提供這個 ID。廣告客戶可以指定任何有意義的 ID。要求中的每筆轉換都必須指定一個專屬 ID,且該 ID 與時間戳記的組合在廣告客戶內的所有轉換中都不得重複。如果是線上轉換,Search Ads 360 會根據廣告客戶的 Floodlight 指示,將 dsConversionIdfloodlightOrderId 複製到這項資源中。
  • conversionTimestamp:表示轉換發生的日期和時間。舉例來說,如果轉換發生在 2016 年 8 月 5 日星期五上午 11:53:22 (格林威治標準時間 -4:00),請以 Epoch 紀元時間表示的時間戳記 (以 Epoch 時間計算的毫秒為單位):1470412402000
  • segmentationType:指定您要上傳轉換資料的目標轉換系統類型。目前系統僅支援 Floodlight 轉換,因此這個欄位 一律必須指定 FLOODLIGHT
  • segmentationName:廣告客戶用於回報轉換的 Floodlight 活動名稱。

    如果廣告客戶包含相同名稱的活動 (如果活動屬於不同的 Floodlight 群組,就可能會發生這種情況),建議您重新命名其中一個活動

    或者,如果您知道 Search Ads 360 指派給 Floodlight 活動的 ID,可以在 segmentationId 中指定這個 ID,而不是在 segmentationName 欄位中指定名稱。(Campaign Manager 也會將 ID 指派給 Floodlight 活動, 但 Campaign Manager ID 與 Search Ads 360 ID 不同,無法用於歸因轉換。)如要查看 Floodlight 活動的 Search Ads 360 ID,請透過 Search Ads 360 使用者介面Reporting API 下載轉換報表。如果報表時間範圍內有至少一個轉換歸因於 Floodlight 活動, 報表就會顯示 Search Ads 360 ID。

  • type:轉換類型,即 ACTIONTRANSACTION。ACTION 轉換沒有貨幣價值,而 TRANSACTION 轉換卻有。例如電子郵件名單註冊 (動作) 和電子商務購買 (交易)。

    如果指定 TRANSACTION,則還必須指定下列欄位:

    • revenueMicros:轉換的金額。

選填欄位

  • quantityMillis:該次轉換中的項目數量。例如訂閱電子報的使用者人數或售出商品總數。如果您未針對動作轉換指定這個欄位,Search Ads 360 會自動插入 1000 的值。
  • currencyCode:交易收益的貨幣。根據預設,系統會假設收益是以廣告主的幣別計算。如果您指定不同的貨幣,Search Ads 360 會將指定的收益金額轉換為廣告客戶的貨幣。 瞭解詳情
    請使用 ISO 4217 字母 (3 個字元) 格式指定貨幣。
    僅適用於 TRANSACTION 轉換。
  • customMetriccustomDimension:上傳轉換的其他資料,例如購買商品的運送國家/地區、產品 ID,甚至是通話時間長度。進一步瞭解如何上傳 Floodlight 自訂變數的資料
  • deviceType:指明轉換是在哪種裝置類型上發生,請參閱這個欄位的接受的值清單

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

只將轉換歸因於關鍵字

如果您主要的目標是將轉換歸因於關鍵字,而不擔心如何歸功於廣告,您可以略過大部分的 Search Ads 360 識別碼,只需指定關鍵字 ID 以及其他幾個欄位:

必填欄位

  • criterionId:這是關鍵字 ID。只要在到達網頁網址中加入 TrackerId 巨集,就能取得 criterionId。如要瞭解如何取得關鍵字 ID,請參閱 Search Ads 360 ID 和 轉換一文。
  • conversionId:如果是離線轉換,廣告客戶請提供這個 ID。廣告客戶可以指定任何有意義的 ID。要求中的每筆轉換都必須指定一個專屬 ID,且該 ID 與時間戳記的組合在廣告客戶內的所有轉換中都不得重複。如果是線上轉換,Search Ads 360 會根據廣告客戶的 Floodlight 指示,將 dsConversionIdfloodlightOrderId 複製到這項資源中。
  • conversionTimestamp:表示轉換發生的日期和時間。舉例來說,如果轉換發生在 2016 年 8 月 5 日星期五上午 11:53:22 (格林威治標準時間 -4:00),請以 Epoch 紀元時間表示的時間戳記 (以 Epoch 時間計算的毫秒為單位):1470412402000
  • segmentationType:指定您要上傳轉換資料的目標轉換系統類型。目前系統僅支援 Floodlight 轉換,因此這個欄位 一律必須指定 FLOODLIGHT
  • segmentationName:廣告客戶用於回報轉換的 Floodlight 活動名稱。

    如果廣告客戶包含相同名稱的活動 (如果活動屬於不同的 Floodlight 群組,就可能會發生這種情況),建議您重新命名其中一個活動

    或者,如果您知道 Search Ads 360 指派給 Floodlight 活動的 ID,可以在 segmentationId 中指定這個 ID,而不是在 segmentationName 欄位中指定名稱。(Campaign Manager 也會將 ID 指派給 Floodlight 活動, 但 Campaign Manager ID 與 Search Ads 360 ID 不同,無法用於歸因轉換。)如要查看 Floodlight 活動的 Search Ads 360 ID,請透過 Search Ads 360 使用者介面Reporting API 下載轉換報表。如果報表時間範圍內有至少一個轉換歸因於 Floodlight 活動, 報表就會顯示 Search Ads 360 ID。

  • type:轉換類型,即 ACTIONTRANSACTION。ACTION 轉換沒有貨幣價值,而 TRANSACTION 轉換卻有。例如電子郵件名單註冊 (動作) 和電子商務購買 (交易)。

    如果指定 TRANSACTION,則還必須指定下列欄位:

    • revenueMicros:轉換的金額。

選填欄位

  • quantityMillis:該次轉換中的項目數量。例如訂閱電子報的使用者人數或售出商品總數。如果您未針對動作轉換指定這個欄位,Search Ads 360 會自動插入 1000 的值。
  • currencyCode:交易收益的貨幣。根據預設,系統會假設收益是以廣告主的幣別計算。如果您指定不同的貨幣,Search Ads 360 會將指定的收益金額轉換為廣告客戶的貨幣。 瞭解詳情
    請使用 ISO 4217 字母 (3 個字元) 格式指定貨幣。
    僅適用於 TRANSACTION 轉換。
  • customMetriccustomDimension:上傳轉換的其他資料,例如購買商品的運送國家/地區、產品 ID,甚至是通話時間長度。進一步瞭解如何上傳 Floodlight 自訂變數的資料
  • deviceType:指明轉換是在哪種裝置類型上發生,請參閱這個欄位的接受的值清單

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

透過第三方歸因模式上傳資料

歸因模式可以分配轉換路徑中所有活動的轉換功勞。舉例來說,假設消費者在完成轉換前曾點擊付費搜尋廣告、多媒體廣告和另一則付費搜尋廣告,線性歸因模式會將 33% 的轉換功勞歸給每次點擊。

儘管 Search Ads 360 會提供歸因模式,如果您使用的是第三方服務,或者自行開發了將轉換功勞歸給點擊的服務,仍然可以將第三方歸因資料上傳到 Search Ads 360,讓報表和 Search Ads 360 出價策略使用這項資料。

事前準備

在 Campaign Manager 中建立自訂歸因模式,然後將該模式匯入 Search Ads 360。請務必將模式命名為「外部歸因模式」。 這樣 Search Ads 360 功能就能辨識歸因模式已套用至您上傳的轉換資料。瞭解詳情

必填欄位

如要將第三方歸因模式套用至轉換,請在 Conversion.insert() 要求中指定下列所有項目:

  • clickId:造訪會區分大小寫的點擊 ID。在廣告客戶的網頁記錄中查看點擊 ID 或列出轉換,然後使用其他轉換的點擊 ID。Search Ads 360 會將轉換歸因於負責產生造訪的關鍵字、廣告和其他 Search Ads 360 物件。
    請在 Search Ads 360 產生點擊 ID 後至少等待 30 分鐘,再上傳含有該 ID 的轉換資料。 否則 Search Ads 360 API 可能無法識別該次造訪。
  • attributionModel:設為「External Attribution Model」(外部歸因模式)瞭解詳情
  • countMillis:對這次點擊的影響的轉換功勞金額。 僅適用於要求也包含 attributionModel 欄位的情況。

    請勿將這項屬性與 quantityMillis 混淆,這是用來指定轉換中項目數量的選填欄位,例如購物車中的商品數量。

  • conversionId:如果是離線轉換,廣告客戶請提供這個 ID。廣告客戶可以指定任何有意義的 ID。要求中的每筆轉換都必須指定一個專屬 ID,且該 ID 與時間戳記的組合在廣告客戶內的所有轉換中都不得重複。如果是線上轉換,Search Ads 360 會根據廣告客戶的 Floodlight 指示,將 dsConversionIdfloodlightOrderId 複製到這項資源中。
  • conversionTimestamp:表示轉換發生的日期和時間。舉例來說,如果轉換發生在 2016 年 8 月 5 日星期五上午 11:53:22 (格林威治標準時間 -4:00),請以 Epoch 紀元時間表示的時間戳記 (以 Epoch 時間計算的毫秒為單位):1470412402000
  • segmentationType:指定您要上傳轉換資料的目標轉換系統類型。目前系統僅支援 Floodlight 轉換,因此這個欄位 一律必須指定 FLOODLIGHT
  • segmentationName:廣告客戶用於回報轉換的 Floodlight 活動名稱。

    如果廣告客戶包含相同名稱的活動 (如果活動屬於不同的 Floodlight 群組,就可能會發生這種情況),建議您重新命名其中一個活動

    或者,如果您知道 Search Ads 360 指派給 Floodlight 活動的 ID,可以在 segmentationId 中指定這個 ID,而不是在 segmentationName 欄位中指定名稱。(Campaign Manager 也會將 ID 指派給 Floodlight 活動, 但 Campaign Manager ID 與 Search Ads 360 ID 不同,無法用於歸因轉換。)如要查看 Floodlight 活動的 Search Ads 360 ID,請透過 Search Ads 360 使用者介面Reporting API 下載轉換報表。如果報表時間範圍內有至少一個轉換歸因於 Floodlight 活動, 報表就會顯示 Search Ads 360 ID。

  • type:轉換類型,即 ACTIONTRANSACTION。ACTION 轉換沒有貨幣價值,而 TRANSACTION 轉換卻有。例如電子郵件名單註冊 (動作) 和電子商務購買 (交易)。

    如果指定 TRANSACTION,則還必須指定下列欄位:

    • revenueMicros:轉換的金額。

如果您有追蹤轉換收益,請務必讓模式將收益分配給轉換路徑中的每個接觸點。舉例來說,假設模式採用線性方法 (將收益平均分配給每個接觸點),那麼在包含 3 次廣告點擊的轉換路徑中,每次點擊都會分配到 33% 的轉換。如果轉換獲得了 $100 美元的收益,請確認模式會將 $33 美元的收益分配給每次點擊,並確保 revenueMicros 會針對每次點擊指定 $33 美元的收益。

選填欄位

  • quantityMillis:該次轉換中的項目數量。例如訂閱電子報的使用者人數或售出商品總數。如果您未針對動作轉換指定這個欄位,Search Ads 360 會自動插入 1000 的值。
  • currencyCode:交易收益的貨幣。根據預設,系統會假設收益是以廣告主的幣別計算。如果您指定不同的貨幣,Search Ads 360 會將指定的收益金額轉換為廣告客戶的貨幣。 瞭解詳情
    請使用 ISO 4217 字母 (3 個字元) 格式指定貨幣。
    僅適用於 TRANSACTION 轉換。
  • customMetriccustomDimension:上傳轉換的其他資料,例如購買商品的運送國家/地區、產品 ID,甚至是通話時間長度。進一步瞭解如何上傳 Floodlight 自訂變數的資料
  • deviceType:指明轉換是在哪種裝置類型上發生,請參閱這個欄位的接受的值清單

範例

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

處理 Search Ads 360 回應

Search Ads 360 的回應只有在要求中的所有轉換都已成功通過驗證並上傳時,才會成功。

如果要求成功

如果要求成功,回應會包含每個上傳轉換的完整 Search Ads 360 內部表示法,例如廣告活動 ID、廣告群組 ID 和關鍵字 (條件) ID。

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

如果要求失敗

如果一或多項轉換無法驗證或上傳,回應會包含每筆轉換上傳失敗的訊息。回應不會包含成功上傳轉換的相關訊息。

以下是回應未完全成功的要求範例:

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

每個失敗訊息都包含兩個重要欄位:原因和詳細錯誤訊息。原因欄位可以包含 requestValidationinternalErrortransactionFailedlateStageRequestError

requestValidation 錯誤

requestValidation 錯誤代表轉換上傳要求中的資料問題 (例如轉換已上傳,或是找不到 clickId)。在這類錯誤中,details 訊息包含兩個項目:

  • 識別錯誤類型的十六進位代碼。您可以在自己的指令碼中使用這段程式碼找出錯誤。
  • 驗證錯誤的說明。

詳情請參閱 Search Ads 360 針對轉換上傳錯誤傳回代碼和說明清單

其他錯誤類型

所有其他錯誤類型 (internalErrortransactionFailedlateStageRequestError) 會指出 Search Ads 360 發生內部問題。

回應錯誤

如果要求失敗,請稍後再重新提交整個要求呼叫。如果轉換成功,Search Ads 360 會回報 requestValidation 錯誤,但 會嘗試上傳剩餘的轉換。

如果您在重新提交後仍看到錯誤,請查看疑難排解一節以瞭解如何繼續。