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
• Google Ad Manager-Konten

Verknüpfung erstellen

Erstellen Sie ein PartnerLink, indem Sie eine CreatePartnerLinkRequest senden.

Anfragetext erstellen

Erstellen Sie eine PartnerLink-Ressource. Hier sind die Felder, die festgelegt werden 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 account_id auf die ID des Werbetreibendenkontos fest.

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

partner_account

Gibt das Partnerkonto an. 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 account_id auf die ID des Partnerkontos fest.

Erstellen Sie die Anfrage

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

1. Legen Sie parent auf den Ressourcennamen des Werbetreibendenkontos fest. Verwenden Sie das Format:

   accountTypes/{account_type}/accounts/{account}
   

2. Legen Sie partner_link auf die von Ihnen erstellte PartnerLink-Ressource 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 in Ziele und Header konfigurieren beschrieben fest.

Hier finden Sie Beispielanfragen in JSON zum Erstellen einer Verknüpfung zu einem Datenpartnerkonto in verschiedenen Arten von Werbetreibendenkonten.

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "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 die 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.

Verknüpfung löschen

Wenn Sie eine PartnerLink löschen möchten, senden Sie eine DeletePartnerLinkRequest mit name, das auf den Ressourcennamen festgelegt ist. Legen Sie bei Bedarf Header fest.