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 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. Hãy 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ũ. Để liên kết mã nhận dạng giữa Search Ads 360 cũ và Search Ads 360 mới, hãy gửi một yêu cầu Reports.getIdMappingFile() . Phản hồi này bao gồm các liên kết mã nhận dạng cho tất cả các thực thể của một nhà quảng cáo được chỉ định.

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: một chuỗi JSON chứa đường dẫn thực thể đầy đủ trong Search Ads 360 cũ

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

Bảng bên dưới hiển thị danh sách các thực thể được hỗ trợ và ví dụ về mối liên kết mã nhận dạng:

Loại đối tượng Nội dung mô tả Mã cũ Mã nhận dạng mới
KHÁCH HÀNG Liên kết mã nhận dạng cho: 
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"
}
MỤC TIÊU Liên kết mã nhận dạng cho: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "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: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Liên kết 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ã nhận dạng cho mục tiêu hoạt động 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"
}

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 đều được xác định bằng mã riêng. Một số mã nhận dạng trong số này là duy nhất trên toàn cầu trong mọi tài khoản trong Search Ads 360 mới, trong khi một số mã khác chỉ là duy nhất trong một phạm vi nhất định. Ví dụ: bạn phải sử dụng cả nhóm quảng cáo và mã quảng cáo để xác định riêng quảng cáo, vì mã quảng cáo được chỉ định riêng cho mỗi nhóm quảng cáo, chứ không phải cho các nhóm quảng cáo. Dưới đây là danh sách điểm duy nhất của từng mã đối tượng 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 riêng biệt Là duy nhất trên toàn cầu?
ID ngân sách Các khu vực nói tiếng Anh Có
Mã chiến dịch Các khu vực nói tiếng Anh Có
ID Nhóm Quảng cáo Các khu vực nói tiếng Anh 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 hệ thống.
ID tiêu chí của nhóm quảng cáo Nhóm Quảng cáo Không. Cặp (AdGroupId, CriterionId) là duy nhất trên toàn hệ thống.
ID tiêu chí chiến dịch Chiến dịch Không. Cặp (CampaignId, CriterionId) là duy nhất trên toàn hệ thống.
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 hệ thống.
ID nguồn cấp dữ liệu Các khu vực nói tiếng Anh Có
Mã mục nguồn cấp dữ liệu Các khu vực nói tiếng Anh Có
ID thuộc tính nguồn cấp dữ liệu Nguồn cấp dữ liệu Không
Mã bản đồ nguồn cấp dữ liệu Các khu vực nói tiếng Anh Có
ID nhãn Các khu vực nói tiếng Anh Có
ID danh sách người dùng Các khu vực nói tiếng Anh Có