Partnerlink erstellen oder löschen

So erstellen oder löschen Sie eine PartnerLink-Ressource. Mit der Data Manager API können Partnerverknüpfungen für die folgenden Kontotypen erstellt werden:

• Google Ads-Konten
• Display & Video 360-Partner- oder ‑Werbetreibendenkonten

Link erstellen

Erstellen Sie ein PartnerLink, indem Sie eine CreatePartnerLinkRequest senden.

Anfragetext erstellen

Erstellen Sie eine PartnerLink-Ressource. Hier sind die Felder, die Sie festlegen müssen.

owning_account

Gibt das Werbetreibendenkonto an, zu dem der Link gehört. Auf ein ProductAccount-Objekt festgelegt.

Legen Sie account_type auf die AccountType des Werbetreibendenkontos fest.

Legen Sie für account_id die ID des Werbetreibendenkontos fest.

Im Leitfaden zu Zielen und Headern finden Sie eine Anleitung zur ID, die für die einzelnen Arten von Werbetreibenden verwendet werden muss.

partner_account

Identifiziert das Partnerkonto. Auf ein ProductAccount-Objekt festgelegt.

Setzen Sie account_type auf die AccountType des Partnerkontos. Wenn die Verknüpfung beispielsweise von einem Werbetreibendenkonto zu einem Konto eines Datenpartners erfolgt, legen Sie dieses Feld auf DATA_PARTNER fest.

Legen Sie für account_id die ID des Partnerkontos fest.

Erstellen Sie die Anfrage

Um einen Partnerlink zu erstellen, müssen Sie ein CreatePartnerLinkRequest erstellen.

1. Legen Sie für parent den Ressourcennamen des Werbetreibendenkontos fest. Verwenden Sie das folgende Format:

   accountTypes/{account_type}/accounts/{account}
   

2. Legen Sie partner_link auf die von Ihnen erstellte Ressource PartnerLink fest.

3. Wenn Ihre Anmeldedaten für ein Google-Konto mit Zugriff auf ein übergeordnetes Konto des Werbetreibendenkontos sind, z. B. ein Google Ads-Verwaltungskonto oder ein Display & Video 360-Partnerkonto, legen Sie den login-account-Header wie unter Ziele und Header konfigurieren beschrieben fest.

Hier sind Beispielanfragen im JSON-Format zum Erstellen einer Verknüpfung mit einem Datenpartnerkonto in verschiedenen Arten von Werbekonten.

Google Ads

Im API Explorer öffnen

{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

DV360-Werbetreibender

Im API Explorer öffnen

{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

DV360-Partner

Im API Explorer öffnen

{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Anfrage senden

Senden Sie die Anfrage und fügen Sie bei Bedarf Anfrageheader hinzu. Verwenden Sie Anmeldedaten für ein Google-Konto mit Zugriff auf owning_account.

Wenn die Anfrage erfolgreich ist, enthält die Antwort das erstellte PartnerLink mit den ausgefüllten Feldern id und name.

Wenn die Anfrage fehlschlägt, untersuchen Sie die Fehler, um die Ursache des Fehlers zu ermitteln. Aktualisieren Sie dann die Anfrage und die Header, um alle Probleme zu beheben, und senden Sie die aktualisierte Anfrage und die Header.

Link löschen

Senden Sie zum Löschen einer PartnerLink eine DeletePartnerLinkRequest mit name, das auf den Ressourcennamen festgelegt ist. Legen Sie bei Bedarf Header fest.