Mapowanie identyfikatorów w nowej wersji Search Ads 360

Nowy interfejs Search Ads 360 Reporting API jest już dostępny. Nowy interfejs API zapewnia większa elastyczność tworzenia raportów niestandardowych i integrowania danych z aplikacjami służącymi do raportowania. i procesach. Więcej informacji o przechodzeniu do nowej wersji Search Ads 360 Raportowanie i korzystaniu z niej API.

Elementy w nowej wersji Search Ads 360 mają inną przestrzeń identyfikatorów niż w poprzedniej wersji tej usługi. Aby uzyskać mapowanie identyfikatorów między poprzednią a nową wersją Search Ads 360, wyślij Reports.getIdMappingFile() użytkownika. Odpowiedź zawiera mapowania identyfikatorów wszystkich elementów określonego reklamodawcy.

Oto przykład zwróconego pliku (format CSV z kodowaniem UTF-8):

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

Plik CSV zawiera 3 kolumny:

  • Entity Type: typ elementu w danym wierszu.

  • Legacy IDs: ciąg znaków JSON pełnej ścieżki encji w poprzedniej wersji Search Ads 360

  • New IDs: ciąg znaków JSON pełnej ścieżki encji w nowej wersji Search Ads 360

W tabeli poniżej znajdziesz listę obsługiwanych elementów i przykładowe mapowania identyfikatorów:

Typ encji Opis Starsze identyfikatory Nowe identyfikatory
KLIENT Mapowanie identyfikatorów dla: Mapowania dla menedżerów i agencji są niedostępne. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
KAMPANIA Mapowanie identyfikatorów kampanii. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Mapowanie identyfikatora grupy reklam adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
KRYTERIUM Mapowanie identyfikatorów dla: 
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 Mapowanie identyfikatora elementu ad. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION Mapowanie identyfikatorów dla: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mapowanie identyfikatorów na potrzeby grupy kampanii. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Mapowanie identyfikatorów celu skuteczności grupy kampanii. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Mapowanie identyfikatorów tabeli kanału. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Mapowanie identyfikatora elementu feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Pobieranie raportu

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

Niepowtarzalność identyfikatora obiektu

Każdy obiekt w nowej wersji Search Ads 360 ma własny identyfikator. Niektóre z tych identyfikatorów są unikalny na poziomie globalnym na wszystkich kontach w nowej wersji Search Ads 360, a inne są unikalne. tylko w ograniczonym zakresie. Na przykład musisz użyć zarówno identyfikatorów grupy reklam, jak i reklam, aby identyfikowania reklam, ponieważ są one jednoznacznie przypisywane do grup reklam, ale nie do poszczególnych grup. Unikalne identyfikatory obiektów w nowej wersji Search Ads 360 znajdziesz poniżej. Reguły te mogą może być przydatna przy projektowaniu pamięci lokalnej na potrzeby nowych obiektów Search Ads 360.

Identyfikator obiektu Zakres unikalności Wyjątkowe globalnie?
Identyfikator budżetu Cały świat Tak
Identyfikator kampanii Cały świat Tak
Identyfikator grupy reklam Cały świat Tak
Identyfikator reklamy Grupa reklam Nie. Para (AdGroupId, AdId) jest unikalna globalnie.
Identyfikator kryterium grupy reklam Grupa reklam Nie. Para (AdGroupId, CriterionId) jest unikalna globalnie.
Identyfikator kryterium Campaignkryterium Kampania Nie. Para (CampaignId, CriterionId) jest unikalna globalnie.
Rozszerzenia reklam Kampania Nie. Para (CampaignId, AdExtensionId) jest unikalna globalnie.
Identyfikator kanału RSS Cały świat Tak
Identyfikator elementu kanału RSS Cały świat Tak
Identyfikator atrybutu kanału Kanał Nie
Identyfikator mapowania kanału Cały świat Tak
Identyfikator etykiety Cały świat Tak
Identyfikator listy użytkowników Cały świat Tak