Trải nghiệm

Search Ads 360 mới chỉ định các mã nhận dạng mới cho tài khoản người dùng, chiến dịch, nhóm quảng cáo, từ khoá (tiêu chí) và quảng cáo. Có hai thay đổi khác về hành vi đối với các mã nhận dạng này:

  • Search Ads 360 mới chỉ định một mã khách hàng duy nhất trên toàn cầu cho tài khoản người quản lý, tài khoản người quản lý phụ và tài khoản khách hàng (trước đây gọi là công ty quảng cáo, nhà quảng cáo và tài khoản công cụ) tương ứng.

  • Search Ads 360 mới không còn gán mã nhận dạng duy nhất cho từ khoá và quảng cáo nữa.

API chuyển đổi hiện chấp nhận các mã khách hàng Search Ads 360 mới đối với những mã công ty quảng cáo, mã nhận dạng nhà quảng cáo và mã tài khoản công cụ được chấp nhận. Nếu bạn chỉ định API khách hàng thì API sẽ yêu cầu mã chiến dịch, mã nhóm quảng cáo, mã từ khoá và mã quảng cáo là mã nhận dạng mới trên Search Ads 360. Khi sử dụng mã từ khoá hoặc mã quảng cáo trên Search Ads 360 mới, bạn phải chỉ định mã chiến dịch và mã nhóm quảng cáo được liên kết bất cứ khi nào yêu cầu của bạn sử dụng mã từ khoá hoặc mã quảng cáo.

Khi bạn sử dụng mã nhận dạng Search Ads 360 mới trong yêu cầu, nội dung phản hồi cũng sẽ sử dụng mã nhận dạng Search Ads 360 mới.

Liệt kê lượt chuyển đổi

Có một điểm cuối mới cho yêu cầu danh sách bằng mã nhận dạng trong Search Ads 360 mới. Bạn cần cung cấp mã khách hàng của tài khoản khách hàng. Ngoài ra, bạn vẫn có thể chỉ định mã chiến dịch và mã nhóm quảng cáo để liệt kê trong tham số truy vấn. Ngoài ra, endDate, rowCount, startDatestartRow vẫn là bắt buộc.

Yêu cầu HTTP

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

Chèn/cập nhật lượt chuyển đổi

Chúng tôi hỗ trợ yêu cầu sau đây bằng mã nhận dạng trong Search Ads 360 mới:

  • Phân bổ lượt chuyển đổi cho từ khoá và quảng cáo
  • Chỉ quy lượt chuyển đổi cho từ khoá
  • Cập nhật lượt chuyển đổi bằng criterionId (mã từ khoá) đã chỉ định của lượt chuyển đổi đó

Các điểm cuối vẫn giữ nguyên. Bạn nên cung cấp mã Search Ads 360 mới trong mỗi tài nguyên chuyển đổi: Thay vì đặt agencyId, advertiserIdengineAccountId, bạn nên cung cấp customerId và sử dụng mã nhận dạng Search Ads 360 mới trong campaignId, adGroupId, criterionId, adId khi cần.

Dưới đây là yêu cầu mẫu về cách sử dụng mã nhận dạng trong Search Ads 360 mới để phân bổ lượt chuyển đổi cho một từ khoá.

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}
    

Chỉ định tình trạng hoạt động

Bạn cũng có thể sử dụng mã nhận dạng Search Ads 360 mới trong phương thức Conversion.updateAvailability() . Bạn phải sử dụng mã khách hàng của người quản lý phụ. Dưới đây là ví dụ:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}