Liên kết mã nhận dạng cho Search Ads 360 mới

API Báo cáo Search Ads 360 mới hiện đã ra mắt. API mới mang đến cho bạn khả năng linh hoạt hơn nữa trong việc xây dựng các báo cáo tuỳ chỉnh và tích hợp dữ liệu vào các ứng dụng và quy trình báo cáo. Tìm hiểu thêm về việc di chuyển sang và sử dụng API Báo cáo Search Ads 360 mới.

Các thực thể trong Search Ads 360 mới có không gian mã nhận dạng khác với Search Ads 360 cũ. Để nhận bản đồ ánh xạ mã nhận dạng giữa Search Ads 360 cũ và mới, hãy gửi yêu cầu Reports.getIdMappingFile(). Nội dung phản hồi bao gồm các mối liên kết mã nhận dạng cho hầu hết các thực thể của một nhà quảng cáo cụ thể. Hãy xem phần Các lý do phổ biến khiến thực thể bị thiếu để tìm hiểu thêm về lý do một thực thể có thể bị bỏ qua khỏi tệp ánh xạ.

Dưới đây là ví dụ về tệp được trả về (định dạng CSV được mã hoá bằng UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

Tệp CSV có 3 cột:

  • Entity Type: loại thực thể của hàng này.

  • Legacy IDs: chuỗi JSON của đường dẫn thực thể đầy đủ trong Search Ads 360 cũ

  • New IDs: chuỗi JSON của đường dẫn thực thể đầy đủ trong Search Ads 360 mới

Bảng dưới đây cho thấy danh sách các thực thể được hỗ trợ và mối liên kết mã nhận dạng mẫu:

Kiểu pháp nhân Mô tả Mã nhận dạng cũ Mã nhận dạng mới
KHÁCH HÀNG Ánh xạ mã nhận dạng cho: Bạn không thể liên kết cho người quản lý và đại lý. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
CHIẾN DỊCH Liên kết mã nhận dạng cho chiến dịch. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Liên kết mã nhận dạng cho adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
TIÊU CHÍ Liên kết mã nhận dạng cho tiêu chí ở cấp nhóm quảng cáo: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD (Andorra) Liên kết mã nhận dạng cho quảng cáo. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Liên kết mã nhận dạng cho tiêu chí ở cấp chiến dịch: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Ánh xạ mã nhận dạng cho nhóm chiến dịch. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Liên kết mã cho mục tiêu hiệu suất của nhóm chiến dịch. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Liên kết mã nhận dạng cho Bảng nguồn cấp dữ liệu. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Liên kết mã nhận dạng cho feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Lý do thường gặp khiến thực thể bị thiếu

Mặc dù tệp ánh xạ của nhà quảng cáo sẽ chứa hầu hết các thực thể của họ, nhưng vẫn có một số trường hợp thực thể sẽ bị thiếu. Dưới đây là một số lý do phổ biến nhất:

  • Mỗi tệp ánh xạ được cập nhật 3 ngày một lần. Nếu tệp ánh xạ được tải xuống ngay sau khi tạo một thực thể mới, thì thực thể đó có thể sẽ không có trong tệp ánh xạ. Thông tin này có thể được thêm vào sau khi chờ tối đa 3 ngày.
  • Tài khoản mà thực thể thuộc về sẽ bị xoá. Chúng tôi không hỗ trợ việc liên kết mã nhận dạng trong trường hợp này.
  • Nội dung cập nhật trong một thực thể (ví dụ: Chiến dịch) ở phía công cụ không được hỗ trợ trong Search Ads 360 mới. Chúng tôi đã xử lý các nội dung cập nhật bằng cách tạo một thực thể Search Ads 360 mới, trong đó có nội dung cập nhật và việc xoá thực thể Search Ads 360 cũ sau đó.
  • Có thể các mối liên kết trước đó đã bị xoá do quá trình đồng bộ hoá giữa Search Ads 360 cũ và mới, trong đó chỉ giữ lại mối liên kết mới nhất. Nhiều mối liên kết giữa một mã cũ và nhiều mã Search Ads 360 mới sẽ được phân giải, giữ lại mối liên kết có dấu thời gian mới nhất.
  • Tài khoản công cụ không được đồng bộ hoá do lỗi đồng bộ hoá giữa Search Ads 360 cũ và mới.
  • Tài khoản bị xoá hoặc bị vô hiệu hoá.

Tải báo cáo xuống

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

Tính duy nhất của mã đối tượng

Mỗi đối tượng trong Search Ads 360 mới được xác định bằng mã nhận dạng riêng. Một số mã nhận dạng này là duy nhất ở cấp toàn cầu trên tất cả tài khoản trong Search Ads 360 mới, trong khi một số khác chỉ là duy nhất trong một phạm vi giới hạn. Ví dụ: bạn phải sử dụng cả nhóm quảng cáo và mã nhận dạng quảng cáo để xác định riêng từng quảng cáo, vì mã nhận dạng quảng cáo được chỉ định riêng cho mỗi nhóm quảng cáo, chứ không phải cho nhiều nhóm quảng cáo. Dưới đây là danh sách các mã nhận dạng đối tượng riêng biệt trong Search Ads 360 mới. Các quy tắc mã nhận dạng này có thể hữu ích khi thiết kế bộ nhớ cục bộ cho các đối tượng Search Ads 360 mới.

Mã đối tượng Phạm vi của tính duy nhất Duy nhất trên toàn cầu?
ID ngân sách Toàn cầu Có
Mã chiến dịch Toàn cầu Có
ID Nhóm Quảng cáo Toàn cầu Có
ID Quảng cáo Nhóm quảng cáo Không. Cặp (AdGroupId, AdId) là duy nhất trên toàn cầu.
Mã AdGroupCriterion Nhóm quảng cáo Không. Cặp (AdGroupId, CriterionId) là duy nhất trên toàn cầu.
Mã CampaignCriterion Chiến dịch Không. Cặp (CampaignId, CriterionId) là duy nhất trên toàn cầu.
Phần mở rộng quảng cáo Chiến dịch Không. Cặp (CampaignId, AdExtensionId) là duy nhất trên toàn cầu.
ID nguồn cấp dữ liệu Toàn cầu Có
Mã mặt hàng trong nguồn cấp dữ liệu Toàn cầu Có
Mã thuộc tính nguồn cấp dữ liệu Nguồn cấp dữ liệu Không
Mã ánh xạ nguồn cấp dữ liệu Toàn cầu Có
ID nhãn Toàn cầu Có
Mã danh sách người dùng Toàn cầu Có