Aracılığıyla paylaş

Hesap Hiyerarşisi ve Kullanıcı İzinleri

  • Makale

Microsoft Advertising kullanıcıları, her hesapta farklı izinlere sahip olabilecek birden çok hesaba erişmek için aynı oturum açma kimlik bilgilerini kullanabilir. Bir kuruluş, tüm kullanıcıları ve hesapları tek bir üst hesaptan yönetmek için bir hesap hiyerarşisi ayarlayabilir, her şey için tek bir merkezi cüzdan kullanabilir ve Evrensel Olay İzleme (UET) etiketleri ve yeniden pazarlama listeleri gibi kampanya kaynaklarını müşteriler arasında paylaşabilir.

Not

Hiyerarşiler bağlamında Müşteri , "Yönetici hesabı" olarak da bilinir. ReklamverenHesap", "Hesap" veya "Reklamveren hesabı" olarak adlandırılır.

Bir hesaptaki kampanya hiyerarşisi hakkında daha fazla bilgi için bkz. Varlık Sınırları .

Kullanıcı Rolleri ve İzinleri

Uygulamanızın bilinen bir hesapta yalnızca bir Süper Yönetici kullanıcısını desteklemesi gerekebilir. Bu kadar basit bir izin yapısıyla bile her kullanıcı rolü için kullanılabilir eylemleri, kullanıcıların bir hesapta nasıl sağlandığı , geçerli erişim haklarını nasıl keşfedebileceğinizi ve Bing Ads API'siyle kimliği doğrulanmış bir Microsoft Advertising kullanıcısı adına nasıl işlem yapabileceğinizi anlamak istersiniz.

Kullanıcı Rolleri

Müşterinin Süper Yöneticisi veya Microsoft Advertising sistem yöneticisi tarafından verilen kullanıcı rolü, hizmet kullanılabilirliğini belirler. Örneğin Reklamveren Kampanya Yöneticisi rolüne sahip bir kullanıcı kampanya ekleyip güncelleştirebilir, ancak kullanıcı oluşturamaz veya güncelleştiremez. Hizmet başına başvuru içeriği işleminde aksi belirtilmedikçe, aşağıdaki tabloda kullanıcı rolü başına hizmet kısıtlamaları üst düzeyde açıklanmaktadır.

Not

Bir hesabın birincil kişisi olarak yalnızca Süper Yönetici ve Standart kullanıcılar ayarlanabilir. Kullanıcı rolleri hakkında daha fazla bilgi için Microsoft Advertising hesabıma nasıl erişim izni verebilirim? yardım konusuna bakın.

Kullanıcı Rolü Kullanılabilir Hizmetler
Reklamveren Kampanya Yöneticisi Bu rolün seçili hesapları görüntüleme ve seçili hesaplar içinde kampanya ekleme, düzenleme veya silme izinleri vardır. Reklamveren Kampanya Yöneticisi ödeme yöntemlerini görüntüleyebilir, ancak faturalama ve ödeme görevlerini yönetemez.

Tüm hizmetler için okuma işlemleri kullanılabilir.

Müşteri Yönetimi hizmetiyle yazma işlemleri genel olarak kullanılamaz. Bir istisna, Reklamveren Kampanya Yöneticisinin UpdateAccount işlemini kullanarak bir ReklamverenHesap'ınAutoTagType öğesini güncelleştirebileceğidir.
Toplayıcı DeleteCustomer dışında tüm hizmetler için okuma ve yazma işlemleri kullanılabilir.
Standart kullanıcı Bu rolün kampanyaları yönetme ve seçili hesaplarda bazı faturalama etkinlikleri gerçekleştirme izinleri vardır. Bu rol ödeme yöntemlerini ekleyemez, düzenleyemez veya silemez; hesap ekleme veya silme. Standart kullanıcılar reklamveren hesaplarını bağlayabilir ve bağlantılarını kaldırabilir, ancak müşteriyi müşteri düzeyindeki istemci bağlantılarına yönetemez.

Standart kullanıcılar, erişim sahibi oldukları hesaplardaki bazı kullanıcıları yönetebilir. Standart kullanıcı diğer Standart kullanıcıları, Reklamveren Kampanya Yöneticileri'ni ve Görüntüleyicileri davet edebilir veya silebilir ve geçerli müşteri bağlamında tüm kullanıcılar hakkındaki bilgileri görüntüleyebilir. Ancak, Standart kullanıcılar bir Süper Yöneticiyi davet edemez veya silemez veya süper yönetici rolünü düzenleyemez.

Müşteride paylaşılmayan bir hedef kitleye veya UET etiketine sahip standart kullanıcılar, açıklama ve ad gibi özelliklerini (kapsam dışında) güncelleştirebilir. hedef kitle veya UET etiketi paylaşılırken, Standart kullanıcı bu özellikleri güncelleştiremez. Daha fazla ayrıntı için İzleyicileri Paylaşma ve UET Etiketleri teknik kılavuzuna bakın.

Tüm hizmetler için okuma işlemleri kullanılabilir.

Müşteri Faturalama hizmeti ve Müşteri Yönetimi hizmetiyle yazma işlemleri genel olarak kullanılamaz. Standart kullanıcı tarafından kullanılabilen işlemlerin özel durumları AddInsertionOrder, UpdateInsertionOrder ve UpdateAccount'dır.
Süper Yönetici Bu rol tüm hesaplar için tam izinlere sahiptir. Süper Yönetici faturalama ve ödemelerle, hesap ayrıntılarıyla ve diğer kullanıcılarla (diğer Süper Yöneticiler dahil) ilgili her şeyi yönetebilir. Süper Yönetici, diğer kullanıcıların hangi hesaplara erişebileceğini belirtebilir. Yeni müşteri olarak kaydolduğunda ilk kullanıcı Süper Yönetici olur.

Müşteride hedef kitle veya UET etiketinin sahibi olan bir Süper Yönetici kullanıcı, hedef kitlenin veya UET etiketinin müşteri hesabı paylaşım kapsamını güncelleştirebilir. Hiyerarşinin üst müşterilerindeki Süper Yönetici kullanıcıları da kapsamı güncelleştirebilir. Açıklama ve ad gibi diğer hedef kitle veya UET etiket özellikleri (kapsam dışında) yalnızca hedef kitlenin veya UET etiketinin sahibi olan müşterideki bir Süper Yönetici kullanıcı tarafından güncelleştirilebilir. Hiyerarşinin üst müşterilerindeki Süper Yönetici kullanıcıları bu ayrıntıları güncelleştiremez. Daha fazla ayrıntı için İzleyicileri Paylaşma ve UET Etiketleri teknik kılavuzuna bakın.

