Yeni Search Ads 360 İçin Kimlik Eşleme

Yeni Search Ads 360 Reporting API kullanıma sunuldu. Yeni API, özel raporlar oluşturmak ve raporlama uygulamalarınıza ve süreçlerinize verileri 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 tam öğe yolunun 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İ Şunlar için kimlik eşleme: Yöneticiler ve ajanslar için eşlemeler mevcut değildir. 
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. Yeni bir öğe oluşturulduktan hemen sonra bir eşleme dosyası indirilirse öğe 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.

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 yararlı 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 genel olarak benzersizdir.
CampaignCriterion kimliği Kampanya Hayır. (CampaignId, CriterionId) çifti genel olarak 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