Von Version 2 zu Version 3 migrieren

Letzte Aktualisierung: 31.10.2023

Anwendung migrieren

Für die Migration von v2 zu v3 müssen Sie Ihre Endpunkt-URLs für den Aufruf von v3 und Sie müssen Ihre Anwendung aktualisieren, um funktionsgefährdende Änderungen zu berücksichtigen.

API-Aufrufe von v2 auf v3 aktualisieren

Um v3 anstelle von v2 zu verwenden, müssen Sie Ihre Anfragen auf die neue Version 3 aktualisieren. Endpunkten.

Um beispielsweise die Methode advertisers.get mit v2 aufzurufen, verwenden Sie die folgende URL:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

Aktualisieren Sie bei Version 3 die URL wie folgt:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

Wenn Sie eine Clientbibliothek verwenden, um Anfragen an die API zu senden, verwenden Sie die aktuelle Version der Clientbibliothek und aktualisieren Sie Ihre Konfiguration für die Verwendung von v3.

Erforderliche Änderungen ausführen

Version 3 enthält eine Reihe funktionsgefährdender Änderungen. Überprüfen Sie Folgendes und nehmen Sie die erforderlichen Änderungen vor, die für Ihre Nutzung des Display- und Video 360 API

Anrufe aktualisieren, bei denen YouTube-Ressourcen und das zugehörige Targeting abgerufen werden

• Ressourcen YoutubeAdGroup und YoutubeAdGroupAd wurden ersetzt durch Ressourcen zu AdGroup und AdGroupAd Diese neuen Ressourcen bieten Fast identische Informationen wie die Ressourcen von V2, aber möglicherweise aktualisiertes Feld oder enum-Typen. Ersetzen Sie in Ihrer Integration Ihre Verwendung von YoutubeAdGroup- oder YoutubeAdGroupAd-Ressourcen mit AdGroup und AdGroupAd-Ressourcen und Aktualisierungsaufrufe an die folgenden V2-Dienste, um dem entsprechenden v3-Dienst an:
  • advertisers.youtubeAdGroupAds nach advertisers.adGroupAds
  • advertisers.youtubeAdGroups nach advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions bis advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Verweise auf YoutubeAndPartnersBiddingStrategy-Objekte wurden in ein neues youtubeAndPartnersBid-Feld verschoben im allgemeinen BiddingStrategy-Objekt. Die Das Feld „biddingStrategy“ wurde aus dem Objekt YoutubeAndPartnersSettings. Aktualisieren Sie Ihre Integration auf die Gebotsstrategie für YouTube-Werbebuchungen oder -Anzeigengruppen aus dem BiddingStrategy-Objekt im Feld bidStrategy im LineItem- oder AdGroup-Ressource.
• Das Feld „thirdPartyMeasurementSettings“ wurde umbenannt in thirdPartyMeasurementConfigs im YoutubeAndPartnersSettings-Objekt und das YoutubeAndPartnersThirdPartyMeasurementSettings-Objekt wurde umbenannt in ThirdPartyMeasurementConfigs Aktualisieren Sie Ihre Integration auf Konfigurationsinformationen für Analysen durch Drittanbieter mithilfe des neuen Felds abrufen und Objekt.

Erforderliche Abrechnungskonfigurationen beim Erstellen von Werbetreibenden einschließen

billingConfig ist jetzt ein Pflichtfeld im Advertiser-Ressource. advertisers.create aktualisieren um zu überprüfen, ob dieses Feld festgelegt wurde. Die standardmäßigen Zahlungsinformationen können wird für den übergeordneten Partner über den neuen Partner abgerufen Ressource billingConfig.

Neues Feld zur Steuerung der optimierten Ausrichtung verwenden

Das neue boolesche Feld enableOptimizedTargeting ersetzt das Feld Feld targetingExpansionLevel in TargetingExpansionConfig -Objekt enthält.

Einbindung des Anzeigenauftrags aktualisieren, um das neue KPI-Feld zu verwenden

Das Feld performanceGoal in der folgenden Tabelle wurde durch das neue Feld kpi ersetzt: Die InsertionOrder-Ressource. Dieses neue Feld verwendet einen Kpi anstelle des PerformanceGoal-Objekts und verwendet neue Felder und Enums.

Verweise auf eingestellte Dienste und Felder entfernen

In Version 3 wurden verschiedene Elemente entfernt, um sie an frühere Funktion anzupassen. Einstellungen:

• Der Dienst advertisers.manualTriggers wurde als manuelle Trigger entfernt wurden verworfen.
• Das Feld „billableOutcome“ wurde aus dem Ressource InsertionOrder, da ergebnisbasierte Käufe verworfen.

Weitere Änderungen

Neben den oben aufgeführten funktionsgefährdenden Änderungen enthält Version 3 auch neue Funktionen.

Funktionen, die nach der Ersteinführung zu Version 3 hinzugefügt wurden, finden Sie in unserer Version Notizen.

Verwaltung von Listen mit Umgebungen

In Version 3 können Sie Listen mit Umgebungen vollständig verwalten, um Folgendes zu tun: advertisers.locationLists.assignedLocations verwenden, um TARGETING_LOCATION_TYPE_PROXIMITY zugewiesene Standorte erstellen und löschen LocationList Ressourcen Standorte werden mithilfe der ID identifiziert von TARGETING_TYPE_POI TargetingOption-Ressourcen Diese können abgerufen mit targetingTypes.targetingOptions.search.

Möglichkeit, regelbasierte Algorithmen für die benutzerdefinierte Gebotseinstellung zu erstellen

In Version 3 können Sie regelbasierte Algorithmen für die benutzerdefinierte Gebotseinstellung mithilfe der Funktion customBiddingAlgorithms, media customBiddingAlgorithms.rules-Dienste.

Diese Funktion befindet sich in der Betaphase und ist nur für Partner auf der Zulassungsliste verfügbar. Wenn Ihr Partner nicht auf der Zulassungsliste steht, gibt Ihre Anfrage einen Fehler zurück.