DeleteCustomer dışında tüm hizmetler için okuma ve yazma işlemleri kullanılabilir
Görüntüleyici Bu rolün salt okunur izinleri vardır.

Tüm hizmetler için okuma işlemleri kullanılabilir.

Bağlantı izni (CustomerLinkPermission) "Standart" ise bağlı müşteriler üzerindeki Süper Yönetici izinleri kısıtlanır. Bağlantı izni "Yönetim" ise izinleri kısıtlanmaz. Ayrıca, doğrudan erişebilecekleri müşteriler üzerinde tam Süper Yönetici izinlerini de korur. Örneğin kaydoldukları yerde.

Müşteri Bağlantı İzni

Ayrıca, tek tek alınan bir kullanıcının belirli bir CustomerRole için CustomerId, AccountIds ve LinkedAccountIds üzerinde aynı role sahip olduğunu da unutmayın; Ancak, bir kullanıcının birden çok müşteri rolü varsa, etkin izinlerin tamamı GetUser tarafından döndürülen customerRole nesnelerinin tamamına bağlıdır. Kullanıcı Rollerini Alma bölümünde çeşitli örnekler verilmiştir.

Kullanıcı Rolleri Atama

Microsoft Advertising web uygulamasında yeni bir hesaba kaydolduğunda Size Süper Yönetici kullanıcı rolü verilir. Süper Yönetici, Reklamveren Kampanya Yöneticisi, Süper Yönetici, Standart veya Görüntüleyici rolüyle yeni kullanıcılar oluşturabilir. Toplayıcı rolü, Sistem Yöneticisi aracılığıyla özel istek tarafından sağlanır. Daha fazla bilgi için bkz . Toplayıcı Hiyerarşisi ve hesap yöneticinize başvurun.

Teknik olarak yeni kullanıcılar program aracılığıyla oluşturulamaz; ancak, kişileri mevcut bir Microsoft Advertising hesabı altında kaydolmaya davet etmek için SendUserInvitation işlemini kullanabilirsiniz. Birini bir hesaba veya hesap kümesine davet ettiğinizde, kullanıcı rolünü de ayarlarsınız. Microsoft Advertising, davetliye gönderilen bir e-posta daveti oluşturur. E-postayla gönderilen bağlantıya tıklayarak ve Microsoft Advertising kayıt iş akışını tamamlayarak, SendUserInvitation isteğinde sağladığınız kullanıcı rolüyle hesapları yönetme davetini kabul ederler.

Not

Yeni hesaplara kaydolan ve mevcut hesaplara davetleri kabul eden bir kişi aynı oturum açma kimlik bilgilerini kullanabilir. Kaydolma iş akışını tamamlamak için aynı kimlik bilgileri kullanıldığında her iki durumda da, kişinin Çok Kullanıcılı Kimlik Bilgilerine sahip olduğu kabul edilir. Her Süper Yöneticinin müşteri kapsamlarındaki kullanıcıları yönetmesi açısından, kullanıcının rolü, hesap erişimi ve kişi bilgileri benzersizdir. Kullanıcının başka bir müşteri bağlamında sahip olduğu izinler, geçerli müşteri kapsamında hareket ederken dikkate alınmaz.

Süper Yönetici, kullanıcılarının farklı hesaplara erişimini değiştirme ve kullanıcı rolünü değiştirme (ör. Görüntüleyiciden Standart kullanıcı ) seçeneğine sahiptir. Kullanıcının rolünü güncelleştirmek için UpdateUserRoles işlemini çağırın.

Kullanıcı Rollerini Alma

Bir müşterinin bir veya daha fazla hesabına erişebilen kullanıcıların listesini almak için GetUsersInfo işlemini çağırın. İşlem, her kullanıcının oturum açma e-posta adresini ve tanımlayıcısını içeren bir nesne dizisi döndürür. Ardından listedeki her kullanıcının microsoft Advertising'teki rolü ve hesap izinleri gibi ayrıntılarını alabilir ve GetUser işlemini çağırabilirsiniz. UserId öğesini sıfırdan bırakırsanız GetUser çağrılırken yanıt, istek üst bilgisi kimlik bilgileri tarafından belirtilen geçerli kimliği doğrulanmış kullanıcının ayrıntılarını içerir.

Aşağıda GetUser işlemi tarafından döndürülen customerRoles öğesi örneği verilmiştir.

<CustomerRoles xmlns:e1335="https://bingads.microsoft.com/Customer/v13/Entities" d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
  <e1335:CustomerRole>
    <e1335:RoleId>ValueHere</e1335:RoleId>
    <e1335:CustomerId>ValueHere</e1335:CustomerId>
    <e1335:AccountIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a1:long>ValueHere</a1:long>
    </e1335:AccountIds>
    <e1335:LinkedAccountIds d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a1:long>ValueHere</a1:long>
    </e1335:LinkedAccountIds>
    <e1335:CustomerLinkPermission d4p1:nil="false">ValueHere</e1335:CustomerLinkPermission>
  </e1335:CustomerRole>
</CustomerRoles>

Her CustomerRole , ilgili hesaba veya hesap kümesine erişirken bir kişinin sahip olduğu izinleri temsil eder.

Tek tek alınan bir kullanıcı, belirli bir CustomerRole için CustomerId, AccountId veLinkedAccountIds üzerinde aynı role sahiptir; Ancak, bir kullanıcının birden çok müşteri rolü varsa, etkin izinlerin tamamı GetUser tarafından döndürülen customerRole nesnelerinin tamamına bağlıdır. Aşağıda çeşitli örnekler verilmiştir.

Yeni Kullanıcı için Roller Örneği

Microsoft Advertising ile ilk kez kaydolup yeni bir hesap oluşturduysanız GetUser işlemi bir CustomerRole nesnesi döndürür.

  • Yeni hesabın ilk kullanıcısı Süper Yönetici kullanıcı rolüne sahip olduğundan RoleId değeri 41'dir.
  • CustomerId, kaydolduysanız sağlanan müşteri tanımlayıcısıdır.
  • Bir Süper Yönetici müşterideki tüm reklamveren hesaplarına CustomerId tanımlayıcısı ile her zaman erişebildiğinden AccountIds öğesi boş olur.
  • LinkedAccountIds öğesi boş çünkü henüz herhangi bir müşteri reklamveren hesabına bağlanmamışsınız.
  • Atanan CustomerId üzerinden doğrudan reklamveren hesaplarına erişebildiğiniz için CustomerLinkPermission boş olur.
<CustomerRoles xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
	<a:CustomerRole>
	   <a:RoleId>41</a:RoleId>
	   <a:CustomerId>999</a:CustomerId>
	   <a:AccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
	   <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
	   <a:CustomerLinkPermission i:nil="true"/>
	</a:CustomerRole>
 </CustomerRoles>

