ID-Zuordnung für die neue Search Ads 360-Version

Die neue Search Ads 360 Reporting API ist jetzt verfügbar. Die neue API bietet mehr Flexibilität, um benutzerdefinierte Berichte zu erstellen und die Daten in Ihre Berichtsanwendungen und -prozesse zu integrieren. Weitere Informationen zur Migration zur neuen Search Ads 360 Reporting API und zu ihrer Verwendung

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-Version

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