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 bei der Erstellung benutzerdefinierter Berichte und Integration der Daten in Ihre Berichtsanwendungen und Prozesse. Weitere Informationen zur Migration zur neuen Search Ads 360-Berichterstellung und deren Verwendung API hinzu.

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-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: <ph type="x-smartling-placeholder"> Zuordnungen für Manager und Agenturen sind nicht verfügbar. 
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