Çok Kullanıcılı Kimlik Bilgileri için Roller Örneği

Önceki örnekteki mevcut oturum açma kimlik bilgilerinizle başka bir müşteride kullanıcı olma davetini kabul ederseniz, Microsoft Advertising'te Çok Kullanıcılı Kimlik Bilgileriniz vardır. Müşteri tanımlayıcılarının her biriyle doğrudan ilişkili oturum açma kimlik bilgileriniz ve GetUser işlemi iki CustomerRole nesnesi döndürür. Bu örnekte customerRole içindeki öğeler CustomerId değeri dışında eşdeğerdir. RoleId, Yönetici Hesabı L1'in (müşteri kimliği 111) Süper Yöneticisinin size daveti gönderdiğinde atanan role bağlıdır.

<CustomerRoles xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <a:CustomerRole>
      <a:RoleId>41</a:RoleId>
      <a:CustomerId>999</a:CustomerId>
      <a:AccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:CustomerLinkPermission i:nil="true"/>
  </a:CustomerRole>
  <a:CustomerRole>
      <a:RoleId>41</a:RoleId>
      <a:CustomerId>111</a:CustomerId>
      <a:AccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:CustomerLinkPermission i:nil="true"/>
  </a:CustomerRole>
</CustomerRoles>

Hesap Hiyerarşisi için Roller Örneği

Çok Kullanıcılı Kimlik Bilgileri için Roller Örneği'ni temel alarak (hiyerarşi oluşturmak için Çok Kullanıcılı Kimlik Bilgileri gerekli olmasa da), örneğin, Yönetici Hesabı L1'deki (müşteri kimliği 111) (siz veya başka bir Süper Yönetici) Süper Yönetici kullanıcılarından biri, hem müşteri hem de reklamveren hesabı istemci bağlantıları ile Yönetici Hesabı L1 (müşteri kimliği 111) altında bir Ajans Hierachy kurulumu yapar:

  • Yönetici Hesabı L1 (müşteri kimliği 111), Yönetici Hesabı L2'ye (müşteri kimliği 222) yönetim bağlantısıyla bağlanır.
  • Yönetici Hesabı L2 (müşteri kimliği 222), Standart bağlantı içeren Yönetici Hesabı L3'e (müşteri kimliği 333) bağlanır.
  • Yönetici Hesabı L3 (müşteri kimliği 333) bir hesap düzeyi bağlantısıyla Ad Hesabı 4A'ya (hesap kimliği 444111) bağlantılar. Reklam Hesabı 4A (hesap kimliği 444111), doğrudan Müşteri düzeyi hiyerarşisine dahil olmayan Yönetici Hesabı L4'in (müşteri kimliği 444) altındadır.

Kaydolmuş olduğunuz özgün müşteriye (örneğin, 999) erişmeye devam edebilirsiniz ve hala Yönetici Hesabı L1'de (müşteri kimliği 111) doğrudan bir kullanıcısınız. Şimdi GetUser işlemi, her biri Yönetici Hesabı L2 (müşteri kimliği 222) ve Yönetici Hesabı L3 (müşteri kimliği 333) için birer tane olan iki ek CustomerRole nesnesi döndürür. Sırasıyla Yönetici Hesabı L2 (müşteri kimliği 222) ve 333 aracılığıyla erişilebilen tüm AccountId'lere ve LinkedAccountId'lere erişebilirsiniz. Bu örnekte Ad Hesabı 4A'ya (hesap kimliği 444111) Yönetici Hesabı L3 (müşteri kimliği 333) üzerinden erişebilirsiniz; örneğin, müşteri tanımlayıcısı gerektiren hizmet işlemlerini çağırırken, hesap 444111 erişmek için Yönetici Hesabı L3 (müşteri kimliği 333) kullanmanız gerekir.

<CustomerRoles xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <a:CustomerRole>
      <a:RoleId>41</a:RoleId>
      <a:CustomerId>999</a:CustomerId>
      <a:AccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:CustomerLinkPermission i:nil="true"/>
  </a:CustomerRole>
  <a:CustomerRole>
      <a:RoleId>41</a:RoleId>
      <a:CustomerId>111</a:CustomerId>
      <a:AccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:CustomerLinkPermission i:nil="true"/>
  </a:CustomerRole>
  <a:CustomerRole>
      <a:RoleId>41</a:RoleId>
      <a:CustomerId>222</a:CustomerId>
      <a:AccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:CustomerLinkPermission>Administrative</a:CustomerLinkPermission>
  </a:CustomerRole>
  <a:CustomerRole>
      <a:RoleId>41</a:RoleId>
      <a:CustomerId>333</a:CustomerId>
      <a:AccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <b:long>444111</b:long>
      </a:LinkedAccountIds>
      <a:CustomerLinkPermission>Standard</a:CustomerLinkPermission>
  </a:CustomerRole>
</CustomerRoles>

Müşteri rolleri hangi müşterilere erişebileceğinizi bildirir ancak erişimi nasıl edindiğiniz her zaman açıklanmaz. GetLinkedAccountsAndCustomersInfo işlemi, belirtilen müşterinin altındaki müşteri ve hesap hiyerarşisini döndürür. Ayrıntılar ve örnekler için bkz. Hiyerarşiyi Görüntüleme.

Toplayıcı Hiyerarşisi için Roller Örneği

Microsoft Advertising ile ilk kez kaydolduysanız, Toplayıcı kimlik bilgilerini aldıysanız ve SignupCustomer aracılığıyla yeni bir müşteri ve reklamveren hesabı oluşturduysanız, GetUser işlemi iki CustomerRole nesnesi döndürür. Her CustomerRole içindeki öğeler RoleId dışında eşdeğerdir. Toplayıcı, Microsoft Advertising'te 41 ve 33 gibi iki rol tanımlayıcısına sahiptir.

<CustomerRoles xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <a:CustomerRole>
      <a:RoleId>33</a:RoleId>
      <a:CustomerId>111</a:CustomerId>
      <a:AccountIds i:nil="true" xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <b:long>111222</b:long>                  
      </a:LinkedAccountIds>
      <a:CustomerLinkPermission i:nil="true"/>
  </a:CustomerRole>
  <a:CustomerRole>
      <a:RoleId>41</a:RoleId>
      <a:CustomerId>111</a:CustomerId>
      <a:AccountIds i:nil="true" xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
      <a:LinkedAccountIds xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <b:long>111222</b:long>                  
      </a:LinkedAccountIds>
      <a:CustomerLinkPermission i:nil="true"/>
  </a:CustomerRole>
</CustomerRoles>

Erişim ve Geliştirici Belirteçleri

