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 360New 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 |