Yeni Search Ads 360 İçin Kimlik Eşleme

Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yeni API, özel raporlar oluşturmak ve verileri raporlama uygulamalarınıza ve süreçlerinize entegre etmek için daha fazla esneklik sağlar. Yeni Search Ads 360 Reporting API'ye geçme ve bu API'yi kullanma hakkında daha fazla bilgi edinin.

Yeni Search Ads 360'taki öğelerin kimlik alanı, önceki Search Ads 360'tan farklıdır. Önceki ile yeni Search Ads 360 arasındaki kimlik eşlemesini almak için bir Reports.getIdMappingFile() isteği gönderin. Yanıt, belirtilen reklamverenin çoğu öğesi için kimlik eşlemelerini içerir. Bir varlığın eşleme dosyasından neden çıkarılmış olabileceği hakkında daha fazla bilgi edinmek için Öğelerin eksik olmasının yaygın nedenleri başlıklı makaleyi inceleyin.

Döndürülen dosyanın örneğini (UTF-8'de kodlanmış CSV biçimi) aşağıda bulabilirsiniz:

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

CSV dosyasında 3 sütun bulunur:

  • Entity Type: Bu satırın varlık türü.

  • Legacy IDs: önceki Search Ads 360'taki öğe yolunun tamamının JSON dizesi

  • New IDs: Yeni Search Ads 360'taki öğe yolunun tamamının JSON dizesi

Aşağıdaki tabloda, desteklenen öğelerin ve örnek kimlik eşlemelerinin listesi gösterilmektedir:

Varlık Türü Açıklama Eski kimlikler Yeni kimlikler
MÜŞTERİ Şuna yönelik kimlik eşleme: Yöneticiler ve ajanslar için eşlemeler kullanılamaz. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
KAMPANYA Kampanya için kimlik eşleme. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP adGroup için kimlik eşleme. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
KRİTER Reklam grubu düzeyindeki ölçütler için kimlik eşleme: 
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 Reklam için kimlik eşleme. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Kampanya düzeyindeki ölçütler için kimlik eşleme: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Kampanya grubu için kimlik eşleme. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Kampanya grubu performans hedefi için kimlik eşleme. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Feed tablosu için kimlik eşleme. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM feedItem için kimlik eşleme. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Öğelerin eksik olmasının yaygın nedenleri

Bir reklamverenin eşleme dosyası, öğelerinin çoğunu içerse de öğelerin eksik olduğu bazı durumlar vardır. Bunun en yaygın nedenlerinden bazıları şunlardır:

  • Her eşleme dosyası 3 günde bir güncellenir. Bir eşleme dosyası, yeni bir varlık oluşturulduktan hemen sonra indirilirse varlık muhtemelen eşleme dosyasında yer almaz. Bu işlem, 3 gün kadar bekledikten sonra eklenecektir.
  • Öğenin ait olduğu hesap kaldırılır. Bu durumda kimlik eşleme desteklenmez.
  • Motor tarafında bir öğede (ör. kampanya) yapılan güncellemeler yeni Search Ads 360'ta desteklenmez. Güncellemeler, yeni bir Search Ads 360 öğesi oluşturularak ele alındı. Bu öğe, güncellemenin yapılması ve ardından önceki Search Ads 360 öğesinin kaldırılmasıyla oluşturuldu.
  • Eski ve yeni Search Ads 360 arasında senkronizasyon yapılması sonucunda önceki eşlemelerin kaldırılmış olması mümkündür. Bu durumda yalnızca en son eşleme korunur. Tek bir eski kimlik ile birden fazla yeni Search Ads 360 kimliği arasındaki birden fazla eşleme çözüldükten sonra en son zaman damgasına sahip olan eşleme korunur.
  • Eski ve yeni Search Ads 360 arasındaki senkronizasyon hataları nedeniyle arama motoru hesabı senkronize edilmiyor.
  • Hesap kaldırılır veya devre dışı bırakılır.

Raporu indirme

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()

Nesne kimliğinin benzersizliği

Yeni Search Ads 360'taki her nesne kendi kimliğiyle tanımlanır. Bu kimliklerden bazıları, yeni Search Ads 360'taki tüm hesaplar genelinde küresel düzeyde benzersizdir. Diğerleri ise yalnızca sınırlı bir kapsamda benzersizdir. Örneğin, reklam kimlikleri reklam grupları arasında değil, reklam grubu başına benzersiz şekilde atandığından reklamları benzersiz şekilde tanımlamak için hem reklam grubunu hem de reklam kimliklerini kullanmanız gerekir. Yeni Search Ads 360'taki her bir nesne kimliğinin benzersizliği aşağıda listelenmiştir. Bu kimlik kuralları, yeni Search Ads 360 nesneleriniz için yerel depolama alanı tasarlarken faydalı olabilir.

Nesne kimliği Benzersizlik kapsamı Dünya genelinde benzersiz mi?
Bütçe Kimliği Global Evet
Kampanya Kimliği Global Evet
Reklam Grubu Kimliği Global Evet
Reklam Kimliği Reklam Grubu Hayır. (AdGroupId, AdId) çifti dünya genelinde benzersizdir.
AdGroupCriterion kimliği Reklam Grubu Hayır. (AdGroupId, CriterionId) çifti dünya genelinde benzersizdir.
CampaignCriterion kimliği Kampanya Hayır. (CampaignId, CriterionId) çifti dünya genelinde benzersizdir.
Reklam Uzantıları Kampanya Hayır. (CampaignId, AdExtensionId) çifti dünya genelinde benzersizdir.
Özet akışı kimliği Global Evet
Feed Öğe Kimliği Global Evet
Feed Özelliği Kimliği Feed Hayır
Feed eşleme kimliği Global Evet
Etiket Kimliği Global Evet
UserList kimliği Global Evet