Elemente in der neuen Search Ads 360-Version haben einen anderen ID-Bereich als in der vorherigen Search Ads 360-Version.
Senden Sie eine
Reports.getIdMappingFile()
-Anfrage, um die ID-Zuordnung zwischen der vorherigen und der neuen Search Ads 360-Version abzurufen. Die Antwort enthält ID-Zuordnungen für alle Entitäten für einen bestimmten Werbetreibenden.
Hier sehen Sie ein Beispiel für die zurückgegebene Datei (in UTF-8 codiertes CSV-Format):
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: |
advertiser: { "agencyId": "20700000000000125", "advertiserId": "2170000012345" } account: { "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205" } |
{ "customerId": "200001235" } |
KAMPAGNE | ID-Zuordnung für campaign. |
{ "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: |
{ "agencyId": "20700000000000125", "advertiserId": "2170000012345", "engineAccountId": "700000000042205", "campaignId": "71700000068948065", "adGroupId": "58700006123995025", "AdGroupCriterionId": "46700015332504045" } |
{ "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: |
{ "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 anhand einer eigenen ID identifiziert. Einige dieser IDs sind in der neuen Search Ads 360-Version auf globaler Ebene eindeutig, während andere nur innerhalb eines begrenzten Gültigkeitsbereichs eindeutig sind. Beispielsweise müssen Sie sowohl die Anzeigengruppen- als auch die Anzeigen-ID zur eindeutigen Identifizierung von Anzeigen verwenden, da Anzeigen-IDs pro Anzeigengruppe, aber nicht Anzeigengruppenübergreifend eindeutig zugewiesen werden. Die Eindeutigkeit jeder Objekt-ID in der neuen Search Ads 360-Version ist unten aufgeführt. Diese ID-Regeln sind beim Entwerfen des lokalen Speichers für Ihre neuen Search Ads 360-Objekte hilfreich.
Objekt-ID | Gültigkeitsbereich der Eindeutigkeit | Global eindeutig? |
---|---|---|
Budget-ID | Global | Ja |
Kampagnen-ID | Global | Ja |
Anzeigengruppen-ID | Global | Ja |
Anzeigen-ID | Anzeigengruppe | Nein. Das Paar (AdGroupId , AdId ) ist global eindeutig. |
ID des Anzeigengruppenkriteriums | Anzeigengruppe | Nein. Das Paar (AdGroupId , CriterionId ) ist global eindeutig. |
ID des Kampagnenkriteriums | Kampagne | Nein. Das Paar (CampaignId , CriterionId ) ist global eindeutig. |
Anzeigenerweiterungen | Kampagne | Nein. Das Paar (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 |