Mapowanie identyfikatorów w nowej wersji Search Ads 360

Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Nowy interfejs API daje większą swobodę tworzenia raportów niestandardowych oraz integrowania danych z aplikacjami i procesami służącymi do raportowania. Dowiedz się więcej o przechodzeniu na nowy interfejs Search Ads 360 Reporting API i jego używaniu.

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

Oto przykład zwróconego pliku (w formacie CSV zakodowanym w 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 danego wiersza.

  • Legacy IDs: ciąg znaków w formacie JSON zawierający pełną ścieżkę encji w poprzedniej wersji Search Ads 360.

  • New IDs: ciąg znaków w formacie JSON zawierający pełną ścieżkę encji w nowej wersji Search Ads 360.

Tabela poniżej zawiera listę obsługiwanych elementów i przykładowe mapowania identyfikatorów:

Typ encji Opis Starsze identyfikatory Nowe identyfikatory
KLIENT Mapowanie identyfikatorów dla: 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
KAMPANIA Mapowanie identyfikatorów dla kampanii. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Mapowanie identyfikatora dla grupy adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
KRYTERIUM Mapowanie identyfikatorów dla: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD Mapowanie identyfikatora reklamy. 
{
  "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 dla grupy kampanii. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Mapowanie identyfikatorów na potrzeby celu skuteczności grupy kampanii. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Mapowanie identyfikatorów na potrzeby tabeli kanałów. 
{
  "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"
}

Pobierz raport

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ą unikalne na poziomie globalnym na wszystkich kontach w nowej wersji Search Ads 360, a inne tylko w ograniczonym zakresie. Na przykład do jednoznacznej identyfikacji reklam musisz użyć zarówno identyfikatorów grupy reklam, jak i identyfikatora reklamy, ponieważ są one jednoznacznie przypisywane do poszczególnych grup reklam, ale nie do poszczególnych grup. Unikalne identyfikatory obiektów w nowej wersji Search Ads 360 są wymienione poniżej. Te reguły dotyczące identyfikatorów mogą być przydatne podczas projektowania pamięci lokalnej nowych obiektów Search Ads 360.

Identyfikator obiektu Zakres unikalności Niepowtarzalne na całym świecie?
Identyfikator budżetu Cały świat Tak
Identyfikator kampanii Cały świat Tak
Identyfikator grupy reklam Cały świat Tak
Identyfikator reklamy Grupa reklam Para nie (AdGroupId, AdId) jest globalnie unikalna.
Identyfikator kryterium grupy reklam Grupa reklam Para nie (AdGroupId, CriterionId) jest globalnie unikalna.
Identyfikator CampaignCriterion Priorytet Para nie (CampaignId, CriterionId) jest globalnie unikalna.
Rozszerzenia reklam Priorytet Para nie (CampaignId, AdExtensionId) jest globalnie unikalna.
Identyfikator kanału RSS Cały świat Tak
Identyfikator elementu kanału RSS Cały świat Tak
Identyfikator atrybutu w pliku danych 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