Tworzenie i usuwanie linku partnerskiego

Oto jak utworzyć lub usunąć zasób PartnerLink. Interfejs Data Manager API obsługuje tworzenie połączeń z partnerami w przypadku tych rodzajów kont:

• konta Google Ads,
• Konta partnerów lub reklamodawców Display & Video 360
• Konta Google Ad Managera

Tworzenie połączenia

Utwórz PartnerLink, wysyłając CreatePartnerLinkRequest.

Tworzenie treści żądania

Utwórz zasób PartnerLink. Oto pola, które należy ustawić.

owning_account

Identyfikuje konto reklamodawcy, do którego należy link. Ustaw na obiekt ProductAccount.

Ustaw account_type na AccountType konta reklamodawcy.

Ustaw account_id na identyfikator konta reklamodawcy.

Instrukcje dotyczące identyfikatora, którego należy użyć w przypadku każdego typu reklamodawcy, znajdziesz w przewodniku po miejscach docelowych i nagłówkach.

partner_account

Identyfikuje konto partnera. Ustaw na obiekt ProductAccount.

Ustaw account_type na AccountType konta partnera. Jeśli na przykład link prowadzi z konta reklamodawcy na konto dostawcy danych, ustaw w tym polu wartość DATA_PARTNER.

Ustaw account_id na identyfikator konta partnera.

Tworzenie żądania

Aby utworzyć link partnera, utwórz CreatePartnerLinkRequest.

1. Ustaw parent na nazwę zasobu konta reklamodawcy. Użyj formatu:

   accountTypes/{account_type}/accounts/{account}
   

2. Ustaw partner_link na utworzony zasób PartnerLink.

3. Jeśli Twoje dane logowania dotyczą konta Google z dostępem do konta nadrzędnego konta reklamodawcy, np. konta menedżera Google Ads lub konta partnera Display & Video 360, ustaw nagłówek login-account zgodnie z opisem w artykule Konfigurowanie miejsc docelowych i nagłówków.

Oto przykładowe żądania w formacie JSON, które umożliwiają utworzenie połączenia z kontem dostawcy danych na różnych typach kont reklamodawców.

Google Ads

Otwórz w narzędziu APIs Explorer

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

reklamodawca DV360

Otwórz w narzędziu APIs Explorer

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

Partner DV360

Otwórz w narzędziu APIs Explorer

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

Google Ad Manager

Otwórz w narzędziu APIs Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Wysyłanie żądania

Wyślij żądanie i w razie potrzeby dołącz nagłówki żądania. Użyj danych logowania na konto Google z dostępem do owning_account.

Jeśli żądanie się powiedzie, odpowiedź będzie zawierać utworzony obiekt PartnerLink z wypełnionymi polami id i name.

Jeśli żądanie się nie powiedzie, sprawdź błędy, aby ustalić przyczynę niepowodzenia, zaktualizuj żądanie i nagłówki, aby rozwiązać problemy, a następnie wyślij zaktualizowane żądanie i nagłówki.

Usuwanie połączenia

Aby usunąć PartnerLink, wyślij DeletePartnerLinkRequest z parametrem name ustawionym na nazwę zasobu. W razie potrzeby ustaw nagłówki.