Mapowanie identyfikatorów w nowej wersji Search Ads 360

Nowy interfejs Search Ads 360 Reporting API jest już dostępny. 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 o jego używaniu.

Jednostki w nowej wersji Search Ads 360 mają inny zakres 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 prośbęReports.getIdMappingFile(). Odpowiedź zawiera mapowania identyfikatorów większości elementów w przypadku wybranego reklamodawcy. Aby dowiedzieć się więcej o przyczynach, dla których element może nie zostać uwzględniony w pliku mapowania, zapoznaj się z artykułem Częste przyczyny braku encji.

Oto przykład zwróconego pliku (format CSV zakodowany 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 w danym wierszu.

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

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

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

Typ elementu Opis Stare identyfikatory Nowe identyfikatory
CUSTOMER Mapowanie identyfikatorów: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 w kampanii. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP Mapowanie identyfikatorów na potrzeby adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
KRYTERIUM Mapowanie identyfikatorów w przypadku kryteriów na poziomie grupy reklam: 
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 identyfikatorów 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 w przypadku kryteriów na poziomie kampanii: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP Mapowanie identyfikatorów w grupie kampanii. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET Mapowanie identyfikatorów w przypadku celu skuteczności grupy kampanii. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE Mapowanie identyfikatorów w tabeli pliku danych 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM Mapowanie identyfikatorów w przypadku elementu feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

Najczęstsze przyczyny braku elementów

Plik mapowania reklamodawcy zawiera większość jego elementów, ale w niektórych przypadkach mogą one być nieobecne. Oto kilka najczęstszych powodów:

  • Każdy plik mapowania jest aktualizowany co 3 dni. Jeśli plik mapowania zostanie pobrany bezpośrednio po utworzeniu nowego elementu, prawdopodobnie nie będzie on uwzględniony w tym pliku. Prawdopodobnie zostanie ona dołączona w ciągu 3 dni.
  • Konto, do którego należy element, zostanie usunięte. W tym przypadku nie obsługujemy mapowania identyfikatorów.
  • Aktualizacja elementu (np. kampanii) po stronie wyszukiwarki nie jest obsługiwana w nowej wersji Search Ads 360. Zmiany zostały wprowadzone przez utworzenie nowego elementu Search Ads 360 z wprowadzonymi w nim zmianami i następnym usunięciem poprzedniego elementu Search Ads 360.
  • Być może poprzednie mapowania zostały usunięte w wyniku synchronizacji starszej i nowej wersji Search Ads 360, w której zachowywane jest tylko najnowsze mapowanie. Wiele mapowań między pojedynczym identyfikatorem w starszej wersji a wieloma identyfikatorami w nowej wersji Search Ads 360 zostanie rozwiązanych, zachowując ten z najnowszym znacznikiem czasu.
  • Konto wyszukiwarki nie jest synchronizowane z powodu błędów synchronizacji między starą a nową wersją Search Ads 360.
  • Konto zostało usunięte lub wyłączone.

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

Unikalność identyfikatora obiektu

Każdy obiekt w nowej wersji Search Ads 360 jest identyfikowany na podstawie własnego identyfikatora. Niektóre z tych identyfikatorów są unikalne globalnie na wszystkich kontach w nowej wersji Search Ads 360, a inne są unikalne tylko w określonym zakresie. Aby jednoznacznie zidentyfikować reklamy, musisz użyć zarówno grupy reklam, jak i identyfikatorów reklam, ponieważ identyfikatory reklam są przypisywane jednoznacznie do każdej grupy reklam, ale nie do wszystkich grup reklam. Poniżej podajemy informacje o wyjątkowym charakterze każdego identyfikatora obiektu w nowej wersji Search Ads 360. Te reguły identyfikatorów mogą być przydatne podczas projektowania lokalnego miejsca na dane dla nowych obiektów Search Ads 360.

Identyfikator obiektu Zakres unikalności Czy jest niepowtarzalny 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 Nie. Para (AdGroupId, AdId) jest globalnie unikalna.
Identyfikator kryterium w grupie reklam Grupa reklam Nie. Para (AdGroupId, CriterionId) jest globalnie unikalna.
CampaignCriterion ID Kampania Nie. Para (CampaignId, CriterionId) jest globalnie unikalna.
Rozszerzenia reklam Kampania Nie. Para (CampaignId, AdExtensionId) jest globalnie unikalna.
Identyfikator kanału RSS Cały świat Tak
Identyfikator elementu kanału 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