Program aracılığıyla bir Microsoft Advertising kullanıcısı adına hareket etmek için, bu kullanıcının onayını almanız gerekir. Onay iş akışının sonunda kullanıcıyı temsil eden bir erişim belirteci alabilirsiniz. Erişim belirteci, kullanıcının Microsoft Advertising web uygulamasındaki rolleriyle aynı rollere ve aynı hesaplara erişime sahiptir. Başka bir deyişle, Microsoft Advertising web uygulamasında sağlanan aynı hesaplar ve kullanıcı rolü izinleri API aracılığıyla program aracılığıyla kullanıcı tarafından kullanılabilir. Microsoft Advertising kullanıcısı adına işlem yapmak üzere erişim belirteci alma hakkında bilgi için bkz. OAuth ile kimlik doğrulaması.

Ayrıca uygulamanızı benzersiz olarak tanımlayan bir geliştirici belirteci gerekir. API erişimi için geliştirici belirteci almak herhangi bir Microsoft Advertising hesabına ek izin vermez. Geliştirici belirteci, bir kullanıcı için önceden sağlanan hesaplara program aracılığıyla erişim sağlar. Bilgi için bkz. Geliştirici Belirteci Alma.

İpucu

Bir erişim belirteci almak ve Bing Ads API'sini kullanarak ilk hizmet çağrınızı yapmak için Hızlı Başlangıç kılavuzuna bakın.

AuthenticationToken ve DeveloperToken üst bilgileri Bing Ads API'sini kullanarak her istekte ayarlanmalıdır. GetUser işlemine örnek bir çağrı aşağıda verilmiştir .

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v13="https://bingads.microsoft.com/Customer/v13">
  <soapenv:Header>
      <v13:DeveloperToken>DeveloperTokenGoesHere</v13:DeveloperToken>
      <v13:AuthenticationToken>AccessTokenGoesHere</v13:AuthenticationToken>
  </soapenv:Header>
  <soapenv:Body>
      <v13:GetUserRequest>
        <v13:UserId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
      </v13:GetUserRequest>
  </soapenv:Body>
</soapenv:Envelope>

Çok Kullanıcılı Kimlik Bilgileri

Farklı kullanıcı rolleri ve izinlerine sahip olabilecek birden çok müşteri genelinde reklamveren hesaplarına erişmek için tek bir Microsoft Advertising çok kullanıcılı kimlik bilgileri kümesi kullanabilirsiniz.

Farklı izinlere sahip çok müşterili müşterilere erişmek için bir perspektiften yalnızca bir kullanıcı adıyla oturum açtığınızdan, "çok kullanıcılı" kimlik bilgilerinin "birden çok kullanıcı rolü" olarak anılması yararlı olabilir. Bir kişinin kimlik bilgileri birden çok farklı kullanıcı rolüyle işlem yapabilir. Örneğin, çok kullanıcılı kimlik bilgileriniz A Müşterisine ve B Müşterisine erişmenizi sağlar. Ancak, Müşteri A için Görüntüleyici kullanıcı rolünüz, A Müşterisine Ait hesaplarda herhangi bir değişiklik yapmanızı sınırlar. Ancak B Müşterisi için Süper Yönetici olarak bu müşterinin hesapları üzerinde tam denetime sahip olursunuz.

Zaten birden çok oturum açma kimlik bilgisi kümeniz varsa destek biriminin tek bir kimlik bilgisi kümesiyle birleştirmesini isteyebilirsiniz. Birleştirmeden önce sahip olduğunuz her müşteri üzerinden kullanıcı rolü ve hesap erişimi korunur. Ayrıca, aynı kişinin kimlik bilgilerinin müşteri başına benzersiz iletişim bilgileri gibi ayrı kullanıcı iletişim bilgileri kümesiyle ilişkilendirilebileceğini de unutmayın.

Daha fazla ayrıntı için Microsoft Advertising yardım konusuna bakın. Birden çok uçtan 10 0'a erişmek için kullanıcı adınızı yönetme.

Çok Kullanıcılı Birleştirme

İki e-posta adresi gibi birden çok kimlik bilgisi kümesiyle zaten oturum açtığınızda, çok kullanıcılı kimlik bilgileri el ile sağlanabilir. Mevcut kullanıcı adlarını tek bir kullanıcı adıyla birleştirmek için desteğe veya hesap yöneticinize başvurun. Bir diğer seçenek de yönetmek istediğiniz her müşteriden size bir davet gönderilmesini sağlamak ve ardından tutmak istediğiniz oturum açma kimlik bilgilerini kullanarak her daveti kabul etmektir. Bu seçenek Microsoft Advertising web uygulaması veya SendUserInvitation hizmeti işlemi aracılığıyla kullanılabilir. Mevcut Microsoft Advertising kimlik bilgileriyle daveti kabul ettikten sonra "çok kullanıcılı" kimlik bilgileriniz olur.

Çok kullanıcılı birleştirmeden önce aşağıdaki kullanıcı rollerini ve izinlerini göz önünde bulunduralım. Microsoft Advertising web uygulamasında her kullanıcı ayrı olarak oturum açmalıdır ve oturum açmış her oturum sırasında farklı izinlere sahiptir. Benzer şekilde API aracılığıyla her kullanıcının erişim belirteci (bkz. OAuth ile kimlik doğrulaması), ilgili kullanıcı ve rolle sınırlı izinleri temsil eder.

Kullanıcı Rol İzinler
one@contoso.com Görüntüleyici Müşteri A - Tüm Hesaplar
two@contoso.com Süper Yönetici Müşteri B - Tüm Hesaplar
three@contoso.com Görüntüleyici Müşteri C - Hesap A
four@contoso.com Standart kullanıcı Müşteri B - Tüm Hesaplar

öncelikle müşteri başına yalnızca bir e-posta adresinin birleştirilebileceğini, dolayısıyla bu örnekte two@contoso.comfour@contoso.com birleştirilemeyeceğini lütfen unutmayın. Şimdi ilk üç kullanıcı altında one@contoso.combirleştirildikten sonra ne olacağını görelim.

  • Microsoft Advertising web uygulaması, Microsoft Advertising Editor veya API aracılığıyla kullanıcı four@contoso.com için hiçbir değişiklik yapılmaz.
  • Kullanıcı one@contoso.com , Microsoft Advertising web uygulaması ve Microsoft Advertising Editor aracılığıyla oturum açabilir. Birleştirilmiş kullanıcılar, two@contoso.comthree@contoso.com yani artık Microsoft Advertising web uygulaması veya Microsoft Advertising Editor aracılığıyla oturum açma izinlerine sahip değildir. olarak one@contoso.comoturum açtığınızda, daha önce ve three@contoso.com'ye atanmış ilgili kullanıcı rolleriyle müşteri hesaplarına two@contoso.com bağlam değiştirebilirsiniz. Bir kullanıcının kimlik bilgileriyle (one@contoso.com ) oturum açmış birden çok müşteriye erişebilseniz de, benzersiz kullanıcı rolleriyle bağlantılı hesapları yönetmek için müşteriden müşteriye geçmeniz gerekir. Müşteriler ve ilgili hesapları birbirinden ayrı kalır. Daha fazla ayrıntı için Microsoft Advertising yardım konusuna bakın. Birden çok uçtan 10 0'a erişmek için kullanıcı adınızı yönetme.
  • Çok kullanıcılı birleştirmeden sonra, kullanıcının one@contoso.com erişim belirteci hesapların birleştirilmiş listesi (üst kümesi) izinlerini temsil eder. Geçerli kullanıcı rolü, hizmet isteğinde belirtilen müşteri ve hesap tanımlayıcılarına bağlıdır. ve three@contoso.com için two@contoso.com erişim belirteçleri artık kabul edilmeyecektir; örneğin, hata 120 - UserLoginAccessDenied döndürülür.

