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 entegre etmek için daha fazla esneklik ve süreçler. Yeni Search Ads 360 Reporting'e geçme ve bu hizmeti kullanma hakkında daha fazla bilgi edinin. API.

Yeni Search Ads 360'taki öğeler, önceki Search Ads 360'tan farklı kimlik alanına sahiptir. Önceki ve yeni Search Ads 360 arasında kimlik eşlemesini almak için Reports.getIdMappingFile() isteği gönderin. Yanıt, belirtilen reklamverenin tüm varlıkları için kimlik eşlemelerini içerir.

Döndürülen dosyanın bir örneğini burada bulabilirsiniz (UTF-8 olarak 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 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İ Şunun için kimlik eşlemesi: 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şlemesi. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP adGroup için kimlik eşlemesi. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
ÖDEME Şunun için kimlik eşlemesi: 
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 ad için kimlik eşlemesi. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Şunun 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şlemesi. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Kampanya grubu performans hedefi için kimlik eşlemesi. 
{
  "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 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ğ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 benzersiz, bazıları ise benzersizdir sınırlı bir alanda çalışır. Örneğin, bir müşterinin hedefini benzersiz bir şekilde yapmak için hem reklam grubu hem de reklam Reklam kimlikleri her reklam grubu için benzersiz bir şekilde atandığı, ancak tüm reklam grupları arasında atanmaması nedeniyle, reklamları tanımlama. Yeni Search Ads 360'taki her nesne kimliğinin benzersizliği aşağıda listelenmiştir. Bu kimlik kuralları 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 genel olarak benzersizdir.
AdGroupCriterion Kimliği Reklam Grubu Hayır. (AdGroupId, CriterionId) çifti genel olarak benzersizdir.
Kampanya Ölçütü Kimliği Kampanya Hayır. (CampaignId, CriterionId) çifti genel olarak benzersizdir.
Reklam Uzantıları Kampanya Hayır. (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