Pemetaan ID untuk Search Ads 360 Versi Baru

Search Ads 360 Reporting API versi baru kini telah tersedia. API baru ini memberikan fleksibilitas yang lebih baik dalam membuat laporan kustom dan mengintegrasikan data ke dalam proses dan aplikasi pelaporan Anda. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Search Ads 360 Reporting API baru.

Entity 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 permintaan Reports.getIdMappingFile(). Responsnya menyertakan pemetaan ID untuk sebagian besar entitas untuk pengiklan yang ditentukan. Lihat Alasan umum entitas tidak ada untuk mempelajari lebih lanjut alasan entitas mungkin dihilangkan dari file pemetaan.

Berikut adalah contoh file yang ditampilkan (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 entity baris ini.

  • Legacy IDs: string JSON dari jalur entitas lengkap di Search Ads 360 versi sebelumnya

  • New IDs: string JSON dari jalur entitas lengkap di Search Ads 360 versi baru

Tabel di bawah menunjukkan daftar entity yang didukung dan contoh pemetaan ID:

Jenis Entity 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 kriteria tingkat grup iklan: 
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 kriteria tingkat kampanye: 
{
  "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"
}

Alasan umum entitas tidak ada

Meskipun file pemetaan pengiklan akan berisi sebagian besar entitas mereka, masih ada beberapa kasus saat entitas akan hilang. Berikut adalah beberapa penyebab yang paling umum:

  • Setiap file pemetaan diperbarui setiap 3 hari. Jika file pemetaan langsung didownload setelah entity baru dibuat, entity tersebut mungkin tidak akan ada dalam file pemetaan. Data tersebut kemungkinan akan disertakan setelah menunggu hingga 3 hari.
  • Akun yang dimiliki entitas akan dihapus. Dalam hal ini, kami tidak mendukung pemetaan ID.
  • Pembaruan pada entitas (misalnya, Kampanye) di sisi mesin tidak didukung di Search Ads 360 versi baru. Pembaruan ditangani dengan membuat entitas Search Ads 360 baru, dengan pembaruan dan penghapusan entitas Search Ads 360 sebelumnya.
  • Pemetaan sebelumnya mungkin dihapus sebagai akibat dari sinkronisasi antara Search Ads 360 versi lama dan versi baru, yang hanya mempertahankan pemetaan terbaru. Beberapa pemetaan antara satu ID lama dan beberapa ID Search Ads 360 versi baru akan di-resolve, dengan mempertahankan ID yang memiliki stempel waktu terbaru.
  • Akun mesin tidak disinkronkan karena error sinkronisasi antara Search Ads 360 versi lama dan versi baru.
  • Akun akan dihapus atau dinonaktifkan.

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 dengan ID-nya sendiri. Beberapa ID ini bersifat unik di tingkat global di semua akun di Search Ads 360 versi baru, sementara yang lainnya hanya bersifat unik dalam cakupan terbatas. Misalnya, Anda harus menggunakan ID grup iklan dan iklan untuk mengidentifikasi iklan secara unik, karena ID iklan ditetapkan secara unik per grup iklan, tetapi tidak di 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 Anda.

ID Objek Cakupan keunikan Unik secara global?
ID Anggaran Global Ya
ID kampanye Global Ya
Nomor Grup Iklan Global Ya
ID iklan Grup Iklan Tidak. Pasangan (AdGroupId, AdId) bersifat unik secara global.
ID AdGroupCriterion Grup Iklan Tidak. Pasangan (AdGroupId, CriterionId) bersifat unik secara global.
ID CampaignCriterion Kampanye Tidak. Pasangan (CampaignId, CriterionId) bersifat unik secara global.
Ekstensi Iklan Kampanye Tidak. Pasangan (CampaignId, AdExtensionId) bersifat 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 Daftar Pengguna Global Ya