Çok Kullanıcılı Kişi Bilgileri

Çok kullanıcılı kimlik bilgilerine sahip bir kişi birden çok Kullanıcı nesnesi ve buna karşılık gelen kullanıcı tanımlayıcıları ile temsil edilir. Aynı kişinin kimlik bilgileri, müşteri başına benzersiz iletişim bilgileri gibi ayrı kullanıcı iletişim bilgileri kümeleriyle ilişkilendirilebilir.

GetUser yanıtı, aynı kullanıcı tanımlayıcısıyla bile aramayı kimin yaptığına bağlı olarak değişebilir. Örneğin, , ve tanımlayıcılarını one@contoso.comtwo@contoso.combirleştirmeden önce sırasıyla 123, 456 ve three@contoso.com 789 olduğunu düşünelim. Her kullanıcı tanımlayıcısı, bir kişiyi etkin bir şekilde belirli bir müşteriye eşler; örneğin, tanımlayıcı 123 kişinin erişebileceği özgün müşteriyle eşler one@contoso.com . Bu örnekte özgün kullanıcı tanımlayıcısı olarak 123'e başvuruyoruz.

  • Erişim belirteci GetUser'ı çağırmak için one@contoso.com kullanılıyorsa ve UserId değeri sıfır veya UserId değeri özgün kullanıcı tanımlayıcısına ayarlanmışsa (örneğin, 123), işlem kullanıcının erişebileceği tüm müşteriler için CustomerRole nesnelerini döndürür.
  • Erişim belirteci GetUser'ı çağırmak için one@contoso.com kullanılıyorsa ve UserId değeri 456 veya 789 olarak ayarlandıysa, işlem bu kişiyi belirli bir müşteriyle eşleyen yalnızca bir CustomerRole nesnesi döndürür.

Aynı kişinin Name, Lcid, JobTitle ve ContactInfo kullanıcı ayarları, kullanıcı birleştirme sonrasında gerçekleşen güncelleştirmelerle otomatik olarak eşitlenir. LastModifiedByUserId ve LastModifiedTime, eski bir kullanıcı adı birleştirilmemişse ve birleştirmeden bu yana hiçbir kullanıcı ayarlarını güncelleştirmediyseniz döndürülen her Kullanıcı nesnesi arasında eşitlenir.

Not

TimeStamp, LastModifiedTime'dan farklıdır. Tüm TimeStamp değerleri Kullanıcı başına benzersizdir ve UpdateUser'ı çağırdığınızda ilgili kullanıcının zaman damgalarını (adres zaman damgası dahil) eklemeniz gerekir.

Örneğin, ve three@contoso.comile two@contoso.com birleştirmeden önce için one@contoso.com kullanıcı bilgilerini güncelleştirmemiş olduğunuzu varsayalım. Birleştirmeden sonra ve kullanıcı ayarları birleştirme sonrasında güncelleştirilene kadar döndürülen her User nesnesi içinde benzersiz bir LastModifiedByUserId ve LastModifiedTime gözlemlemeye devam edebilirsiniz.

Kullanıcı Kimliği Kişi Bilgileri Kimliği İzinler LastModifiedByUserId
123 234 Müşteri A - Tüm Hesaplar 123
456 567 Müşteri B - Tüm Hesaplar 456
789 890 Müşteri C - Hesap A 789

Şimdi bunun Müşteri B bağlamında hareket ettiğini ve iletişim bilgilerini güncelleştirdiğini one@contoso.com düşünelim. Güncelleştirilmiş kişi bilgilerinin yanı sıra aynı LastModifiedByUserId ve LastModifiedTime artık döndürülen tüm User nesneleri arasında eşitlenir.

Kullanıcı Kimliği Kişi Bilgileri Kimliği İzinler LastModifiedByUserId
123 234 Müşteri A - Tüm Hesaplar 456
456 567 Müşteri B - Tüm Hesaplar 456
789 890 Müşteri C - Hesap A 456

Hesap Hiyerarşisi

Arama reklam işletmeleri genellikle aşağıdaki hesap yönetimi modellerinden biriyle veya daha fazlasıyla uyumlu olur.

  • Doğrudan reklam veren, kendi reklam kampanyaları için bir Bing Ads API uygulaması oluşturur ve geçerli reklam tıklamaları için doğrudan Microsoft tarafından faturalandırılır.
  • Bir araç sağlayıcısı, diğer şirketlerin reklam kampanyalarını yönetmesi için bir Bing Ads API uygulaması oluşturur ve Microsoft tarafından faturalandırılmaz. Hesapların sahibi reklamveren kullanıcıdır, geçerli reklam tıklamaları için doğrudan Microsoft tarafından faturalandırılır ve araç sağlayıcısına bir ücret ödeyebilir.
  • Bir ajans, şirketinin reklam müşterilerinin kampanyalarını yönetmesi için bir Bing Ads API uygulaması oluşturur. Hesapların sahibi kuruluşun müşterisidir, geçerli reklam tıklamaları için doğrudan Microsoft tarafından faturalandırılır ve kuruluşa bir ücret ödeyebilir.
  • Toplayıcı veya bayi, reklam müşterilerinin kampanyalarını yönetmek için bir Bing Ads API uygulaması oluşturur ve geçerli canlı tıklamalar için doğrudan Microsoft tarafından faturalandırılır. Reklamveren Microsoft Advertising kimlik bilgilerine kaydolmaz ve toplayıcıya bir ücret ödeyebilir.

İş modeli ne olursa olsun, ilk kaydolma ve kullanıcı rolü sağlama işlemi az çok aynıdır. Aşağıdaki bölümlerde , aracı ve toplayıcı hiyerarşilerini ayarlamak için gereken ek adımlar ele alınmıştır.

Ajans Hiyerarşisi

