Produktkonten verknüpfen

Die Google Ads API unterstützt die Verknüpfung von Google Ads-Konten mit anderen Produktkonten. In dieser Anleitung wird beschrieben, wie Sie die API verwenden, um Ihre Konten zu verknüpfen.

Wenn Sie ein Google Ads-Konto mit einem anderen Produktkonto verknüpfen, gibt es zwei verschiedene Möglichkeiten.

Einladungsablauf

Der Einladungsablauf wird verwendet, wenn Sie Administratorzugriff auf das Google Ads-Konto, aber nicht auf das Produktkonto haben. Dieser Ablauf funktioniert in zwei Szenarien:

  1. Sie möchten die beiden Konten verknüpfen und eine Einladung für einen Administrator des Produktkontos erstellen. Der Administrator des Produktkontos nimmt die Einladung an, um die Kontoverknüpfung abzuschließen.
  2. Der Administrator des Produktkontos möchte die beiden Konten verknüpfen, hat aber keinen Zugriff auf das Google Ads-Konto. Der Administrator des Produktkontos erstellt eine Einladung, die Sie annehmen und die Verknüpfung abschließen.

In diesem Szenario werden die folgenden Methoden verwendet:

Szenario Aktion Anmerkungen
Szenario 1 Einladung erstellen Verwenden Sie die Methode ProductLinkInvitationService.CreateProductLinkInvitation, um eine Einladung zu erstellen. Die status des ProductLinkInvitation darf nicht festgelegt werden. Der Google Ads API-Server legt sie nach erfolgreichem Abschluss des API-Aufrufs auf REQUESTED fest.
Status einer Einladung prüfen Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream, um die Ressource product_link_invitation abzufragen und ihren Status zu prüfen.
Szenario 2 Einladung abrufen Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream, um die Ressource product_link_invitation abzufragen. Filtern Sie nach status = PENDING_APPROVAL, um eine ausstehende Einladung anzunehmen oder abzulehnen.
Einladung annehmen oder ablehnen Verwenden Sie die Methode ProductLinkInvitationService.UpdateProductLinkInvitation, um den Status von ProductLinkInvitation auf ACCEPTED oder REJECTED zu aktualisieren.
Einladung zurücknehmen Verwenden Sie die Methode ProductLinkInvitationService.RemoveProductLinkInvitation, um ein vorhandenes ProductLinkInvitation zu widerrufen.

In diesem Workflow können die folgenden häufigen Fehler auftreten:

Fehlercode Erklärung
ProductLinkInvitationError.PERMISSION_DENIED Der Kunde ist nicht berechtigt, diese Aktion auszuführen.
ProductLinkError.NO_INVITATION_REQUIRED Eine Einladung konnte nicht erstellt werden, da der Nutzer bereits Administratorzugriff auf das eingeladene Konto hat. Der Nutzer sollte den ProductLinkService verwenden, um direkt einen aktiven Link zu erstellen.

Ablauf für Deep-Linking

Der Ablauf für die direkte Verknüpfung wird verwendet, wenn Sie Administratorzugriff auf das Google Ads-Konto und das Produktkonto haben. In diesem Fall verknüpfen Sie das Google Ads-Konto direkt mit dem Produktkonto, anstatt eine Einladung zu senden.

In diesem Szenario werden die folgenden Methoden verwendet:

Aktion Anmerkungen
Aktiven Link erstellen Mit ProductLinkService.createProductLink können Sie eine ProductLink erstellen.
Aktiven Link deaktivieren Verwenden Sie ProductLinkService.removeProductLink, um eine aktive ProductLink zu entfernen.
Aktive Links abrufen Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream, um die Ressource product_link abzufragen.

In diesem Workflow können die folgenden häufigen Fehler auftreten:

Fehlercode Erklärung
ProductLinkError.CREATION_NOT_PERMITTED Es wurde versucht, eine Kontoverknüpfung über den Direktlink-Ablauf herzustellen. Dies wird jedoch aufgrund fehlender Berechtigungen nicht unterstützt. Der Nutzer sollte stattdessen ProductLinkInvitationService verwenden, um den Einladungsprozess durchzuführen.
ProductLinkError.INVITATION_EXISTS Ein Link kann nicht erstellt werden, da bereits eine ausstehende Einladung vorhanden ist.

Änderungen an AccountLinkService

Wenn Sie AccountLinkService verwenden, um ein Google Ads-Konto mit einem anderen Produktkonto zu verknüpfen, müssen Sie Ihre vorhandene Anwendung zu einem der oben aufgeführten Workflows migrieren. Migrieren Sie für die folgenden Linktypen von AccountLinkService zu ProductLinkService:

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

Verwenden Sie für ThirdPartyAppAnalyticsLinkIdentifier weiterhin AccountLinkService.

Zurück
Einladungen zum Nutzerzugriff verwalten
Weiter
YouTube verknüpfen