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 korzystaniu z niego.

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 żądanie Reports.getIdMappingFile(). Odpowiedź zawiera mapowania identyfikatorów większości elementów określonego 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 Najczęstsze 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 Starsze 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 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 na potrzeby grupy 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 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 będzie zawierać większość elementów, ale w niektórych przypadkach ich zabraknie. 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 w nim zawarty. 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.

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 na poziomie globalnym dla wszystkich kont w nowej wersji Search Ads 360, a inne są unikalne tylko w ograniczonym 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 znajdziesz informacje o wyjątkowości 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 grupy 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 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