Bir ajans, şirketinin reklam müşterilerinin kampanyalarını yönetmesi için bir Bing Ads API uygulaması oluşturur. İstemci bağlantıları, bir kuruluşun bir reklamveren hesabının bazı veya tüm yönlerini yönetmesine olanak tanır. İstemci bağlantı isteği kapsamı tek tek müşteri reklamvereni hesaplarıyla veya müşteri altındaki tüm hesaplara sınırlayabilir.

Not

Hiyerarşiler bağlamında Müşteri , "Yönetici hesabı" olarak da bilinir. ReklamverenHesap", "Hesap" veya "Reklamveren hesabı" olarak adlandırılır.

Bir ajansa bağlanabilecek müşteri hesabı miktarı için belirlenmiş bir sınır yoktur; ancak, yönetici hesabından yönetici hesabına bağlantılar için yalnızca 5 derinlik düzeyi desteklenir. Her düzeyde (L1, L2, L3, L4, L5) bir yönetici hesabı herhangi bir sayıda yönetici hesabına ve reklam hesabına bağlanabilir. Ajans olma hakkında daha fazla bilgi için, Microsoft Reklamcılık veya Ajans iş ortakları için Kaynaklarkonusunda müşterilerinizi bir ajans olarak yönetme yardım makalesine bakın.

İstemci hesaplarını yönetmek üzere bir hiyerarşi ayarlamak için, kuruluşun istemciye bir davet göndermesi gerekir. Bu davet, istemci müşterisinde yetkili bir kullanıcı tarafından kabul edilmelidir. Bir bağlantının zaten var olup olmadığını belirlemek için SearchClientLinks işlemini çağırın ve döndürülen ClientLink'lerin Status öğesini denetleyin. Tek bir hesaba göre arama yapmak için koşul alanını ClientAccountId olarak ayarlayın ve koşul değerini bulmak istediğiniz hesap tanımlayıcısı olarak ayarlayın.

Not

Yalnızca Süper Yönetici veya Standart kimlik bilgilerine sahip bir kullanıcı reklamveren hesaplarına istemci bağlantıları ekleyebilir, güncelleştirebilir ve arama yapabilir. Yalnızca Süper Yönetici kimlik bilgilerine sahip bir kullanıcı müşterilere istemci bağlantıları ekleyebilir, güncelleştirebilir ve arama yapabilir.

Etkin, LinkAccepted, LinkInProgress, LinkPending, UnlinkInProgress veya UnlinkPending durumunda bir bağlantı varsa, kuruluş yinelenen bir istemci bağlantısı başlatamaz.

Belirtilen hesaba yönelik bir istemci bağlantısı henüz yoksa veya mevcut bir bağlantının yaşam döngüsü Süresi Doldu, LinkCanceled, LinkDe eğik, LinkFailed veya Etkin Değil durumuyla sona erdiyse, kuruluş AddClientLinks işlemini çağırarak yeni bir istemci bağlantısı daveti başlatabilir. Hizmet, istemci bağlantı durumunu hemen LinkPending'e geçirir.

Önemli

Reklamveren hesabı istemci bağlantıları için, kuruluş istemci bağlantı isteğinde IsBillToClient öğesini ayarlayarak müşterinin veya kuruluşun faturalamadan sorumlu olup olmayacağını belirtmelidir.

İstemci bağlantısını güncelleştirmek için, doğrulama için TimeStamp öğesi gereklidir, bu nedenle var olan ClientLink nesnesini almak için önce SearchClientLinks işlemini çağırmanız gerekir. Ardından döndürülen ClientLink'inStatus öğesini değiştirin ve güncelleştirilmiş ClientLink nesnesini UpdateClientLinks işlemine sonraki bir çağrıya ekleyin.

Not

İstemci, Bing Ads API'sinde oluşturulmuş bir uygulamayı veya Microsoft Advertising web uygulamasındaki Hesaplar & Faturalama sekmesini kullanarak kabul edebilir veya reddedebilir.

İstemci yalnızca UpdateClientLinks işlemini kullanarak Durumu LinkAccepted veya LinkDe eğik olarak güncelleştirebilir.

  • İstemci durumu LinkDe eğik olarak ayarlarsa, istemci bağlantı yaşam döngüsü sona erer. Reddedilen istemci bağlantısını güncelleştiremezsiniz ve istemci hesabını yönetmek için yeni bir davet göndermeniz gerekir.
  • İstemci durumu LinkAccepted olarak ayarlarsa, durum LinkInProgress'e geçer. Bağlantı işlemi başarılı olursa, hizmet istemci bağlantı durumunu Etkin olarak güncelleştirir.

Örneğin, faturalama geçişi hatası nedeniyle bağlantı kurulamıyorsa, hizmet istemci bağlantısı durumunu LinkFailed olarak güncelleştirir. Başarısız istemci bağlantısını güncelleştiremezsiniz ve istemci hesabını yönetmek için yeni bir davet göndermeniz gerekir. İstemci veya kuruluş 30 gün içinde işlem yapmazsa, hizmet durumu LinkExpired olarak ayarlar ve istemci bağlantı yaşam döngüsü sona erer. Süresi dolan bir istemci bağlantısını güncelleştiremezsiniz ve istemci hesabını yönetmek için yeni bir davet göndermeniz gerekir.

İstemciye İstemci

İstemci bağlantı durumu LinkPending ise, kuruluş önceki bir bağlantı isteğini iptal etmeyi seçebilir.

İstemci bağlantı durumu Etkin ise, kuruluş istemciyle var olan ilişkiyi sonlandırmayı seçebilir. Bağlantıyı kaldırma işlemini başlatmak için, aracı istemci bağlantı durumunu UnlinkRequested olarak ayarlar ve UpdateClientLinks işlemini çağırır. UnlinkRequested ile durumu güncelleştirmek, durumu etkili bir şekilde UnlinkInProgress olarak ayarlar. Hizmet, istemci bağlantı durumunu hemen UnlinkPending'e geçirir ve ardından sistem kaynaklarının devam etmelerini bekler. Durum hızla UnlinkInProgress'e geçmelidir.

Örneğin, faturalama geçişi hatası nedeniyle bağlantıyı kaldırma işlemi başarısız olursa istemci bağlantısı Etkin durumuna devam eder. Bağlantıyı kaldırma işlemi başarılı olursa durum Etkin Değil olarak güncelleştirilir ve istemci bağlantısı yaşam döngüsü sona erer. Etkin olmayan istemci bağlantısını güncelleştiremezsiniz ve istemci hesabını yönetmek için yeni bir davet göndermeniz gerekir.

İstemci bağlantısını İstemciden

İstemci bağlantısı davetinin nasıl ekleneceğini ve güncelleştirileceğini gösteren kod örnekleri için bkz. İstemci Bağlantıları Kod Örneği.

