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 có thể khiến một thực thể bị bỏ qua khỏi tệp ánh xạ.
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: 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 | 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ã 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"
}
|
Những lý do phổ biến 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 chứa thực thể sẽ bị xoá. Chúng tôi không hỗ trợ liên kết mã nhận dạng trong trường hợp này.
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ã quảng cáo để xác định duy nhất 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 trên các 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 trong 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 hệ thống. |
| 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ó |