Veri Yöneticisi API'siyle çalışırken hem Destination kavramı hem de istek başlıkları sık sık görünür. Farklı senaryolarda hedefleri ve başlıkları nasıl yapılandıracağınızı anlamak için bu kılavuzu okuyun.
Hedefler veya başlıklar ne zaman kullanılır?
Alım isteklerinde
Destinationkullanın. Bir alım isteği, kitleye üye eklemek veya kitledeki üyeleri kaldırmak ya da etkinlik göndermek içinIngestionServicekullanır. BirIngestAudienceMembersRequestveyaIngestEventsRequestiçindekidestinationslistesi şunları tanımlar:- Verileri alan hesap. Örneğin, bir Google Ads hesabı veya Google Analytics mülkü.
- Hesaptaki verilerin hedef öğesi (ör. Google Ads dönüşüm işlemi veya Google Analytics akışı).
- İsteğin kimlik bilgilerinin, verileri alan hesaba erişim yolu.
Aynı alım isteğine birden fazla hedef ekleyebilirsiniz.
Kaynak oluşturan, güncelleyen, silen veya alan kaynak yönetimi isteklerinde istek başlıklarını kullanın. Başlıklar, kaynak yönetimi isteğinin hedef hesabına yönelik isteğin kimlik bilgilerinin erişim yolunu tanımlar. İstek başlıklarını destekleyen kaynak yönetimi yöntemlerine sahip kaynakların listesini aşağıda bulabilirsiniz:
Örneğin, bir kitle oluşturmak, kitleye üye eklemek, teşhisleri kontrol etmek ve ardından kitlenin boyutunu kontrol etmek için kitleyi almak istiyorsanız her adım, kullanılacak istek türü ve hedefler mi yoksa istek başlıkları mı kullanmanız gerektiği aşağıda açıklanmıştır:
| Adım | İstek türü | Hedef veya istek başlıkları |
|---|---|---|
| Kitle oluşturma | Kaynak yönetimi | İstek başlıkları |
| Kitleye üye ekleme | Besleme | Hedefler |
| Teşhisleri kontrol et | Besleme | Hedefler |
| Kitleyi alma | Kaynak yönetimi | İstek başlıkları |
Her tablonun etrafındaki Alım veya Kaynak yönetimi sekmesini tıklayarak bu rehberdeki her istek türüyle ilgili ayrıntılar arasında geçiş yapın.
Reklamveren veya ajanssanız başlıkların nasıl ayarlanacağına ve Destination'nin nasıl oluşturulacağına dair örnekler için Reklamveren senaryoları bölümüne gidin:
Veri iş ortağıysanız kaynakları yönetmek ve veri iş ortağı hesabınıza iş ortağı bağlantısı olan bir hesaba veri göndermek için başlıkları ayarlama ve Destination oluşturma örnekleri için Veri iş ortağı senaryoları bölümüne gidin:
Ayrıntılı şartlar bölümünde şartlar ve doğrulama kuralları ayrıntılı olarak açıklanmaktadır.
Reklamveren senaryoları
Reklamverenler ve ajanslar için yaygın senaryolarda Destination veya istek üstbilgilerini nasıl yapılandıracağınız aşağıda açıklanmıştır. Bu diyagramda, Data Manager API'sinin reklam hesabına erişmek için kimlik bilgilerini ve Destination alanlarını nasıl kullandığı gösterilmektedir.
Google Ads
Aşağıda, bir grup Google Ads hesabı ve kullanıcının örneğini gösteren bir şema yer almaktadır.
- Yönetici hesabı Y1
M1'in iki doğrudan alt hesabı var:
- Yönetici hesabı Y2
- Müşteri hesabı C1
Google Hesabı
cloudysanfrancisco@gmail.com, M1'de kullanıcıdır.- Yönetici hesabı Y2
Y2'nin iki doğrudan alt hesabı var:
- Müşteri hesabı C1
- Müşteri hesabı C2
Google Hesabı
baklavainthebalkans@gmail.com, Y2'de kullanıcıdır.- Müşteri hesabı C1
C1'in iki doğrudan üst yönetici hesabı var:
- Yönetici hesabı Y1
- Yönetici hesabı Y2
jeffersonloveshiking@gmail.comGoogle Hesabı, M1'de kullanıcıdır.- Müşteri hesabı C2
Yönetici hesabı Y2, H2'nin tek doğrudan üst öğesidir.
Listelenen Google Hesaplarından hiçbiri C2'de kullanıcı değil.
Doğrudan erişim senaryosu ve Yönetici erişimi senaryosu, bu hesaplara veri göndermek için bir hedefi nasıl yapılandıracağınızı gösterir.
Doğrudan erişim senaryosu
Bir Google Ads hesabına veri göndermek istiyorsanız ve kimlik bilgileriniz Google Ads hesabında kullanıcı olan bir Google Hesabı'na aitse:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account özelliğini ayarlamayın veya operating_account ile aynı değerlere ayarlayın. |
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin veya dönüşüm işleminin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Şemadaki hesapları ve Google Hesabı jeffersonloveshiking@gmail.com'nın kimlik bilgilerini kullanarak doğrudan erişim senaryosuna dair bir örnek aşağıda verilmiştir:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Yönetici erişimi senaryosu
Bir Google Ads hesabına veri göndermek istiyorsanız ve kimlik bilgileriniz, reklamveren hesabının alt hesap olduğu bir Google Ads yönetici hesabında kullanıcı olan bir Google Hesabı'na aitse:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin veya dönüşüm işleminin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Şemadaki Google Ads müşteri hesabı C2 için yönetici erişimi senaryosu ve Google Hesabı baklavainthebalkans@gmail.com'nın kimlik bilgileriyle ilgili bir örneği aşağıda bulabilirsiniz:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "M2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Google Ads müşteri hesabı C2 için yönetici erişimi senaryosuna ve Google Ads yönetici hesabı Y1'de kullanıcı olan Google Hesabı cloudysanfrancisco@gmail.com'nın kimlik bilgilerine dair başka bir örnek aşağıda verilmiştir:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "M1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Display & Video 360
İki yaklaşım kullanarak Display & Video 360'a veri gönderebilirsiniz:
- Kimlik bilgilerinin, Display & Video 360 reklamveren veya iş ortağı hesabında kullanıcı olan bir Google Hesabı'na ait olduğu doğrudan erişim.
- Display & Video 360 iş ortağı erişimi: Kimlik bilgileri, Display & Video 360 iş ortağı hesabında kullanıcı olan bir Google Hesabı'na aittir ve işletilen hesap, iş ortağı hesabı altındaki bir Display & Video 360 reklamveren hesabıdır.
Doğrudan erişim senaryoları
Verileri bir Display & Video 360 reklamveren hesabına göndermek istiyorsanız ve kimlik bilgileriniz reklamveren hesabında kullanıcı olan bir Google Hesabı'na aitse:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account özelliğini ayarlamayın veya operating_account ile aynı değerlere ayarlayın. |
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Verileri bir Display & Video 360 reklamverenine göndermek için doğrudan erişim senaryosuna yönelik bir Destination örneğini aşağıda bulabilirsiniz:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Benzer şekilde, verileri bir Display & Video 360 iş ortağı hesabına göndermek istiyorsanız ve kimlik bilgileriniz iş ortağı hesabında kullanıcı olan bir Google Hesabı'na aitse:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account özelliğini ayarlamayın veya operating_account ile aynı değerlere ayarlayın. |
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Verileri bir Display & Video 360 iş ortağına göndermek için doğrudan erişim senaryosuna yönelik bir Destination örneğini aşağıda bulabilirsiniz:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"loginAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Display & Video 360 iş ortağı erişimi senaryosu
Verileri bir Display & Video 360 reklamverenine göndermek istiyorsanız ve kimlik bilgileriniz, reklamverenin üst Display & Video 360 iş ortağı hesabında kullanıcı olan bir Google Hesabı'na aitse:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Display & Video 360 reklamverenine veri göndermek için iş ortağı erişimi senaryosuna yönelik bir Destination örneğini aşağıda bulabilirsiniz. Bu senaryoda, kimlik bilgileri Display & Video 360 iş ortağı hesabında DISPLAY_VIDEO_PARTNER_ID kullanıcı olan bir Google Hesabı'na ait olmalıdır ve Display & Video 360 reklamveren hesabı DISPLAY_VIDEO_ADVERTISER_ID, iş ortağı hesabının DISPLAY_VIDEO_PARTNER_ID alt öğesi olmalıdır.
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Google Analytics
Not: operating_account bir Google Analytics hesabıysa login_account öğesini ayarlamayın veya operating_account ile aynı değerlere ayarlayın. Aksi takdirde, istek OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH hatasıyla başarısız olur.
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account özelliğini ayarlamayın veya operating_account ile aynı değerlere ayarlayın. |
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
|
||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Etkinlikleri Google Analytics'e göndermek için kullanılan Destination örneğini aşağıda bulabilirsiniz:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "PROPERTY_ID",
"accountType": "GOOGLE_ANALYTICS_PROPERTY"
},
"loginAccount": {
"accountId": "PROPERTY_ID",
"accountType": "GOOGLE_ANALYTICS_PROPERTY"
},
"productDestinationId": "MEASUREMENT_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Floodlight
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
login_account özelliğini ayarlamayın veya operating_account ile aynı değerlere ayarlayın. |
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Floodlight etkinlik kimliği | ||||
Etkinlikleri Floodlight'a göndermek için kullanılan bir Destination örneği aşağıda verilmiştir:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "FLOODLIGHT_CONFIG_ID",
"accountType": "FLOODLIGHT_CONFIG"
},
"loginAccount": {
"accountId": "FLOODLIGHT_CONFIG_ID",
"accountType": "FLOODLIGHT_CONFIG"
},
"productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
}
]
}
Veri iş ortağı senaryoları
Veri iş ortağı hesabına iş ortağı bağlantısı oluşturulmuş reklamveren hesaplarına veri gönderen bir veri iş ortağının yaygın senaryoları için Destination nasıl yapılandırılacağını burada bulabilirsiniz.
Bu diyagramda, Data Manager API'nin iş ortağı bağlantısı üzerinden reklam hesabına erişmek için kimlik bilgilerini ve Destination alanlarını nasıl kullandığı gösterilmektedir.
Google Ads
Aşağıda, bir grup Google Ads ve veri iş ortağı hesabının örneğini gösteren bir şema yer almaktadır. Şemada, her bir Google Ads veya veri iş ortağı hesabında hangi Google Hesabı'nın kullanıcı olduğu ve hesaplar arasındaki iş ortağı bağlantıları da gösterilir.
- D1 veri iş ortağı
D1 ile Google Ads yönetici hesabı Y2 arasında iş ortağı bağlantısı vardır.
Google Hesabı
222larabrown@gmail.com, D1'de kullanıcıdır.- D2 veri iş ortağı
D2 ile Google Ads müşteri hesabı C1 arasında iş ortağı bağlantısı vardır.
Google Hesabı
jeffersonloveshiking@gmail.com, D2'de kullanıcıdır.- Yönetici hesabı Y1
M1'in iki doğrudan alt hesabı var:
- Yönetici hesabı Y2
- Müşteri hesabı C1
- Yönetici hesabı Y2
Y2'nin iki doğrudan alt hesabı var:
- Müşteri hesabı C1
- Müşteri hesabı C2
- Müşteri hesabı C1
C1'in iki doğrudan üst yönetici hesabı var:
- Yönetici hesabı Y1
- Yönetici hesabı Y2
- Müşteri hesabı C2
Yönetici hesabı Y2, H2'nin tek doğrudan üst öğesidir.
Bu hesap grubuyla yapabilecekleriniz:
- D1 veri iş ortağı gibi davran
Veri iş ortağı D1 olarak hareket etmek için Google Hesabı
222larabrown@gmail.comkimlik bilgilerini kullanaraklogin_accounthedefi veri iş ortağı hesabı D1 velinked_accounthedefi yönetici hesabı Y2 olarak ayarlanmış bir hedefle yönetici hesabı Y2, müşteri hesabı M1 veya müşteri hesabı M2'ye veri gönderin.D1 veri iş ortağı olarak, D1 ile M1 arasında iş ortağı bağlantısı olmadığı için M1 yönetici hesabına veri gönderemezsiniz.
- D2 veri iş ortağı gibi davran
D2 veri iş ortağı olarak hareket etmek için
jeffersonloveshiking@gmail.comGoogle Hesabı kimlik bilgilerini kullanarak verileri C1 müşteri hesabına gönderin. Bu işlem içinlogin_accounthedefi D2 veri iş ortağı hesabı velinked_accounthedefi C1 müşteri hesabı olarak ayarlanmış bir hedef kullanın.D2 veri iş ortağı olarak, D2 ile bu hesaplar veya bunların üst yönetici hesapları arasında iş ortağı bağlantısı olmadığından M1 yönetici hesabına, M2 yönetici hesabına ya da C2 müşteri hesabına veri gönderemezsiniz.
D1 ve D2 veri iş ortakları arasındaki temel fark, veri iş ortağının Google Ads hesaplarına nasıl bağlandığıdır.
- D1 adlı veri iş ortağı bir Google Ads yönetici hesabına bağlıdır. Bu, yönetici iş ortağı bağlantısı senaryosunun bir örneğidir.
- Veri iş ortağı D2, bir Google Ads müşteri hesabına bağlı. Bu, doğrudan iş ortağı bağlantısı senaryosunun bir örneğidir.
Doğrudan iş ortağı bağlantısı senaryosu
Bir Google Ads hesabına veri göndermek istiyorsanız ve Google Ads hesabı ile veri iş ortağı hesabınız arasında iş ortağı bağlantısı varsa:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin veya dönüşüm işleminin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Şemadaki hesapların kullanıldığı doğrudan iş ortağı bağlantısı senaryosuna ve kaynak yönetimi istekleriyle ilgili istek üstbilgilerine dair bir örneği aşağıda bulabilirsiniz. Bu senaryoda, D2 ve C1 arasındaki iş ortağı bağlantısını ve Google Hesabı jeffersonloveshiking@gmail.com kimlik bilgilerini kullanarak veri iş ortağı D2, kitle üyesi verilerini Google Ads istemci müşterisi C1'e gönderir:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "C1_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "D2_CUSTOMER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "USER_LIST_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Yönetici iş ortağı bağlantısı senaryosu
Bir Google Ads hesabına veri göndermek istiyorsanız ve iş ortağı bağlantısı bir üst Google Ads yönetici hesabı ile veri iş ortağı hesabınız arasında bulunuyorsa:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
Kitlenin veya dönüşüm işleminin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID |
Şemadaki hesapların kullanıldığı bir yönetici iş ortağı bağlantısı senaryosu örneğini aşağıda bulabilirsiniz. Bu senaryoda, veri iş ortağı D1, D1 ile M2 arasındaki iş ortağı bağlantısını ve Google Hesabı 222larabrown@gmail.com kimlik bilgilerini kullanarak kitle üyesi verilerini Google Ads istemci müşterisi C2'ye gönderir:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "C2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"loginAccount": {
"accountId": "D1_CUSTOMER_ID",
"accountType": "DATA_PARTNER"
},
"linkedAccount": {
"accountId": "M2_CUSTOMER_ID",
"accountType": "GOOGLE_ADS"
},
"productDestinationId": "USER_LIST_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID |
linked-account |
accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID |
Display & Video 360
Veri iş ortağı olarak, iki yaklaşım kullanarak bir Display & Video 360 hesabına veri gönderebilirsiniz:
- Bir veri iş ortağı hesabı ile Display & Video 360 iş ortağı veya reklamveren hesabı arasında doğrudan iş ortağı bağlantısı kullanın.
- Bir veri iş ortağı hesabı ile reklamverenin üst Display & Video 360 iş ortağı hesabı arasında iş ortağı bağlantısı kullanarak bir Display & Video 360 reklamverenine veri gönderme.
Doğrudan iş ortağı bağlantısı senaryoları
Verileri bir Display & Video 360 reklamverenine göndermek istiyorsanız ve iş ortağı bağlantısı Display & Video 360 reklamveren hesabı ile veri iş ortağı hesabınız arasında bulunuyorsa:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin veya dönüşüm işleminin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Verileri bir Display & Video 360 reklamverenine göndermek için doğrudan iş ortağı bağlantısı senaryosuna yönelik bir Destination örneği ve kaynak yönetimi istekleriyle ilgili istek başlıkları aşağıda verilmiştir:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Verileri bir Display & Video 360 iş ortağı hesabına göndermek istiyorsanız Display & Video 360 iş ortağı hesabı ile veri iş ortağı hesabınız arasında bir iş ortağı bağlantısı olmalıdır.
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin veya dönüşüm işleminin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Verileri bir Display & Video 360 iş ortağına göndermek için doğrudan iş ortağı bağlantısı senaryosuna yönelik bir Destination örneği ve kaynak yönetimi istekleriyle ilgili istek başlıkları aşağıda verilmiştir:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Ebeveyn iş ortağı bağlantısı senaryosu
Verileri bir Display & Video 360 reklamverenine göndermek istiyorsanız ve veri iş ortağı hesabınızla iş ortağı bağlantısı, reklamveren hesabının alt hesap olduğu bir Display & Video 360 iş ortağı hesabıyla yapılıyorsa:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
product_destination_id |
Kitlenin veya dönüşüm işleminin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
Verileri, veri iş ortağı ile reklamverenin üst Display & Video 360 iş ortağı arasındaki bir iş ortağı bağlantısını kullanarak bir Display & Video 360 reklamverenine göndermek için iş ortağı bağlantısı senaryosuna yönelik bir Destination örneğini aşağıda bulabilirsiniz:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
"accountType": "DISPLAY_VIDEO_ADVERTISER"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"linkedAccount": {
"accountId": "DISPLAY_VIDEO_PARTNER_ID",
"accountType": "DISPLAY_VIDEO_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID |
Google Ad Manager
Bir Google Ad Manager hesabına veri göndermek istiyorsanız ve veri iş ortağı hesabınız ile Google Ad Manager hesabı arasında iş ortağı bağlantısı varsa:
Besleme
| Hedef | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
linked_account alanını ayarlamayın. |
||||
product_destination_id |
Kitlenin kimliği. | ||||
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
İş ortağı bağlantısı kullanarak bir Google Ad Manager hesabına veri göndermek için kullanılan Destination örneğini aşağıda bulabilirsiniz:
Besleme
{
"destinations": [
{
"operatingAccount": {
"accountId": "GAM_AUDIENCE_LINK_ID",
"accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
},
"loginAccount": {
"accountId": "DATA_PARTNER_ID",
"accountType": "DATA_PARTNER"
},
"productDestinationId": "AUDIENCE_ID"
}
]
}
Kaynak yönetimi
| İstek başlıkları | |
|---|---|
login-account |
accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID |
linked-account |
linked-account üstbilgisini ayarlamayın. |
Google Analytics
Data Manager API, iş ortağı bağlantısı kullanılarak Google Analytics hesabına veri gönderilmesini desteklemez. Bunun yerine Google Analytics için reklamveren senaryoları yaklaşımını kullanın.
Floodlight
Data Manager API, iş ortağı bağlantısı kullanarak Floodlight yapılandırmasına veri göndermeyi desteklemez. Bunun yerine Floodlight için reklamveren senaryoları yaklaşımını kullanın.
Ayrıntılı şartlar
Bu bölümde, IngestionService isteği için Destination hesap alanlarıyla ilgili ayrıntılı koşullar, kaynak yönetimi isteklerine yönelik eşdeğer istek başlıkları, product_destination_id'ü ayarlama ile ilgili ipuçları ve kimlik bilgilerinizin nerelere erişebileceğini belirleme hakkında bilgiler yer almaktadır.
Hesap alanları
Bir Destination en fazla 3 farklı hesaba sahip olabilir:
operating_accountoperating_accountzorunludur.operating_account, istekteki verileri hangi hesabın alacağını gösterir.operating_accountaşağıdakilerden herhangi biri olabilir:- Google Ads hesabı
- Display & Video 360 reklamveren hesabı
- Display & Video 360 iş ortağı hesabı
- Google Ad Manager hesabı
- Google Analytics mülkü
- Veriler, veri iş ortağı hesabına ait bir kitleye gönderiliyorsa veri iş ortağı hesabı.
operating_accountalanına karşılık gelen bir istek başlığı yok.DestinationKaynak yönetimi isteği gönderirken isteğin hedef hesabı, işletim hesabıdır.login_accountalanı velogin-accountistek başlığılogin_accounther zaman gerekli değildir veIngestionServiceisteğinde varsayılan olarakoperating_account, kaynak yönetimi isteğinde ise hedef hesap kullanılır. Kaynak yönetimi isteğinde, oturum açma hesabını tanımlamak içinlogin-accountistek başlığını kullanın.Data Manager API, aşağıdakileri doğrular:
Kimlik bilgilerinin Google Hesabı, giriş hesabında bir kullanıcıdır.
Giriş hesabı aşağıdakilerden biri olmalıdır:
operating_accountile aynı.IngestionServiceisteğindeDestinationöğesininlogin_accountdeğerini ayarlamazsanız veya kaynak yönetimi isteğindelogin-accountbaşlığını ayarlamazsanız bu varsayılan değerdir.Bir Google Ads yöneticisi veya Display & Video 360 iş ortağı hesabı,
IngestionServiceisteğindeoperating_accountöğesinin üst öğesi ya da kaynak yönetimi isteğinde hedef hesabın üst öğesidir.Bir iş ortağı bağlantısı içeren bir veri iş ortağı hesabı,
IngestionServiceisteğindelinked_accountveya kaynak yönetimi isteğindelinked-accountüstbilgisi.
linked_accountalanı velinked-accountistek başlığı-
linked_account, hangi hesabınlogin_accountiş ortağı bağlantısı içerdiğini gösterir. Bu bağlantı,IngestionServiceisteğinin veya kaynak yönetimi isteğinin hedef hesabıdır.
Ürünün hedef kimliği
Bir product_destination_id, Destination öğesinin operating_account içindeki hangi nesnenin verileri aldığını tanımlar. Örneğin, bu; Google Ads veya Display & Video 360 için bir kitle kimliği, Google Ads için bir dönüşüm işlemi kimliği ya da Google Analytics veri akışı için bir ölçüm kimliği olabilir.
Her ürün hedefi türünün kimliğini nasıl bulacağınız aşağıda açıklanmıştır.
Google Ads kitlesi
Kitle üyelerini dahil etmek için kullanılan ürün hedef kimliği, kitle kimliğidir. Bu kimliği Google Ads kullanıcı arayüzünü veya Data Manager API'sini kullanarak alın.
Google Ads kullanıcı arayüzü
Google Ads kullanıcı arayüzünden kitle kimliğini almak için:
- Google Ads kullanıcı arayüzünde Kitle Yöneticisi'ne gidin.
- Ayrıntıları görüntülemek için kitle adını tıklayın.
- Kitle kimliği, Liste kimliği'nin yanında listelenir.
Data Manager API
UserList öğesini List yöntemini kullanarak alın, gerekirse istek üstbilgilerini sağlayın ve ürün hedef kimliği için UserList öğesinin id kısmını kullanın.
Google Ads etkinliği
Etkinlikleri alma için ürün hedef kimliği, dönüşüm işlemi kimliğidir. Bu kimliği Google Ads kullanıcı arayüzünü veya Google Ads API'yi kullanarak alın.
Google Ads kullanıcı arayüzü
Google Ads kullanıcı arayüzünden dönüşüm işlemi kimliğini almak için:
- Google Ads kullanıcı arayüzünde Dönüşümler'e gidin.
- Dönüşüm işleminin adını tıklayın.
- Ayrıntılar sekmesine gidin.
- Dönüşüm işlemi kimliği, Dönüşüm türü kimliği'nin yanındaki sayıdır.
Google Ads API
Google Ads API'den dönüşüm işlemi kimliğini almak için:
Aşağıdaki sorguyla
GoogleAdsServiceadresineSearchveyaSearchStreamisteği gönderin:SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'Yanıtın
idalanındakiconversion_actionöğesinden dönüşüm işlemi kimliğini alın.[ { "results": [ { "conversionAction": { "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID", "id": "CONVERSION_ACTION_ID", "name": "CONVERSION_ACTION_NAME" } } ] } ]
Display & Video 360 kitlesi
Kitle üyelerini dahil etmek için kullanılan ürün hedef kimliği, kitle kimliğidir. Bu kimliği Display & Video 360 kullanıcı arayüzünü veya Data Manager API'yi kullanarak alın.
Display & Video 360 kullanıcı arayüzü
Display & Video 360 kullanıcı arayüzünden kitle kimliğini almak için:
- https://displayvideo.google.com adresinden Display & Video 360 kullanıcı arayüzünde oturum açın.
operating_accountiçin kullandığınız Display & Video 360 iş ortağına veya reklamverene gidin.- Soldaki menüden Kitleler'e gidip Tüm kitleler'i seçin.
- Listede kitleyi bulun. Kitle kimliği, Ad sütununda adın yanındaki sayıdır.
Data Manager API
UserList öğesini List yöntemini kullanarak alın, gerekirse istek üstbilgilerini sağlayın ve ürün hedef kimliği için UserList öğesinin id değerini kullanın.
Google Analytics etkinliği
Ürün hedefi kimliği, veri akışının türüne bağlıdır.
- Web veri akışı
- Veri akışının ölçüm kimliğini kullanın.
- Uygulama veri akışı
Veri akışının Firebase uygulama kimliğini kullanın. Firebase uygulama kimliğinizi bulmak için iki seçenek vardır:
- Google Analytics kullanıcı arayüzünde Veri akışları'na gidin, veri akışını tıklayın ve FIREBASE UYGULAMA KİMLİĞİ'ni bulun.
- Firebase konsolunu kullanın.
Floodlight etkinliği
Etkinlikleri Floodlight'a aktarmak için kullanılan ürün hedef kimliği, Floodlight etkinlik kimliğidir. Bu kimliği Campaign Manager 360 kullanıcı arayüzünü veya Campaign Manager 360 API'yi kullanarak alın.
Campaign Manager 360 kullanıcı arayüzü
Floodlight etkinliği kimliğini Campaign Manager 360 kullanıcı arayüzünden almak için:
- Campaign Manager 360 kullanıcı arayüzünde oturum açın.
operating_accountiçin kullandığınız Campaign Manager 360 reklamverenine gidin.- Soldaki menüde Floodlight'a gidin, ardından Etkinlikler'i seçin.
- Listede Floodlight etkinliğini bulun. Kimlik, Etkinlik adı sütununda adın yanındaki sayıdır.
Campaign Manager 360 API
Floodlight etkinliği kimliğini Campaign Manager 360 API'sinden almak için:
floodlightActivitieskaynağına birlististeği gönderin.- Floodlight yapılandırmasının
floodlightConfigurationIddeğerini belirtin. - İsteğe bağlı olarak, etkinlik adına göre filtrelemek için
searchStringparametresini kullanın. - Yanıtın
idalanındaki seçiliFloodlightActivityöğesinden Floodlight etkinlik kimliğini alın.
Kimlik bilgilerinin erişebileceği yerleri belirleme
Bir Data Manager API isteğini yetkilendirmek için kullandığınız kimlik bilgileri belirli bir Google Hesabı ile ilişkilendirilir.
- Kullanıcı kimlik bilgilerini kullanıyorsanız kimlik bilgilerini oluşturduğunuzda, kendi adına işlem yapma izni veren kullanıcının Google Hesabı olarak istekler yetkilendirilir.
- Hizmet hesabı kimlik bilgilerini kullanırsanız istekler hizmet hesabının Google Hesabı olarak yetkilendirilir.
Kimlik bilgileriniz için kullanılan Google Hesabı'nın Google Ads, Display & Video 360, Google Analytics veya Campaign Manager 360 hesabına erişimi olduğunu nasıl doğrulayacağınızı aşağıda bulabilirsiniz.
Google Ads veya veri iş ortağı
login_accountiçin Google Ads kullanıcı arayüzünde Erişim ve güvenlik'e gidin.- Kullanıcılar sekmesini seçin.
login_account, bir Google Ads yönetici hesabıysa alt hesaplardaki kullanıcıları gizlemek için Hiyerarşinin tamamındaki kullanıcıları göster açma/kapatma düğmesini devre dışı bırakın.- Kimlik bilgilerinizin Google Hesabı'nın Kullanıcılar sekmesinde gösterilen hesaplar listesinde yer aldığını doğrulayın.
Display & Video 360
- Display & Video 360 kullanıcı arayüzünde Kullanıcı yönetimi ve e-posta tercihleri'ne gidin.
- Kullanıcı yönetimi bölümünde, kimlik bilgileriniz için kullanılan Google Hesabı'nın
login_accountüzerinde bir kullanıcı olduğunu doğrulayın.
Google Analytics
- Google Analytics kullanıcı arayüzünde Mülk erişim yönetimi'ne gidin.
login_accountbölümünde belirtilen Google Analytics mülkünün seçili olduğunu onaylayın.- Kimlik bilgilerinizin Google Hesabı'nın mülkte Düzenleyici veya Yönetici rolüne sahip olduğunu doğrulayın.
Floodlight (Campaign Manager 360)
- Campaign Manager 360 kullanıcı arayüzünde oturum açın.
- Sol menüde Yönetici > Kullanıcı profilleri'ne gidin.
- Kimlik bilgileriniz için kullanılan Google Hesabı'nın gösterilen profiller listesinde yer aldığını doğrulayın.
- Profili tıklayın ve
login_accountolarak kullanılan reklamveren hesabına erişimi olduğunu doğrulayın. İstek sırasındalogin_accountayarlamazsanız varsayılan olarakoperating_accountkullanılır. Hesabın, çevrimdışı dönüşümleri ekleme iznine sahip bir kullanıcı rolü olduğundan emin olun.