Hiyerarşiyi Görüntüleme

Bir ajansın hesap hiyerarşisini görüntülemek için çeşitli seçenekleri vardır.

  • GetUser işlemi, müşteri ve bağlı hesaplar başına kullanıcı rollerini döndürür. Müşteri rolleri hangi müşterilere erişebileceğinizi bildirir ancak erişimi nasıl edindiğiniz her zaman açıklanmaz. Kullanıcı rolünün belirlenmesi, Yönetim ve Standart istemci bağlantıları arasında fark yaratır. Müşteri rolü örnekleri için bkz. Kullanıcı Rollerini Alma.
  • Zaten aracı ve istemci varlık tanımlayıcılarına sahipseniz SearchClientLinks işlemi size bir istemci bağlantısının geçerli durumunu verir. Örneğin, müşteri kimliğini ve istemci hesabı kimliğini veya istemci müşteri kimliğini yöneterek arama yapabilirsiniz.
  • GetLinkedAccountsAndCustomersInfo işlemi, belirtilen müşterinin altındaki müşteri ve hesap hiyerarşisini döndürür.

Örneğin, hem müşteri hem de reklamveren hesabı istemci bağlantıları ile Yönetici Hesabı L1 (müşteri kimliği 111) altında bir ajans hiyerarşisinin ayarlandığını düşünelim:

  • Hiyerarşi kurulmadan önce dört ayrı yönetici hesabı sağlanıyordu. Yönetici Hesabı L1, Ad Hesabı 1A ve Reklam Hesabı 1B içerir. Yönetici Hesabı L2, Ad Hesabı 2A ve Reklam Hesabı 2B içerir. Yönetici Hesabı L3, Ad Hesabı 3A ve Reklam Hesabı 3B içerir. Yönetici Hesabı L4, Ad Hesabı 4A ve Reklam Hesabı 4B içerir.
  • Yönetici Hesabı L1 (müşteri kimliği 111), Yönetici Hesabı L2'ye (müşteri kimliği 222) yönetim bağlantısıyla bağlanır.
  • Yönetici Hesabı L2 (müşteri kimliği 222), Standart bağlantı içeren Yönetici Hesabı L3'e (müşteri kimliği 333) bağlanır.
  • Yönetici Hesabı L3 (müşteri kimliği 333) bir hesap düzeyi bağlantısıyla Ad Hesabı 4A'ya (hesap kimliği 444111) bağlantılar. Reklam Hesabı 4A (hesap kimliği 444111), doğrudan Müşteri düzeyi hiyerarşisine dahil olmayan Yönetici Hesabı L4'in (müşteri kimliği 444) altındadır. Bu örnekte Ad Hesabı 4A'ya (hesap kimliği 444111) Yönetici Hesabı L3 (müşteri kimliği 333) üzerinden erişebilirsiniz; örneğin, müşteri tanımlayıcısı gerektiren hizmet işlemlerini çağırırken, hesap 444111 erişmek için Yönetici Hesabı L3 (müşteri kimliği 333) kullanmanız gerekir.

Yönetici Hesabı L1'de (müşteri kimliği 111) Microsoft Advertising web uygulamasında oturum açan tam hiyerarşiye erişimi olan bir kullanıcı aşağıdaki hesap görünümüne erişebilir.

Hiyerarşili Hiyerarşi Yöneticisi Hesabı

Müşteri kimliği 111'e göre arama yaparsanız GetLinkedAccountsAndCustomersInfo yanıtı AccountsInfo içinde Ad Hesabı 1A ve Reklam Hesabı 1B'yi içerir. Yönetici Hesabı L2 hakkındaki bilgiler CustomersInfo içinde döndürülür.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/Customer/v13">f4f8d20a-e354-4bfc-b196-bef9d766d372</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetLinkedAccountsAndCustomersInfoResponse xmlns="https://bingads.microsoft.com/Customer/v13">
         <AccountsInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:AccountInfo>
               <a:Id>111111</a:Id>
               <a:Name>Ad Account 1A</a:Name>
               <a:Number>E101NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
            <a:AccountInfo>
               <a:Id>111222</a:Id>
               <a:Name>Ad Account 1B</a:Name>
               <a:Number>E102NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
         </AccountsInfo>
         <CustomersInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:CustomerInfo>
               <a:Id>222</a:Id>
               <a:Name>Manager Account L2</a:Name>
            </a:CustomerInfo>
         </CustomersInfo>
      </GetLinkedAccountsAndCustomersInfoResponse>
   </s:Body>
</s:Envelope>

Benzer şekilde, müşteri kimliği 222'ye göre arama yaparsanız GetLinkedAccountsAndCustomersInfo yanıtı , AccountsInfo içinde Ad Hesabı 2A ve Ad Hesabı 2B'yi içerir. Yönetici Hesabı L3 hakkındaki bilgiler CustomersInfo içinde döndürülür.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/Customer/v13">f4f8d20a-e354-4bfc-b196-bef9d766d372</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetLinkedAccountsAndCustomersInfoResponse xmlns="https://bingads.microsoft.com/Customer/v13">
         <AccountsInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:AccountInfo>
               <a:Id>222111</a:Id>
               <a:Name>Ad Account 2A</a:Name>
               <a:Number>E201NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
            <a:AccountInfo>
               <a:Id>222222</a:Id>
               <a:Name>Ad Account 2B</a:Name>
               <a:Number>E202NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
         </AccountsInfo>
         <CustomersInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:CustomerInfo>
               <a:Id>333</a:Id>
               <a:Name>Manager Account L3</a:Name>
            </a:CustomerInfo>
         </CustomersInfo>
      </GetLinkedAccountsAndCustomersInfoResponse>
   </s:Body>
</s:Envelope>

Şimdi müşteri kimliği 333'e göre arama yaparsanız GetLinkedAccountsAndCustomersInfo yanıtı AccountsInfo içinde Ad Hesabı 3A, Reklam Hesabı 3B ve Ad Hesabı 4A'yı içerir. CustomersInfo içinde hiçbir yönetici hesabı listelenmez.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/Customer/v13">e9ecedcc-720d-4ba4-a3e8-9bdef148dae2</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetLinkedAccountsAndCustomersInfoResponse xmlns="https://bingads.microsoft.com/Customer/v13">
         <AccountsInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:AccountInfo>
               <a:Id>333111</a:Id>
               <a:Name>Ad Account 3A</a:Name>
               <a:Number>E301NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
            <a:AccountInfo>
               <a:Id>333222</a:Id>
               <a:Name>Ad Account 3B</a:Name>
               <a:Number>E302NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
            <a:AccountInfo>
               <a:Id>444111</a:Id>
               <a:Name>Ad Account 4A</a:Name>
               <a:Number>E401NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
         </AccountsInfo>
         <CustomersInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetLinkedAccountsAndCustomersInfoResponse>
   </s:Body>
