Entitas di Search Ads 360 versi baru memiliki ruang ID yang berbeda dari Search Ads 360 versi sebelumnya.
Untuk mendapatkan pemetaan ID antara Search Ads 360 versi sebelumnya dan versi baru, kirim
Reports.getIdMappingFile()
permintaan. Responsnya mencakup pemetaan ID untuk semua entitas untuk pengiklan tertentu.
Berikut ini adalah contoh file yang dikembalikan (format CSV yang dienkode dalam UTF-8):
Entity Type,Legacy IDs,New IDs CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"
File CSV memiliki 3 kolom:
Entity Type
: jenis entitas baris ini.Legacy IDs
: string JSON dari jalur entitas lengkap di Search Ads 360 versi sebelumnyaNew IDs
: string JSON dari jalur entitas lengkap di Search Ads 360 versi baru
Tabel di bawah menampilkan daftar entitas yang didukung dan contoh pemetaan ID:
Jenis Entitas | Deskripsi | ID lama | ID baru |
---|---|---|---|
PELANGGAN | Pemetaan ID untuk: Pemetaan untuk pengelola dan agensi tidak tersedia. |
advertiser: { "agencyId": "20700000000000125", "advertiserId": "2170000012345" } account: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205" } |
{ "customerId": "200001235" } |
KAMPANYE | Pemetaan ID untuk kampanye. |
{ "agencyId":"20700000000000125", "advertiserId":"2170000012345", "engineAccountId":"700000000042205", "campaignId":"71700000087192405" } |
{ "customerId": "200001235", "campaignId": "14660344555" } |
AD_GROUP | Pemetaan ID untuk adGroup. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000084761225", "adGroupId": "58700007213529045" } |
{ "customerId": "200001235", "campaignId": "13666840065", "adGroupId": "127701366165" } |
KRITERIA | Pemetaan ID untuk: |
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 | Pemetaan ID untuk iklan. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000065395945", "adGroupId": "58700005797210525", "adId": "44700029299414085" } |
{ "customerId": "200001235", "campaignId": "15314179325", "adGroupId": "131599768485", "adId": "562719339005" } |
CAMPAIGN_CRITERION | Pemetaan ID untuk: |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000084403015", "campaignTargetId": "38700011011700285" } |
{ "customerId": "200001235", "campaignId": "13467100745", "campaignCriterionId": "2125" } |
CAMPAIGN_GROUP | Pemetaan ID untuk grup kampanye. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "budgetGroupId": "87700002234256082" } |
{ "customerId": "200001235", "campaignGroupId": "1000665659" } |
CAMPAIGN_GROUP_PERFORMANCE_TARGET | Pemetaan ID untuk target performa grup kampanye. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "budgetGroupId": "87700002234256082", "budgetPlanId": "88700007187391026" } |
{ "customerId": "200001235", "campaignGroupId": "1000665659" "campaignGroupPerformanceTargetId": "7624175" } |
FEED_TABLE | Pemetaan ID untuk Tabel Feed. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "feedTableId": "32700008040329135" } |
{ "customerId": "200001235", "feedId": "207040045" } |
FEED_ITEM | Pemetaan ID untuk feedItem. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "feedTableId": "32700014854183375", "feedItemRowId": "33700014854183415" } |
{ "customerId": "200001235", "feedId": "377982485", "feedItemId": "235028589065" } |
Download laporannya
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()
Keunikan ID objek
Setiap objek di Search Ads 360 versi baru diidentifikasi berdasarkan ID-nya sendiri. Beberapa ID ini adalah unik di tingkat global di semua akun di Search Ads 360 versi baru, sementara akun yang lain bersifat unik hanya dalam lingkup terbatas. Misalnya, Anda harus menggunakan grup iklan dan ID iklan untuk mengidentifikasi iklan, karena ID iklan ditetapkan secara unik per grup iklan, tetapi tidak untuk seluruh grup iklan. Keunikan setiap ID objek dalam Search Ads 360 versi baru tercantum di bawah. Aturan ID ini dapat berguna saat mendesain penyimpanan lokal untuk objek Search Ads 360 versi baru.
ID Objek | Cakupan keunikan | Unik secara global? |
---|---|---|
ID Anggaran | Global | Ya |
ID kampanye | Global | Ya |
Nomor Grup Iklan | Global | Ya |
ID iklan | Grup Iklan | Pasangan tidak. (AdGroupId , AdId ) unik secara global. |
ID Kriteria GrupIklan | Grup Iklan | Pasangan tidak. (AdGroupId , CriterionId ) unik secara global. |
ID Kriteria Kampanye | Kampanye | Pasangan tidak. (CampaignId , CriterionId ) unik secara global. |
Ekstensi Iklan | Kampanye | Pasangan tidak. (CampaignId , AdExtensionId ) unik secara global. |
ID Feed | Global | Ya |
ID Item Feed | Global | Ya |
ID Atribut Feed | Feed | Tidak |
ID Pemetaan Feed | Global | Ya |
ID Label | Global | Ya |
ID DaftarPengguna | Global | Ya |