Entitäten in der neuen Search Ads 360-Version haben einen anderen ID-Bereich als in der vorherigen Search Ads 360-Version.
Um die ID-Zuordnung zwischen der vorherigen und der neuen Search Ads 360-Version zu erhalten, senden Sie eine
Reports.getIdMappingFile()
Die Antwort enthält ID-Zuordnungen für alle Entitäten für einen bestimmten Werbetreibenden.
Hier ist ein Beispiel für die zurückgegebene Datei im CSV-Format mit UTF-8-Codierung:
Entity Type,Legacy IDs,New IDs CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"
Die CSV-Datei hat drei Spalten:
Entity Type
: der Entitätstyp dieser Zeile.Legacy IDs
: ein JSON-String des vollständigen Entitätspfads in der vorherigen Search Ads 360-VersionNew IDs
: ein JSON-String des vollständigen Entitätspfads in der neuen Search Ads 360-Version
Die folgende Tabelle enthält eine Liste der unterstützten Entitäten und Beispiel-ID-Zuordnungen:
Entitätstyp | Beschreibung | Legacy-IDs | Neue IDs |
---|---|---|---|
KUNDE |
ID-Zuordnung für:
<ph type="x-smartling-placeholder">
|
advertiser: { "agencyId": "20700000000000125", "advertiserId": "2170000012345" } account: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205" } |
{ "customerId": "200001235" } |
KAMPAGNE | ID-Zuordnung für Kampagne. |
{ "agencyId":"20700000000000125", "advertiserId":"2170000012345", "engineAccountId":"700000000042205", "campaignId":"71700000087192405" } |
{ "customerId": "200001235", "campaignId": "14660344555" } |
AD_GROUP | ID-Zuordnung für adGroup. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000084761225", "adGroupId": "58700007213529045" } |
{ "customerId": "200001235", "campaignId": "13666840065", "adGroupId": "127701366165" } |
KRITERIEN | ID-Zuordnung für: <ph type="x-smartling-placeholder"> |
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 | ID-Zuordnung für ad. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000065395945", "adGroupId": "58700005797210525", "adId": "44700029299414085" } |
{ "customerId": "200001235", "campaignId": "15314179325", "adGroupId": "131599768485", "adId": "562719339005" } |
CAMPAIGN_CRITERION | ID-Zuordnung für: <ph type="x-smartling-placeholder"> |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000084403015", "campaignTargetId": "38700011011700285" } |
{ "customerId": "200001235", "campaignId": "13467100745", "campaignCriterionId": "2125" } |
CAMPAIGN_GROUP | ID-Zuordnung für Kampagnengruppe. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "budgetGroupId": "87700002234256082" } |
{ "customerId": "200001235", "campaignGroupId": "1000665659" } |
CAMPAIGN_GROUP_PERFORMANCE_TARGET | ID-Zuordnung für das Leistungsziel der Kampagnengruppe. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "budgetGroupId": "87700002234256082", "budgetPlanId": "88700007187391026" } |
{ "customerId": "200001235", "campaignGroupId": "1000665659" "campaignGroupPerformanceTargetId": "7624175" } |
FEED_TABLE | ID-Zuordnung für Feedtabelle. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "feedTableId": "32700008040329135" } |
{ "customerId": "200001235", "feedId": "207040045" } |
FEED_ITEM | ID-Zuordnung für feedItem. |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "feedTableId": "32700014854183375", "feedItemRowId": "33700014854183415" } |
{ "customerId": "200001235", "feedId": "377982485", "feedItemId": "235028589065" } |
Bericht herunterladen
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()
Eindeutigkeit der Objekt-ID
Jedes Objekt in der neuen Search Ads 360-Version wird durch eine eigene ID identifiziert. Einige dieser IDs sind auf globaler Ebene für alle Konten in der neuen Search Ads 360-Version eindeutig, andere wiederum nur innerhalb eines begrenzten Umfangs. Beispielsweise müssen Sie sowohl die Anzeigengruppen- als auch die Anzeigen-ID verwenden, um Anzeigen identifizieren, da Anzeigen-IDs pro Anzeigengruppe eindeutig, aber nicht über Anzeigengruppen hinweg zugewiesen sind. Die Eindeutigkeit jeder Objekt-ID in der neuen Search Ads 360-Version ist unten aufgeführt. Diese ID-Regeln können sind beim Entwerfen des lokalen Speichers für Ihre neuen Search Ads 360-Objekte nützlich.
Objekt-ID | Gültigkeitsbereich der Eindeutigkeit | Global eindeutig? |
---|---|---|
Budget-ID | Global | Ja |
Kampagnen-ID | Global | Ja |
Anzeigengruppen-ID | Global | Ja |
Anzeigen-ID | Anzeigengruppe | Anzahl (AdGroupId , AdId ) ist global eindeutig. |
ID des Anzeigengruppenkriteriums | Anzeigengruppe | Anzahl (AdGroupId , CriterionId ) ist global eindeutig. |
ID des Kampagnenkriteriums | Kampagne | Anzahl (CampaignId , CriterionId ) ist global eindeutig. |
Anzeigenerweiterungen | Kampagne | Anzahl (CampaignId , AdExtensionId ) ist global eindeutig. |
Feed-ID | Global | Ja |
ID des Feedelements | Global | Ja |
Feed-Attribut-ID | Feed | Nein |
Feed-Mapping-ID | Global | Ja |
Label-ID | Global | Ja |
Nutzerlisten-ID | Global | Ja |