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ız ile 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 öğeler, önceki Search Ads 360'ta olduğundan farklı kimlik alanına sahiptir. Önceki ile yeni Search Ads 360 arasındaki kimlik eşlemesini almak için Reports.getIdMappingFile() isteği gönderin. Yanıt, belirtilen reklamveren için tüm varlıklar için kimlik eşlemelerini içerir.

Döndürülen dosyanın bir örneğini burada görebilirsiniz (UTF-8'de kodlanmış CSV biçimi):

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 öğe türü.

  • Legacy IDs: Önceki Search Ads 360'taki tam varlık yolunun bir JSON dizesi

  • New IDs: Yeni Search Ads 360'taki tam varlık yolunun bir 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şlemesi: 
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"
}
ÖLÇÜT Şunlar için kimlik eşlemesi: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "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 Şunlar için kimlik eşlemesi: 
{
  "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şlemesi. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM feedItem için kimlik eşlemesi. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Raporu indirin

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ği 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 hesaplarda genel düzeyde benzersizken diğerleri yalnızca sınırlı bir kapsamda benzersizdir. Örneğin, reklam kimlikleri reklam grupları arasında değil de reklam grubu başına benzersiz bir şekilde atandığından, reklamları benzersiz bir şekilde tanımlamak için hem reklam grubunu hem de reklam kimliklerini kullanmanız gerekir. Yeni Search Ads 360'taki her 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 Numaralı (AdGroupId, AdId) çifti genel olarak benzersizdir.
AdGroupCriterion Kimliği Reklam Grubu Numaralı (AdGroupId, CriterionId) çifti genel olarak benzersizdir.
Kampanya Ölçütü Kimliği Kampanya Numaralı (CampaignId, CriterionId) çifti genel olarak benzersizdir.
Reklam Uzantıları Kampanya Numaralı (CampaignId, AdExtensionId) çifti genel olarak benzersizdir.
Özet akışı kimliği Global Evet
Özet Akışı Öğesi Kimliği Global Evet
Feed Özellik Kimliği Feed Hayır
Özet Akışı Eşleme Kimliği Global Evet
Etiket Kimliği Global Evet
Kullanıcı Listesi Kimliği Global Evet