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 cung cấp 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 báo cáo và quy trình. Tìm hiểu thêm về cách di chuyển sang và sử dụng 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à mới, hãy gửi một Reports.getIdMappingFile() của bạn. Nội dung phản hồi có chứa mục liên kết mã nhận dạng cho tất cả các pháp nhân của một nhà quảng cáo đã chỉ định.

Dưới đây là ví dụ về tệp trả về (định dạng CSV được mã hoá theo 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 của đường dẫn thực thể đầy đủ trong Search Ads 360 cũ

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

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

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: Không có bản đồ cho người quản lý và công ty quảng cáo. 
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 Ánh xạ 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Í Ánh xạ mã nhận dạng cho: 
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 Ánh xạ 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 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 ID 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 được xác định bằng mã nhận dạng riêng của đối tượng đó. Một số mã trong số này là riêng biệt trên toàn cầu trên mọi tài khoản trong Search Ads 360 mới, trong khi các tài khoản khác thì khác biệt chỉ 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ã quảng cáo để xác định quảng cáo, vì ID quảng cáo được chỉ định riêng cho mỗi nhóm quảng cáo, chứ không phải trên các nhóm quảng cáo. Dưới đây là điểm riêng biệt của từng mã đối tượng trong Search Ads 360 mới. Những 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 mới trong Search Ads 360.

Mã đối tượng Phạm vi của tính duy nhất Độc 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 hệ thống.
ID tiêu chí 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 Toàn cầu Có
Mã mục 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
ID mối liên kết nguồn cấp dữ liệu Toàn cầu Có
ID nhãn Toàn cầu Có
ID danh sách người dùng Toàn cầu Có