</s:Envelope>

Şimdi müşteri kimliği 444'e göre arama yaparsanız GetLinkedAccountsAndCustomersInfo yanıtı AccountsInfo içinde Ad Hesabı 4A ve Reklam Hesabı 4B'yi içerir. CustomersInfo içinde hiçbir yönetici hesabı listelenmez.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/Customer/v13">e5799094-dad6-45b8-983b-4ace50efd86b</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetLinkedAccountsAndCustomersInfoResponse xmlns="https://bingads.microsoft.com/Customer/v13">
         <AccountsInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:AccountInfo>
               <a:Id>444111</a:Id>
               <a:Name>Ad Account 4A</a:Name>
               <a:Number>E401NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
            <a:AccountInfo>
               <a:Id>444222</a:Id>
               <a:Name>Ad Account 4B</a:Name>
               <a:Number>E402NUMB</a:Number>
               <a:AccountLifeCycleStatus>Pause</a:AccountLifeCycleStatus>
               <a:PauseReason>2</a:PauseReason>
            </a:AccountInfo>
         </AccountsInfo>
         <CustomersInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetLinkedAccountsAndCustomersInfoResponse>
   </s:Body>
</s:Envelope>

Yukarıdaki örnek yanıtlardan bazı önemli noktalar aşağıda verilmiştir:

  • GetLinkedAccountsAndCustomersInfo, müşteri kimliği 111 veya 222 tarafından istense de benzer bir yapı döndürmüş gibi görünse de, önemli bir fark vardır. Senaryo girişinde belirtildiği gibi, Mananger Hesabı L1'den Yönetici Hesabı L2'ye bağlantı bir Yönetim bağlantısıyken, Yönetici Hesabı L2'den Yönetici Hesabı L3'e bağlantı Standart'tır. GetLinkedAccountsAndCustomersInfo yanıtı, yönetim veya standart gibi bağlantı türüyle ilgili ayrıntıları içermez. Bağlantı türü, kullanıcı rolüne bağlı olarak kullanıcının iznini daha da daraltabildiğinden, GetUser'ı çağırdığınızda her CustomerRole'a eklenir.
  • Müşteri kimliği 333'e göre arama yaparken Reklam Hesabı 3A, Reklam Hesabı 3B ve Reklam Hesabı 4A arasında belirgin bir fark yoktur. Senaryo girişinde belirtildiği gibi Reklam Hesabı 4A'ya bir reklamveren hesabı istemci bağlantısı üzerinden erişilebilirken, diğer hesaplar doğrudan Yönetici Hesabı L3'te yer alır. Her hesabın doğrudan sahibini belirleme gereksiniminiz varsa GetAccount veya SearchAccounts gibi diğer hizmet işlemlerini çağırabilirsiniz.
  • Geçerli hiyerarşide Ad Hesabı 4B yalnızca Yönetici Hesabı L4'teki kullanıcılar tarafından kullanılabilir. Yönetici Hesabı L3'teki kullanıcılar 3 hesaba erişmek için sağlanabilir, Yönetici Hesabı L2'deki kullanıcılar 5 hesaba erişmek için sağlanabilir ve Yönetici Hesabı L1'deki kullanıcılar 7 hesaba erişmek için sağlanabilir. Süper Yönetici, her kullanıcının erişimini kullanılabilir hesapların bir alt kümesiyle sınırlamayı seçebilir.

Toplayıcı Hiyerarşisi

Toplayıcı rolü, çok sayıda reklamverene arama-pazarlama araçları ve hizmetleri sunan sınırlı bir iş ortağı kümesine sunulur. Toplayıcı rolü, iş ortaklarının program aracılığıyla yeni müşteri hesapları oluşturmasına olanak tanır. Toplayıcı, müşterileri tarafından tahakkuk eden tüm reklam maliyetleri için faturayla faturalandırılır. Reklam veren genellikle Microsoft Advertising kimlik bilgilerine kaydolmaz ve toplayıcıya bir ücret ödeyebilir.

Birincil müşteri kabuğunda bir Toplayıcı kullanıcısı sağlanır. Varlık Sınırları'nda açıklandığı gibi, tüm reklam etkinlikleri müşteri tarafından düzenlenir ve bir veya daha fazla hesabı olabilir. SignupCustomer Toplayıcı kullanıcısı tarafından her çağrıldığında, yeni bir müşteri içinde yeni bir reklamveren hesabı oluşturulur.

Önemli

Toplayıcı kullanıcı rolü , SignupCustomer için gereklidir. İlk kimlik bilgileriniz sağlandıktan sonra toplayıcı müşteriye bir Süper Yönetici kullanıcısı eklenirse, kullanıcı varsayılan olarak toplayıcının yönettiği tüm müşterilerin verilerini yönetebilir. Kullanıcı SignupCustomer'ı çağıramaz, ancak aksi takdirde kampanya verilerine okuma ve yazma erişimine sahip olur.

SignupCustomer işlemi hem Customer hem de AdvertiserAccount nesnelerini gerektirir. Müşteri nesnesi müşterinin adını, müşterinin bulunduğu adresi, müşterinin faaliyet gösterdiği pazarı ve müşterinin katıldığı sektörü içerir. Aynı ayrıntılara sahip birden çok müşteri eklemek mümkün olsa da, kullanıcıların kullanıcı arabirimindeki müşterileri kolayca ayırt edebilmesi için benzersiz müşteri adları kullanmanız gerekir. Hesap nesnesi hesabın adını belirtmelidir; hesabı kapatmak için kullanılacak para biriminin türü; ve null olarak ayarlanması gereken ödeme yöntemi tanımlayıcısını seçin. İşlem bir fatura hesabı oluşturur ve ödeme yöntemi tanımlayıcısını toplayıcının faturasıyla ilişkili tanımlayıcıya ayarlar. Faturalama toplayıcının ödeme aracına yuvarlanır ve toplayıcılar, yönettiği müşteriler tarafından tahakkuk eden tüm ücretler için faturalandırılır.

Toplayıcı Kimlik Bilgilerini Alma

Toplayıcı kimlik bilgilerini istemek için toplayıcı rolünü alma hakkında ayrıntılı bilgi için lütfen belirlenen hesap yönetimi ekibinize başvurun. Şu anda toplayıcı değilseniz ancak bir toplayıcı olmak istiyorsanız Microsoft Reklam İş Ortağı Programı hoş geldiniz sayfasına gidin.

Ayrıca Bkz

Müşteri Yönetim Hizmeti Başvurusu
Bing Ads API Web Hizmeti Adresleri